@shelamkoff/rector 1.0.0

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

@@ -0,0 +1,20 @@
+declare const _default: {
+    'plugin.embed.title': string;
+    'plugin.embed.url': string;
+    'plugin.embed.urlPrompt': string;
+    'plugin.embed.hint': string;
+    'plugin.embed.caption': string;
+    'plugin.embed.delete': string;
+    'plugin.embed.replace': string;
+    'plugin.embed.settings': string;
+    'plugin.embed.videoTitle': string;
+    'plugin.embed.duration': string;
+    'plugin.embed.cover': string;
+    'plugin.embed.uploadCover': string;
+    'plugin.embed.removeCover': string;
+    'plugin.embed.back': string;
+    'plugin.embed.coverUrlPrompt': string;
+    'plugin.embed.play': string;
+    'plugin.embed.videoLabel': string;
+};
+export default _default;

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

@@ -0,0 +1,19 @@
+export default {
+  'plugin.embed.title': 'Video',
+  'plugin.embed.url': 'URL',
+  'plugin.embed.urlPrompt': 'Video URL (YouTube or Vimeo):',
+  'plugin.embed.hint': 'Paste a YouTube or Vimeo link',
+  'plugin.embed.caption': 'Caption',
+  'plugin.embed.delete': 'Delete',
+  'plugin.embed.replace': 'Replace',
+  'plugin.embed.settings': 'Settings',
+  'plugin.embed.videoTitle': 'Title',
+  'plugin.embed.duration': 'Duration',
+  'plugin.embed.cover': 'Cover',
+  'plugin.embed.uploadCover': 'Upload',
+  'plugin.embed.removeCover': 'Remove',
+  'plugin.embed.back': 'Back',
+  'plugin.embed.coverUrlPrompt': 'Cover image URL:',
+  'plugin.embed.play': 'Play video',
+  'plugin.embed.videoLabel': 'Video',
+}

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

@@ -0,0 +1,20 @@
+declare const _default: {
+    'plugin.embed.title': string;
+    'plugin.embed.url': string;
+    'plugin.embed.urlPrompt': string;
+    'plugin.embed.hint': string;
+    'plugin.embed.caption': string;
+    'plugin.embed.delete': string;
+    'plugin.embed.replace': string;
+    'plugin.embed.settings': string;
+    'plugin.embed.videoTitle': string;
+    'plugin.embed.duration': string;
+    'plugin.embed.cover': string;
+    'plugin.embed.uploadCover': string;
+    'plugin.embed.removeCover': string;
+    'plugin.embed.back': string;
+    'plugin.embed.coverUrlPrompt': string;
+    'plugin.embed.play': string;
+    'plugin.embed.videoLabel': string;
+};
+export default _default;

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

@@ -0,0 +1,19 @@
+export default {
+  'plugin.embed.title': 'Видео',
+  'plugin.embed.url': 'URL',
+  'plugin.embed.urlPrompt': 'Ссылка на видео (YouTube или Vimeo):',
+  'plugin.embed.hint': 'Вставьте ссылку на YouTube или Vimeo',
+  'plugin.embed.caption': 'Подпись',
+  'plugin.embed.delete': 'Удалить',
+  'plugin.embed.replace': 'Заменить',
+  'plugin.embed.settings': 'Настройки',
+  'plugin.embed.videoTitle': 'Заголовок',
+  'plugin.embed.duration': 'Длительность',
+  'plugin.embed.cover': 'Обложка',
+  'plugin.embed.uploadCover': 'Загрузить',
+  'plugin.embed.removeCover': 'Убрать',
+  'plugin.embed.back': 'Назад',
+  'plugin.embed.coverUrlPrompt': 'URL изображения обложки:',
+  'plugin.embed.play': 'Воспроизвести видео',
+  'plugin.embed.videoLabel': 'Видео',
+}

package/dist/plugins/embed/player.d.ts

@@ -0,0 +1 @@
+export { SERVICES, buildPlayer } from "../../shared/embedPlayer.js";

package/dist/plugins/embed/player.js

@@ -0,0 +1 @@
+export { SERVICES, buildPlayer } from '../../shared/embedPlayer.js'

package/dist/plugins/gallery/README.md

