@shelamkoff/rector 1.0.0

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * Delimiter block renderer
+ * @param {string} classPrefix
+ * @param {Record<string, import('../../../shared/localeTypes.js').LocaleValue>} _locale
+ * @returns {import('../../types.js').BlockRenderer<import('../../types.js').DelimiterBlock>}
+ */
+export function createDelimiterRenderer(classPrefix: string, _locale: Record<string, import("../../../shared/localeTypes.js").LocaleValue>): import("../../types.js").BlockRenderer<import("../../types.js").DelimiterBlock>;

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

@@ -0,0 +1,28 @@
+// @ts-check
+import { resolvePath } from '../../../shared/resolvePath.js'
+
+const styles = resolvePath('./styles.css', import.meta.url)
+
+/**
+ * Delimiter block renderer
+ * @param {string} classPrefix
+ * @param {Record<string, import('../../../shared/localeTypes').LocaleValue>} _locale
+ * @returns {import('../../types').BlockRenderer<import('../../types').DelimiterBlock>}
+ */
+export function createDelimiterRenderer(classPrefix, _locale) {
+  return {
+    type: 'delimiter',
+    styles: [styles],
+
+    /**
+     * @param {import('../../types').DelimiterBlock} _block
+     * @param {import('../../types').InlineParser} _parseInline
+     * @returns {HTMLElement}
+     */
+    render(_block, _parseInline) {
+      const hr = document.createElement('hr')
+      hr.className = `${classPrefix}-delimiter`
+      return hr
+    },
+  }
+}

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

