@shelamkoff/rector 1.0.0

package/dist/plugins/paragraph/README.md

@@ -0,0 +1,57 @@
+# Paragraph block plugin
+
+Editable rich-text paragraph with alignment, inline tools, inline widgets, merge, and block conversion support.
+
+## Install and register
+
+```bash
+npm install @shelamkoff/rector
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Paragraph } from '@shelamkoff/rector/plugins/paragraph'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Paragraph()],
+})
+```
+
+The registered block type is `paragraph`. The class is also exported by the complete `@shelamkoff/rector/plugins` preset and can be loaded through `@shelamkoff/rector/plugins/async`.
+
+## Data
+
+```json
+{ "text": "Hello <strong>world</strong>", "align": "left" }
+```
+
+### Field reference
+
+| Field | Required | Meaning and constraints |
+| --- | --- | --- |
+| `text` | yes | Non-blank sanitized inline HTML. Serialized text may contain placeholders whose data lives in the block's `inline` map. |
+| `align` | no | `left`, `center`, `right`, or `justify`. When omitted, the editor and renderer use their normal text alignment. |
+
+An empty paragraph may exist temporarily while the user is editing. It is not valid persisted paragraph data in strict validation mode.
+
+## Configuration
+
+Every built-in block plugin accepts two style ownership options: `injectStyles?: boolean` defaults to `true`; set it to `false` when the host bundles that plugin's CSS. `css?: string` adds one host-provided stylesheet URL after the plugin default, or acts as the replacement URL when default injection is disabled.
+
+`placeholder?: string` overrides the empty paragraph prompt.
+
+## Capabilities
+
+Inline tools and widgets; paragraph merge; export for conversion.
+
+## Undo, lifecycle, and styles
+
+User actions exposed by the plugin enter the command pipeline through the supplied `context.mutate()` capability, so each completed action is one undo/redo step. The editor reference-counts the plugin's declared stylesheet URLs. Removing a block calls its cleanup hook; removing the editor calls `destroy()` for every remaining block and then releases shared plugin resources.
+
+Do not remove the editor holder without first calling `editor.destroy()`.
+
+## Document output
+
+Use the matching renderer from `@shelamkoff/rector/renderer/renderers/paragraph`. The VitePress guide documents configuration, commands and history, extension contracts, document migrations, styling, security, and lifecycle in a sequential form.

package/dist/plugins/paragraph/README.ru.md

@@ -0,0 +1,58 @@
+# Блочный плагин Paragraph
+
+Абзац с форматированием, выравниванием, внутристрочными инструментами и виджетами.
+
+## Установка и регистрация
+
+```bash
+npm install @shelamkoff/rector
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Paragraph } from '@shelamkoff/rector/plugins/paragraph'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Paragraph()],
+})
+```
+
+Тип блока — `paragraph`. Класс также экспортируется общей точкой входа `@shelamkoff/rector/plugins` и может загружаться по типу документа через `@shelamkoff/rector/plugins/async`.
+
+## Данные
+
+```json
+{ "text": "Привет, <strong>мир</strong>", "align": "left" }
+```
+
+### Поля данных
+
+| Поле | Обязательно | Назначение и ограничения |
+| --- | --- | --- |
+| `text` | да | Непустой очищенный внутристрочный HTML. Сериализованный текст может содержать заполнители, данные которых находятся в карте `inline` блока. |
+| `align` | нет | `left`, `center`, `right` или `justify`. Если поле отсутствует, редактор и рендерер используют обычное выравнивание текста. |
+
+Пустой абзац может временно существовать во время редактирования. В строгом режиме проверки он не является допустимыми сохранёнными данными абзаца.
+
+## Конфигурация
+
+Каждый встроенный блочный плагин принимает два параметра владения стилями: `injectStyles?: boolean` по умолчанию равен `true`; укажите `false`, если приложение само включает CSS этого плагина. `css?: string` добавляет URL таблицы стилей приложения после стандартной, а при отключённой стандартной инъекции служит URL замены.
+
+`placeholder?: string` заменяет подсказку пустого абзаца.
+
+
+## Возможности
+
+Внутристрочные инструменты и виджеты; объединение абзацев; экспорт данных для преобразования блока.
+
+## История, жизненный цикл и стили
+
+Действия плагина входят в конвейер команд через предоставленный контекст `mutate()`, поэтому одно завершённое действие создаёт один шаг отмены и повтора. Редактор подсчитывает владельцев объявленных URL стилей. Удаление блока вызывает его метод освобождения ресурсов; `editor.destroy()` освобождает оставшиеся блоки и общие ресурсы.
+
+Не удаляйте контейнер редактора до вызова `editor.destroy()`.
+
+## Вывод документа
+
+Используйте фабричную функцию из `@shelamkoff/rector/renderer/renderers/paragraph`. Последовательное руководство VitePress описывает проверку данных, миграции, разработку расширений, диагностику, безопасность и стили.

