@shelamkoff/rector 1.0.0

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

@@ -0,0 +1,49 @@
+# Блочный плагин Delimiter
+
+Визуальный разделитель без содержимого.
+
+## Установка и регистрация
+
+```bash
+npm install @shelamkoff/rector
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Delimiter } from '@shelamkoff/rector/plugins/delimiter'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Delimiter()],
+})
+```
+
+Тип блока — `delimiter`. Класс также экспортируется общей точкой входа `@shelamkoff/rector/plugins` и может загружаться по типу документа через `@shelamkoff/rector/plugins/async`.
+
+## Данные
+
+```json
+{}
+```
+
+Блок принимает объект `data` и сериализует его как `{}`. Настраиваемых полей данных нет; значения, не являющиеся объектом, не проходят проверку.
+
+## Конфигурация
+
+Каждый встроенный блочный плагин принимает два параметра владения стилями: `injectStyles?: boolean` по умолчанию равен `true`; укажите `false`, если приложение само включает CSS этого плагина. `css?: string` добавляет URL таблицы стилей приложения после стандартной, а при отключённой стандартной инъекции служит URL замены.
+
+
+## Возможности
+
+Вставка через меню добавления и отображение документа.
+
+## История, жизненный цикл и стили
+
+Действия плагина входят в конвейер команд через предоставленный контекст `mutate()`, поэтому одно завершённое действие создаёт один шаг отмены и повтора. Редактор подсчитывает владельцев объявленных URL стилей. Удаление блока вызывает его метод освобождения ресурсов; `editor.destroy()` освобождает оставшиеся блоки и общие ресурсы.
+
+Не удаляйте контейнер редактора до вызова `editor.destroy()`.
+
+## Вывод документа
+
+Используйте фабричную функцию из `@shelamkoff/rector/renderer/renderers/delimiter`. Последовательное руководство VitePress описывает проверку данных, миграции, разработку расширений, диагностику, безопасность и стили.

package/dist/plugins/delimiter/delimiter.css

