@shelamkoff/rector 1.0.0

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

@@ -0,0 +1,41 @@
+declare const _default: {
+    'plugin.carousel.title': string;
+    'plugin.carousel.addMedia': string;
+    'plugin.carousel.addUrl': string;
+    'plugin.carousel.addHtml': string;
+    'plugin.carousel.add': string;
+    'plugin.carousel.upload': string;
+    'plugin.carousel.back': string;
+    'plugin.carousel.dropzoneText': string;
+    'plugin.carousel.empty': string;
+    'plugin.carousel.emptyReadonly': string;
+    'plugin.carousel.html': string;
+    'plugin.carousel.source': string;
+    'plugin.carousel.alt': string;
+    'plugin.carousel.poster': string;
+    'plugin.carousel.caption': string;
+    'plugin.carousel.previous': string;
+    'plugin.carousel.next': string;
+    'plugin.carousel.goToSlide': string;
+    'plugin.carousel.movePrevious': string;
+    'plugin.carousel.moveNext': string;
+    'plugin.carousel.movePreviousShort': string;
+    'plugin.carousel.moveNextShort': string;
+    'plugin.carousel.remove': string;
+    'plugin.carousel.removeSlide': string;
+    'plugin.carousel.deleteAll': string;
+    'plugin.carousel.video': string;
+    'plugin.carousel.settings': string;
+    'plugin.carousel.currentSlide': string;
+    'plugin.carousel.behavior': string;
+    'plugin.carousel.loop': string;
+    'plugin.carousel.autoplay': string;
+    'plugin.carousel.navigation': string;
+    'plugin.carousel.pagination': string;
+    'plugin.carousel.thumbnails': string;
+    'plugin.carousel.autoplayDelay': string;
+    'plugin.carousel.aspectRatio': string;
+    'plugin.carousel.sourcePrompt': string;
+    'plugin.carousel.htmlPrompt': string;
+};
+export default _default;

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

@@ -0,0 +1,40 @@
+export default {
+  'plugin.carousel.title': 'Carousel',
+  'plugin.carousel.addMedia': 'Add media',
+  'plugin.carousel.addUrl': 'Add URL',
+  'plugin.carousel.addHtml': 'Add HTML',
+  'plugin.carousel.add': 'Add',
+  'plugin.carousel.upload': 'Upload',
+  'plugin.carousel.back': 'Back',
+  'plugin.carousel.dropzoneText': 'images or videos from your device or drag and drop them here',
+  'plugin.carousel.empty': 'Add the first slide',
+  'plugin.carousel.emptyReadonly': 'No slides',
+  'plugin.carousel.html': 'HTML',
+  'plugin.carousel.source': 'Source URL',
+  'plugin.carousel.alt': 'Alternative text',
+  'plugin.carousel.poster': 'Poster URL',
+  'plugin.carousel.caption': 'Caption',
+  'plugin.carousel.previous': 'Previous slide',
+  'plugin.carousel.next': 'Next slide',
+  'plugin.carousel.goToSlide': 'Go to slide {index}',
+  'plugin.carousel.movePrevious': 'Move slide backward',
+  'plugin.carousel.moveNext': 'Move slide forward',
+  'plugin.carousel.movePreviousShort': 'Earlier',
+  'plugin.carousel.moveNextShort': 'Later',
+  'plugin.carousel.remove': 'Remove',
+  'plugin.carousel.removeSlide': 'Remove slide',
+  'plugin.carousel.deleteAll': 'Remove all slides',
+  'plugin.carousel.video': 'Video slide',
+  'plugin.carousel.settings': 'Settings',
+  'plugin.carousel.currentSlide': 'Current slide',
+  'plugin.carousel.behavior': 'Behavior',
+  'plugin.carousel.loop': 'Loop',
+  'plugin.carousel.autoplay': 'Autoplay',
+  'plugin.carousel.navigation': 'Navigation',
+  'plugin.carousel.pagination': 'Pagination',
+  'plugin.carousel.thumbnails': 'Thumbnails',
+  'plugin.carousel.autoplayDelay': 'Autoplay delay, ms',
+  'plugin.carousel.aspectRatio': 'Aspect ratio',
+  'plugin.carousel.sourcePrompt': 'Media URL',
+  'plugin.carousel.htmlPrompt': 'Slide HTML',
+}

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

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

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

