@shelamkoff/rector 1.0.0

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

@@ -0,0 +1,11 @@
+declare const _default: {
+    'plugin.code.title': string;
+    'plugin.code.placeholder': string;
+    'plugin.code.copy': string;
+    'plugin.code.edit': string;
+    'plugin.code.done': string;
+    'plugin.code.search': string;
+    'plugin.code.languageAuto': string;
+    'plugin.code.languagePlainText': string;
+};
+export default _default;

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

@@ -0,0 +1,10 @@
+export default {
+  'plugin.code.title': 'Code',
+  'plugin.code.placeholder': '// Write code...',
+  'plugin.code.copy': 'Copy',
+  'plugin.code.edit': 'Edit',
+  'plugin.code.done': 'Done',
+  'plugin.code.search': 'Search...',
+  'plugin.code.languageAuto': 'Auto',
+  'plugin.code.languagePlainText': 'Plain text',
+}

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

@@ -0,0 +1,11 @@
+declare const _default: {
+    'plugin.code.title': string;
+    'plugin.code.placeholder': string;
+    'plugin.code.copy': string;
+    'plugin.code.edit': string;
+    'plugin.code.done': string;
+    'plugin.code.search': string;
+    'plugin.code.languageAuto': string;
+    'plugin.code.languagePlainText': string;
+};
+export default _default;

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

@@ -0,0 +1,10 @@
+export default {
+  'plugin.code.title': 'Код',
+  'plugin.code.placeholder': '// Введите код...',
+  'plugin.code.copy': 'Копировать',
+  'plugin.code.edit': 'Редактировать',
+  'plugin.code.done': 'Готово',
+  'plugin.code.search': 'Поиск...',
+  'plugin.code.languageAuto': 'Авто',
+  'plugin.code.languagePlainText': 'Обычный текст',
+}

package/dist/plugins/columns/README.md

@@ -0,0 +1,55 @@
+# Columns block plugin
+
+Two- or three-column rich-content layouts.
+
+## Install and register
+
+```bash
+npm install @shelamkoff/rector
+```
+
+```js
+import { createEditor } from '@shelamkoff/rector'
+import { Columns } from '@shelamkoff/rector/plugins/columns'
+import '@shelamkoff/rector/styles/editor.css'
+
+const editor = createEditor({
+  holder: document.querySelector('#editor'),
+  plugins: [new Columns()],
+})
+```
+
+The registered block type is `columns`. The class is also exported by the complete `@shelamkoff/rector/plugins` preset and can be loaded through `@shelamkoff/rector/plugins/async`.
+
+## Data
+
+```json
+{ "columns": [{ "content": "Left" }, { "content": "Right" }], "layout": "1-1" }
+```
+
+### Field reference
+
+| Field | Required | Meaning and constraints |
+| --- | --- | --- |
+| `layout` | yes | `1-1`, `1-2`, `2-1`, or `1-1-1`. A new block defaults to `1-1`. |
+| `columns` | yes | Array of `{ content: string }` objects. Two-column layouts require exactly two entries; `1-1-1` requires exactly three. Content stores sanitized inline HTML. |
+
+Empty column strings are valid. Changing the layout preserves columns in order. Expanding from two to three columns adds an empty final column. Reducing from three to two columns appends the removed column's non-blank rich text to the second column, separated by `<br>`, so changing the layout does not discard content. Every column supports the editor's enabled inline tools and persistent inline widgets.
+
+## 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
+
+Layout controls; editable column content; validation and document rendering.
+
+## 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/columns`. The VitePress guide documents configuration, commands and history, extension contracts, document migrations, styling, security, and lifecycle in a sequential form.

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

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

package/dist/plugins/columns/columns.css