package/dist/plugins/paragraph/index.d.ts

@@ -0,0 +1,112 @@
+import type {} from './locale/keys.js'
+/**
+ * Consumer configuration for {@link Paragraph}.
+ * @typedef {Object} ParagraphConfig
+ * @property {string} [placeholder] Text shown by an empty paragraph. The
+ *   default comes from the active editor locale.
+ * @property {boolean} [injectStyles=true] Whether the editor should load the
+ *   built-in paragraph stylesheet.
+ * @property {string} [css] Additional stylesheet URL, or the replacement URL
+ *   when `injectStyles` is `false`.
+ */
+/**
+ * Editable paragraph block that stores sanitized rich text and alignment.
+ * @extends {BlockPluginAbstract<ParagraphConfig>}
+ */
+export class Paragraph extends BlockPluginAbstract<ParagraphConfig> {
+    static isTextBlock: boolean;
+    static styles: string[];
+    /**
+     * Create a Paragraph instance with the supplied consumer configuration.
+     * @param {ParagraphConfig} [config]
+     */
+    constructor(config?: ParagraphConfig);
+    type: string;
+    icon: string;
+    inlineTools: boolean;
+    mapTextFields: typeof mapTextFields;
+    /**
+     * Return the localized toolbox label for this block.
+     * @returns {string}
+     */
+    get title(): string;
+    /**
+     * Set placeholder from editor-level config (lower priority than constructor config).
+     * @param {string} placeholder
+     * @returns {void}
+     */
+    setPlaceholder(placeholder: string): void;
+    /**
+     * Create the editable DOM owned by this block instance.
+     * @param {{ text?: string, align?: string }} data
+     * @returns {HTMLElement}
+     */
+    render(data: {
+        text?: string;
+        align?: string;
+    }): HTMLElement;
+    /**
+     * Serialize the current block DOM into document data.
+     * @param {HTMLElement} element
+     * @returns {{ text: string, align?: string }}
+     */
+    save(element: HTMLElement): {
+        text: string;
+        align?: string;
+    };
+    /**
+     * Check whether serialized data satisfies this block's schema.
+     * @param {{ text: string }} data
+     * @returns {boolean}
+     */
+    validate(data: {
+        text: string;
+    }): boolean;
+    /**
+     * Merge another paragraph's data into this element.
+     * @param {HTMLElement} element
+     * @param {{ text?: string, align?: string }} data
+     * @returns {void}
+     */
+    merge(element: HTMLElement, data: {
+        text?: string;
+        align?: string;
+    }): void;
+    /**
+     * Extract transferable data for block type conversion.
+     * @param {HTMLElement} element
+     * @returns {{ text: string, align?: string }}
+     */
+    exportData(element: HTMLElement): {
+        text: string;
+        align?: string;
+    };
+    /**
+     * Check if the paragraph content is empty.
+     * @param {HTMLElement} element
+     * @returns {boolean}
+     */
+    isEmpty(element: HTMLElement): boolean;
+}
+/**
+ * Consumer configuration for {@link Paragraph}.
+ */
+export type ParagraphConfig = {
+    /**
+     * Text shown by an empty paragraph. The
+     * default comes from the active editor locale.
+     */
+    placeholder?: string;
+    /**
+     * Whether the editor should load the
+     * built-in paragraph stylesheet.
+     */
+    injectStyles?: boolean;
+    /**
+     * Additional stylesheet URL, or the replacement URL
+     * when `injectStyles` is `false`.
+     */
+    css?: string;
+};
+import { BlockPluginAbstract } from '../BlockPluginAbstract.js';
+import { mapTextFields } from './mapTextFields.js';

