@shelamkoff/rector 1.0.0

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

@@ -0,0 +1,7 @@
+declare const _default: {
+    'plugin.raw.title': string;
+    'plugin.raw.placeholder': string;
+    'plugin.raw.preview': string;
+    'plugin.raw.previewFrame': string;
+};
+export default _default;

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

@@ -0,0 +1,6 @@
+export default {
+  'plugin.raw.title': 'Raw HTML',
+  'plugin.raw.placeholder': 'Paste HTML code...',
+  'plugin.raw.preview': 'Preview',
+  'plugin.raw.previewFrame': 'HTML preview',
+}

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

@@ -0,0 +1,7 @@
+declare const _default: {
+    'plugin.raw.title': string;
+    'plugin.raw.placeholder': string;
+    'plugin.raw.preview': string;
+    'plugin.raw.previewFrame': string;
+};
+export default _default;

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

@@ -0,0 +1,6 @@
+export default {
+  'plugin.raw.title': 'HTML',
+  'plugin.raw.placeholder': 'Вставьте HTML код...',
+  'plugin.raw.preview': 'Просмотр',
+  'plugin.raw.previewFrame': 'Предпросмотр HTML',
+}

package/dist/plugins/raw/raw.css

@@ -0,0 +1,127 @@
+/* =============================================================================
+   Raw HTML plugin — code input with live preview
+   ============================================================================= */
+
+.oe-raw {
+  border: 1px solid var(--oe-border, #2e2e35);
+  border-radius: 0.5rem;
+  overflow: hidden;
+  outline: none;
+}
+
+/* ── Header bar ───────────────────────────────────────────────────────────── */
+
+.oe-raw__bar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.375rem 0.75rem;
+  background: var(--oe-surface-2, #141418);
+  border-bottom: 1px solid var(--oe-border, #2e2e35);
+}
+
+.oe-raw__label {
+  font-size: 0.6875rem;
+  font-weight: 600;
+  color: var(--oe-text-3, #6e6e78);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.oe-raw__toggle {
+  padding: 0.1875rem 0.5rem;
+  border: 1px solid var(--oe-border, #2e2e35);
+  border-radius: 4px;
+  background: transparent;
+  color: var(--oe-text-3, #6e6e78);
+  font-size: 0.6875rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: background 0.12s, color 0.12s, border-color 0.12s;
+  font-family: inherit;
+  outline: none;
+}
+
+.oe-raw__toggle:hover {
+  background: var(--oe-surface-hover, #1e1e24);
+  color: var(--oe-text-2, #b0b0b8);
+}
+
+.oe-raw__toggle--active {
+  background: var(--oe-accent, #4357b4);
+  border-color: var(--oe-accent, #4357b4);
+  color: var(--oe-text-on-accent, #fff);
+}
+
+.oe-raw__toggle--active:hover {
+  opacity: 0.9;
+}
+
+/* ── Textarea ─────────────────────────────────────────────────────────────── */
+
+.oe-raw__textarea {
+  display: block;
+  width: 100%;
+  min-height: 6rem;
+  padding: 0.75rem;
+  border: none;
+  background: var(--oe-surface, #0e0e10);
+  color: var(--oe-text-1, #e8e8ec);
+  font-family: 'JetBrains Mono', 'Fira Code', Monaco, Consolas, monospace;
+  font-size: 0.8125rem;
+  line-height: 1.6;
+  resize: none;
+  overflow: hidden;
+  outline: none;
+  tab-size: 2;
+}
+
+.oe-raw__textarea::placeholder {
+  color: var(--oe-text-3, #5a5a64);
+}
+
+/* ── Preview ──────────────────────────────────────────────────────────────── */
+
+.oe-raw__preview {
+  padding: 0.75rem;
+  min-height: 3rem;
+  background: var(--oe-surface, #0e0e10);
+  color: var(--oe-text-1, #e8e8ec);
+  font-size: 0.875rem;
+  line-height: 1.6;
+}
+
+.oe-raw__preview:empty::before {
+  content: 'Empty';
+  color: var(--oe-text-3, #5a5a64);
+  font-style: italic;
+}
+
+/* ── Light theme ──────────────────────────────────────────────────────────── */
+
+.oe-theme-light .oe-raw {
+  border-color: var(--oe-border, #e0e0e0);
+}
+
+.oe-theme-light .oe-raw__bar {
+  background: var(--oe-surface-2, #f5f5f5);
+  border-bottom-color: var(--oe-border, #e0e0e0);
+}
+
+.oe-theme-light .oe-raw__toggle {
+  border-color: var(--oe-border, #e0e0e0);
+}
+
+.oe-theme-light .oe-raw__toggle:hover {
+  background: var(--oe-surface-hover, #f0f0f0);
+}
+
+.oe-theme-light .oe-raw__textarea {
+  background: var(--oe-surface, #fff);
+  color: var(--oe-text-1, #1a1a1a);
+}
+
+.oe-theme-light .oe-raw__preview {
+  background: var(--oe-surface, #fff);
+  color: var(--oe-text-1, #1a1a1a);
+}

package/dist/plugins/shared/actionBar.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared action bar utilities for block plugins (image, gallery, etc.).
+ * Eliminates duplicate makeActionBtn/makeSep across plugin view-filled files.
+ */
+/**
+ * Create an action button with click handler and AbortSignal cleanup.
+ * @param {string} cssClass — CSS class for the button element
+ * @param {string} innerHTML — SVG icon or label HTML
+ * @param {() => void} handler — click callback
+ * @param {AbortSignal} signal — AbortSignal for automatic listener removal
+ * @returns {HTMLButtonElement}
+ */
+export function makeActionBtn(cssClass: string, innerHTML: string, handler: () => void, signal: AbortSignal): HTMLButtonElement;
+/**
+ * Create a visual separator element for action bars.
+ * @param {string} cssClass — CSS class for the separator element
+ * @returns {HTMLDivElement}
+ */
+export function makeSep(cssClass: string): HTMLDivElement;

package/dist/plugins/shared/actionBar.js

@@ -0,0 +1,35 @@
+/**
+ * Shared action bar utilities for block plugins (image, gallery, etc.).
+ * Eliminates duplicate makeActionBtn/makeSep across plugin view-filled files.
+ */
+
+/**
+ * Create an action button with click handler and AbortSignal cleanup.
+ * @param {string} cssClass — CSS class for the button element
+ * @param {string} innerHTML — SVG icon or label HTML
+ * @param {() => void} handler — click callback
+ * @param {AbortSignal} signal — AbortSignal for automatic listener removal
+ * @returns {HTMLButtonElement}
+ */
+export function makeActionBtn(cssClass, innerHTML, handler, signal) {
+  const btn = document.createElement('button')
+  btn.type = 'button'
+  btn.className = cssClass
+  btn.innerHTML = innerHTML
+  btn.addEventListener('click', (e) => {
+    e.stopPropagation()
+    handler()
+  }, { signal })
+  return btn
+}
+
+/**
+ * Create a visual separator element for action bars.
+ * @param {string} cssClass — CSS class for the separator element
+ * @returns {HTMLDivElement}
+ */
+export function makeSep(cssClass) {
+  const sep = document.createElement('div')
+  sep.className = cssClass
+  return sep
+}

package/dist/plugins/shared/dropzone.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Shared dropzone (empty-state) view for media block plugins (image, gallery).
+ * Eliminates duplicate DOM construction and drag-and-drop wiring.
+ */
+/**
+ * @typedef {Object} DropzoneCssMap
+ * @property {string} select Wrapper class.
+ * @property {string} selectIcon Icon container class.
+ * @property {string} selectText Text container class.
+ * @property {string} selectLink Upload link class.
+ * @property {string} dropzoneActive Class added during dragover.
+ * @property {string} filled Class removed from the wrapper during rendering.
+ * @property {string} [selectActions] Optional application-source list class.
+ * @property {string} [selectAction] Optional application-source button class.
+ */
+/**
+ * @typedef {Object} DropzoneConfig
+ * @property {string} iconHtml SVG icon markup.
+ * @property {string} uploadText Localized upload-link text.
+ * @property {string} afterText Localized text after the upload link.
+ * @property {() => void} onUploadClick Opens the file input.
+ * @property {(dataTransfer: DataTransfer) => void} onDrop Handles dropped files.
+ * @property {Array<{ icon?: string, label: string, onSelect: () => void }>} [actions]
+ * @property {boolean} [readOnly] Render a non-interactive empty state.
+ * @property {string} [emptyText] Text shown for an empty read-only block.
+ */
+/**
+ * Render a dropzone (empty-state) view into a wrapper element.
+ * Clears the wrapper, removes the `filled` class, and wires drag-and-drop.
+ *
+ * @param {HTMLElement} wrapper Block wrapper element.
+ * @param {AbortSignal} signal Enables automatic listener cleanup.
+ * @param {DropzoneCssMap} css — plugin-specific CSS class names
+ * @param {DropzoneConfig} config — icon, text, and callbacks
+ * @returns {void}
+ */
+export function renderDropzone(wrapper: HTMLElement, signal: AbortSignal, css: DropzoneCssMap, config: DropzoneConfig): void;
+export type DropzoneCssMap = {
+    /**
+     * Wrapper class.
+     */
+    select: string;
+    /**
+     * Icon container class.
+     */
+    selectIcon: string;
+    /**
+     * Text container class.
+     */
+    selectText: string;
+    /**
+     * Upload link class.
+     */
+    selectLink: string;
+    /**
+     * Class added during dragover.
+     */
+    dropzoneActive: string;
+    /**
+     * Class removed from the wrapper during rendering.
+     */
+    filled: string;
+    /**
+     * Optional application-source list class.
+     */
+    selectActions?: string;
+    /**
+     * Optional application-source button class.
+     */
+    selectAction?: string;
+};
+export type DropzoneConfig = {
+    /**
+     * SVG icon markup.
+     */
+    iconHtml: string;
+    /**
+     * Localized upload-link text.
+     */
+    uploadText: string;
+    /**
+     * Localized text after the upload link.
+     */
+    afterText: string;
+    /**
+     * Opens the file input.
+     */
+    onUploadClick: () => void;
+    /**
+     * Handles dropped files.
+     */
+    onDrop: (dataTransfer: DataTransfer) => void;
+    actions?: Array<{
+        icon?: string;
+        label: string;
+        onSelect: () => void;
+    }>;
+    /**
+     * Render a non-interactive empty state.
+     */
+    readOnly?: boolean;
+    /**
+     * Text shown for an empty read-only block.
+     */
+    emptyText?: string;
+};

package/dist/plugins/shared/dropzone.js

@@ -0,0 +1,107 @@
+/**
+ * Shared dropzone (empty-state) view for media block plugins (image, gallery).
+ * Eliminates duplicate DOM construction and drag-and-drop wiring.
+ */
+
+/**
+ * @typedef {Object} DropzoneCssMap
+ * @property {string} select Wrapper class.
+ * @property {string} selectIcon Icon container class.
+ * @property {string} selectText Text container class.
+ * @property {string} selectLink Upload link class.
+ * @property {string} dropzoneActive Class added during dragover.
+ * @property {string} filled Class removed from the wrapper during rendering.
+ * @property {string} [selectActions] Optional application-source list class.
+ * @property {string} [selectAction] Optional application-source button class.
+ */
+
+/**
+ * @typedef {Object} DropzoneConfig
+ * @property {string} iconHtml SVG icon markup.
+ * @property {string} uploadText Localized upload-link text.
+ * @property {string} afterText Localized text after the upload link.
+ * @property {() => void} onUploadClick Opens the file input.
+ * @property {(dataTransfer: DataTransfer) => void} onDrop Handles dropped files.
+ * @property {Array<{ icon?: string, label: string, onSelect: () => void }>} [actions]
+ * @property {boolean} [readOnly] Render a non-interactive empty state.
+ * @property {string} [emptyText] Text shown for an empty read-only block.
+ */
+
+/**
+ * Render a dropzone (empty-state) view into a wrapper element.
+ * Clears the wrapper, removes the `filled` class, and wires drag-and-drop.
+ *
+ * @param {HTMLElement} wrapper Block wrapper element.
+ * @param {AbortSignal} signal Enables automatic listener cleanup.
+ * @param {DropzoneCssMap} css — plugin-specific CSS class names
+ * @param {DropzoneConfig} config — icon, text, and callbacks
+ * @returns {void}
+ */
+export function renderDropzone(wrapper, signal, css, config) {
+  wrapper.innerHTML = ''
+  wrapper.classList.remove(css.filled)
+
+  const select = document.createElement('div')
+  select.className = css.select
+
+  const icon = document.createElement('div')
+  icon.className = css.selectIcon
+  icon.innerHTML = config.iconHtml
+
+  const text = document.createElement('div')
+  text.className = css.selectText
+
+  if (config.readOnly) {
+    text.textContent = config.emptyText || config.afterText
+    select.append(icon, text)
+    wrapper.appendChild(select)
+    return
+  }
+
+  const uploadLink = document.createElement('button')
+  uploadLink.type = 'button'
+  uploadLink.className = css.selectLink
+  uploadLink.textContent = config.uploadText
+  uploadLink.addEventListener('click', (e) => {
+    e.stopPropagation()
+    config.onUploadClick()
+  }, { signal })
+
+  const afterText = document.createTextNode(' ' + config.afterText)
+
+  text.append(uploadLink, afterText)
+  select.append(icon, text)
+
+  if (css.selectActions && css.selectAction && config.actions?.length) {
+    const actions = document.createElement('div')
+    actions.className = css.selectActions
+    for (const action of config.actions) {
+      const button = document.createElement('button')
+      button.type = 'button'
+      button.className = css.selectAction
+      if (action.icon) button.insertAdjacentHTML('afterbegin', action.icon)
+      button.append(document.createTextNode(action.label))
+      button.addEventListener('click', (event) => {
+        event.stopPropagation()
+        action.onSelect()
+      }, { signal })
+      actions.appendChild(button)
+    }
+    select.appendChild(actions)
+  }
+
+  wrapper.addEventListener('dragover', (e) => {
+    e.preventDefault()
+    select.classList.add(css.dropzoneActive)
+  }, { signal })
+  wrapper.addEventListener('dragleave', () => {
+    select.classList.remove(css.dropzoneActive)
+  }, { signal })
+  wrapper.addEventListener('drop', (e) => {
+    e.preventDefault()
+    select.classList.remove(css.dropzoneActive)
+    if (e.dataTransfer) config.onDrop(e.dataTransfer)
+  }, { signal })
+
+  wrapper.appendChild(select)
+}

package/dist/plugins/shared/fileInput.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shared file input trigger for block plugins (image, gallery, attaches).
+ * Eliminates duplicate #triggerFileInput methods.
+ */
+/**
+ * @typedef {Object} FileInputConfig
+ * @property {string} [accept] - accepted MIME types (e.g. 'image/*')
+ * @property {boolean} [multiple] - allow multiple file selection
+ * @property {AbortSignal} [signal] - removes the temporary input when the owning view is disposed
+ * @property {(files: File[]) => void} onFiles - callback with selected files
+ */
+/**
+ * Programmatically open a file picker dialog and call back with selected files.
+ *
+ * @param {FileInputConfig} config
+ * @returns {void}
+ */
+export function triggerFileInput(config: FileInputConfig): void;
+/**
+ * Return whether a browser `File` is an image accepted by media plugins.
+ * MIME is authoritative when present; an extension fallback supports files
+ * from drag sources that omit MIME metadata.
+ * @param {File} file
+ * @returns {boolean}
+ */
+export function isSupportedImageFile(file: File): boolean;
+export type FileInputConfig = {
+    /**
+     * - accepted MIME types (e.g. 'image/*')
+     */
+    accept?: string;
+    /**
+     * - allow multiple file selection
+     */
+    multiple?: boolean;
+    /**
+     * - removes the temporary input when the owning view is disposed
+     */
+    signal?: AbortSignal;
+    /**
+     * - callback with selected files
+     */
+    onFiles: (files: File[]) => void;
+};

package/dist/plugins/shared/fileInput.js

@@ -0,0 +1,62 @@
+/**
+ * Shared file input trigger for block plugins (image, gallery, attaches).
+ * Eliminates duplicate #triggerFileInput methods.
+ */
+
+/**
+ * @typedef {Object} FileInputConfig
+ * @property {string} [accept] - accepted MIME types (e.g. 'image/*')
+ * @property {boolean} [multiple] - allow multiple file selection
+ * @property {AbortSignal} [signal] - removes the temporary input when the owning view is disposed
+ * @property {(files: File[]) => void} onFiles - callback with selected files
+ */
+
+/**
+ * Programmatically open a file picker dialog and call back with selected files.
+ *
+ * @param {FileInputConfig} config
+ * @returns {void}
+ */
+export function triggerFileInput(config) {
+  if (config.signal?.aborted) return
+  const input = document.createElement('input')
+  input.type = 'file'
+  input.style.cssText = 'position:fixed;top:0;left:0;width:1px;height:1px;opacity:0.01;pointer-events:none;z-index:-1'
+  if (config.accept) input.accept = config.accept
+  if (config.multiple) input.multiple = true
+  let cleaned = false
+  const cleanup = () => {
+    if (cleaned) return
+    cleaned = true
+    config.signal?.removeEventListener('abort', cleanup)
+    input.remove()
+  }
+  config.signal?.addEventListener('abort', cleanup, { once: true })
+  input.addEventListener('change', () => {
+    const files = [...(input.files || [])]
+    if (files.length > 0) config.onFiles(files)
+    cleanup()
+  })
+  input.addEventListener('cancel', cleanup, { once: true })
+  document.body.appendChild(input)
+  try {
+    input.click()
+  } catch (error) {
+    cleanup()
+    throw error
+  }
+}
+
+/**
+ * Return whether a browser `File` is an image accepted by media plugins.
+ * MIME is authoritative when present; an extension fallback supports files
+ * from drag sources that omit MIME metadata.
+ * @param {File} file
+ * @returns {boolean}
+ */
+export function isSupportedImageFile(file) {
+  const type = file.type.trim().toLowerCase()
+  if (type.startsWith('image/')) return true
+  if (type) return false
+  return /\.(?:avif|bmp|gif|jpe?g|png|svg|webp)$/i.test(file.name)
+}

package/dist/plugins/spoiler/README.md

@@ -0,0 +1,55 @@
+# Spoiler block plugin
+
+User-revealed hidden content with an editable label.
+
+## Install and register
+
+```bash
+npm install @shelamkoff/rector
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Spoiler } from '@shelamkoff/rector/plugins/spoiler'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Spoiler()],
+})
+```
+
+The registered block type is `spoiler`. The class is also exported by the complete `@shelamkoff/rector/plugins` preset and can be loaded through `@shelamkoff/rector/plugins/async`.
+
+## Data
+
+```json
+{ "label": "Reveal", "content": "Spoiler text" }
+```
+
+### Field reference
+
+| Field | Required | Meaning and constraints |
+| --- | --- | --- |
+| `label` | yes | String containing sanitized inline HTML; it may be empty. |
+| `content` | yes | Non-blank sanitized inline HTML. |
+
+The expanded state is transient and is not stored in block data. The renderer supplies keyboard and `aria-expanded` disclosure semantics.
+
+## 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 formatting; editable label/content; merge; accessible disclosure.
+
+## 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/spoiler`. The VitePress guide documents configuration, commands and history, extension contracts, document migrations, styling, security, and lifecycle in a sequential form.

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

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