@@ -0,0 +1,103 @@
+/* =============================================================================
+   Columns plugin — multi-column layout
+   ============================================================================= */
+
+.oe-columns {
+  outline: none;
+}
+
+/* ── Grid ─────────────────────────────────────────────────────────────────── */
+
+.oe-columns__grid {
+  display: grid;
+  gap: 0.75rem;
+}
+
+/* ── Column ───────────────────────────────────────────────────────────────── */
+
+.oe-columns__col {
+  min-height: 3rem;
+  padding: 0.75rem;
+  border: 1px dashed var(--oe-border, #2e2e35);
+  border-radius: 0.375rem;
+  outline: none;
+  font-size: 0.875rem;
+  line-height: 1.6;
+  transition: border-color 0.15s;
+}
+
+.oe-columns__col:focus {
+  border-color: var(--oe-accent, #4357b4);
+  border-style: solid;
+}
+
+.oe-columns__col:empty::before {
+  content: attr(data-placeholder);
+  color: var(--oe-text-3, #6e6e78);
+  opacity: 0.35;
+  pointer-events: none;
+}
+
+/* ── Layout selector ──────────────────────────────────────────────────────── */
+
+.oe-columns__actions {
+  display: inline-flex;
+  gap: 0.25rem;
+  margin-top: 0.5rem;
+  background: var(--oe-surface, #0e0e10);
+  border: 1px solid var(--oe-border, #1a1a1f);
+  border-radius: 0.375rem;
+  padding: 0.1875rem;
+}
+
+.oe-columns__layout-btn {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.3125rem 0.5rem;
+  border: none;
+  border-radius: 0.25rem;
+  background: transparent;
+  color: var(--oe-text-3, #6e6e78);
+  cursor: pointer;
+  transition: background 0.12s, color 0.12s;
+  outline: none;
+}
+
+.oe-columns__layout-btn:hover {
+  background: var(--oe-surface-hover, #1e1e24);
+  color: var(--oe-text-1, #e8e8ec);
+}
+
+.oe-columns__layout-btn--active {
+  background: var(--oe-accent, #4357b4);
+  color: var(--oe-text-on-accent, #fff);
+}
+
+.oe-columns__layout-btn--active:hover {
+  opacity: 0.9;
+}
+
+/* ── Light theme ──────────────────────────────────────────────────────────── */
+
+.oe-theme-light .oe-columns__col {
+  border-color: var(--oe-border, #e0e0e0);
+}
+
+.oe-theme-light .oe-columns__col:focus {
+  border-color: var(--oe-accent, #4357b4);
+}
+
+.oe-theme-light .oe-columns__actions {
+  background: var(--oe-surface, #fafafa);
+  border-color: var(--oe-border, #e0e0e0);
+}
+
+.oe-theme-light .oe-columns__layout-btn {
+  color: var(--oe-text-3, #6e6e78);
+}
+
+.oe-theme-light .oe-columns__layout-btn:hover {
+  background: var(--oe-surface-hover, #f0f0f0);
+  color: var(--oe-text-1, #1a1a1a);
+}

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

@@ -0,0 +1,58 @@
+import type {} from './locale/keys.js'
+/** Editable two- or three-column rich-text layout block. */
+export class Columns extends BlockPluginAbstract<Record<string, any>> {
+    static isTextBlock: boolean;
+    static styles: string[];
+    constructor(config?: Record<string, any>);
+    type: string;
+    icon: string;
+    inlineTools: boolean;
+    mapTextFields: typeof mapColumnsTextFields;
+    /**
+     * Return the localized toolbox label for this block.
+     * @returns {string}
+     */
+    get title(): string;
+    /**
+     * Create the editable DOM owned by this block instance.
+     * @param {Record<string, unknown>} data
+     * @param {import('../../core/types.js').BlockMutationContext} context
+     * @returns {HTMLElement}
+     */
+    render(data: Record<string, unknown>, context: import("../../core/types.js").BlockMutationContext): HTMLElement;
+    /**
+     * Serialize the current block DOM into document data.
+     * @param {HTMLElement} element @returns {{ columns: Array<{ content: string }>, layout: string }}
+     */
+    save(element: HTMLElement): {
+        columns: Array<{
+            content: string;
+        }>;
+        layout: string;
+    };
+    /**
+     * 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;
+    /**
+     * Extract neutral rich text that can initialize another block type.
+     * @param {HTMLElement} element @returns {{ text: string }}
+     */
+    exportData(element: HTMLElement): {
+        text: string;
+    };
+    /**
+     * Release listeners and resources owned by this block element.
+     * @param {HTMLElement} element @returns {void}
+     */
+    destroy(element: HTMLElement): void;
+    #private;
+}
+import { BlockPluginAbstract } from '../BlockPluginAbstract.js';
+import { mapColumnsTextFields } from '../../shared/mapTextFields.js';

package/dist/plugins/columns/index.js

@@ -0,0 +1,236 @@
+import { sanitizeHtml } from '../../core/sanitize.js'
+import { resolvePath } from '../../shared/resolvePath.js'
+import { BlockPluginAbstract } from '../BlockPluginAbstract.js'
+import { validateColumnsData } from '../../shared/blockDataValidators.js'
+import { normalizeTextValue } from '../../shared/textFormat.js'
+import { mapColumnsTextFields } from '../../shared/mapTextFields.js'
+
+const editorStyles = resolvePath('./columns.css', import.meta.url)
+
+// Tabler icon: columns-2
+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="M3 3m0 1a1 1 0 0 1 1-1h16a1 1 0 0 1 1 1v16a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1z"/><path d="M12 3v18"/></svg>'
+
+
+const LAYOUTS = {
+  '1-1':   { cols: 2, grid: '1fr 1fr', label: '50 / 50' },
+  '1-2':   { cols: 2, grid: '1fr 2fr', label: '33 / 67' },
+  '2-1':   { cols: 2, grid: '2fr 1fr', label: '67 / 33' },
+  '1-1-1': { cols: 3, grid: '1fr 1fr 1fr', label: '33 / 33 / 33' },
+}
+/** @type {(keyof typeof LAYOUTS)[]} */
+const LAYOUT_KEYS = ['1-1', '1-2', '2-1', '1-1-1']
+// Layout preview icons (small SVGs for selector)
+/** @type {Record<string, string>} */
+const LAYOUT_ICONS = {
+  '1-1':   '<svg width="20" height="14" viewBox="0 0 20 14"><rect x="0.5" y="0.5" width="9" height="13" rx="1" fill="none" stroke="currentColor" stroke-width="1"/><rect x="10.5" y="0.5" width="9" height="13" rx="1" fill="none" stroke="currentColor" stroke-width="1"/></svg>',
+  '1-2':   '<svg width="20" height="14" viewBox="0 0 20 14"><rect x="0.5" y="0.5" width="6" height="13" rx="1" fill="none" stroke="currentColor" stroke-width="1"/><rect x="7.5" y="0.5" width="12" height="13" rx="1" fill="none" stroke="currentColor" stroke-width="1"/></svg>',
+  '2-1':   '<svg width="20" height="14" viewBox="0 0 20 14"><rect x="0.5" y="0.5" width="12" height="13" rx="1" fill="none" stroke="currentColor" stroke-width="1"/><rect x="13.5" y="0.5" width="6" height="13" rx="1" fill="none" stroke="currentColor" stroke-width="1"/></svg>',
+  '1-1-1': '<svg width="20" height="14" viewBox="0 0 20 14"><rect x="0.5" y="0.5" width="5.67" height="13" rx="1" fill="none" stroke="currentColor" stroke-width="1"/><rect x="7.17" y="0.5" width="5.67" height="13" rx="1" fill="none" stroke="currentColor" stroke-width="1"/><rect x="13.83" y="0.5" width="5.67" height="13" rx="1" fill="none" stroke="currentColor" stroke-width="1"/></svg>',
+}
+/** @type {WeakMap<HTMLElement, { data: { columns: Array<{content: string}>, layout: string } }>} */
+const stateMap = new WeakMap()
+/** Editable two- or three-column rich-text layout block. */
+export class Columns extends BlockPluginAbstract {
+  static isTextBlock = false
+  static styles = [editorStyles]
+  type = 'columns'
+  icon = ICON
+  inlineTools = true
+  mapTextFields = mapColumnsTextFields
+
+  /**
+   * Return the localized toolbox label for this block.
+   * @returns {string}
+   */
+  get title() {
+    return this._t('title', 'Columns')
+  }
+
+  /**
+   * Create the editable DOM owned by this block instance.
+   * @param {Record<string, unknown>} data
+   * @param {import('../../core/types').BlockMutationContext} context
+   * @returns {HTMLElement}
+   */
+  render(data, context) {
+    const layout = LAYOUT_KEYS.includes(/** @type {any} */ (data?.layout)) ? String(data.layout) : '1-1'
+    const layoutDef = /** @type {{ cols: number, grid: string, label: string }} */ (LAYOUTS[layout])
+    const columns = Array.isArray(data?.columns)
+      ? data.columns.map((c) => ({ content: normalizeTextValue(c?.content) }))
+      : []
+
+    // Ensure correct number of columns for layout
+    while (columns.length < layoutDef.cols) columns.push({ content: '' })
+    if (columns.length > layoutDef.cols) columns.length = layoutDef.cols
+
+    const wrapper = document.createElement('div')
+    wrapper.classList.add('oe-columns')
+    wrapper.contentEditable = 'false'
+    wrapper.tabIndex = -1
+
+    stateMap.set(wrapper, { data: { columns, layout } })
+
+    this.#build(wrapper, context)
+    return wrapper
+  }
+
+  /**
+   * Serialize the current block DOM into document data.
+   * @param {HTMLElement} element @returns {{ columns: Array<{ content: string }>, layout: string }}
+   */
+  save(element) {
+    this.#syncFromDom(element)
+    const s = stateMap.get(element)
+    if (!s) return { columns: [], layout: '1-1' }
+    return {
+      columns: s.data.columns.map((c) => ({ ...c })),
+      layout: s.data.layout,
+    }
+  }
+
+  /**
+   * Check whether serialized data satisfies this block's schema.
+   * @param {Record<string, unknown>} data @returns {boolean}
+   */
+  validate(data) {
+    return validateColumnsData(data)
+  }
+
+  /**
+   * Check whether the block has no meaningful user content.
+   * @param {HTMLElement} element @returns {boolean}
+   */
+  isEmpty(element) {
+    this.#syncFromDom(element)
+    const s = stateMap.get(element)
+    if (!s) return true
+    return s.data.columns.every((c) => !c.content.trim())
+  }
+
+  /**
+   * Extract neutral rich text that can initialize another block type.
+   * @param {HTMLElement} element @returns {{ text: string }}
+   */
+  exportData(element) {
+    this.#syncFromDom(element)
+    const s = stateMap.get(element)
+    if (!s) return { text: '' }
+    return { text: s.data.columns.map((c) => c.content).filter(Boolean).join('<br>') }
+  }
+
+  /**
+   * Release listeners and resources owned by this block element.
+   * @param {HTMLElement} element @returns {void}
+   */
+  destroy(element) {
+    stateMap.delete(element)
+  }
+
+  // ── Private ─────────────────────────────────────────────────────────────────
+
+  /** @param {HTMLElement} wrapper @returns {void} */
+  #syncFromDom(wrapper) {
+    const s = stateMap.get(wrapper)
+    if (!s) return
+    const colEls = wrapper.querySelectorAll('.oe-columns__col')
+    colEls.forEach((el, i) => {
+      const col = s.data.columns[i]
+      if (col) {
+        col.content = sanitizeHtml(el.innerHTML?.trim() || '')
+      }
+    })
+  }
+
+  /**
+   * @param {HTMLElement} wrapper
+   * @param {import('../../core/types').BlockMutationContext} context
+   * @returns {void}
+   */
+  #build(wrapper, context) {
+    const s = stateMap.get(wrapper)
+    if (!s) return
+    wrapper.innerHTML = ''
+
+    const layoutDef = /** @type {{ cols: number, grid: string, label: string }} */ (LAYOUTS[s.data.layout] || LAYOUTS['1-1'])
+
+    // Grid container
+    const grid = document.createElement('div')
+    grid.className = 'oe-columns__grid'
+    grid.style.gridTemplateColumns = layoutDef.grid
+
+    for (let i = 0; i < s.data.columns.length; i++) {
+      const colData = /** @type {{content: string}} */ (s.data.columns[i])
+      const col = document.createElement('div')
+      col.className = 'oe-columns__col'
+      col.contentEditable = 'true'
+      col.dataset.placeholder = `${this._t('colPlaceholder', 'Column')} ${i + 1}`
+      if (colData.content) {
+        col.innerHTML = sanitizeHtml(colData.content)
+      }
+      col.addEventListener('keydown', (e) => {
+        if (e.key === 'Enter' && !e.shiftKey) { e.stopPropagation(); return }
+        // Let modifier combos (Ctrl+Z, Ctrl+A, etc.) bubble to ShortcutRegistry
+        if (!e.ctrlKey && !e.metaKey) e.stopPropagation()
+      })
+      grid.appendChild(col)
+    }
+
+    wrapper.appendChild(grid)
+
+    // Layout selector
+    const actions = document.createElement('div')
+    actions.className = 'oe-columns__actions'
+
+    for (const key of LAYOUT_KEYS) {
+      const btn = document.createElement('button')
+      btn.type = 'button'
+      btn.className = `oe-columns__layout-btn${s.data.layout === key ? ' oe-columns__layout-btn--active' : ''}`
+      btn.innerHTML = LAYOUT_ICONS[key] || ''
+      btn.title = LAYOUTS[key]?.label || ''
+      btn.setAttribute('aria-label', `${this._t('layout', 'Layout')} ${btn.title}`)
+      btn.setAttribute('aria-pressed', String(s.data.layout === key))
+      btn.addEventListener('mousedown', (e) => e.preventDefault())
+      btn.addEventListener('click', () => {
+        context.mutate(() => {
+          this.#syncFromDom(wrapper)
+          this.#changeLayout(wrapper, key, context)
+        })
+      })
+      actions.appendChild(btn)
+    }
+
+    wrapper.appendChild(actions)
+  }
+
+  /**
+   * @param {HTMLElement} wrapper
+   * @param {string} newLayout
+   * @param {import('../../core/types').BlockMutationContext} context
+   * @returns {void}
+   */
+  #changeLayout(wrapper, newLayout, context) {
+    const newDef = LAYOUTS[newLayout]
+    if (!newDef) return
+
+    const s = stateMap.get(wrapper)
+    if (!s) return
+
+    // Adjust columns count
+    while (s.data.columns.length < newDef.cols) {
+      s.data.columns.push({ content: '' })
+    }
+    if (s.data.columns.length > newDef.cols) {
+      // Merge overflow into last column
+      const overflow = s.data.columns.splice(newDef.cols)
+      const last = /** @type {{content: string}} */ (s.data.columns[newDef.cols - 1])
+      for (const col of overflow) {
+        if (col.content.trim()) {
+          last.content = last.content ? last.content + '<br>' + col.content : col.content
+        }
+      }
+    }
+
+    s.data.layout = newLayout
+    this.#build(wrapper, context)
+  }
+}

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

@@ -0,0 +1,6 @@
+declare const _default: {
+    'plugin.columns.title': string;
+    'plugin.columns.colPlaceholder': string;
+    'plugin.columns.layout': string;
+};
+export default _default;

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

@@ -0,0 +1,5 @@
+export default {
+  'plugin.columns.title': 'Columns',
+  'plugin.columns.colPlaceholder': 'Column',
+  'plugin.columns.layout': 'Layout',
+}

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

@@ -0,0 +1,6 @@
+declare const _default: {
+    'plugin.columns.title': string;
+    'plugin.columns.colPlaceholder': string;
+    'plugin.columns.layout': string;
+};
+export default _default;

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

@@ -0,0 +1,5 @@
+export default {
+  'plugin.columns.title': 'Колонки',
+  'plugin.columns.colPlaceholder': 'Колонка',
+  'plugin.columns.layout': 'Макет',
+}

package/dist/plugins/delimiter/README.md

@@ -0,0 +1,48 @@
+# Delimiter block plugin
+
+A visual section separator with no content payload.
+
+## Install and register
+
+```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()],
+})
+```
+
+The registered block type is `delimiter`. The class is also exported by the complete `@shelamkoff/rector/plugins` preset and can be loaded through `@shelamkoff/rector/plugins/async`.
+
+## Data
+
+```json
+{}
+```
+
+The block accepts an object as `data` and serializes it as `{}`. It has no configurable data fields; non-object values fail validation.
+
+## 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
+
+Toolbox insertion and document rendering.
+
+## 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/delimiter`. The VitePress guide documents configuration, commands and history, extension contracts, document migrations, styling, security, and lifecycle in a sequential form.