@@ -0,0 +1,92 @@
+# Gallery block plugin
+
+Multi-image gallery with layouts, captions, appearance settings, reordering, and viewer options.
+
+## Install and register
+
+```bash
+npm install @shelamkoff/rector
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Gallery } from '@shelamkoff/rector/plugins/gallery'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Gallery()],
+})
+```
+
+The registered block type is `gallery`. The class is also exported by the complete `@shelamkoff/rector/plugins` preset and can be loaded through `@shelamkoff/rector/plugins/async`.
+
+## Data
+
+```json
+{
+  "images": [{ "url": "https://cdn.example/a.jpg", "caption": "A" }],
+  "layout": "auto",
+  "styles": { "gap": "8px", "borderRadius": "8px", "height": "420px" },
+  "options": { "loop": true, "zoom": true, "navigation": true, "captions": true, "thumbnails": true, "fullscreen": true, "autoplayInterval": 3000 }
+}
+```
+
+### Field reference
+
+| Field | Required | Meaning and constraints |
+| --- | --- | --- |
+| `images` | yes | Non-empty array. Every item requires a media-policy `url`; `caption` is an optional string. |
+| `layout` | yes | One of `auto`, `1`, `2`, `3a`, `3b`, `3c`, `4a`, `4b`, `4c`, `5a`, `5b`, `5c`, `6a`, `6b`, `6c`, `triptych`, `masonry`, `poly-5`, `poly-3arch`, `poly-5flat`, or `poly-3steps`. |
+| `styles` | no | String-valued map. The built-in settings UI uses `gap`, `borderRadius`, and `height`. |
+| `options.loop` | no | Wraps viewer navigation from the last image to the first. The new-block default is `true`. |
+| `options.zoom`, `navigation`, `captions`, `fullscreen` | no | Boolean viewer controls; new-block defaults are `true`. |
+| `options.thumbnails` | no | Shows viewer thumbnails; the new-block default is `false`. |
+| `options.autoplayInterval` | no | Positive finite interval in milliseconds. Omit it to disable autoplay. `0` is not valid persisted data. |
+
+Without `uploadFile`, local files become data URLs. Callback results are accepted only when `url` passes the shared media URL policy. The viewer requires `@shelamkoff/expose`.
+
+## 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; alt?: string }>` uploads each file. `actions?: Array<{ icon?; label; handler(context: { signal: AbortSignal }): Promise<Array<{ url: string; alt?: string }> | null> }>` adds application media sources. Both callbacks must stop work when the supplied signal is aborted.
+
+## Application file sources
+
+Use `uploadFile` for browser `File` objects and `actions` for existing assets selected from a media library, cloud drive, or another application-owned catalog. An action may return several images; the complete selection becomes one undo/redo step.
+
+```js
+const gallery = new Gallery({
+  actions: [{
+    label: 'Media library',
+    async handler({ signal }) {
+      const assets = await openMediaLibrary({
+        accept: ['image/*'],
+        multiple: true,
+        signal,
+      })
+      return assets?.map(asset => ({
+        url: asset.url,
+        alt: asset.alt,
+      })) ?? null
+    },
+  }],
+})
+```
+
+Return `null` when selection is cancelled. The optional `alt` value initializes the image caption. Multiple independent 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
+
+Multi-file upload; image-file paste with an async transaction; layout/style controls; drag reordering; custom media actions.
+
+## 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/gallery`. The VitePress guide documents configuration, commands and history, extension contracts, document migrations, styling, security, and lifecycle in a sequential form.

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

