@shelamkoff/rector 1.0.0

package/dist/renderer/renderers/link-preview/styles.css

@@ -0,0 +1,246 @@
+/* =============================================================================
+   LinkPreview renderer — 7 card templates
+   ============================================================================= */
+
+.editor-link-preview {
+    display: flex;
+    overflow: hidden;
+    border-radius: 0.625rem;
+    border: 1px solid var(--er-border);
+    text-decoration: none;
+    color: inherit;
+    transition: border-color 0.15s;
+}
+
+.editor-link-preview:hover {
+    border-color: var(--er-border-hover);
+}
+
+.editor-link-preview__content {
+    flex: 1;
+    min-width: 0;
+    padding: 14px 18px;
+    display: flex;
+    flex-direction: column;
+    justify-content: center;
+    gap: 4px;
+}
+
+.editor-link-preview__title {
+    font-size: 14px;
+    font-weight: 600;
+    color: var(--er-text-1);
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+.editor-link-preview__desc {
+    font-size: 13px;
+    color: var(--er-text-3);
+    line-height: 1.5;
+    display: -webkit-box;
+    -webkit-line-clamp: 2;
+    -webkit-box-orient: vertical;
+    overflow: hidden;
+}
+
+.editor-link-preview__domain {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    font-size: 12px;
+    color: var(--er-text-3);
+    margin-top: 4px;
+}
+
+.editor-link-preview__favicon {
+    width: 14px;
+    height: 14px;
+    border-radius: 2px;
+    flex-shrink: 0;
+}
+
+.editor-link-preview__external {
+    display: inline-flex;
+    opacity: 0.5;
+}
+
+.editor-link-preview__image {
+    flex-shrink: 0;
+}
+
+.editor-link-preview__image img {
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+    display: block;
+}
+
+/* ── Template: horizontal (image right) ─────────────────────────────────── */
+
+.editor-link-preview--horizontal {
+    flex-direction: row;
+}
+
+.editor-link-preview--horizontal .editor-link-preview__image {
+    width: 200px;
+}
+
+/* ── Template: compact (small image left) ───────────────────────────────── */
+
+.editor-link-preview--compact {
+    flex-direction: row;
+    align-items: center;
+}
+
+.editor-link-preview--compact .editor-link-preview__image {
+    width: 48px;
+    height: 48px;
+    flex-shrink: 0;
+    order: -1;
+    margin: 10px 0 10px 14px;
+    border-radius: 6px;
+    overflow: hidden;
+}
+
+.editor-link-preview--compact .editor-link-preview__content {
+    padding: 10px 14px;
+}
+
+.editor-link-preview--compact .editor-link-preview__title {
+    font-size: 13px;
+}
+
+.editor-link-preview--compact .editor-link-preview__desc {
+    -webkit-line-clamp: 1;
+    font-size: 12px;
+}
+
+/* ── Template: large-top (image top) ────────────────────────────────────── */
+
+.editor-link-preview--large-top {
+    flex-direction: column;
+}
+
+.editor-link-preview--large-top .editor-link-preview__image {
+    width: 100%;
+    height: 180px;
+}
+
+/* ── Template: minimal (no image, accent border) ────────────────────────── */
+
+.editor-link-preview--minimal {
+    flex-direction: row;
+    border-left: 3px solid var(--er-accent);
+}
+
+.editor-link-preview--minimal .editor-link-preview__content {
+    padding: 12px 16px;
+}
+
+.editor-link-preview--minimal .editor-link-preview__title {
+    font-size: 13px;
+}
+
+.editor-link-preview--minimal .editor-link-preview__desc {
+    font-size: 12px;
+    -webkit-line-clamp: 1;
+}
+
+/* ── Template: twitter (image top, domain above title) ──────────────────── */
+
+.editor-link-preview--twitter {
+    flex-direction: column;
+    background: var(--er-surface);
+}
+
+.editor-link-preview--twitter .editor-link-preview__image {
+    width: 100%;
+    height: 180px;
+    border-bottom: 1px solid var(--er-border);
+}
+
+.editor-link-preview--twitter .editor-link-preview__content {
+    padding: 12px 14px;
+    gap: 2px;
+}
+
+.editor-link-preview--twitter .editor-link-preview__domain {
+    order: -1;
+    margin-top: 0;
+    margin-bottom: 2px;
+    font-size: 11px;
+    text-transform: uppercase;
+    letter-spacing: 0.04em;
+}
+
+.editor-link-preview--twitter .editor-link-preview__title {
+    font-size: 13px;
+    white-space: normal;
+    -webkit-line-clamp: 2;
+    display: -webkit-box;
+    -webkit-box-orient: vertical;
+    overflow: hidden;
+}
+
+.editor-link-preview--twitter .editor-link-preview__desc {
+    font-size: 12px;
+    -webkit-line-clamp: 1;
+}
+
+/* ── Template: notion (large favicon left) ──────────────────────────────── */
+
+.editor-link-preview--notion {
+    flex-direction: row;
+    align-items: center;
+    background: var(--er-surface);
+}
+
+.editor-link-preview__favicon-large {
+    width: 32px;
+    height: 32px;
+    border-radius: 6px;
+    margin: 12px 0 12px 14px;
+    flex-shrink: 0;
+}
+
+.editor-link-preview--notion .editor-link-preview__content {
+    padding: 10px 14px;
+    gap: 0;
+}
+
+.editor-link-preview--notion .editor-link-preview__title {
+    font-size: 13px;
+    font-weight: 500;
+}
+
+.editor-link-preview--notion .editor-link-preview__desc {
+    display: none;
+}
+
+.editor-link-preview--notion .editor-link-preview__domain {
+    margin-top: 1px;
+    font-size: 11px;
+}
+
+/* ── Template: split (50/50) ────────────────────────────────────────────── */
+
+.editor-link-preview--split {
+    flex-direction: row;
+    min-height: 140px;
+}
+
+.editor-link-preview--split .editor-link-preview__image {
+    width: 50%;
+}
+
+.editor-link-preview--split .editor-link-preview__content {
+    width: 50%;
+    padding: 16px 20px;
+}
+
+.editor-link-preview--split .editor-link-preview__title {
+    font-size: 15px;
+    white-space: normal;
+}

package/dist/renderer/renderers/list/README.md

@@ -0,0 +1,33 @@
+# List renderer
+
+Renderer for the `list` block. It converts persisted block data into renderer-owned DOM.
+
+The `@shelamkoff/rector/renderer` entry contains the synchronous built-in preset, so `@shelamkoff/carousel` and `@shelamkoff/expose` must be installed before importing it. Passing `blockTypes: []` prevents default renderer construction but does not change ESM module resolution.
+
+## Usage
+
+```js
+import { createEditorRenderer } from '@shelamkoff/rector/renderer'
+import { createListRenderer } from '@shelamkoff/rector/renderer/renderers/list'
+
+const renderer = createEditorRenderer({ classPrefix: 'article', blockTypes: [] })
+renderer.registerRenderer(createListRenderer('article', {}))
+const rendererStyles = renderer.injectStyles()
+renderer.renderTo(documentData, document.querySelector('#article'))
+
+// When the mounted output is removed:
+renderer.destroy()
+rendererStyles.destroy()
+```
+
+## Typical data
+
+```json
+{ "style": "unordered", "items": ["One", "Two"] }
+```
+
+Every item uses the shared inline parser. The renderer creates only ordered or unordered list markup, declares one stylesheet, and creates no listeners or external instances.
+
+When styles are declared, the explicit `EditorRenderer.injectStyles()` call shown above acquires them and its returned owner releases them.
+
+The VitePress guide documents renderer ownership, inline widget reconstruction, styles, cleanup, and security boundaries.

package/dist/renderer/renderers/list/README.ru.md

@@ -0,0 +1,33 @@
+# Рендерер List
+
+Преобразует сохранённый блок `list` в принадлежащий рендереру DOM.
+
+Синхронная точка входа `@shelamkoff/rector/renderer` включает все встроенные рендереры, поэтому до её импорта установите `@shelamkoff/carousel` и `@shelamkoff/expose`. Значение `blockTypes: []` отключает создание встроенных рендереров, но не меняет правила разрешения модулей ESM.
+
+## Использование
+
+```js
+import { createEditorRenderer } from '@shelamkoff/rector/renderer'
+import { createListRenderer } from '@shelamkoff/rector/renderer/renderers/list'
+
+const renderer = createEditorRenderer({ classPrefix: 'article', blockTypes: [] })
+renderer.registerRenderer(createListRenderer('article', {}))
+const rendererStyles = renderer.injectStyles()
+renderer.renderTo(documentData, document.querySelector('#article'))
+
+// При удалении добавленного результата:
+renderer.destroy()
+rendererStyles.destroy()
+```
+
+## Типичные данные
+
+```json
+{ "style": "unordered", "items": ["Первый пункт", "Второй пункт"] }
+```
+
+Каждый пункт проходит общий обработчик внутристрочной разметки. Рендерер создаёт только нумерованный или маркированный список, объявляет одну таблицу стилей и не создаёт обработчиков или сторонних экземпляров.
+
+Если рендерер объявляет стили, показанный выше явный вызов `EditorRenderer.injectStyles()` подключает их, а возвращённый владелец освобождает.
+
+Жизненный цикл, восстановление внутристрочных виджетов, стили и границы безопасности описаны в последовательном руководстве VitePress.

package/dist/renderer/renderers/list/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * List block renderer for the Rector document format.
+ * Data: { style: 'ordered' | 'unordered', items: string[] }
+ * @param {string} classPrefix
+ * @param {Record<string, import('../../../shared/localeTypes.js').LocaleValue>} _locale
+ * @returns {import('../../types.js').BlockRenderer<import('../../types.js').ListBlock>}
+ */
+export function createListRenderer(classPrefix: string, _locale: Record<string, import("../../../shared/localeTypes.js").LocaleValue>): import("../../types.js").BlockRenderer<import("../../types.js").ListBlock>;

package/dist/renderer/renderers/list/index.js

@@ -0,0 +1,42 @@
+// @ts-check
+import { resolvePath } from '../../../shared/resolvePath.js'
+import { mapListTextFields as mapTextFields } from '../../../shared/mapTextFields.js'
+
+const styles = resolvePath('./styles.css', import.meta.url)
+
+/**
+ * List block renderer for the Rector document format.
+ * Data: { style: 'ordered' | 'unordered', items: string[] }
+ * @param {string} classPrefix
+ * @param {Record<string, import('../../../shared/localeTypes').LocaleValue>} _locale
+ * @returns {import('../../types').BlockRenderer<import('../../types').ListBlock>}
+ */
+export function createListRenderer(classPrefix, _locale) {
+  return {
+    type: 'list',
+    styles: [styles],
+    mapTextFields,
+
+    /**
+     * @param {import('../../types').ListBlock} block
+     * @param {import('../../types').InlineParser} parseInline
+     * @returns {HTMLElement}
+     */
+    render(block, parseInline) {
+      const { style, items } = block.data
+
+      const tag = style === 'ordered' ? 'ol' : 'ul'
+      const list = document.createElement(tag)
+      list.className = `${classPrefix}-list ${classPrefix}-list--${style}`
+
+      for (const item of items) {
+        const li = document.createElement('li')
+        li.className = `${classPrefix}-list__item`
+        li.appendChild(parseInline(item))
+        list.appendChild(li)
+      }
+
+      return list
+    },
+  }
+}

package/dist/renderer/renderers/list/styles.css

@@ -0,0 +1,20 @@
+.editor-list {
+  padding-left: 24px;
+}
+
+.editor-list--ordered {
+  list-style-type: decimal;
+}
+
+.editor-list--unordered {
+  list-style-type: disc;
+}
+
+.editor-list__item {
+  margin-bottom: 8px;
+  color: var(--er-text-2);
+}
+
+.editor-list__item:last-child {
+  margin-bottom: 0;
+}

package/dist/renderer/renderers/paragraph/README.md

@@ -0,0 +1,33 @@
+# Paragraph renderer
+
+Renderer for the `paragraph` block. It converts persisted block data into renderer-owned DOM.
+
+The `@shelamkoff/rector/renderer` entry contains the synchronous built-in preset, so `@shelamkoff/carousel` and `@shelamkoff/expose` must be installed before importing it. Passing `blockTypes: []` prevents default renderer construction but does not change ESM module resolution.
+
+## Usage
+
+```js
+import { createEditorRenderer } from '@shelamkoff/rector/renderer'
+import { createParagraphRenderer } from '@shelamkoff/rector/renderer/renderers/paragraph'
+
+const renderer = createEditorRenderer({ classPrefix: 'article', blockTypes: [] })
+renderer.registerRenderer(createParagraphRenderer('article', {}))
+const rendererStyles = renderer.injectStyles()
+renderer.renderTo(documentData, document.querySelector('#article'))
+
+// When the mounted output is removed:
+renderer.destroy()
+rendererStyles.destroy()
+```
+
+## Typical data
+
+```json
+{ "text": "Hello <strong>world</strong>", "align": "left" }
+```
+
+The `text` field uses the shared inline parser, including supported inline widgets. The renderer declares one stylesheet and creates no listeners or external instances.
+
+When styles are declared, the explicit `EditorRenderer.injectStyles()` call shown above acquires them and its returned owner releases them.
+
+The VitePress guide documents renderer ownership, inline widget reconstruction, styles, cleanup, and security boundaries.

package/dist/renderer/renderers/paragraph/README.ru.md

@@ -0,0 +1,33 @@
+# Рендерер Paragraph
+
+Преобразует сохранённый блок `paragraph` в принадлежащий рендереру DOM.
+
+Синхронная точка входа `@shelamkoff/rector/renderer` включает все встроенные рендереры, поэтому до её импорта установите `@shelamkoff/carousel` и `@shelamkoff/expose`. Значение `blockTypes: []` отключает создание встроенных рендереров, но не меняет правила разрешения модулей ESM.
+
+## Использование
+
+```js
+import { createEditorRenderer } from '@shelamkoff/rector/renderer'
+import { createParagraphRenderer } from '@shelamkoff/rector/renderer/renderers/paragraph'
+
+const renderer = createEditorRenderer({ classPrefix: 'article', blockTypes: [] })
+renderer.registerRenderer(createParagraphRenderer('article', {}))
+const rendererStyles = renderer.injectStyles()
+renderer.renderTo(documentData, document.querySelector('#article'))
+
+// При удалении добавленного результата:
+renderer.destroy()
+rendererStyles.destroy()
+```
+
+## Типичные данные
+
+```json
+{ "text": "Привет, <strong>мир</strong>", "align": "left" }
+```
+
+Поле `text` проходит общий обработчик внутристрочной разметки, включая поддерживаемые внутристрочные виджеты. Рендерер объявляет одну таблицу стилей и не создаёт обработчиков или сторонних экземпляров.
+
+Если рендерер объявляет стили, показанный выше явный вызов `EditorRenderer.injectStyles()` подключает их, а возвращённый владелец освобождает.
+
+Жизненный цикл, восстановление внутристрочных виджетов, стили и границы безопасности описаны в последовательном руководстве VitePress.

package/dist/renderer/renderers/paragraph/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Paragraph block renderer for the Rector document format.
+ * @param {string} classPrefix
+ * @param {Record<string, import('../../../shared/localeTypes.js').LocaleValue>} _locale
+ * @returns {import('../../types.js').BlockRenderer<import('../../types.js').ParagraphBlock>}
+ */
+export function createParagraphRenderer(classPrefix: string, _locale: Record<string, import("../../../shared/localeTypes.js").LocaleValue>): import("../../types.js").BlockRenderer<import("../../types.js").ParagraphBlock>;

package/dist/renderer/renderers/paragraph/index.js

@@ -0,0 +1,35 @@
+// @ts-check
+import { resolvePath } from '../../../shared/resolvePath.js'
+import { mapParagraphTextFields as mapTextFields } from '../../../shared/mapTextFields.js'
+
+const styles = resolvePath('./styles.css', import.meta.url)
+
+/**
+ * Paragraph block renderer for the Rector document format.
+ * @param {string} classPrefix
+ * @param {Record<string, import('../../../shared/localeTypes').LocaleValue>} _locale
+ * @returns {import('../../types').BlockRenderer<import('../../types').ParagraphBlock>}
+ */
+export function createParagraphRenderer(classPrefix, _locale) {
+  return {
+    type: 'paragraph',
+    styles: [styles],
+    mapTextFields,
+
+    /**
+     * @param {import('../../types').ParagraphBlock} block
+     * @param {import('../../types').InlineParser} parseInline
+     * @returns {HTMLElement}
+     */
+    render(block, parseInline) {
+      const p = document.createElement('p')
+      p.className = `${classPrefix}-paragraph`
+      const { text, align } = block.data
+      if (align && align !== 'left') {
+        p.style.textAlign = align
+      }
+      p.appendChild(parseInline(text))
+      return p
+    },
+  }
+}

package/dist/renderer/renderers/paragraph/styles.css

@@ -0,0 +1,3 @@
+.editor-paragraph {
+  color: var(--er-text-2);
+}

package/dist/renderer/renderers/person/README.md

@@ -0,0 +1,44 @@
+# Person renderer
+
+Renderer for the `person` block. It converts persisted block data into renderer-owned DOM.
+The Person renderer directly uses `@shelamkoff/carousel` and its `carouselStylesUrl` package export.
+
+The `@shelamkoff/rector/renderer` entry contains the synchronous built-in preset, so `@shelamkoff/carousel` and `@shelamkoff/expose` must be installed before importing it. Passing `blockTypes: []` prevents default renderer construction but does not change ESM module resolution.
+
+## Usage
+
+```js
+import { createEditorRenderer } from '@shelamkoff/rector/renderer'
+import { createPersonRenderer } from '@shelamkoff/rector/renderer/renderers/person'
+
+const renderer = createEditorRenderer({ classPrefix: 'article', blockTypes: [] })
+renderer.registerRenderer(createPersonRenderer('article', {}))
+const rendererStyles = renderer.injectStyles()
+renderer.renderTo(documentData, document.querySelector('#article'))
+
+// When the mounted output is removed:
+renderer.destroy()
+rendererStyles.destroy()
+```
+
+## Typical data
+
+```json
+{
+  "persons": [{
+    "avatar": "https://cdn.example/ada.jpg",
+    "name": "Ada",
+    "role": "Author",
+    "bio": "",
+    "links": [{ "type": "website", "url": "https://example.com" }]
+  }]
+}
+```
+
+The complete persisted-data contract is defined by the matching [Person plugin](../../../plugins/person/README.md#field-reference).
+
+Profile text uses the inline parser; avatars and links use the media and external URL policies. Multi-profile output owns a Carousel and navigation listeners, released in `destroy()`. The renderer declares profile and Carousel styles.
+
+When styles are declared, the explicit `EditorRenderer.injectStyles()` call shown above acquires them and its returned owner releases them.
+
+The VitePress guide documents renderer ownership, inline widget reconstruction, styles, cleanup, and security boundaries.

package/dist/renderer/renderers/person/README.ru.md

@@ -0,0 +1,44 @@
+# Рендерер Person
+
+Преобразует сохранённый блок `person` в принадлежащий рендереру DOM.
+Рендерер Person напрямую использует `@shelamkoff/carousel` и экспорт пакета `carouselStylesUrl`.
+
+Синхронная точка входа `@shelamkoff/rector/renderer` включает все встроенные рендереры, поэтому до её импорта установите `@shelamkoff/carousel` и `@shelamkoff/expose`. Значение `blockTypes: []` отключает создание встроенных рендереров, но не меняет правила разрешения модулей ESM.
+
+## Использование
+
+```js
+import { createEditorRenderer } from '@shelamkoff/rector/renderer'
+import { createPersonRenderer } from '@shelamkoff/rector/renderer/renderers/person'
+
+const renderer = createEditorRenderer({ classPrefix: 'article', blockTypes: [] })
+renderer.registerRenderer(createPersonRenderer('article', {}))
+const rendererStyles = renderer.injectStyles()
+renderer.renderTo(documentData, document.querySelector('#article'))
+
+// При удалении добавленного результата:
+renderer.destroy()
+rendererStyles.destroy()
+```
+
+## Типичные данные
+
+```json
+{
+  "persons": [{
+    "avatar": "https://cdn.example/ada.jpg",
+    "name": "Ada",
+    "role": "Автор",
+    "bio": "",
+    "links": [{ "type": "website", "url": "https://example.com" }]
+  }]
+}
+```
+
+Полный контракт сохранённых данных описан в [справочнике полей плагина Person](../../../plugins/person/README.ru.md#поля-данных).
+
+Текст профиля проходит обработчик внутристрочной разметки, а аватары и ссылки — политики URL для медиафайлов и внешних адресов. Вывод нескольких профилей владеет Carousel и обработчиками навигации, которые освобождаются в `destroy()`. Рендерер объявляет стили профиля и Carousel.
+
+Если рендерер объявляет стили, показанный выше явный вызов `EditorRenderer.injectStyles()` подключает их, а возвращённый владелец освобождает.
+
+Жизненный цикл, восстановление внутристрочных виджетов, стили и границы безопасности описаны в последовательном руководстве VitePress.

package/dist/renderer/renderers/person/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Person/author card block renderer — supports multi-person with carousel
+ * @param {string} classPrefix
+ * @param {Record<string, import('../../../shared/localeTypes.js').LocaleValue>} locale
+ * @returns {import('../../types.js').BlockRenderer<import('../../types.js').PersonBlock>}
+ */
+export function createPersonRenderer(classPrefix: string, locale: Record<string, import("../../../shared/localeTypes.js").LocaleValue>): import("../../types.js").BlockRenderer<import("../../types.js").PersonBlock>;