@@ -0,0 +1,12 @@
+.editor-delimiter {
+  margin: 38px auto;
+  border: none;
+  text-align: center;
+}
+
+.editor-delimiter::after {
+  content: '***';
+  font-size: 1.8rem;
+  letter-spacing: 0.24em;
+  color: var(--er-text-2, #666);
+}

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

@@ -0,0 +1,35 @@
+# Embed renderer
+
+Renderer for the `embed` 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 { createEmbedRenderer } from '@shelamkoff/rector/renderer/renderers/embed'
+
+const renderer = createEditorRenderer({ classPrefix: 'article', blockTypes: [] })
+renderer.registerRenderer(createEmbedRenderer('article', {}))
+const rendererStyles = renderer.injectStyles()
+renderer.renderTo(documentData, document.querySelector('#article'))
+
+// When the mounted output is removed:
+renderer.destroy()
+rendererStyles.destroy()
+```
+
+## Typical data
+
+```json
+{ "service": "youtube", "videoId": "dQw4w9WgXcQ", "caption": "Caption", "cover": "", "title": "", "duration": "" }
+```
+
+The [embed plugin field reference](../../../plugins/embed/README.md#field-reference) is the canonical persisted-data contract shared by the editor and renderer.
+
+The shared player builds output only for supported providers and the caption uses the inline parser. The play listener is released with the rendered root. The renderer declares one stylesheet.
+
+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/embed/README.ru.md

@@ -0,0 +1,35 @@
+# Рендерер Embed
+
+Преобразует сохранённый блок `embed` в принадлежащий рендереру DOM.
+
+Синхронная точка входа `@shelamkoff/rector/renderer` включает все встроенные рендереры, поэтому до её импорта установите `@shelamkoff/carousel` и `@shelamkoff/expose`. Значение `blockTypes: []` отключает создание встроенных рендереров, но не меняет правила разрешения модулей ESM.
+
+## Использование
+
+```js
+import { createEditorRenderer } from '@shelamkoff/rector/renderer'
+import { createEmbedRenderer } from '@shelamkoff/rector/renderer/renderers/embed'
+
+const renderer = createEditorRenderer({ classPrefix: 'article', blockTypes: [] })
+renderer.registerRenderer(createEmbedRenderer('article', {}))
+const rendererStyles = renderer.injectStyles()
+renderer.renderTo(documentData, document.querySelector('#article'))
+
+// При удалении добавленного результата:
+renderer.destroy()
+rendererStyles.destroy()
+```
+
+## Типичные данные
+
+```json
+{ "service": "youtube", "videoId": "dQw4w9WgXcQ", "caption": "Подпись", "cover": "", "title": "", "duration": "" }
+```
+
+Канонический контракт сохраняемых данных, общий для редактора и рендерера, приведён в [справочнике полей плагина встраиваемого содержимого](../../../plugins/embed/README.ru.md#поля-данных).
+
+Общий модуль плеера создаёт вывод только для поддерживаемых сервисов, а подпись проходит обработчик внутристрочной разметки. Обработчик запуска освобождается вместе с результатом. Рендерер объявляет одну таблицу стилей.
+
+Если рендерер объявляет стили, показанный выше явный вызов `EditorRenderer.injectStyles()` подключает их, а возвращённый владелец освобождает.
+
+Жизненный цикл, восстановление внутристрочных виджетов, стили и границы безопасности описаны в последовательном руководстве VitePress.

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

@@ -0,0 +1,8 @@
+/**
+ * Embed block renderer — uses shared buildPlayer() for identical DOM structure.
+ * Data: { service, videoId, caption?, cover?, title?, duration? }
+ * @param {string} classPrefix
+ * @param {Record<string, import('../../../shared/localeTypes.js').LocaleValue>} locale
+ * @returns {import('../../types.js').BlockRenderer<import('../../types.js').EmbedBlock>}
+ */
+export function createEmbedRenderer(classPrefix: string, locale: Record<string, import("../../../shared/localeTypes.js").LocaleValue>): import("../../types.js").BlockRenderer<import("../../types.js").EmbedBlock>;

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

@@ -0,0 +1,66 @@
+// @ts-check
+import { buildPlayer } from '../../../shared/embedPlayer.js'
+import { resolvePath } from '../../../shared/resolvePath.js'
+
+const styles = resolvePath('./styles.css', import.meta.url)
+
+const ICON_PLAY = `<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 4v16a1 1 0 0 0 1.524 .852l13 -8a1 1 0 0 0 0 -1.704l-13 -8a1 1 0 0 0 -1.524 .852z" stroke-width="0" fill="currentColor"/></svg>`
+
+/**
+ * Embed block renderer — uses shared buildPlayer() for identical DOM structure.
+ * Data: { service, videoId, caption?, cover?, title?, duration? }
+ * @param {string} classPrefix
+ * @param {Record<string, import('../../../shared/localeTypes').LocaleValue>} locale
+ * @returns {import('../../types').BlockRenderer<import('../../types').EmbedBlock>}
+ */
+export function createEmbedRenderer(classPrefix, locale) {
+  /** @param {string} key @param {string} fallback */
+  const t = (key, fallback) => typeof locale?.[key] === 'string' ? locale[key] : fallback
+  return {
+    type: 'embed',
+    styles: [styles],
+
+    /**
+     * @param {import('../../types').EmbedBlock} block
+     * @param {import('../../types').InlineParser} parseInline
+     * @returns {HTMLElement}
+     */
+    render(block, parseInline) {
+      const { service, videoId, caption, cover, title, duration } = block.data
+
+      const figure = document.createElement('figure')
+      figure.className = `${classPrefix}-embed`
+      if (!videoId) return figure
+
+      // Build player using shared module (same DOM as editor plugin)
+      const result = buildPlayer({
+        service,
+        videoId,
+        cover,
+        title,
+        duration,
+        classPrefix,
+        playIcon: ICON_PLAY,
+        playLabel: t('renderer.embed.play', 'Play video'),
+        videoLabel: t('renderer.embed.video', 'Video'),
+      })
+
+      // Wire play button
+      /** @type {HTMLElement | null} */
+      const playBtn = result.player.querySelector(`.${classPrefix}-embed__play-btn`)
+      playBtn?.addEventListener('click', () => result.play())
+
+      figure.appendChild(result.player)
+
+      // Caption
+      if (caption) {
+        const figcaption = document.createElement('figcaption')
+        figcaption.className = `${classPrefix}-embed__caption`
+        figcaption.appendChild(parseInline(caption))
+        figure.appendChild(figcaption)
+      }
+
+      return figure
+    },
+  }
+}

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

@@ -0,0 +1,217 @@
+/* ── Embed (video player) ─────────────────────────────────────────────────── */
+
+.editor-embed__player {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  padding: 0;
+  overflow: hidden;
+  background-color: var(--er-surface, #2a2b2d);
+  border-radius: 6px;
+  container-type: inline-size;
+}
+
+.editor-embed__player::before {
+  display: block;
+  content: "";
+  padding-top: 56.25%;
+}
+
+/* ── Preview image ───────────────────────────────────────────────────────── */
+
+.editor-embed__preview {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  border: 0;
+  border-radius: 6px;
+  object-fit: cover;
+  z-index: 2;
+}
+
+@keyframes editor-embed-bounceOut {
+  20% { transform: scale3d(0.9, 0.9, 0.9); }
+  50%, 55% { opacity: 1; transform: scale3d(1.1, 1.1, 1.1); }
+  100% { opacity: 0; transform: scale3d(0, 0, 0); }
+}
+
+.editor-embed__player--playing .editor-embed__preview {
+  animation-name: editor-embed-bounceOut;
+  animation-duration: 1.5s;
+  animation-fill-mode: both;
+}
+
+/* ── Iframe ──────────────────────────────────────────────────────────────── */
+
+.editor-embed__iframe {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  border: 0;
+  z-index: 1;
+}
+
+.editor-embed__iframe iframe {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  border: 0;
+  border-radius: 6px;
+}
+
+/* ── Play button ─────────────────────────────────────────────────────────── */
+
+@keyframes editor-embed-pulse {
+  0% { transform: scale(1); }
+  50% { transform: scale(1.08); }
+  100% { transform: scale(1); }
+}
+
+.editor-embed__play-btn {
+  position: absolute;
+  background-color: var(--er-embed-play-bg);
+  border-radius: 50%;
+  padding: 2rem;
+  z-index: 3;
+  border: none;
+  outline: none;
+  cursor: pointer;
+  transition: ease 1s;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  -webkit-appearance: none;
+  appearance: none;
+}
+
+.editor-embed__play-btn:hover {
+  animation-iteration-count: infinite;
+  animation-name: editor-embed-pulse;
+  animation-duration: 1s;
+  opacity: 0.75;
+}
+
+.editor-embed__play-btn svg {
+  width: 36px;
+  height: 36px;
+  color: var(--er-embed-play-color);
+}
+
+@container (width <= 500px) {
+  .editor-embed__play-btn { padding: 1.5rem; }
+  .editor-embed__play-btn svg { width: 28px; height: 28px; }
+}
+
+@container (width <= 400px) {
+  .editor-embed__play-btn { padding: 1rem; }
+  .editor-embed__play-btn svg { width: 22px; height: 22px; }
+}
+
+.editor-embed__player--playing .editor-embed__play-btn {
+  transform: scale(0);
+  opacity: 0;
+  visibility: hidden;
+  z-index: -1;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .editor-embed__play-btn,
+  .editor-embed__player--playing .editor-embed__preview {
+    transition: none;
+    animation: none;
+  }
+}
+
+/* ── Title overlay (top-left) ────────────────────────────────────────────── */
+
+.editor-embed__title {
+  position: absolute;
+  top: 0.75rem;
+  left: 0.75rem;
+  z-index: 4;
+  max-width: 260px;
+  padding: 0.25rem 0.625rem;
+  font-size: 0.75rem;
+  font-weight: 600;
+  color: #fff;
+  background: rgba(0, 0, 0, 0.55);
+  border-radius: 0.375rem;
+  backdrop-filter: blur(4px);
+  pointer-events: none;
+  line-height: 1.3;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+/* ── Duration overlay (bottom-right) ─────────────────────────────────────── */
+
+.editor-embed__duration {
+  position: absolute;
+  bottom: 0.75rem;
+  right: 0.75rem;
+  z-index: 4;
+  padding: 0.125rem 0.5rem;
+  font-size: 0.75rem;
+  font-weight: 600;
+  color: #fff;
+  background: rgba(0, 0, 0, 0.7);
+  border-radius: 0.25rem;
+  pointer-events: none;
+  line-height: 1.4;
+  letter-spacing: 0.02em;
+  font-variant-numeric: tabular-nums;
+}
+
+.editor-embed__player--playing .editor-embed__title,
+.editor-embed__player--playing .editor-embed__duration {
+  display: none;
+}
+
+/* ── Placeholder (Vimeo — no preview) ────────────────────────────────────── */
+
+.editor-embed__placeholder {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--er-embed-placeholder);
+  z-index: 2;
+  border-radius: 6px;
+}
+
+.editor-embed__placeholder svg {
+  width: 64px;
+  height: 64px;
+  color: var(--er-embed-placeholder-icon);
+}
+
+.editor-embed__player--playing .editor-embed__placeholder {
+  animation-name: editor-embed-bounceOut;
+  animation-duration: 1.5s;
+  animation-fill-mode: both;
+}
+
+/* ── Caption ─────────────────────────────────────────────────────────────── */
+
+.editor-embed__caption {
+  margin-top: 8px;
+  font-size: 13px;
+  color: var(--er-text-3);
+  text-align: center;
+}

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

@@ -0,0 +1,41 @@
+# Gallery renderer
+
+Renderer for the `gallery` block. It converts persisted block data into renderer-owned DOM.
+The Gallery renderer directly uses `@shelamkoff/expose` and its `exposeStylesUrl` 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 { createGalleryRenderer } from '@shelamkoff/rector/renderer/renderers/gallery'
+
+const renderer = createEditorRenderer({ classPrefix: 'article', blockTypes: [] })
+renderer.registerRenderer(createGalleryRenderer('article', {}))
+const rendererStyles = renderer.injectStyles()
+renderer.renderTo(documentData, document.querySelector('#article'))
+
+// When the mounted output is removed:
+renderer.destroy()
+rendererStyles.destroy()
+```
+
+## Typical data
+
+```json
+{
+  "images": [{ "url": "https://cdn.example/a.jpg", "caption": "A" }],
+  "layout": "auto",
+  "styles": { "gap": "8px", "borderRadius": "8px", "height": "420px" },
+  "options": { "loop": true, "zoom": true, "navigation": true, "captions": true, "thumbnails": true, "fullscreen": true, "autoplayInterval": 3000 }
+}
+```
+
+The complete persisted-data contract, including layouts, defaults, and validation constraints, is defined by the matching [Gallery plugin](../../../plugins/gallery/README.md#field-reference).
+
+Image sources use the media URL policy. The renderer owns its Expose viewers and image-readiness listeners; `destroy()` releases them. It declares gallery and Expose 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/gallery/README.ru.md

@@ -0,0 +1,41 @@
+# Рендерер Gallery
+
+Преобразует сохранённый блок `gallery` в принадлежащий рендереру DOM.
+Рендерер Gallery напрямую использует `@shelamkoff/expose` и экспорт пакета `exposeStylesUrl`.
+
+Синхронная точка входа `@shelamkoff/rector/renderer` включает все встроенные рендереры, поэтому до её импорта установите `@shelamkoff/carousel` и `@shelamkoff/expose`. Значение `blockTypes: []` отключает создание встроенных рендереров, но не меняет правила разрешения модулей ESM.
+
+## Использование
+
+```js
+import { createEditorRenderer } from '@shelamkoff/rector/renderer'
+import { createGalleryRenderer } from '@shelamkoff/rector/renderer/renderers/gallery'
+
+const renderer = createEditorRenderer({ classPrefix: 'article', blockTypes: [] })
+renderer.registerRenderer(createGalleryRenderer('article', {}))
+const rendererStyles = renderer.injectStyles()
+renderer.renderTo(documentData, document.querySelector('#article'))
+
+// При удалении добавленного результата:
+renderer.destroy()
+rendererStyles.destroy()
+```
+
+## Типичные данные
+
+```json
+{
+  "images": [{ "url": "https://cdn.example/a.jpg", "caption": "A" }],
+  "layout": "auto",
+  "styles": { "gap": "8px", "borderRadius": "8px", "height": "420px" },
+  "options": { "loop": true, "zoom": true, "navigation": true, "captions": true, "thumbnails": true, "fullscreen": true, "autoplayInterval": 3000 }
+}
+```
+
+Полный контракт сохранённых данных, включая раскладки, значения по умолчанию и ограничения проверки, описан в [справочнике полей плагина Gallery](../../../plugins/gallery/README.ru.md#поля-данных).
+
+Адреса изображений проходят политику URL для медиафайлов. Рендерер владеет экземплярами `Expose` и обработчиками готовности изображений; `destroy()` освобождает их. Он объявляет стили галереи и `Expose`.
+
+Если рендерер объявляет стили, показанный выше явный вызов `EditorRenderer.injectStyles()` подключает их, а возвращённый владелец освобождает.
+
+Жизненный цикл, восстановление внутристрочных виджетов, стили и границы безопасности описаны в последовательном руководстве VitePress.

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

@@ -0,0 +1,8 @@
+/**
+ * Create the gallery renderer and own every opened Expose instance.
+ * @param {string} classPrefix
+ * @param {Record<string, import('../../../shared/localeTypes.js').LocaleValue>} locale
+ * @returns {import('../../types.js').BlockRenderer<import('../../types.js').GalleryBlock>}
+ */
+export function createGalleryRenderer(classPrefix: string, locale: Record<string, import("../../../shared/localeTypes.js").LocaleValue>): import("../../types.js").BlockRenderer<import("../../types.js").GalleryBlock>;
+export type Orientation = "L" | "P" | "S";