package/dist/plugins/paragraph/index.js

@@ -0,0 +1,158 @@
+import { sanitizeHtml } from '../../core/sanitize.js'
+import { resolvePath } from '../../shared/resolvePath.js'
+import { BlockPluginAbstract } from '../BlockPluginAbstract.js'
+import { mapTextFields } from './mapTextFields.js'
+import { validateParagraphData } from '../../shared/blockDataValidators.js'
+import { normalizeTextAlign, normalizeTextValue } from '../../shared/textFormat.js'
+
+const editorStyles = resolvePath('./paragraph.css', import.meta.url)
+
+// Tabler icon: letter-t
+const ICON = '<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M6 4l12 0"/><path d="M12 4l0 16"/></svg>'
+
+
+/**
+ * Consumer configuration for {@link Paragraph}.
+ * @typedef {Object} ParagraphConfig
+ * @property {string} [placeholder] Text shown by an empty paragraph. The
+ *   default comes from the active editor locale.
+ * @property {boolean} [injectStyles=true] Whether the editor should load the
+ *   built-in paragraph stylesheet.
+ * @property {string} [css] Additional stylesheet URL, or the replacement URL
+ *   when `injectStyles` is `false`.
+ */
+
+/**
+ * Editable paragraph block that stores sanitized rich text and alignment.
+ * @extends {BlockPluginAbstract<ParagraphConfig>}
+ */
+export class Paragraph extends BlockPluginAbstract {
+  static isTextBlock = true
+  static styles = [editorStyles]
+  type = 'paragraph'
+  icon = ICON
+  inlineTools = true
+  mapTextFields = mapTextFields
+
+  /**
+   * Create a Paragraph instance with the supplied consumer configuration.
+   * @param {ParagraphConfig} [config]
+   */
+  constructor(config) {
+    super(config)
+  }
+
+  /**
+   * Return the localized toolbox label for this block.
+   * @returns {string}
+   */
+  get title() {
+    return this._t('title', 'Text')
+  }
+
+  /**
+   * Set placeholder from editor-level config (lower priority than constructor config).
+   * @param {string} placeholder
+   * @returns {void}
+   */
+  setPlaceholder(placeholder) {
+    if (!Object.hasOwn(this._config, 'placeholder')) {
+      this._config = /** @type {typeof this._config} */ (Object.freeze({ ...this._config, placeholder }))
+    }
+  }
+
+  /**
+   * Create the editable DOM owned by this block instance.
+   * @param {{ text?: string, align?: string }} data
+   * @returns {HTMLElement}
+   */
+  render(data) {
+    const p = document.createElement('p')
+    p.classList.add('oe-paragraph')
+    p.contentEditable = 'true'
+
+    const text = normalizeTextValue(data?.text)
+    if (text) {
+      p.innerHTML = sanitizeHtml(text)
+    }
+    const align = normalizeTextAlign(data?.align)
+    if (align) {
+      p.style.textAlign = align
+    }
+
+    // Placeholder via data attribute + CSS :empty::before
+    // Priority: explicit config > i18n locale > empty (no placeholder)
+    const placeholder = Object.hasOwn(this._config, 'placeholder')
+      ? this._config.placeholder
+      : this._t('placeholder', '')
+    if (placeholder) {
+      p.dataset.placeholder = placeholder
+    }
+
+    // No Level 1 paste handler — paragraph is a simple text block.
+    // Clipboard (Level 2) handles all paste: sanitization, multi-line splitting.
+    // Level 1 is for specialized plugins (code block, image) that need custom paste.
+
+    return p
+  }
+
+  /**
+   * Serialize the current block DOM into document data.
+   * @param {HTMLElement} element
+   * @returns {{ text: string, align?: string }}
+   */
+  save(element) {
+    const data = { text: element.innerHTML.trim() }
+    if (element.style.textAlign) data.align = element.style.textAlign
+    return data
+  }
+
+  /**
+   * Check whether serialized data satisfies this block's schema.
+   * @param {{ text: string }} data
+   * @returns {boolean}
+   */
+  validate(data) {
+    return validateParagraphData(data)
+  }
+
+  /**
+   * Merge another paragraph's data into this element.
+   * @param {HTMLElement} element
+   * @param {{ text?: string, align?: string }} data
+   * @returns {void}
+   */
+  merge(element, data) {
+    const text = normalizeTextValue(data.text)
+    if (text) {
+      element.innerHTML += sanitizeHtml(text)
+    }
+    // Preserve alignment from merged block if current has none
+    const align = normalizeTextAlign(data.align)
+    if (align && !element.style.textAlign) {
+      element.style.textAlign = align
+    }
+  }
+
+  /**
+   * Extract transferable data for block type conversion.
+   * @param {HTMLElement} element
+   * @returns {{ text: string, align?: string }}
+   */
+  exportData(element) {
+    /** @type {{ text: string, align?: string }} */
+    const data = { text: element.innerHTML.trim() }
+    if (element.style.textAlign) data.align = element.style.textAlign
+    return data
+  }
+
+  /**
+   * Check if the paragraph content is empty.
+   * @param {HTMLElement} element
+   * @returns {boolean}
+   */
+  isEmpty(element) {
+    return (element.textContent?.trim().length ?? 0) === 0
+  }
+
+}