@@ -0,0 +1,22 @@
+/* =============================================================================
+   Delimiter plugin — edit mode styles
+   ============================================================================= */
+
+.oe-delimiter {
+  margin: 0;
+  border: none;
+  text-align: center;
+  outline: none;
+  cursor: default;
+}
+
+.oe-delimiter::after {
+  content: '***';
+  font-size: 1.8rem;
+  letter-spacing: 0.24em;
+  color: var(--oe-text-2, #666);
+}
+
+.oe-block--focused .oe-delimiter::after {
+  color: var(--oe-text-1, #999);
+}

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

@@ -0,0 +1,38 @@
+import type {} from './locale/keys.js'
+/** Visual section separator that stores no user data. */
+export class Delimiter extends BlockPluginAbstract<Record<string, any>> {
+    static isTextBlock: boolean;
+    static styles: string[];
+    constructor(config?: Record<string, any>);
+    type: string;
+    icon: string;
+    inlineTools: boolean;
+    /**
+     * Return the localized toolbox label for this block.
+     * @returns {string}
+     */
+    get title(): string;
+    /**
+     * Create the editable DOM owned by this block instance.
+     * @returns {HTMLElement}
+     */
+    render(): HTMLElement;
+    /**
+     * Serialize the current block DOM into document data.
+     * @returns {{}}
+     */
+    save(): {};
+    /**
+     * Check whether serialized data satisfies this block's schema.
+     * @param {Record<string, unknown>} data
+     * @returns {boolean}
+     */
+    validate(data: Record<string, unknown>): boolean;
+    /**
+     * Check whether the block has no meaningful user content.
+     * @param {HTMLElement} _element
+     * @returns {boolean}
+     */
+    isEmpty(_element: HTMLElement): boolean;
+}
+import { BlockPluginAbstract } from '../BlockPluginAbstract.js';

package/dist/plugins/delimiter/index.js

@@ -0,0 +1,69 @@
+// =============================================================================
+// Delimiter — horizontal rule / section break
+// =============================================================================
+
+import { resolvePath } from '../../shared/resolvePath.js'
+import { BlockPluginAbstract } from '../BlockPluginAbstract.js'
+import { validateDelimiterData } from '../../shared/blockDataValidators.js'
+
+const editorStyles = resolvePath('./delimiter.css', import.meta.url)
+
+// Tabler icon: separator-horizontal (three dots)
+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="M5 12h2"/><path d="M17 12h2"/><path d="M11 12h2"/></svg>'
+
+/** Visual section separator that stores no user data. */
+export class Delimiter extends BlockPluginAbstract {
+  static isTextBlock = false
+  static styles = [editorStyles]
+  type = 'delimiter'
+  icon = ICON
+  inlineTools = false
+
+  /**
+   * Return the localized toolbox label for this block.
+   * @returns {string}
+   */
+  get title() {
+    return this._t('title', 'Delimiter')
+  }
+
+  /**
+   * Create the editable DOM owned by this block instance.
+   * @returns {HTMLElement}
+   */
+  render() {
+    const hr = document.createElement('hr')
+    hr.classList.add('oe-delimiter')
+    hr.contentEditable = 'false'
+    hr.tabIndex = -1
+    return hr
+  }
+
+  /**
+   * Serialize the current block DOM into document data.
+   * @returns {{}}
+   */
+  save() {
+    return {}
+  }
+
+  /**
+   * Check whether serialized data satisfies this block's schema.
+   * @param {Record<string, unknown>} data
+   * @returns {boolean}
+   */
+  validate(data) {
+    return validateDelimiterData(data)
+  }
+
+  /**
+   * Check whether the block has no meaningful user content.
+   * @param {HTMLElement} _element
+   * @returns {boolean}
+   */
+  isEmpty(_element) {
+    // Delimiter is never empty — it's always valid
+    return false
+  }
+
+}

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

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

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

@@ -0,0 +1,3 @@
+export default {
+  'plugin.delimiter.title': 'Delimiter',
+}

package/dist/plugins/delimiter/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/delimiter/locale/ru.d.ts

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

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

@@ -0,0 +1,3 @@
+export default {
+  'plugin.delimiter.title': 'Разделитель',
+}

package/dist/plugins/embed/README.md

@@ -0,0 +1,81 @@
+# Embed block plugin
+
+YouTube and Vimeo embed block with caption, cover image, and preview metadata.
+
+## Install and register
+
+```bash
+npm install @shelamkoff/rector
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Embed } from '@shelamkoff/rector/plugins/embed'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Embed()],
+})
+```
+
+The registered block type is `embed`. The class is also exported by the complete `@shelamkoff/rector/plugins` preset and can be loaded through `@shelamkoff/rector/plugins/async`.
+
+## Data
+
+```json
+{ "service": "youtube", "videoId": "dQw4w9WgXcQ", "caption": "Caption", "cover": "", "title": "", "duration": "" }
+```
+
+### Field reference
+
+| Field | Required | Meaning and constraints |
+| --- | --- | --- |
+| `service` | yes | `youtube` or `vimeo`. |
+| `videoId` | yes | Eleven-character YouTube id or numeric Vimeo id, according to `service`. |
+| `caption`, `title`, `duration` | no | Display strings; normalized saved data uses empty strings when absent. |
+| `cover` | no | Empty string or canonical media-policy URL. It may come from preview resolution, upload, or an application action. |
+
+Upload, action, and preview callbacks receive an `AbortSignal` and must stop work when it is aborted. The preview request is `{ service: "vimeo", videoId, url, signal }`. Only supported provider URLs and media URLs accepted by the shared policy are used.
+
+## 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 }>` persists a cover. Without it, a selected cover uses a temporary object URL that stops working after editor disposal or page reload. `actions?: Array<{ icon?; label; handler(context: { signal: AbortSignal }): Promise<{ url: string } | null> }>` adds application cover sources. `resolvePreview?: false | (request) => Promise<{ thumbnailUrl: string; title?: string } | null>` overrides Vimeo preview resolution; `false` disables it. When `resolvePreview` is omitted, the plugin requests Vimeo oEmbed directly from the browser; YouTube does not use this callback. `previewTimeoutMs?: number` defaults to `5000`; finite values are clamped to zero and non-finite values use the default.
+
+## Application cover sources
+
+`uploadFile` and `actions` apply to the video cover only; the video itself is selected with a supported YouTube or Vimeo URL. Use an action to add a media library, cloud drive, or another application-owned image source.
+
+```js
+const embed = new Embed({
+  actions: [{
+    label: 'Media library',
+    async handler({ signal }) {
+      const asset = await openMediaLibrary({
+        accept: ['image/*'],
+        multiple: false,
+        signal,
+      })
+      return asset ? { url: asset.url } : null
+    },
+  }],
+})
+```
+
+Return `null` when selection is cancelled. A valid result replaces the cover in one undo/redo step. Multiple independent cover sources may be added as separate `actions` entries. See [File sources and media libraries](https://shelamkoff.github.io/editor/guide/file-sources) for upload, cancellation, validation, and reusable adapter guidance.
+
+## Capabilities
+
+YouTube/Vimeo URL paste; cover upload; cancellable preview resolution; settings and 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/embed`. The VitePress guide documents configuration, commands and history, extension contracts, document migrations, styling, security, and lifecycle in a sequential form.

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

@@ -0,0 +1,82 @@
+# Блочный плагин Embed
+
+Видео YouTube или Vimeo с подписью, обложкой и сведениями предварительного просмотра.
+
+## Установка и регистрация
+
+```bash
+npm install @shelamkoff/rector
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Embed } from '@shelamkoff/rector/plugins/embed'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Embed()],
+})
+```
+
+Тип блока — `embed`. Класс также экспортируется общей точкой входа `@shelamkoff/rector/plugins` и может загружаться по типу документа через `@shelamkoff/rector/plugins/async`.
+
+## Данные
+
+```json
+{ "service": "youtube", "videoId": "dQw4w9WgXcQ", "caption": "Подпись", "cover": "", "title": "", "duration": "" }
+```
+
+### Поля данных
+
+| Поле | Обязательное | Назначение и ограничения |
+| --- | --- | --- |
+| `service` | да | `youtube` или `vimeo`. |
+| `videoId` | да | Идентификатор YouTube из одиннадцати символов или числовой идентификатор Vimeo в зависимости от `service`. |
+| `caption`, `title`, `duration` | нет | Отображаемые строки; при отсутствии нормализованные данные используют пустые строки. |
+| `cover` | нет | Пустая строка или канонический адрес, разрешённый политикой медиафайлов. Обложка может поступить из предварительного просмотра, загрузки или действия приложения. |
+
+Обратный вызов предварительного просмотра получает `{ service, videoId, url, signal }`; учитывайте `AbortSignal`. Преобразуются только URL поддерживаемых служб.
+
+## Конфигурация
+
+Каждый встроенный блочный плагин принимает два параметра владения стилями: `injectStyles?: boolean` по умолчанию равен `true`; укажите `false`, если приложение само включает CSS этого плагина. `css?: string` добавляет URL таблицы стилей приложения после стандартной, а при отключённой стандартной инъекции служит URL замены.
+
+`uploadFile(file, { signal })` сохраняет обложку в постоянном хранилище. Без него выбранная обложка использует временный объектный URL и перестаёт работать после освобождения редактора или перезагрузки страницы. Обработчики в `actions` получают `{ signal }`. `resolvePreview` заменяет получение данных Vimeo; `false` отключает его. Если `resolvePreview` не передан, плагин запрашивает Vimeo `oEmbed` непосредственно из браузера; для YouTube этот обработчик не используется. `previewTimeoutMs` по умолчанию равен `5000`: конечное значение ограничивается снизу нулём, неконечное заменяется значением по умолчанию. Все обработчики должны учитывать переданный `AbortSignal`.
+
+## Источники обложки приложения
+
+Параметры `uploadFile` и `actions` относятся только к обложке видео; само видео выбирается по поддерживаемому адресу YouTube или Vimeo. Через `actions` можно добавить медиатеку, облачный диск или другой источник изображений приложения.
+
+```js
+const embed = new Embed({
+  actions: [{
+    label: 'Медиатека',
+    async handler({ signal }) {
+      const asset = await openMediaLibrary({
+        accept: ['image/*'],
+        multiple: false,
+        signal,
+      })
+      return asset ? { url: asset.url } : null
+    },
+  }],
+})
+```
+
+При отмене выбора верните `null`. Корректный результат заменяет обложку одним шагом отмены и повтора. Для нескольких независимых источников добавьте несколько элементов в `actions`. Загрузка, отмена, проверка данных и общий адаптер описаны в разделе [«Источники файлов и медиатека»](https://shelamkoff.github.io/editor/ru/guide/file-sources).
+
+
+## Возможности
+
+Вставка URL YouTube и Vimeo; загрузка обложки; отменяемый запрос предварительного просмотра; настройки; освобождение ресурсов.
+
+## История, жизненный цикл и стили
+
+Действия плагина входят в конвейер команд через предоставленный контекст `mutate()`, поэтому одно завершённое действие создаёт один шаг отмены и повтора. Редактор подсчитывает владельцев объявленных URL стилей. Удаление блока вызывает его метод освобождения ресурсов; `editor.destroy()` освобождает оставшиеся блоки и общие ресурсы.
+
+Не удаляйте контейнер редактора до вызова `editor.destroy()`.
+
+## Вывод документа
+
+Используйте фабричную функцию из `@shelamkoff/rector/renderer/renderers/embed`. Последовательное руководство VitePress описывает проверку данных, миграции, разработку расширений, диагностику, безопасность и стили.