@@ -0,0 +1,41 @@
+declare const _default: {
+    'plugin.carousel.title': string;
+    'plugin.carousel.addMedia': string;
+    'plugin.carousel.addUrl': string;
+    'plugin.carousel.addHtml': string;
+    'plugin.carousel.add': string;
+    'plugin.carousel.upload': string;
+    'plugin.carousel.back': string;
+    'plugin.carousel.dropzoneText': string;
+    'plugin.carousel.empty': string;
+    'plugin.carousel.emptyReadonly': string;
+    'plugin.carousel.html': string;
+    'plugin.carousel.source': string;
+    'plugin.carousel.alt': string;
+    'plugin.carousel.poster': string;
+    'plugin.carousel.caption': string;
+    'plugin.carousel.previous': string;
+    'plugin.carousel.next': string;
+    'plugin.carousel.goToSlide': string;
+    'plugin.carousel.movePrevious': string;
+    'plugin.carousel.moveNext': string;
+    'plugin.carousel.movePreviousShort': string;
+    'plugin.carousel.moveNextShort': string;
+    'plugin.carousel.remove': string;
+    'plugin.carousel.removeSlide': string;
+    'plugin.carousel.deleteAll': string;
+    'plugin.carousel.video': string;
+    'plugin.carousel.settings': string;
+    'plugin.carousel.currentSlide': string;
+    'plugin.carousel.behavior': string;
+    'plugin.carousel.loop': string;
+    'plugin.carousel.autoplay': string;
+    'plugin.carousel.navigation': string;
+    'plugin.carousel.pagination': string;
+    'plugin.carousel.thumbnails': string;
+    'plugin.carousel.autoplayDelay': string;
+    'plugin.carousel.aspectRatio': string;
+    'plugin.carousel.sourcePrompt': string;
+    'plugin.carousel.htmlPrompt': string;
+};
+export default _default;

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

@@ -0,0 +1,40 @@
+export default {
+  'plugin.carousel.title': 'Карусель',
+  'plugin.carousel.addMedia': 'Добавить медиафайлы',
+  'plugin.carousel.addUrl': 'Добавить URL',
+  'plugin.carousel.addHtml': 'Добавить HTML',
+  'plugin.carousel.add': 'Добавить',
+  'plugin.carousel.upload': 'Загрузить',
+  'plugin.carousel.back': 'Назад',
+  'plugin.carousel.dropzoneText': 'изображения или видео с устройства либо перетащите их сюда',
+  'plugin.carousel.empty': 'Добавьте первый слайд',
+  'plugin.carousel.emptyReadonly': 'Слайдов нет',
+  'plugin.carousel.html': 'HTML',
+  'plugin.carousel.source': 'URL источника',
+  'plugin.carousel.alt': 'Альтернативный текст',
+  'plugin.carousel.poster': 'URL постера',
+  'plugin.carousel.caption': 'Подпись',
+  'plugin.carousel.previous': 'Предыдущий слайд',
+  'plugin.carousel.next': 'Следующий слайд',
+  'plugin.carousel.goToSlide': 'Перейти к слайду {index}',
+  'plugin.carousel.movePrevious': 'Переместить слайд назад',
+  'plugin.carousel.moveNext': 'Переместить слайд вперёд',
+  'plugin.carousel.movePreviousShort': 'Раньше',
+  'plugin.carousel.moveNextShort': 'Позже',
+  'plugin.carousel.remove': 'Удалить',
+  'plugin.carousel.removeSlide': 'Удалить слайд',
+  'plugin.carousel.deleteAll': 'Удалить все слайды',
+  'plugin.carousel.video': 'Видеослайд',
+  'plugin.carousel.settings': 'Настройки',
+  'plugin.carousel.currentSlide': 'Текущий слайд',
+  'plugin.carousel.behavior': 'Поведение',
+  'plugin.carousel.loop': 'Зациклить',
+  'plugin.carousel.autoplay': 'Автовоспроизведение',
+  'plugin.carousel.navigation': 'Навигация',
+  'plugin.carousel.pagination': 'Пагинация',
+  'plugin.carousel.thumbnails': 'Миниатюры',
+  'plugin.carousel.autoplayDelay': 'Задержка автовоспроизведения, мс',
+  'plugin.carousel.aspectRatio': 'Соотношение сторон',
+  'plugin.carousel.sourcePrompt': 'URL медиафайла',
+  'plugin.carousel.htmlPrompt': 'HTML слайда',
+}