package/dist/plugins/paragraph/locale/en.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    'plugin.paragraph.title': string;
+    'plugin.paragraph.placeholder': string;
+};
+export default _default;

package/dist/plugins/paragraph/locale/en.js

@@ -0,0 +1,4 @@
+export default {
+  'plugin.paragraph.title': 'Text',
+  'plugin.paragraph.placeholder': 'Type something...',
+}

package/dist/plugins/paragraph/locale/keys.d.ts

@@ -0,0 +1,5 @@
+import enLocale from './en.js'
+
+declare module '../../../core/types.js' {
+  interface I18nMessages extends Record<keyof typeof enLocale, string> {}
+}

package/dist/plugins/paragraph/locale/ru.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    'plugin.paragraph.title': string;
+    'plugin.paragraph.placeholder': string;
+};
+export default _default;

package/dist/plugins/paragraph/locale/ru.js

@@ -0,0 +1,4 @@
+export default {
+  'plugin.paragraph.title': 'Текст',
+  'plugin.paragraph.placeholder': 'Начните писать...',
+}

package/dist/plugins/paragraph/mapTextFields.d.ts

@@ -0,0 +1 @@
+export { mapParagraphTextFields as mapTextFields } from "../../shared/mapTextFields.js";

package/dist/plugins/paragraph/mapTextFields.js

@@ -0,0 +1 @@
+export { mapParagraphTextFields as mapTextFields } from '../../shared/mapTextFields.js'

package/dist/plugins/paragraph/paragraph.css

