@shelamkoff/rector 1.0.0

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

@@ -0,0 +1,23 @@
+declare const _default: {
+    'plugin.poll.title': string;
+    'plugin.poll.questionPlaceholder': string;
+    'plugin.poll.optionPlaceholder': string;
+    'plugin.poll.addOption': string;
+    'plugin.poll.single': string;
+    'plugin.poll.multiple': string;
+    'plugin.poll.results': string;
+    'plugin.poll.resultsAlways': string;
+    'plugin.poll.resultsAfterVote': string;
+    'plugin.poll.resultsHidden': string;
+    'plugin.poll.sort': string;
+    'plugin.poll.selectOption': string;
+    'plugin.poll.vote': string;
+    'plugin.poll.loading': string;
+    'plugin.poll.submitting': string;
+    'plugin.poll.loadError': string;
+    'plugin.poll.emptyResults': string;
+    'plugin.poll.voters': string;
+    'plugin.poll.anonymousVoter': string;
+    'plugin.poll.delete': string;
+};
+export default _default;

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

@@ -0,0 +1,22 @@
+export default {
+  'plugin.poll.title': 'Poll',
+  'plugin.poll.questionPlaceholder': 'Question...',
+  'plugin.poll.optionPlaceholder': 'Option',
+  'plugin.poll.addOption': 'Add option',
+  'plugin.poll.single': 'Single choice',
+  'plugin.poll.multiple': 'Multiple choice',
+  'plugin.poll.results': 'Results',
+  'plugin.poll.resultsAlways': 'Results always visible',
+  'plugin.poll.resultsAfterVote': 'Results after vote',
+  'plugin.poll.resultsHidden': 'Results hidden',
+  'plugin.poll.sort': 'Sort',
+  'plugin.poll.selectOption': 'Select option',
+  'plugin.poll.vote': 'Vote',
+  'plugin.poll.loading': 'Loading results…',
+  'plugin.poll.submitting': 'Submitting…',
+  'plugin.poll.loadError': 'Could not load poll results',
+  'plugin.poll.emptyResults': 'No votes yet',
+  'plugin.poll.voters': 'Voters',
+  'plugin.poll.anonymousVoter': 'Anonymous voter',
+  'plugin.poll.delete': 'Delete',
+}

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

@@ -0,0 +1,23 @@
+declare const _default: {
+    'plugin.poll.title': string;
+    'plugin.poll.questionPlaceholder': string;
+    'plugin.poll.optionPlaceholder': string;
+    'plugin.poll.addOption': string;
+    'plugin.poll.single': string;
+    'plugin.poll.multiple': string;
+    'plugin.poll.results': string;
+    'plugin.poll.resultsAlways': string;
+    'plugin.poll.resultsAfterVote': string;
+    'plugin.poll.resultsHidden': string;
+    'plugin.poll.sort': string;
+    'plugin.poll.selectOption': string;
+    'plugin.poll.vote': string;
+    'plugin.poll.loading': string;
+    'plugin.poll.submitting': string;
+    'plugin.poll.loadError': string;
+    'plugin.poll.emptyResults': string;
+    'plugin.poll.voters': string;
+    'plugin.poll.anonymousVoter': string;
+    'plugin.poll.delete': string;
+};
+export default _default;

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

@@ -0,0 +1,22 @@
+export default {
+  'plugin.poll.title': 'Опрос',
+  'plugin.poll.questionPlaceholder': 'Вопрос...',
+  'plugin.poll.optionPlaceholder': 'Вариант',
+  'plugin.poll.addOption': 'Добавить вариант',
+  'plugin.poll.single': 'Один ответ',
+  'plugin.poll.multiple': 'Несколько ответов',
+  'plugin.poll.results': 'Результаты',
+  'plugin.poll.resultsAlways': 'Результаты видны всегда',
+  'plugin.poll.resultsAfterVote': 'Результаты после голосования',
+  'plugin.poll.resultsHidden': 'Результаты скрыты',
+  'plugin.poll.sort': 'Сортировать',
+  'plugin.poll.selectOption': 'Выбрать вариант',
+  'plugin.poll.vote': 'Проголосовать',
+  'plugin.poll.loading': 'Загрузка результатов…',
+  'plugin.poll.submitting': 'Отправка голоса…',
+  'plugin.poll.loadError': 'Не удалось загрузить результаты опроса',
+  'plugin.poll.emptyResults': 'Голосов пока нет',
+  'plugin.poll.voters': 'Проголосовали',
+  'plugin.poll.anonymousVoter': 'Анонимный участник',
+  'plugin.poll.delete': 'Удалить',
+}

package/dist/plugins/poll/poll.css