package/dist/plugins/carousel/state.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Mutable state and listener ownership for one mounted Carousel block.
+ * A state instance belongs to one block render and must be disposed when that
+ * block is replaced or removed.
+ */
+export class CarouselState {
+    /**
+     * @param {Record<string, unknown>} data Serialized carousel data.
+     * @param {() => string} createId Factory for missing slide identifiers.
+     * @param {import('../../core/types.js').BlockMutationContext} context Editor mutation and lifecycle context.
+     */
+    constructor(data: Record<string, unknown>, createId: () => string, context: import("../../core/types.js").BlockMutationContext);
+    data: import("../../shared/carouselData.js").CarouselData;
+    context: import("../../types.js").BlockMutationContext;
+    activeIndex: number;
+    viewController: AbortController;
+    lifecycleController: AbortController;
+    pendingUpload: any;
+    /**
+     * Abort listeners for the previous view and return a signal for the next one.
+     * @returns {AbortSignal} Signal aborted by the next view reset or state disposal.
+     */
+    resetView(): AbortSignal;
+    /**
+     * Abort all work owned by this rendered block.
+     * @returns {void}
+     */
+    dispose(): void;
+}

package/dist/plugins/carousel/state.js

@@ -0,0 +1,42 @@
+import { normalizeCarouselData } from '../../shared/carouselData.js'
+
+/**
+ * Mutable state and listener ownership for one mounted Carousel block.
+ * A state instance belongs to one block render and must be disposed when that
+ * block is replaced or removed.
+ */
+export class CarouselState {
+  /**
+   * @param {Record<string, unknown>} data Serialized carousel data.
+   * @param {() => string} createId Factory for missing slide identifiers.
+   * @param {import('../../core/types').BlockMutationContext} context Editor mutation and lifecycle context.
+   */
+  constructor(data, createId, context) {
+    this.data = normalizeCarouselData(data, createId)
+    this.context = context
+    this.activeIndex = 0
+    this.viewController = new AbortController()
+    this.lifecycleController = new AbortController()
+    this.pendingUpload = null
+  }
+
+  /**
+   * Abort listeners for the previous view and return a signal for the next one.
+   * @returns {AbortSignal} Signal aborted by the next view reset or state disposal.
+   */
+  resetView() {
+    this.viewController.abort()
+    this.viewController = new AbortController()
+    this.activeIndex = Math.max(0, Math.min(this.activeIndex, this.data.slides.length - 1))
+    return this.viewController.signal
+  }
+
+  /**
+   * Abort all work owned by this rendered block.
+   * @returns {void}
+   */
+  dispose() {
+    this.viewController.abort()
+    this.lifecycleController.abort()
+  }
+}

package/dist/plugins/checklist/README.md