@@ -0,0 +1,93 @@
+# Блочный плагин Gallery
+
+Галерея изображений с макетами, подписями, настройками вида, сортировкой и параметрами просмотра.
+
+## Установка и регистрация
+
+```bash
+npm install @shelamkoff/rector
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Gallery } from '@shelamkoff/rector/plugins/gallery'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Gallery()],
+})
+```
+
+Тип блока — `gallery`. Класс также экспортируется общей точкой входа `@shelamkoff/rector/plugins` и может загружаться по типу документа через `@shelamkoff/rector/plugins/async`.
+
+## Данные
+
+```json
+{
+  "images": [{ "url": "https://cdn.example/a.jpg", "caption": "A" }],
+  "layout": "auto",
+  "styles": { "gap": "8px", "borderRadius": "8px", "height": "420px" },
+  "options": { "loop": true, "zoom": true, "navigation": true, "captions": true, "thumbnails": true, "fullscreen": true, "autoplayInterval": 3000 }
+}
+```
+
+### Поля данных
+
+| Поле | Обязательное | Назначение и ограничения |
+| --- | --- | --- |
+| `images` | да | Непустой массив. Каждому элементу нужен разрешённый политикой медиафайлов `url`; `caption` — необязательная строка. |
+| `layout` | да | Одно из значений `auto`, `1`, `2`, `3a`, `3b`, `3c`, `4a`, `4b`, `4c`, `5a`, `5b`, `5c`, `6a`, `6b`, `6c`, `triptych`, `masonry`, `poly-5`, `poly-3arch`, `poly-5flat` или `poly-3steps`. |
+| `styles` | нет | Карта строковых значений. Встроенная панель настроек использует `gap`, `borderRadius` и `height`. |
+| `options.loop` | нет | После последнего изображения переходит к первому; для нового блока по умолчанию `true`. |
+| `options.zoom`, `navigation`, `captions`, `fullscreen` | нет | Логические параметры просмотра; для нового блока по умолчанию `true`. |
+| `options.thumbnails` | нет | Показывает миниатюры; для нового блока по умолчанию `false`. |
+| `options.autoplayInterval` | нет | Положительный конечный интервал в миллисекундах. Отсутствие поля отключает автовоспроизведение. Значение `0` недопустимо в сохранённых данных. |
+
+Без `uploadFile` файлы сохраняются как URL со встроенными данными. Для полноэкранного просмотра нужен `@shelamkoff/expose`.
+
+## Конфигурация
+
+Каждый встроенный блочный плагин принимает два параметра владения стилями: `injectStyles?: boolean` по умолчанию равен `true`; укажите `false`, если приложение само включает CSS этого плагина. `css?: string` добавляет URL таблицы стилей приложения после стандартной, а при отключённой стандартной инъекции служит URL замены.
+
+`uploadFile(file, { signal })` загружает каждый файл. Обработчики в `actions` получают `{ signal }` и возвращают массив объектов `{ url, alt? }` или `null`. Все обработчики должны учитывать переданный `AbortSignal`.
+
+## Источники файлов приложения
+
+Используйте `uploadFile` для браузерных объектов `File`, а `actions` — для материалов из медиатеки, облачного диска или другого каталога приложения. Одно действие может вернуть несколько изображений; весь выбор становится одним шагом отмены и повтора.
+
+```js
+const gallery = new Gallery({
+  actions: [{
+    label: 'Медиатека',
+    async handler({ signal }) {
+      const assets = await openMediaLibrary({
+        accept: ['image/*'],
+        multiple: true,
+        signal,
+      })
+      return assets?.map(asset => ({
+        url: asset.url,
+        alt: asset.alt,
+      })) ?? null
+    },
+  }],
+})
+```
+
+При отмене выбора верните `null`. Необязательное поле `alt` заполняет подпись изображения. Для нескольких независимых источников добавьте несколько элементов в `actions`. Загрузка, отмена, проверка данных и общий адаптер описаны в разделе [«Источники файлов и медиатека»](https://shelamkoff.github.io/editor/ru/guide/file-sources).
+
+
+## Возможности
+
+Загрузка нескольких файлов; вставка с одной транзакцией истории; настройки макета и стилей; перетаскивание; пользовательские источники.
+
+## История, жизненный цикл и стили
+
+Действия плагина входят в конвейер команд через предоставленный контекст `mutate()`, поэтому одно завершённое действие создаёт один шаг отмены и повтора. Редактор подсчитывает владельцев объявленных URL стилей. Удаление блока вызывает его метод освобождения ресурсов; `editor.destroy()` освобождает оставшиеся блоки и общие ресурсы.
+
+Не удаляйте контейнер редактора до вызова `editor.destroy()`.
+
+## Вывод документа
+
+Используйте фабричную функцию из `@shelamkoff/rector/renderer/renderers/gallery`. Последовательное руководство VitePress описывает проверку данных, миграции, разработку расширений, диагностику, безопасность и стили.

package/dist/plugins/gallery/css.d.ts

@@ -0,0 +1,52 @@
+export namespace CSS {
+    export let wrapper: string;
+    export let loading: string;
+    export let filled: string;
+    export let select: string;
+    export let selectIcon: string;
+    export let selectText: string;
+    export let selectLink: string;
+    export let selectActions: string;
+    export let selectAction: string;
+    export let dropzoneActive: string;
+    export let actionsView: string;
+    export let actionChevron: string;
+    export let grid: string;
+    export let slot: string;
+    export let slotFilled: string;
+    export let slotEmpty: string;
+    export let slotOver: string;
+    export let slotDragging: string;
+    export let slotImg: string;
+    export let slotRemove: string;
+    export let slotCaption: string;
+    export let slotPlaceholder: string;
+    export let overflow: string;
+    export let overflowOver: string;
+    export let overflowItem: string;
+    export let overflowItemOver: string;
+    export let itemDragging: string;
+    export let addCell: string;
+    export let actions: string;
+    export let actionBtn: string;
+    export let actionBtnDanger: string;
+    export let actionBtnActive: string;
+    export let actionsSep: string;
+    export let dropdown: string;
+    export let dropdownOpen: string;
+    export let dropdownPanel: string;
+    export let layoutGrid: string;
+    export let layoutBtn: string;
+    export let layoutBtnActive: string;
+    export let styleForm: string;
+    export let styleGroup: string;
+    export let styleGroupTitle: string;
+    export let styleRow: string;
+    export let styleLabel: string;
+    export let styleInput: string;
+    export let switchRow: string;
+    export let switchLabel: string;
+    let _switch: string;
+    export { _switch as switch };
+    export let switchActive: string;
+}

package/dist/plugins/gallery/css.js

@@ -0,0 +1,67 @@
+/** CSS class names for the Gallery plugin DOM. */
+export const CSS = {
+  wrapper: 'oe-gallery',
+  loading: 'oe-gallery--loading',
+  filled: 'oe-gallery--filled',
+
+  // Empty state (dropzone)
+  select: 'oe-gallery__select',
+  selectIcon: 'oe-gallery__select-icon',
+  selectText: 'oe-gallery__select-text',
+  selectLink: 'oe-gallery__select-link',
+  selectActions: 'oe-gallery__select-actions',
+  selectAction: 'oe-gallery__select-action',
+  dropzoneActive: 'oe-gallery__select--dragover',
+  actionsView: 'oe-gallery__actions-view',
+  actionChevron: 'oe-gallery__action-chevron',
+
+  // Template grid
+  grid: 'oe-gallery__grid',
+
+  // Slot (cell in the template grid)
+  slot: 'oe-gallery__slot',
+  slotFilled: 'oe-gallery__slot--filled',
+  slotEmpty: 'oe-gallery__slot--empty',
+  slotOver: 'oe-gallery__slot--over',
+  slotDragging: 'oe-gallery__slot--dragging',
+  slotImg: 'oe-gallery__slot-img',
+  slotRemove: 'oe-gallery__slot-remove',
+  slotCaption: 'oe-gallery__slot-caption',
+  slotPlaceholder: 'oe-gallery__slot-placeholder',
+
+  // Overflow row (extra images beyond template slots)
+  overflow: 'oe-gallery__overflow',
+  overflowOver: 'oe-gallery__overflow--over',
+  overflowItem: 'oe-gallery__overflow-item',
+  overflowItemOver: 'oe-gallery__overflow-item--over',
+  itemDragging: 'oe-gallery__item--dragging',
+
+  addCell: 'oe-gallery__add-cell',
+
+  // Action bar
+  actions: 'oe-gallery__actions',
+  actionBtn: 'oe-gallery__action-btn',
+  actionBtnDanger: 'oe-gallery__action-btn--danger',
+  actionBtnActive: 'oe-gallery__action-btn--active',
+  actionsSep: 'oe-gallery__actions-sep',
+
+  // Layout selector dropdown
+  dropdown: 'oe-gallery__dropdown',
+  dropdownOpen: 'oe-gallery__dropdown--open',
+  dropdownPanel: 'oe-gallery__dropdown-panel',
+  layoutGrid: 'oe-gallery__layout-grid',
+  layoutBtn: 'oe-gallery__layout-btn',
+  layoutBtnActive: 'oe-gallery__layout-btn--active',
+
+  // Settings form
+  styleForm: 'oe-gallery__style-form',
+  styleGroup: 'oe-gallery__style-group',
+  styleGroupTitle: 'oe-gallery__style-group-title',
+  styleRow: 'oe-gallery__style-row',
+  styleLabel: 'oe-gallery__style-label',
+  styleInput: 'oe-gallery__style-input',
+  switchRow: 'oe-gallery__switch-row',
+  switchLabel: 'oe-gallery__switch-label',
+  switch: 'oe-gallery__switch',
+  switchActive: 'oe-gallery__switch--active',
+}