@@ -0,0 +1,400 @@
+/* =============================================================================
+   Poll plugin — poll/survey with single/multiple choice and results preview
+   ============================================================================= */
+
+.oe-poll {
+  border: 1px solid var(--oe-border, #2e2e35);
+  border-radius: 0.5rem;
+  padding: 1rem 1.25rem;
+  outline: none;
+}
+
+/* ── Question ─────────────────────────────────────────────────────────────── */
+
+.oe-poll__question {
+  font-weight: 600;
+  font-size: 1rem;
+  outline: none;
+  margin-bottom: 0.75rem;
+  line-height: 1.4;
+}
+
+.oe-poll__question:empty::before {
+  content: attr(data-placeholder);
+  color: var(--oe-text-3, #6e6e78);
+  opacity: 0.5;
+  pointer-events: none;
+}
+
+/* ── Options container ────────────────────────────────────────────────────── */
+
+.oe-poll__options {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+}
+
+/* ── Option item ──────────────────────────────────────────────────────────── */
+
+.oe-poll__option {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.5rem;
+  padding: 0.375rem 0.5rem;
+  border-radius: 0.375rem;
+  transition: background 0.12s;
+  position: relative;
+}
+
+.oe-poll__option:hover {
+  background: var(--oe-surface-hover, rgba(255, 255, 255, 0.03));
+}
+
+/* ── Option marker (radio/checkbox visual) ────────────────────────────────── */
+
+.oe-poll__option-marker {
+  flex-shrink: 0;
+  width: 1rem;
+  height: 1rem;
+  margin-top: 0.25rem;
+  border: 2px solid var(--oe-border-hover, #3a3a44);
+  transition: border-color 0.15s;
+  padding: 0;
+  background: transparent;
+  cursor: pointer;
+}
+
+.oe-poll__option-marker--single {
+  border-radius: 50%;
+}
+
+.oe-poll__option-marker--multiple {
+  border-radius: 3px;
+}
+
+.oe-poll__option:hover .oe-poll__option-marker {
+  border-color: var(--oe-accent, #4357b4);
+}
+
+.oe-poll__option-marker--selected {
+  border-color: var(--oe-accent, #4357b4);
+  background: var(--oe-accent, #4357b4);
+  box-shadow: inset 0 0 0 3px var(--oe-surface, #0e0e10);
+}
+
+.oe-poll__option-marker:focus-visible,
+.oe-poll__submit:focus-visible,
+.oe-poll__option-remove:focus-visible,
+.oe-poll__option-add:focus-visible,
+.oe-poll__action-btn:focus-visible {
+  outline: 2px solid var(--oe-focus-ring, var(--oe-accent, #4357b4));
+  outline-offset: 2px;
+}
+
+/* ── Option text ──────────────────────────────────────────────────────────── */
+
+.oe-poll__option-text {
+  flex: 1;
+  min-width: 0;
+  outline: none;
+  font-size: 0.875rem;
+  line-height: 1.5;
+  word-break: break-word;
+}
+
+.oe-poll__option-text:empty::before {
+  content: attr(data-placeholder);
+  color: var(--oe-text-3, #6e6e78);
+  opacity: 0.5;
+  pointer-events: none;
+}
+
+/* ── Option remove button ─────────────────────────────────────────────────── */
+
+.oe-poll__option-remove {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  width: 1.25rem;
+  height: 1.25rem;
+  margin-top: 0.1875rem;
+  border: none;
+  border-radius: 50%;
+  background: transparent;
+  color: var(--oe-text-3, #6e6e78);
+  cursor: pointer;
+  opacity: 0;
+  transition: opacity 0.15s, background 0.15s, color 0.15s;
+  outline: none;
+  padding: 0;
+}
+
+.oe-poll__option:hover .oe-poll__option-remove {
+  opacity: 1;
+}
+
+.oe-poll__option-remove:hover {
+  background: rgba(239, 68, 68, 0.15);
+  color: var(--oe-danger, #f87171);
+}
+
+/* ── Add option button ────────────────────────────────────────────────────── */
+
+.oe-poll__option-add {
+  display: flex;
+  align-items: center;
+  gap: 0.375rem;
+  padding: 0.375rem 0.5rem;
+  margin-top: 0.25rem;
+  border: 1px dashed var(--oe-border, #2e2e35);
+  border-radius: 0.375rem;
+  background: transparent;
+  color: var(--oe-text-3, #6e6e78);
+  font-size: 0.8125rem;
+  font-family: inherit;
+  cursor: pointer;
+  transition: border-color 0.15s, color 0.15s;
+  outline: none;
+}
+
+.oe-poll__option-add:hover {
+  border-color: var(--oe-accent, #4357b4);
+  color: var(--oe-accent, #4357b4);
+}
+
+.oe-poll__option-add svg {
+  flex-shrink: 0;
+}
+
+/* ── Results preview ──────────────────────────────────────────────────────── */
+
+.oe-poll__results {
+  margin-top: 0.75rem;
+  padding-top: 0.75rem;
+  border-top: 1px solid var(--oe-border, #2e2e35);
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.oe-poll__runtime {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 0.625rem;
+}
+
+.oe-poll__status {
+  margin-top: 0.75rem;
+  color: var(--oe-text-3, #6e6e78);
+  font-size: 0.75rem;
+}
+
+.oe-poll__status--error {
+  color: var(--oe-danger, #f87171);
+}
+
+.oe-poll__submit {
+  margin-top: 0.25rem;
+  padding: 0.4375rem 0.75rem;
+  border: 1px solid var(--oe-accent, #4357b4);
+  border-radius: 0.375rem;
+  background: var(--oe-accent, #4357b4);
+  color: var(--oe-text-on-accent, #fff);
+  font: inherit;
+  font-size: 0.75rem;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+.oe-poll__submit:disabled {
+  cursor: not-allowed;
+  opacity: 0.5;
+}
+
+.oe-poll__voters {
+  margin-top: 0.25rem;
+}
+
+.oe-poll__voters-title {
+  margin-bottom: 0.375rem;
+  color: var(--oe-text-2, #9898a0);
+  font-size: 0.75rem;
+  font-weight: 600;
+}
+
+.oe-poll__voters ul {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.375rem 0.75rem;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.oe-poll__voters li {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+  color: var(--oe-text-2, #9898a0);
+  font-size: 0.75rem;
+}
+
+.oe-poll__voters img {
+  border-radius: 50%;
+  object-fit: cover;
+}
+
+.oe-poll__result-row {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.oe-poll__result-label {
+  min-width: 4rem;
+  max-width: 8rem;
+  font-size: 0.75rem;
+  color: var(--oe-text-2, #9898a0);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.oe-poll__result-bar {
+  flex: 1;
+  height: 6px;
+  background: var(--oe-surface-2, #1a1a1f);
+  border-radius: 3px;
+  overflow: hidden;
+}
+
+.oe-poll__result-fill {
+  height: 100%;
+  background: var(--oe-accent, #4357b4);
+  border-radius: 3px;
+  transition: width 0.4s cubic-bezier(0.22, 1, 0.36, 1);
+}
+
+.oe-poll__result-pct {
+  min-width: 2.5rem;
+  font-size: 0.75rem;
+  font-weight: 500;
+  color: var(--oe-text-3, #6e6e78);
+  text-align: right;
+}
+
+/* ── Action bar ───────────────────────────────────────────────────────────── */
+
+.oe-poll__actions {
+  display: inline-flex;
+  align-items: center;
+  gap: 0;
+  margin-top: 0.75rem;
+  background: var(--oe-surface, #0e0e10);
+  border: 1px solid var(--oe-border, #1a1a1f);
+  border-radius: 0.5rem;
+  padding: 0.1875rem;
+}
+
+.oe-poll__action-btn {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.3125rem;
+  padding: 0.3125rem 0.5rem;
+  border: none;
+  border-radius: 0.375rem;
+  background: transparent;
+  color: var(--oe-text-1, #fff);
+  font-size: 0.6875rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: color 0.15s;
+  white-space: nowrap;
+  line-height: 1;
+  isolation: isolate;
+  font-family: inherit;
+  outline: none;
+}
+
+.oe-poll__action-btn::before {
+  content: '';
+  position: absolute;
+  inset: 0;
+  border-radius: 0.375rem;
+  background: var(--oe-accent, #4357b4);
+  transform: scale(0);
+  transition: transform 0.25s cubic-bezier(0.22, 1, 0.36, 1);
+  z-index: -1;
+  backface-visibility: hidden;
+}
+
+.oe-poll__action-btn:hover::before {
+  transform: scale(1);
+}
+
+.oe-poll__action-btn--active {
+  color: var(--oe-accent, #4357b4);
+}
+
+.oe-poll__action-btn--danger {
+  color: var(--oe-danger, #f87171);
+}
+
+.oe-poll__action-btn--danger::before {
+  background: var(--oe-danger, #f87171);
+}
+
+.oe-poll__action-btn--danger:hover {
+  color: var(--oe-text-on-accent, #fff);
+}
+
+.oe-poll__action-btn svg {
+  flex-shrink: 0;
+}
+
+.oe-poll__actions-sep {
+  width: 1px;
+  height: 1.125rem;
+  background: var(--oe-border, #1a1a1f);
+  margin: 0 0.0625rem;
+  flex-shrink: 0;
+}
+
+/* ── Light theme ──────────────────────────────────────────────────────────── */
+
+.oe-theme-light .oe-poll {
+  border-color: var(--oe-border, #e0e0e0);
+}
+
+.oe-theme-light .oe-poll__option:hover {
+  background: var(--oe-surface-hover, rgba(0, 0, 0, 0.02));
+}
+
+.oe-theme-light .oe-poll__option-marker {
+  border-color: var(--oe-border-hover, #d0d0d0);
+}
+
+.oe-theme-light .oe-poll__option-add {
+  border-color: var(--oe-border, #e0e0e0);
+}
+
+.oe-theme-light .oe-poll__results {
+  border-top-color: var(--oe-border, #e0e0e0);
+}
+
+.oe-theme-light .oe-poll__result-bar {
+  background: var(--oe-surface-2, #f0f0f0);
+}
+
+.oe-theme-light .oe-poll__actions {
+  background: var(--oe-surface, #fafafa);
+  border-color: var(--oe-border, #e0e0e0);
+}
+
+.oe-theme-light .oe-poll__action-btn {
+  color: var(--oe-text-1, #1a1a1a);
+}

package/dist/plugins/quote/README.md

@@ -0,0 +1,55 @@
+# Quote block plugin
+
+Quotation text with an optional caption.
+
+## Install and register
+
+```bash
+npm install @shelamkoff/rector
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Quote } from '@shelamkoff/rector/plugins/quote'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Quote()],
+})
+```
+
+The registered block type is `quote`. The class is also exported by the complete `@shelamkoff/rector/plugins` preset and can be loaded through `@shelamkoff/rector/plugins/async`.
+
+## Data
+
+```json
+{ "text": "Quote", "caption": "Author" }
+```
+
+### Field reference
+
+| Field | Required | Meaning and constraints |
+| --- | --- | --- |
+| `text` | yes | Non-blank sanitized inline HTML. |
+| `caption` | yes | A string; it may be empty. |
+
+Both fields participate in inline-widget marshaling. A new quote can be an empty draft, but strict validation requires non-blank `text` before persistence.
+
+## 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; blockquote paste; 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/quote`. The VitePress guide documents configuration, commands and history, extension contracts, document migrations, styling, security, and lifecycle in a sequential form.

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

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

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

@@ -0,0 +1,81 @@
+import type {} from './locale/keys.js'
+/** Editable quotation with optional attribution. */
+export class Quote 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;
+    pasteConfig: {
+        tags: string[];
+    };
+    /**
+     * Return the localized toolbox label for this block.
+     * @returns {string}
+     */
+    get title(): string;
+    /**
+     * Create the editable DOM owned by this block instance.
+     * @param {{ text?: string, caption?: string }} data
+     * @returns {HTMLElement}
+     */
+    render(data: {
+        text?: string;
+        caption?: string;
+    }): HTMLElement;
+    /**
+     * Serialize the current block DOM into document data.
+     * @param {HTMLElement} element
+     * @returns {{ text: string, caption: string }}
+     */
+    save(element: HTMLElement): {
+        text: string;
+        caption: string;
+    };
+    /**
+     * Check whether serialized data satisfies this block's schema.
+     * @param {{ text?: string, caption?: string }} data
+     * @returns {boolean}
+     */
+    validate(data: {
+        text?: string;
+        caption?: string;
+    }): boolean;
+    /**
+     * Merge incoming text into the current block.
+     * @param {HTMLElement} element
+     * @param {{ text?: string }} data
+     * @returns {void}
+     */
+    merge(element: HTMLElement, data: {
+        text?: string;
+    }): void;
+    /**
+     * Extract neutral fields that can initialize another block type.
+     * @param {HTMLElement} element
+     * @returns {{ text: string, caption: string }}
+     */
+    exportData(element: HTMLElement): {
+        text: string;
+        caption: string;
+    };
+    /**
+     * Check whether the block has no meaningful user content.
+     * @param {HTMLElement} element
+     * @returns {boolean}
+     */
+    isEmpty(element: HTMLElement): boolean;
+    /**
+     * Handle pasted blockquote elements.
+     * @param {import('../../types.js').TagPasteEvent} event
+     * @returns {{ text: string, caption: string } | null}
+     */
+    onPaste(event: import("../../types.js").TagPasteEvent): {
+        text: string;
+        caption: string;
+    } | null;
+}
+import { BlockPluginAbstract } from '../BlockPluginAbstract.js';
+import { mapTextFields } from './mapTextFields.js';