@@ -0,0 +1,54 @@
+# Checklist block plugin
+
+Checklist with independently checked rich-text items.
+
+## Install and register
+
+```bash
+npm install @shelamkoff/rector
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Checklist } from '@shelamkoff/rector/plugins/checklist'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Checklist()],
+})
+```
+
+The registered block type is `checklist`. The class is also exported by the complete `@shelamkoff/rector/plugins` preset and can be loaded through `@shelamkoff/rector/plugins/async`.
+
+## Data
+
+```json
+{ "items": [{ "text": "Ship", "checked": false }] }
+```
+
+### Field reference
+
+| Field | Required | Meaning and constraints |
+| --- | --- | --- |
+| `items` | yes | A non-empty array of objects. Each object requires string `text` and boolean `checked`. Text supports sanitized inline markup and inline widgets. |
+
+The document validator permits an empty `text` string, because an empty item is a valid editing state. Enter in an empty last item removes it and creates the default block after the checklist; Enter in the sole empty item converts the checklist itself. Each transition is one undoable action.
+
+## 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.
+
+## Capabilities
+
+Inline tools and widgets; item add/remove/toggle; 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/checklist`. The VitePress guide documents configuration, commands and history, extension contracts, document migrations, styling, security, and lifecycle in a sequential form.

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

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

package/dist/plugins/checklist/checklist.css

@@ -0,0 +1,80 @@
+/* =============================================================================
+   Checklist plugin — interactive checklist with checkable items
+   ============================================================================= */
+
+.oe-checklist {
+  padding: 0;
+  list-style: none;
+}
+
+.oe-checklist__item {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.5rem;
+  padding: 0.25rem 0;
+  transition: opacity 0.2s;
+}
+
+.oe-checklist__item--checked .oe-checklist__text {
+  text-decoration: line-through;
+  color: var(--oe-text-3, #6e6e78);
+}
+
+/* ── Checkbox ─────────────────────────────────────────────────────────────── */
+
+.oe-checklist__checkbox {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  width: 1.125rem;
+  height: 1.125rem;
+  margin-top: 0.1875rem;
+  border: 2px solid var(--oe-border-hover, #3a3a44);
+  border-radius: 4px;
+  background: transparent;
+  color: transparent;
+  cursor: pointer;
+  transition: background 0.15s, border-color 0.15s, color 0.15s;
+  padding: 0;
+  outline: none;
+}
+
+.oe-checklist__checkbox:hover {
+  border-color: var(--oe-accent, #4357b4);
+}
+
+.oe-checklist__item--checked .oe-checklist__checkbox {
+  background: var(--oe-accent, #4357b4);
+  border-color: var(--oe-accent, #4357b4);
+  color: var(--oe-text-on-accent, #fff);
+}
+
+.oe-checklist__checkbox svg {
+  width: 12px;
+  height: 12px;
+}
+
+/* ── Text ─────────────────────────────────────────────────────────────────── */
+
+.oe-checklist__text {
+  flex: 1;
+  min-width: 0;
+  outline: none;
+  line-height: 1.6;
+  word-break: break-word;
+}
+
+.oe-checklist__text:empty::before {
+  content: '';
+}
+
+/* ── Light theme ──────────────────────────────────────────────────────────── */
+
+.oe-theme-light .oe-checklist__checkbox {
+  border-color: var(--oe-border-hover, #d0d0d0);
+}
+
+.oe-theme-light .oe-checklist__checkbox:hover {
+  border-color: var(--oe-accent, #4357b4);
+}

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

@@ -0,0 +1,75 @@
+import type {} from './locale/keys.js'
+/** Editable checklist block with independently toggleable rich-text items. */
+export class Checklist extends BlockPluginAbstract<Record<string, any>> {
+    static isTextBlock: boolean;
+    static styles: string[];
+    constructor(config?: Record<string, any>);
+    type: string;
+    icon: string;
+    inlineTools: boolean;
+    mapTextFields: typeof mapTextFields;
+    /**
+     * Return the localized toolbox label for this block.
+     * @returns {string}
+     */
+    get title(): string;
+    /**
+     * Create the editable DOM owned by this block instance.
+     * @param {{ items?: Array<{ text: string, checked: boolean } | string>, text?: string }} data
+     * @param {import('../../core/types.js').BlockMutationContext} context
+     * @returns {HTMLElement}
+     */
+    render(data: {
+        items?: Array<{
+            text: string;
+            checked: boolean;
+        } | string>;
+        text?: string;
+    }, context: import("../../core/types.js").BlockMutationContext): HTMLElement;
+    /**
+     * Serialize the current block DOM into document data.
+     * @param {HTMLElement} element
+     * @returns {{ items: Array<{ text: string, checked: boolean }> }}
+     */
+    save(element: HTMLElement): {
+        items: Array<{
+            text: string;
+            checked: boolean;
+        }>;
+    };
+    /**
+     * Check whether serialized data satisfies this block's schema.
+     * @param {{ items?: Array<{ text: string, checked: boolean }> }} data
+     * @returns {boolean}
+     */
+    validate(data: {
+        items?: Array<{
+            text: string;
+            checked: boolean;
+        }>;
+    }): boolean;
+    /**
+     * Check whether the block has no meaningful user content.
+     * @param {HTMLElement} element
+     * @returns {boolean}
+     */
+    isEmpty(element: HTMLElement): boolean;
+    /**
+     * Extract neutral text that can initialize another block type.
+     * @param {HTMLElement} element
+     * @returns {{ text: string }}
+     */
+    exportData(element: HTMLElement): {
+        text: string;
+    };
+    /**
+     * Merge incoming text into the current block.
+     * @param {HTMLElement} element
+     * @param {Record<string, unknown>} data
+     * @returns {void}
+     */
+    merge(element: HTMLElement, data: Record<string, unknown>): void;
+    #private;
+}
+import { BlockPluginAbstract } from '../BlockPluginAbstract.js';
+import { mapTextFields } from './mapTextFields.js';