@@ -0,0 +1,56 @@
+.oe-paragraph {
+  margin: 0;
+  padding: 0;
+  font-size: var(--oe-font-size, 15px);
+  line-height: var(--oe-line-height, 1.7);
+  color: var(--oe-text-1, #f5f5f5);
+  font-family: var(--oe-font, inherit);
+  outline: none;
+  word-break: break-word;
+  white-space: pre-wrap;
+}
+
+/* Placeholder — only when it's the sole empty block in the editor */
+.oe-blocks > :first-child:last-child .oe-paragraph:empty::before {
+  content: attr(data-placeholder);
+  color: var(--oe-text-3, #908c8c);
+  pointer-events: none;
+  font-weight: 400;
+}
+
+/* Inline formatting inside paragraphs */
+.oe-paragraph b,
+.oe-paragraph strong {
+  font-weight: 600;
+  color: var(--oe-text-1, #f5f5f5);
+}
+
+.oe-paragraph i,
+.oe-paragraph em {
+  font-style: italic;
+}
+
+.oe-paragraph a {
+  color: var(--oe-text-2, #c4c4c4);
+  text-decoration: underline;
+  text-underline-offset: 3px;
+  transition: color 0.15s;
+}
+
+.oe-paragraph a:hover {
+  color: var(--oe-text-1, #f5f5f5);
+}
+
+
+.oe-paragraph mark {
+  padding: 1px 4px;
+  background: var(--oe-mark-bg, rgba(245, 166, 35, 0.2));
+  border-radius: 3px;
+  color: var(--oe-text-1, #f5f5f5);
+}
+
+.oe-paragraph s,
+.oe-paragraph strike {
+  text-decoration: line-through;
+  color: var(--oe-text-2, #c4c4c4);
+}

package/dist/plugins/person/README.md

@@ -0,0 +1,72 @@
+# Person block plugin
+
+One or more profile cards with cropped avatars, biography, role, and social links.
+
+## Install and register
+
+```bash
+npm install @shelamkoff/rector @shelamkoff/cropper
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Person } from '@shelamkoff/rector/plugins/person'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Person()],
+})
+```
+
+The registered block type is `person`. The class is also exported by the complete `@shelamkoff/rector/plugins` preset and can be loaded through `@shelamkoff/rector/plugins/async`.
+
+## Data
+
+```json
+{
+  "persons": [{
+    "avatar": "https://cdn.example/ada.jpg",
+    "name": "Ada",
+    "role": "Author",
+    "bio": "",
+    "links": [{ "type": "website", "url": "https://example.com" }]
+  }]
+}
+```
+
+### Field reference
+
+| Field | Required | Meaning and constraints |
+| --- | --- | --- |
+| `persons` | yes | Non-empty array of profile cards. The saved order is the display order. |
+| `persons[].avatar` | yes | Empty string or canonical media URL. Cropping and uploading replace this value. |
+| `persons[].name` | yes | Profile name string. A profile with both an empty name and empty avatar is treated as empty by the editor. |
+| `persons[].role`, `persons[].bio` | yes | Role and biography strings; empty values are allowed. |
+| `persons[].links` | yes | Array of social links; it may be empty. Every item needs a string `type` and a canonical link-policy `url`. |
+
+All fields are present in normalized saved data even when their values are empty. Unknown application fields are not part of the contract and should be stored outside the block.
+
+The active profile tab is view state, not document data: `save()` persists all profiles in their current order but does not persist which tab was open. Tab switching therefore remains available in read-only mode so a reader can inspect every profile; it does not create a history entry. Adding, removing, reordering, or editing profiles is disabled in read-only mode.
+
+Callback avatar URLs must pass the shared media URL policy. The editor plugin requires `@shelamkoff/cropper`. The multi-card renderer requires `@shelamkoff/carousel`.
+
+## Configuration
+
+Every built-in block plugin accepts two style ownership options: `injectStyles?: boolean` defaults to `true`; set it to `false` when the host bundles that plugin's CSS. `css?: string` adds one host-provided stylesheet URL after the plugin default, or acts as the replacement URL when default injection is disabled.
+
+`uploadFile?: (file: File, context: { signal: AbortSignal }) => Promise<{ url: string }>` uploads the cropped avatar as `avatar.webp` and must stop work when the supplied signal is aborted. Without it, the cropped avatar is embedded in `persons[].avatar` as a data URL, which increases document size. `socialResolvers?: Array<{ test: RegExp | ((url: string) => boolean); type: string; icon?: string }>` extends social-link icon resolution.
+
+## Capabilities
+
+Multiple profiles; tab reordering; avatar crop/upload; social links; read-only profile navigation; deterministic dialog cleanup.
+
+## Undo, lifecycle, and styles
+
+User actions exposed by the plugin enter the command pipeline through the supplied `context.mutate()` capability, so each completed action is one undo/redo step. The editor reference-counts the plugin's declared stylesheet URLs. Removing a block calls its cleanup hook; removing the editor calls `destroy()` for every remaining block and then releases shared plugin resources.
+
+Do not remove the editor holder without first calling `editor.destroy()`.
+
+## Document output
+
+Use the matching renderer from `@shelamkoff/rector/renderer/renderers/person`. The VitePress guide documents configuration, commands and history, extension contracts, document migrations, styling, security, and lifecycle in a sequential form.

package/dist/plugins/person/README.ru.md

@@ -0,0 +1,73 @@
+# Блочный плагин Person
+
+Одна или несколько карточек профиля с обрезанным аватаром, биографией, ролью и ссылками.
+
+## Установка и регистрация
+
+```bash
+npm install @shelamkoff/rector @shelamkoff/cropper
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Person } from '@shelamkoff/rector/plugins/person'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Person()],
+})
+```
+
+Тип блока — `person`. Класс также экспортируется общей точкой входа `@shelamkoff/rector/plugins` и может загружаться по типу документа через `@shelamkoff/rector/plugins/async`.
+
+## Данные
+
+```json
+{
+  "persons": [{
+    "avatar": "https://cdn.example/ada.jpg",
+    "name": "Ada",
+    "role": "Автор",
+    "bio": "",
+    "links": [{ "type": "website", "url": "https://example.com" }]
+  }]
+}
+```
+
+### Поля данных
+
+| Поле | Обязательное | Назначение и ограничения |
+| --- | --- | --- |
+| `persons` | да | Непустой массив карточек. Порядок сохранения определяет порядок отображения. |
+| `persons[].avatar` | да | Пустая строка или канонический адрес медиафайла. Обрезка и загрузка заменяют это значение. |
+| `persons[].name` | да | Строка с именем. Профиль с пустыми именем и аватаром редактор считает пустым. |
+| `persons[].role`, `persons[].bio` | да | Строки с ролью и биографией; пустые значения допустимы. |
+| `persons[].links` | да | Массив социальных ссылок, который может быть пустым. Каждому элементу нужны строковый `type` и канонический `url`, разрешённый политикой ссылок. |
+
+После нормализации все поля присутствуют в сохранённых данных, даже если их значения пусты. Произвольные поля приложения не входят в контракт и должны храниться вне блока.
+
+Открытая вкладка профиля относится к состоянию интерфейса, а не к данным документа: `save()` сохраняет все профили и их порядок, но не номер открытой вкладки. Поэтому переключение вкладок доступно и в режиме просмотра — читатель может открыть любой профиль, а история документа при этом не меняется. Добавление, удаление, сортировка и редактирование профилей в режиме просмотра отключены.
+
+Для обработки аватара нужен `@shelamkoff/cropper`, а для нескольких карточек в рендерере — `@shelamkoff/carousel`.
+
+## Конфигурация
+
+Каждый встроенный блочный плагин принимает два параметра владения стилями: `injectStyles?: boolean` по умолчанию равен `true`; укажите `false`, если приложение само включает CSS этого плагина. `css?: string` добавляет URL таблицы стилей приложения после стандартной, а при отключённой стандартной инъекции служит URL замены.
+
+`uploadFile(file, { signal })` загружает `avatar.webp` и должен учитывать переданный `AbortSignal`. Возвращённый URL проходит общую политику адресов медиафайлов. Без этого обработчика обрезанный аватар встраивается в `persons[].avatar` как URL со встроенными данными и увеличивает размер документа. `socialResolvers` расширяет определение типа и значка ссылки.
+
+
+## Возможности
+
+Несколько профилей; сортировка вкладок; обрезка и загрузка аватара; ссылки; навигация по профилям в режиме просмотра; детерминированное освобождение ресурсов диалога.
+
+## История, жизненный цикл и стили
+
+Действия плагина входят в конвейер команд через предоставленный контекст `mutate()`, поэтому одно завершённое действие создаёт один шаг отмены и повтора. Редактор подсчитывает владельцев объявленных URL стилей. Удаление блока вызывает его метод освобождения ресурсов; `editor.destroy()` освобождает оставшиеся блоки и общие ресурсы.
+
+Не удаляйте контейнер редактора до вызова `editor.destroy()`.
+
+## Вывод документа
+
+Используйте фабричную функцию из `@shelamkoff/rector/renderer/renderers/person`. Последовательное руководство VitePress описывает проверку данных, миграции, разработку расширений, диагностику, безопасность и стили.