Make editor updates asynchronous with unified preview API

This commit is contained in:
2026-11-13 15:18:56 +03:00
parent 0d171915d7
commit 3562194d92
30 changed files with 2445 additions and 748 deletions
+2 -2
View File
@@ -5,8 +5,8 @@
# Хеш пароля: docker run --rm -it site-engine site-engine hash-password
# Ключ сессий: docker run --rm site-engine site-engine gen-secret (не короче 32 символов)
SITE_ADMIN_LOGIN=admin
SITE_ADMIN_PASSWORD_HASH=
SITE_SECRET_KEY=
SITE_ADMIN_PASSWORD_HASH=scrypt$32768$8$1$tTVKusjtA1c63XJQ0vnilQ$A8m2kVXr3BknmxkWKHLQINgET3TXh1sSzc408VjdZk4
SITE_SECRET_KEY=please-change-me-for-strong-secret
# Cookie с флагом Secure браузер примет только по https и на http://localhost.
# Если открываете админку по http с другого адреса (http://192.168.1.10:8181), поставьте 0.
+5 -5
View File
@@ -8,8 +8,7 @@
## Куда подключать дизайн
- Публичный сайт-пример: `examples/studio-site/`. Каркас — `layouts/<id>/{layout.yaml,layout.html.j2}`, композиция страниц — `pages/*.md` (включая подкаталоги), страницы записей коллекций — `display/*.yaml`; схемы коллекций — `collections/`, записи — `content/`.
- `examples/ai-studio/` — расширенный кандидат на замену примера, схема остаётся 1: services/scenarios/cases, общие встроенные фрагменты и локальные `entry_cover`, `benefits`, `related`. Списки записей используют `collection_list`, отдельного `catalog` нет. `columns` — контейнер со слотами, `steps` — общий builtin-компонент «Этапы» из дизайна; прежний `card_grid.variant: steps` поддерживается для совместимости. Локальные ID не должны дублировать встроенные. Контракт и отдельный запуск — его `README.md`; проверка — `PYTHONPATH=src python scripts/qa_ai_studio.py`. Базовую фикстуру и рабочий SITE_ROOT не переключать без задачи на перенос.
- Публичный сайт-пример: `examples/site-studio/`. Каркас — `layouts/<id>/{layout.yaml,layout.html.j2}`, композиция страниц — `pages/*.md` (включая подкаталоги), страницы записей коллекций — `display/*.yaml`; схемы коллекций — `collections/`, записи — `content/`.
- Новый независимый публичный пример `examples/site-studio/` переносит разметку/CSS из `design/examples/site-studio/` без локальных дублей builtin и mini-renderer. `entry_card.entry` — ref с `to: '*'`, значение collection/slug; редактор предлагает опубликованные записи включённых коллекций. Fixed ref/refs сохраняют slug + to. `collections/*.yaml:requires` ограничивает публикацию и queries через feature.<имя>, как у courses/posts. Формы сохраняют HTTP 501 с видимым сообщением.
- Встроенные компоненты: `src/site_engine/builtin/fragments/<category>/<id>/` — `fragment.yaml` (поля/слоты), `template.html.j2`, `style.css`, необязательный `script.js`. Категории: `content`, `data`, `forms`, `marketing`, `media`, `system`. Тема — `site.yaml:theme.file` → `theme.yaml` (`schema: 1`, `preset`, `preset_version`, `overrides`); inline `theme.tokens` отклоняется. Resolver/валидация/CSS — `core/theme.py`, immutable пресеты из дизайна — `builtin/themes/v1/`. Без настройки темы используется minimal@1 в памяти. Общие стили — `builtin/base.css`, затем стили фрагментов, вычисленные токены и `builtin/containers.css`.
- Ширина блока — отдельный `layout: {section_width, content_width}`, значения `inherit|boxed|fluid|full`. Отсутствующий layout у hero/cta_banner/site_header/site_footer означает full/inherit, у остальных inherit/inherit; явный inherit берёт глобальный mode темы. `core/block_layout.py` и `layout_marks.py` применяют ширину к корням и собственным `.f-container`/`.container`, не к контейнерам вложенных блоков. Для независимой ширины фона и текста шаблон должен иметь внешний корень и внутренний контейнер; не оборачивай sticky-header общим служебным div. Контролы инспектора перенесены из design; изменение до Save остаётся в памяти вкладки.
@@ -18,6 +17,7 @@
- Админка — отдельный интерфейс: `src/site_engine/web/admin/templates/` и `static/`; runtime — `application.py`, серверный клиент — `api_client.py`, формы — `forms.py`, HTTP-адаптер — `routes.py`; `handlers.py` отвечает за вход/статику, `editor.py` сохраняется для совместимости. Работают HTML-формы с локальным htmx; версия, источник и хеш — `static/VENDOR.md`.
- Направление развития — `specs/001-antirion-admin/{spec,plan,tasks}.md`: браузер/htmx → HTML UI → серверный API-клиент → JSON FastAPI → сервисы. API `/admin/api/v1/` реализован в `web/api/` с Pydantic DTO; ядро сохраняет dataclass. Runtime UI не обходит API при ошибке. Контракт/запуск — `specs/001-antirion-admin/runtime.md`, результаты — `verification.md`.
- Новый перенос — `specs/002-site-studio-theme/{spec,plan,tasks}.md`: этапы 1–5 реализованы, контракт — `runtime.md`, результаты проверок — `verification.md` и `verification-stages-2-3.md`. Отдельный `examples/site-studio/` перенесён на штатный renderer (13 опубликованных страниц); проверка — `scripts/qa_site_studio_002.py`, отчёт — `verification-stage-4.md`. Theme Manager реализован: `/admin/theme`, `/admin/setup/theme`, ThemeService/OnboardingService, snapshot/ETag/CAS и серверный preview overlay. Источники Theme Manager — `design/theme-studio-antirion.html` и `design/assets/theme-studio.css` / `theme-studio.js`; сохраняй исходную композицию и сценарии. Runtime заменяет mock-хранилище API: edits только в памяти вкладки, явный Save, никакого localStorage с палитрой. CSS экрана ограничен theme-content, sample и страница живут в immutable iframe. Workflow — SITE_STATE_DIR/theme-onboarding.json; существующий сайт не перенаправляется. Проверка — scripts/qa_theme_manager_002.py, отчёт — verification-stage-5.md. Первый Save создаёт файл темы и ссылку через ContentService.update_files под одной блокировкой; каждая запись atomic, обычный отказ второго файла откатывает первый, но это не crash-atomic транзакция нескольких файлов. При ошибке после commit API возвращает committed snapshot; не повторяй запись вслепую. Manifest релиза фиксирует документ/effective tokens темы; build fingerprint учитывает ресурсы движка. Исторический каталог релиза не перезаписывается, rollback не меняет workspace.
- Фоновый редактор — `specs/003-background-editor/{spec,plan,tasks,runtime,verification}.md`. Рабочая редакция только в памяти вкладки; явный Save через CAS. Один stateless POST update передаёт source один раз и пакет операций; transform/validate/preview используют один Registry. HTML-адаптер вызывает AdminApi, добавляет компактную серверную проекцию. Не блокируй и не заменяй активные поля при обычных правках; очередь сохраняет новый ввод, preview обновляет существующий iframe/Document. При удалении строки списка учитывай более новые отложенные формы, чтобы не повторить удаление. Проверки — tests/test_editor_updates.py и scripts/qa_editor_updates.py (оба режима preview).
## Правила интеграции
@@ -44,13 +44,13 @@
```bash
PYTHONPATH=src python -m unittest discover -s tests -v
PYTHONPATH=src python -m site_engine.cli validate examples/studio-site
PYTHONPATH=src python -m site_engine.cli build examples/studio-site --out /tmp/studio-dist
PYTHONPATH=src python -m site_engine.cli validate examples/site-studio
PYTHONPATH=src python -m site_engine.cli build examples/site-studio --out /tmp/site-studio-dist
```
Дополнительная приёмка 001: `PYTHONPATH=src python scripts/qa_001.py`, `PYTHONPATH=src python scripts/qa_editor_001.py` (нужен Playwright Chromium), `PYTHONPATH=src python scripts/qa_selection_001.py` (выбор секций и диалоги в обоих режимах превью), `python scripts/verify_package_001.py`; сравнение с исходным дизайном — `scripts/qa_shell_001.py`, `scripts/qa_pages_001.py` и `scripts/qa_builder_001.py`; экспорт контракта — `site-engine export-openapi`.
Это команды `make test`, `make validate-example`, `make build-example` без зависимости от make. Собранный сайт — `/tmp/studio-dist/current/`.
Собранный сайт — `/tmp/site-studio-dist/current/`. Старые тесты и QA ещё ссылаются на удалённый examples/studio-site; для полной регрессии нужна временная базовая фикстура из истории с миграцией файловой темы (см. specs/003-background-editor/verification.md). Не восстанавливай удалённые примеры в рабочем дереве ради тестов. Целевые проверки 003 используют независимую фикстуру и текущий Site Studio.
- Пример сайта используется как фикстура тестов: изменения контента и разметки сверяй с соответствующими проверками. Для изменений поведения обновляй целевые тесты; для чистого CSS проверяй сборку и внешний вид в браузере.
- Черновики могут быть неполными; релиз содержит только `published`. Ошибка сборки не должна менять текущий релиз, публикация и откат переключают `current` атомарно.
+338
View File
@@ -0,0 +1,338 @@
"""Background editor acceptance in real Chromium, with isolated sites and delayed responses."""
from __future__ import annotations
import asyncio
import json
import os
import re
import shutil
import socket
import tempfile
import time
from contextlib import ExitStack
from pathlib import Path
from unittest.mock import patch
from playwright.sync_api import expect, sync_playwright
from qa_001 import PASSWORD, ROOT, serve
from site_engine.services.auth import hash_password
from site_engine.services.preview import PreviewStore
from site_engine.web.app import create_app
from site_engine.web.preview_app import create_preview_app
def reserve():
sock = socket.socket()
sock.bind(("127.0.0.1", 0))
return sock
def idle(page):
page.wait_for_function("""()=>{const e=document.getElementById('document-editor'),p=document.getElementById('preview-result');return e?.dataset.updating==='false'&&p?.dataset.ready==='true'&&p.dataset.revision===e.dataset.revision}""", timeout=25000)
def tree(page, identity):
page.locator(f'[data-tree-scope=page][data-tree-id="{identity}"]').click()
def title(page):
return page.locator('[data-inspector-panel=props] [name="p.title"]')
def heading(page, identity="hero_home"):
return page.frame_locator('#preview-result iframe').locator(f'[data-preview-id="{identity}"] h1, [data-preview-id="{identity}"] h2').first
def main():
out = Path(os.environ.get("QA_EDITOR_UPDATES_OUT", "/tmp/site-engine-editor-updates"))
out.mkdir(parents=True, exist_ok=True)
report = {"runs": [], "page_errors": [], "native_dialogs": []}
with sync_playwright() as pw:
browser = pw.chromium.launch(channel="chromium", headless=True, args=["--no-sandbox", "--no-proxy-server"])
for interactive in (False, True):
run = {"interactive": interactive, "checks": []}
report["runs"].append(run)
with tempfile.TemporaryDirectory(prefix="editor-updates-qa-") as temp, ExitStack() as stack:
work = Path(temp)
site = work / "site"
shutil.copytree(ROOT / "examples/site-studio", site)
original = (site / "pages/index.md").read_bytes()
admin_socket, preview_socket = reserve(), reserve()
admin = f"http://127.0.0.1:{admin_socket.getsockname()[1]}"
preview = f"http://127.0.0.1:{preview_socket.getsockname()[1]}"
stack.enter_context(patch.dict(os.environ, {
"SITE_ROOT": str(site), "SITE_DIST": str(work / "dist"),
"SITE_STATE_DIR": str(work / "state"), "SITE_ADMIN_LOGIN": "admin",
"SITE_ADMIN_PASSWORD_HASH": hash_password(PASSWORD, n=2**10),
"SITE_SECRET_KEY": "editor-background-browser-secret-" * 3,
"SITE_COOKIE_SECURE": "0", "SITE_ADMIN_ORIGIN": admin if interactive else "",
"SITE_PREVIEW_ORIGIN": preview if interactive else "",
}))
app = create_app()
gate = {"delay": 0, "save_delay": 0, "saving": False, "active": 0, "max_active": 0}
@app.middleware("http")
async def delays(request, call_next, gate=gate):
update = request.url.path.startswith('/admin/editor/') and request.url.path.endswith('/update')
save = request.url.path.startswith('/admin/editor/') and request.url.path.endswith('/save')
if update:
gate['active'] += 1
gate['max_active'] = max(gate['max_active'], gate['active'])
try:
if update and gate['delay']:
delay, gate['delay'] = gate['delay'], 0
await asyncio.sleep(delay)
if save and gate['save_delay']:
gate['saving'] = True
await asyncio.sleep(gate['save_delay'])
gate['saving'] = False
return await call_next(request)
finally:
if update:
gate['active'] -= 1
stack.enter_context(serve(app, admin_socket))
if interactive:
stack.enter_context(serve(create_preview_app(), preview_socket))
else:
preview_socket.close()
context = browser.new_context(viewport={"width": 1440, "height": 1050})
stack.callback(context.close)
page = context.new_page()
page.on('pageerror', lambda e: report['page_errors'].append(e.stack))
page.on('dialog', lambda d: (report['native_dialogs'].append(d.message), d.dismiss()))
posts = []
page.on('request', lambda r, posts=posts: posts.append(r.url) if r.method == 'POST' else None)
page.goto(admin + '/admin/login')
page.locator('[name=login]').fill('admin')
page.locator('[name=password]').fill(PASSWORD)
page.get_by_role('button', name='Войти', exact=True).click()
page.goto(admin + '/admin/pages/index')
idle(page)
page.locator('#preview-result iframe').evaluate('e=>e.__qaFrame=true')
page.frame_locator('#preview-result iframe').locator('body').evaluate('e=>e.ownerDocument.__qaDocument=true')
field = title(page)
field.evaluate('e=>e.__qaField=true')
before = len(posts)
page.evaluate("""()=>{window.__updateTiming={};document.addEventListener('input',()=>{window.__updateTiming.start=performance.now()},{once:true});const box=document.getElementById('preview-result');new MutationObserver(()=>{if(box.dataset.revision===document.getElementById('document-editor').dataset.revision&&box.dataset.ready==='true'&&window.__updateTiming.start&&!window.__updateTiming.ms)window.__updateTiming.ms=performance.now()-window.__updateTiming.start}).observe(box,{attributes:true})}""")
start = time.perf_counter()
field.fill('Single background update')
expect(heading(page)).to_have_text('Single background update')
idle(page)
run['input_to_preview_ms'] = round(page.evaluate('window.__updateTiming.ms'),1)
run['playwright_observation_ms'] = round((time.perf_counter() - start) * 1000, 1)
assert posts[before:] == [admin + '/admin/editor/pages/index/update'], posts[before:]
assert title(page).evaluate('e=>e.__qaField===true')
assert page.locator('#preview-result iframe').evaluate('e=>e.__qaFrame===true')
assert page.frame_locator('#preview-result iframe').locator('body').evaluate('e=>e.ownerDocument.__qaDocument===true')
run['checks'].append('one_post_preserves_input_frame_and_document')
# Filling the trailing blank list row must offer another row
# without replacing the active link input or its caret.
action = page.locator('[data-inspector] [name="p.actions.1.target"]')
action.evaluate('e=>e.__qaListInput=true')
action.fill('contacts')
expect(page.locator('[data-inspector] [name="p.actions.2.target"]')).to_be_visible()
idle(page)
assert action.evaluate('e=>e.__qaListInput===true&&document.activeElement===e')
action.press('End')
action.press_sequentially('#contact', delay=5)
idle(page)
expect(action).to_have_value('contacts#contact')
delete = page.locator('[data-inspector] [name="p.actions.1._del"]')
gate['delay'] = 1
delete.check()
page.wait_for_function("()=>document.getElementById('document-editor').dataset.updating==='true'")
title(page).fill('Typing while deleting list row')
idle(page)
expect(title(page)).to_have_value('Typing while deleting list row')
expect(page.locator('[data-inspector] [name="p.actions.0.target"]')).to_have_value('request')
expect(page.locator('[data-inspector] [name="p.actions.1.target"]')).to_have_value('')
assert page.locator('[data-inspector] [name="p.actions.2.target"]').count() == 0
run['checks'].append('list_append_preserves_active_input_and_delete_reindexes')
render_document = PreviewStore.render_document
def unsafe_markup(store, *args, _render_document=render_document, **kwargs):
value = _render_document(store, *args, **kwargs)
value['html'] = value['html'].replace('</body>', '<script nonce="untrusted">window.__qaUntrusted=true</script><svg onload="window.__qaUntrusted=true"></svg></body>')
return value
with patch.object(PreviewStore, 'render_document', unsafe_markup):
title(page).fill('Safe live markup update')
idle(page)
assert page.frame_locator('#preview-result iframe').locator('body').evaluate('e=>!e.ownerDocument.defaultView.__qaUntrusted&&!e.ownerDocument.querySelector("script,[onload],[nonce]")')
if interactive:
page.evaluate("""()=>{const frame=document.querySelector('#preview-result iframe'),root=document.getElementById('document-editor');frame.contentWindow.postMessage({type:'editor:render',snapshot:'0'.repeat(32),revision:Number(root.dataset.revision),next:{snapshot:'a'.repeat(32),revision:Number(root.dataset.revision)+1,html:'<html><body>FORGED UPDATE</body></html>'}},root.dataset.previewOrigin)}""")
page.wait_for_timeout(100)
expect(heading(page)).to_have_text('Safe live markup update')
run['checks'].append('hot_markup_strips_public_scripts_and_bridge_rejects_wrong_snapshot')
gate['delay'] = 2
field.fill('Delayed title')
page.wait_for_function("()=>document.getElementById('document-editor').dataset.updating==='true'")
assert not field.evaluate('e=>!!e.closest("[inert]")')
start = time.perf_counter()
field.press('End')
field.press_sequentially(' while typing', delay=5)
assert time.perf_counter() - start < 1
tree(page, 'services_list')
title(page).fill('Services while waiting')
tree(page, 'hero_home')
expect(title(page)).to_have_value('Delayed title while typing')
title(page).press('End')
title(page).press_sequentially(' final', delay=5)
expect(heading(page)).to_have_text('Delayed title while typing final', timeout=20000)
expect(heading(page, 'services_list')).to_have_text('Services while waiting')
idle(page)
assert gate['max_active'] == 1, gate
assert (site / 'pages/index.md').read_bytes() == original
run['checks'].append('two_second_delay_typing_selection_and_edits_across_sections')
tree(page, 'services_list')
number = page.locator('[data-inspector] [name="p.source.limit"]')
number.fill('invalid number')
expect(page.locator('#request-error')).to_be_visible()
expect(number).to_have_value('invalid number')
before = len(posts)
page.locator('[data-save-document]').click()
page.wait_for_timeout(350)
assert not any(p.endswith('/save') for p in posts[before:])
number.fill('3')
idle(page)
run['checks'].append('validation_preserves_input_and_blocks_save_until_fixed')
tree(page, 'hero_home')
with patch.object(PreviewStore, 'render_document', side_effect=OSError('QA preview failure')):
title(page).fill('Accepted despite preview failure')
expect(page.locator('#request-error [data-request-error-details]')).to_contain_text('preview_failed')
expect(page.locator('#document-source')).to_have_value(re.compile('Accepted despite preview failure'))
expect(heading(page)).to_have_text('Delayed title while typing final')
title(page).fill('Preview recovered')
expect(heading(page)).to_have_text('Preview recovered')
idle(page)
run['checks'].append('preview_failure_retains_accepted_edit_and_old_preview')
def disconnect(route):
route.abort('failed')
page.route('**/admin/editor/pages/index/update', disconnect, times=1)
title(page).fill('Offline edit')
expect(page.locator('#request-error [data-request-error-details]')).to_contain_text('network_error')
expect(title(page)).to_have_value('Offline edit')
page.unroute('**/admin/editor/pages/index/update', disconnect)
title(page).fill('Reconnected edit')
idle(page)
expect(heading(page)).to_have_text('Reconnected edit')
run['checks'].append('network_failure_preserves_input_and_recovers')
gate['delay'] = 1
gate['save_delay'] = 1.5
title(page).fill('Saved captured revision')
page.wait_for_function("()=>document.getElementById('document-editor').dataset.updating==='true'")
page.locator('[data-save-document]').click()
for _ in range(200):
if gate['saving']:
break
page.wait_for_timeout(20)
assert gate['saving']
title(page).fill('New edit during save')
page.wait_for_function("()=>document.getElementById('buffer-status').textContent.includes('несохранённые')")
expect(heading(page)).to_have_text('New edit during save', timeout=20000)
idle(page)
assert 'Saved captured revision' in (site / 'pages/index.md').read_text()
assert 'New edit during save' not in (site / 'pages/index.md').read_text()
expect(page.locator('#buffer-status')).to_have_text('Есть несохранённые правки')
gate['save_delay'] = 0
page.locator('[data-save-document]').click()
expect(page.locator('#buffer-status')).to_have_text('Нет несохранённых изменений')
run['checks'].append('save_drains_updates_and_keeps_newer_input_unsaved')
second = context.new_page()
second.goto(admin + '/admin/pages/index')
idle(second)
title(page).fill('Saved from first tab')
page.locator('[data-save-document]').click()
expect(page.locator('#buffer-status')).to_have_text('Нет несохранённых изменений')
title(second).fill('Conflicting second tab')
second.locator('[data-save-document]').click()
dialog = second.locator('[data-conflict-dialog]')
expect(dialog).to_be_visible()
expect(title(second)).to_have_value('Conflicting second tab')
dialog.locator('input[type=checkbox]').check()
dialog.locator('[data-accept-base]').click()
second.locator('[data-save-document]').click()
expect(second.locator('#buffer-status')).to_have_text('Нет несохранённых изменений')
assert 'Conflicting second tab' in (site / 'pages/index.md').read_text()
second.close()
run['checks'].append('real_two_tab_conflict_and_explicit_rebase')
page.get_by_role('button', name='Эксперт', exact=True).click()
source = page.locator('#document-source')
expect(source).to_be_visible()
source.fill(source.input_value() + '\nQA expert body\n')
idle(page)
page.get_by_role('button', name='Конструктор', exact=True).click()
expect(title(page)).to_be_visible()
page.get_by_role('button', name='Эксперт', exact=True).click()
expect(source).to_be_visible()
before = source.input_value()
source.fill('---\ntitle: [broken\n---\n')
page.wait_for_timeout(650)
expect(page.locator('#document-editor')).to_have_attribute('data-mode', 'expert')
expect(source).to_have_value('---\ntitle: [broken\n---\n')
source.fill(before)
idle(page)
page.get_by_role('button', name='Конструктор', exact=True).click()
run['checks'].append('expert_roundtrip_and_invalid_yaml_recovery')
if page.locator('#request-error').is_visible():
page.locator('[data-close-request-error]').click()
page.locator('[data-catalog-open]').first.click()
page.locator('#builder-catalog-dialog [data-fragment=richtext]').click()
idle(page)
selected = page.locator('[data-tree-scope=page].selected').get_attribute('data-tree-id')
assert re.fullmatch(r'richtext_[a-z0-9]{5}', selected), selected
page.locator('#inspectpane button[name=operation][value=duplicate]').click()
idle(page)
duplicate = page.locator('[data-tree-scope=page].selected').get_attribute('data-tree-id')
assert duplicate != selected
page.locator('#inspectpane button[name=operation][value=delete]').click()
page.locator('#builder-confirm-dialog [data-builder-confirm]').click()
idle(page)
assert page.locator(f'[data-tree-id="{duplicate}"]').count() == 0
run['checks'].append('catalog_duplicate_delete_with_designer_dialog')
page.locator('[data-builder-reset]').click()
page.locator('#builder-confirm-dialog [data-builder-confirm]').click()
idle(page)
page.set_viewport_size({"width": 390, "height": 844})
page.locator('[data-viewport=mobile]').click()
assert not page.evaluate('document.documentElement.scrollWidth>innerWidth+1')
page.screenshot(path=str(out / f"builder-{'bridge' if interactive else 'passive'}-390.png"), full_page=True)
page.set_viewport_size({"width": 1440, "height": 1050})
page.screenshot(path=str(out / f"builder-{'bridge' if interactive else 'passive'}-1440.png"), full_page=True)
run['checks'].append('reset_mobile_layout_and_screenshots')
page.goto(admin + '/admin/content/services/bots')
idle(page)
entry = page.locator('[data-inspector] [name="p.title"]')
entry.fill('Entry background update')
idle(page)
expect(page.frame_locator('#preview-result iframe').locator('h1')).to_have_text('Entry background update')
expect(entry).to_have_value('Entry background update')
run['checks'].append('entry_inspector_background_update')
assert not any(p.endswith(('/transform', '/preview')) for p in posts), posts
run['max_concurrent_updates'] = gate['max_active']
run['posts'] = len(posts)
print(json.dumps(run, ensure_ascii=False), flush=True)
browser.close()
assert not report['page_errors'], report['page_errors']
assert not report['native_dialogs'], report['native_dialogs']
(out / 'browser.json').write_text(json.dumps(report, ensure_ascii=False, indent=2))
print(out / 'browser.json')
if __name__ == '__main__':
main()
+18 -3
View File
@@ -13,7 +13,7 @@ ROOT = Path(__file__).resolve().parents[1]
def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("--site", type=Path, default=ROOT / "examples/studio-site")
parser.add_argument("--site", type=Path, default=ROOT / "examples/site-studio")
args = parser.parse_args()
with tempfile.TemporaryDirectory(prefix="cms-installed-001-") as tmp:
work = Path(tmp)
@@ -97,7 +97,7 @@ with TestClient(app) as client:
assert response.status_code==200
response=client.get('/admin/pages/index')
assert response.status_code==200 and 'document-editor' in response.text
for name in ('antirion-rework.css','shell.css','pages.css','pages.js','admin.css','admin.js','editor.js','builder.css','builder-adapter.css','builder.js','htmx.min.js','theme-studio.css','theme-studio.js'):
for name in ('antirion-rework.css','shell.css','pages.css','pages.js','admin.css','admin.js','editor.js','preview-update.js','builder.css','builder-adapter.css','builder.js','htmx.min.js','theme-studio.css','theme-studio.js'):
assert client.get('/admin/static/'+name).status_code==200,name
assert 'pages-screen' in client.get('/admin/pages').text
cookie=client.cookies.get('se_session')
@@ -113,6 +113,21 @@ with TestClient(app) as client:
assert result.status_code==200,result.text
assert 'preview:ready' in result.text and 'data-preview-id' in result.text
assert 'data-section-width' in result.text and '--container-max:' in result.text
import json
from site_engine.parsing.frontmatter import parse
block_id=parse(source)[0]['regions']['main'][0]['id']
original=source
calls=app.state.api_calls
result=client.post('/admin/editor/pages/index/update',data={'csrf':csrf,'payload':json.dumps({'source':source,'etag':etag_of(source.encode()),'revision':23,'operations':[{'type':'inspector','fields':{'operation':['block'],'block_id':[block_id],'p.title':['Installed background update']}}]})},headers={'Origin':'http://testserver','HX-Request':'true','Accept':'application/json'})
assert result.status_code==200,result.text
updated=result.json()
assert updated['snapshot']['revision']==23 and 'Installed background update' in updated['snapshot']['source']
assert 'Installed background update' in updated['preview']['html'] and updated['projection']
assert app.state.api_calls==calls+1
assert (Path(os.environ['SITE_ROOT'])/'pages/index.md').read_text()==original
with TestClient(create_preview_app()) as preview:
result=preview.get(updated['preview']['url'])
assert result.status_code==200 and 'sitePreviewDocument' in result.text,result.text
assert 'theme-bootstrap' in client.get('/admin/theme').text
import json
document={'schema':1,'preset':'dark','preset_version':1,'overrides':{}}
@@ -125,7 +140,7 @@ with TestClient(app) as client:
assert result.status_code==200 and 'sample-site' in result.text,result.text
assert '--color-primary: #a48bfa' in result.text
assert app.state.api_calls>0
print('installed wheel: all theme presets, build, widths, static, templates, Theme Manager, API, bridge, separate preview OK; design/ absent')
print('installed wheel: all theme presets, build, widths, static, templates, Theme Manager, API, background update, bridge, separate preview OK; design/ absent')
"""
subprocess.run([sys.executable, "-c", program], cwd=work, env=env, check=True)
+685
View File
@@ -253,6 +253,111 @@
"title": "Create",
"type": "object"
},
"EditorUpdate": {
"additionalProperties": false,
"properties": {
"etag": {
"maxLength": 80,
"minLength": 1,
"title": "Etag",
"type": "string"
},
"operations": {
"items": {
"anyOf": [
{
"discriminator": {
"mapping": {
"add": "#/components/schemas/Add",
"block": "#/components/schemas/BlockAction",
"delete": "#/components/schemas/BlockAction",
"duplicate": "#/components/schemas/BlockAction",
"entry_fields": "#/components/schemas/EntryFields",
"metadata": "#/components/schemas/Metadata",
"move": "#/components/schemas/Move",
"toggle": "#/components/schemas/BlockAction"
},
"propertyName": "type"
},
"oneOf": [
{
"$ref": "#/components/schemas/Metadata"
},
{
"$ref": "#/components/schemas/EntryFields"
},
{
"$ref": "#/components/schemas/BlockAction"
},
{
"$ref": "#/components/schemas/Add"
},
{
"$ref": "#/components/schemas/Move"
}
]
},
{
"$ref": "#/components/schemas/InspectorEdit"
}
]
},
"maxItems": 100,
"title": "Operations",
"type": "array"
},
"revision": {
"default": 0,
"minimum": 0.0,
"title": "Revision",
"type": "integer"
},
"source": {
"maxLength": 524288,
"title": "Source",
"type": "string"
}
},
"required": [
"source",
"etag"
],
"title": "EditorUpdate",
"type": "object"
},
"EditorUpdateResult": {
"additionalProperties": false,
"properties": {
"preview": {
"anyOf": [
{
"$ref": "#/components/schemas/Preview"
},
{
"type": "null"
}
]
},
"preview_error": {
"anyOf": [
{
"$ref": "#/components/schemas/ErrorBody"
},
{
"type": "null"
}
]
},
"snapshot": {
"$ref": "#/components/schemas/Snapshot"
}
},
"required": [
"snapshot"
],
"title": "EditorUpdateResult",
"type": "object"
},
"Entries": {
"additionalProperties": false,
"properties": {
@@ -487,6 +592,32 @@
"title": "ErrorEnvelope",
"type": "object"
},
"InspectorEdit": {
"additionalProperties": false,
"properties": {
"fields": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"title": "Fields",
"type": "object"
},
"type": {
"const": "inspector",
"title": "Type",
"type": "string"
}
},
"required": [
"type",
"fields"
],
"title": "InspectorEdit",
"type": "object"
},
"IssueDTO": {
"additionalProperties": false,
"properties": {
@@ -2349,6 +2480,149 @@
"summary": "Entry Transform"
}
},
"/admin/api/v1/collections/{collection}/entries/{identity}/update": {
"post": {
"operationId": "entry_update_admin_api_v1_collections__collection__entries__identity__update_post",
"parameters": [
{
"in": "path",
"name": "collection",
"required": true,
"schema": {
"title": "Collection",
"type": "string"
}
},
{
"in": "path",
"name": "identity",
"required": true,
"schema": {
"title": "Identity",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EditorUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EditorUpdateResult"
}
}
},
"description": "Successful Response"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Bad Request"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Unauthorized"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Forbidden"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Not Found"
},
"405": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Method Not Allowed"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Conflict"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Request Entity Too Large"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Unprocessable Entity"
},
"500": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Internal Server Error"
}
},
"security": [
{
"InternalUiSession": []
}
],
"summary": "Entry Update"
}
},
"/admin/api/v1/collections/{collection}/entries/{identity}/validate": {
"post": {
"operationId": "entry_validate_admin_api_v1_collections__collection__entries__identity__validate_post",
@@ -3054,6 +3328,149 @@
"summary": "Entry Transform"
}
},
"/admin/api/v1/editor/entries/{collection}/{identity}/update": {
"post": {
"operationId": "entry_update_admin_api_v1_editor_entries__collection___identity__update_post",
"parameters": [
{
"in": "path",
"name": "collection",
"required": true,
"schema": {
"title": "Collection",
"type": "string"
}
},
{
"in": "path",
"name": "identity",
"required": true,
"schema": {
"title": "Identity",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EditorUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EditorUpdateResult"
}
}
},
"description": "Successful Response"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Bad Request"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Unauthorized"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Forbidden"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Not Found"
},
"405": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Method Not Allowed"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Conflict"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Request Entity Too Large"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Unprocessable Entity"
},
"500": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Internal Server Error"
}
},
"security": [
{
"InternalUiSession": []
}
],
"summary": "Entry Update"
}
},
"/admin/api/v1/editor/entries/{collection}/{identity}/validate": {
"post": {
"operationId": "entry_validate_admin_api_v1_editor_entries__collection___identity__validate_post",
@@ -3723,6 +4140,140 @@
"summary": "Page Transform"
}
},
"/admin/api/v1/editor/pages/{identity}/update": {
"post": {
"operationId": "page_update_admin_api_v1_editor_pages__identity__update_post",
"parameters": [
{
"in": "path",
"name": "identity",
"required": true,
"schema": {
"title": "Identity",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EditorUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EditorUpdateResult"
}
}
},
"description": "Successful Response"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Bad Request"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Unauthorized"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Forbidden"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Not Found"
},
"405": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Method Not Allowed"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Conflict"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Request Entity Too Large"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Unprocessable Entity"
},
"500": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Internal Server Error"
}
},
"security": [
{
"InternalUiSession": []
}
],
"summary": "Page Update"
}
},
"/admin/api/v1/editor/pages/{identity}/validate": {
"post": {
"operationId": "page_validate_admin_api_v1_editor_pages__identity__validate_post",
@@ -4939,6 +5490,140 @@
"summary": "Page Transform"
}
},
"/admin/api/v1/pages/{identity}/update": {
"post": {
"operationId": "page_update_admin_api_v1_pages__identity__update_post",
"parameters": [
{
"in": "path",
"name": "identity",
"required": true,
"schema": {
"title": "Identity",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EditorUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EditorUpdateResult"
}
}
},
"description": "Successful Response"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Bad Request"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Unauthorized"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Forbidden"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Not Found"
},
"405": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Method Not Allowed"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Conflict"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Request Entity Too Large"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Unprocessable Entity"
},
"500": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorEnvelope"
}
}
},
"description": "Internal Server Error"
}
},
"security": [
{
"InternalUiSession": []
}
],
"summary": "Page Update"
}
},
"/admin/api/v1/pages/{identity}/validate": {
"post": {
"operationId": "page_validate_admin_api_v1_pages__identity__validate_post",
+10
View File
@@ -0,0 +1,10 @@
# План реализации 003
1. **Общий сервисный контракт.** Вынести разбор типизированных полей и операций из HTML-адаптера в сервисный слой, сохранить совместимость прежних форм/маршрутов. Добавить пакетный update с одной загрузкой Registry и откатом всего пакета при ошибке.
2. **Единый запрос.** Добавить DTO и update для страниц/записей. Рендерить preview на подготовленном overlay; независимо вернуть ошибку preview. HTML-адаптер делает один вызов AdminApi и добавляет серверную проекцию интерфейса.
3. **Очередь браузера.** Хранить источник/ETag/revision и несогласованные формы в памяти; сериализовать запросы, объединять ввод, сохранять новые изменения поверх ответов. Выбор секции выполнять локально.
4. **Сохранение DOM.** Оставлять активный инспектор при правках свойств, точечно обновлять строки списков. Структурные изменения применять по серверным шаблонам. Сохранять iframe/Document при обновлении HTML, поддержать пассивный и отдельный origin.
5. **Save и отказы.** Дождаться очереди перед Save, сохранить CAS и явное разрешение конфликта. Не терять новые правки во время Save. Показывать JSON-ошибки и сохранять последнее пригодное preview.
6. **Приёмка.** Серверные проверки одного Registry/API-вызова, отказов и отсутствия записей; браузер с задержками, списками, конфликтом, Expert и записями; wheel вне checkout; OpenAPI и документация.
Дизайн экрана, схема 1 и опубликованный сайт не меняются. Производительность больших документов и объём preview HTML остаются зависимыми от полного серверного рендера; дальнейшая оптимизация требует отдельных измерений.
+73
View File
@@ -0,0 +1,73 @@
# Контракт и устройство 003
## HTTP
JSON API:
- `POST /admin/api/v1/pages/{identity:path}/update`;
- `POST /admin/api/v1/collections/{collection}/entries/{identity}/update`.
Совместимые aliases: `/editor/pages/{identity:path}/update` и `/editor/entries/{collection}/{identity}/update` внутри того же API prefix.
Пример тела:
```json
{
"source": "---\ntitle: Главная\n...",
"etag": "<основание последнего чтения/сохранения>",
"revision": 12,
"operations": [
{
"type": "inspector",
"fields": {
"operation": ["block"],
"block_id": ["hero_home"],
"p.title": ["Новый заголовок"]
}
}
]
}
```
`inspector.fields` — полная успешная форма конкретного инспектора, включая operation/block_id и значения остальных его полей; пример выше сокращён. Значения представлены multimap для checkbox/list/requires. Это позволяет использовать единственный серверный parser схемы. Также принимаются существующие типизированные Action (`metadata`, `entry_fields`, `block`, `add`, `delete`, `toggle`, `duplicate`, `move`). Порядок операций существенен. До 100 операций на запрос; ограничения Buffer сохраняются: source до 524288 символов, revision ≥ 0, etag до 80 символов.
Пустой operations валидирует/рендерит исходник Expert без нормализации его байтов. ETag в update передаётся как основание будущего Save; CAS выполняется только при записи. Revision локальна вкладке и служит для сопоставления ответов, а не серверной версией сохранённого файла.
HTTP 200:
```json
{
"snapshot": {"kind": "page", "id": "index", "source": "...", "etag": "...", "revision": 12, "model": {}, "schema": {}, "issues": [], "path": "pages/index.md"},
"preview": {"url": "...", "snapshot": "<32 hex>", "revision": 12, "interactive": false, "expires_at": 0, "html": "<!doctype html>...", "message": "..."},
"preview_error": null
}
```
При отказе preview: HTTP 200, принятый snapshot, `preview: null` и `preview_error: {code, message, request_id, revision, issues}`. При ошибке пакета: HTTP 422 и стандартный `error: {code, message, request_id, buffer, issues}` с исходной редакцией.
Браузер использует `POST /admin/editor/pages/{identity}/update` либо `/admin/editor/entries/{collection}/{identity}/update`. Передаёт FormData: csrf, JSON `payload`, selection, readonly, mode; заголовки `Accept: application/json`, `HX-Request: true`. Адаптер проверяет сессию/origin/CSRF и делает один AdminApi call. К JSON добавляется `projection` — серверный HTML без повторных скрытых копий исходника в каждой форме конструктора. Save использует тот же транспорт с прежним API save.
Полный контракт: [OpenAPI](../001-antirion-admin/openapi.json).
## Код
- `services/document_fields.py`, `document_actions.py` — общий parser и нормализация операций, без зависимости от web.
- `services/documents.py:update_buffer` — Registry, пакет, диагностика, overlay; `save_source` сохраняет прежний ContentService/CAS.
- `services/preview.py:render_document` — renderer и защищённый snapshot на уже подготовленном Registry.
- `web/api/{models,routes}.py` — DTO и границы ошибок.
- `web/admin/application.py` — сессия/CSRF, AdminApi, серверная проекция.
- `web/admin/static/editor.js` — память вкладки, очередь, локальный выбор, применение проекции, Save/конфликт.
- `web/admin/static/preview-update.js` — общее обновление DOM; `preview.js` — проверенный bridge на отдельном origin.
При смене страницы состояние вкладки теряется; диалог интерфейса предлагает обработать несохранённые правки. Скачивание YAML остаётся доступным. localStorage и восстановление несохранённой редакции после перезагрузки не вводятся.
## Запуск проверки
```bash
PYTHONPATH=src python -m unittest discover -s tests -p test_editor_updates.py -v
PYTHONPATH=src python scripts/qa_editor_updates.py
python scripts/verify_package_001.py --site examples/site-studio
site-engine export-openapi --out specs/001-antirion-admin/openapi.json
```
Для Chromium нужен установленный Playwright с channel chromium. Проверки работают на временных копиях сайта, обходят proxy для локального браузера и не меняют рабочие data/.env/live. После изменения Python/templates/static runtime в Docker требует пересборки образа.
+43
View File
@@ -0,0 +1,43 @@
# 003 — Фоновое редактирование конструктора
Дата: 2026-11-13. Статус: реализовано, готово к проверке пользователем.
## Проблема и принятое решение
Каждое изменение инспектора вызывало последовательные transform и preview, повторные чтения сайта и замену инспектора. Ввод и выбор секции зависели от завершения запросов. Одинаковый исходник передавался повторно.
Рабочая редакция остаётся только в памяти открытой вкладки до явного Save. Серверных сессий редактирования, автосохранения контента и нового хранилища черновиков не добавляем. `status: draft` остаётся статусом документа; preview snapshots — отдельные защищённые временные артефакты.
Браузер отправляет один stateless POST update: исходник один раз, основание ETag, локальную revision и пакет операций. Backend применяет операции, валидирует документ и рендерит preview с одним Registry. PATCH с одним изменённым значением потребовал бы хранения несохранённой основы на сервере; выбранная модель обходится без такого состояния.
## Поведение интерфейса
- Текст собирается с debounce 200 мс; select, checkbox и выбор значения через picker планируют отправку сразу.
- Запросы выполняются последовательно. Пока сервер отвечает, пользователь продолжает ввод и переключает секции; накопленные правки идут следующим пакетом на основе принятого результата.
- Выбор секции в дереве и preview локален. Инспектор берётся из актуальной серверной проекции с наложением ещё не отправленных значений.
- Обычное изменение свойства сохраняет активные input/textarea/select, фокус и каретку. Нет блокировки инспектора через inert/readOnly. Структурные операции и изменение схемы/layout могут пересобрать инспектор.
- Заполнение последней пустой строки списка добавляет следующую без замены активного поля. Подтверждённое удаление перенумеровывает пути строк; более новый пакет не повторяет уже принятое удаление.
- Preview использует настоящий серверный HTML. Обновление сохраняет iframe и его Document, прокрутку и выбранную секцию. Содержимое head/body заменяется; это не дифф отдельных фрагментов. Первичная загрузка и восстановление iframe используют защищённый snapshot URL.
- Поддерживаются пассивный iframe и отдельный preview origin с доверенным bridge. В preview по-прежнему можно выбрать секцию.
- Save дожидается очереди и сохраняет зафиксированную редакцию через существующий CAS. Ввод во время Save остаётся более новой несохранённой редакцией. Save не публикует.
- При 409 показываются серверная и локальная версии и явное принятие основы. Автоматического повторного Save нет.
## Ошибки и безопасность
Невалидный пакет не применяется частично: API возвращает исходную редакцию и диагностику с HTTP 422. Введённые значения остаются в браузере; Save не обходит ошибки. Ошибка preview возвращается отдельно от уже принятых правок: последнее успешное preview остаётся видимым.
Ошибки транспорта, авторизации, CSRF и сервера видны в уведомлении интерфейса. Неожиданные исключения пишутся со стеком и request_id; исходник, cookies и credentials не добавляются в журналы. Нативные диалоги не используются.
Сохраняется цепочка browser → HTML adapter → AdminApi → JSON FastAPI → services/core. Нет обхода API и внутренних credentials в браузере. Контент записывает только ContentService при Save, с CAS/блокировкой/историей/аудитом. Update может создать временный preview snapshot, но не меняет canonical content или live.
Обновление preview удаляет scripts, обработчики on*, nonce, srcdoc, base и служебные meta/preload для скриптов. HTTP CSP исходного iframe сохраняется. Bridge проверяет origin, source, текущие snapshot/revision и параметры следующего снимка. JS публичного сайта не запускается.
## Критерии готовности
1. Одиночное изменение свойства — один POST update, без transform/preview POST.
2. Один Registry на применение пакета и preview; нет записи контента до Save.
3. При искусственной задержке 2 секунды ввод и выбор секции работают; максимум один update в полёте, новые правки не теряются.
4. Списки, metadata, типизированные поля/привязки, вложенные блоки, Expert и редактор записи сохраняют штатный контракт.
5. iframe/Document сохраняются, preview соответствует последней локальной revision; старые ответы не перезаписывают новый ввод.
6. Видимы отказы preview/сети/валидации; работают восстановление и CAS-конфликт двух вкладок.
7. Проходят серверная регрессия, Chromium в обоих режимах preview и smoke установленного wheel без design/.
+16
View File
@@ -0,0 +1,16 @@
# Задачи 003
- [x] T001 Вынести общий parser FormData/полей и form_action из web в services, оставить совместимые импорты.
- [x] T002 Реализовать пакетный update с одним Registry и применением overlay без записи контента.
- [x] T003 Добавить update DTO/JSON endpoints страниц и записей, отдельный preview_error.
- [x] T004 Подключить HTML-адаптер к одному API-вызову, добавить компактную серверную проекцию и JSON auth/CSRF errors.
- [x] T005 Реализовать очередь в памяти вкладки, debounce и объединение форм, защиту нового ввода от старых ответов.
- [x] T006 Убрать блокировку/замену активного инспектора при обычных изменениях; локально выбирать секции.
- [x] T007 Добавлять пустые строки списков без потери каретки, перенумеровывать удалённые строки и новые отложенные правки.
- [x] T008 Обновлять существующий iframe/Document через серверный HTML в обоих режимах preview, сохранить выбор и прокрутку.
- [x] T009 Сохранить явный Save/CAS, ввод во время Save и диалог конфликта; не добавлять автосохранение/публикацию.
- [x] T010 Показывать validation/network/preview/server errors без потери ввода; сохранять traceback/request_id.
- [x] T011 Добавить серверные и браузерные проверки, провести регрессию и визуальную проверку desktop/mobile.
- [x] T012 Проверить установленный wheel без checkout/design, обновить OpenAPI и спецификацию.
Проверка пользователем на сервере после пересборки контейнера остаётся отдельной приёмкой. Коммит и развёртывание не выполняются этой задачей.
@@ -0,0 +1,60 @@
# Проверка 003
Дата: 2026-11-13. Реализация подготовлена к пользовательской проверке после пересборки контейнера.
## Результат
Один update заменяет последовательные transform и preview. Подтверждены один внутренний API-вызов и один Registry на пакет с рендером. Рабочая редакция остаётся в памяти вкладки, запись контента выполняется явным Save с прежним CAS. Ввод/переключение секций не блокируются; новые изменения продолжают очередь на принятой редакции. В обычном сценарии сохраняются активное поле, iframe и Document. Списки получают новую пустую строку; удаление корректно учитывается даже при более новом вводе во время ответа.
## Сервер
**371 unittest-тест прошёл** в полной регрессии. В `tests/test_editor_updates.py` добавлено **12 тестов**:
- один AdminApi call и Registry для нескольких операций с preview, компактная проекция без скрытых повторов source;
- отсутствие записи canonical content/history/live при update;
- сохранение исходных комментариев/байтов Expert при пустом пакете;
- общие типизированные поля, привязки, вложенные блоки и ширина;
- отказ всего пакета при ошибке последующей операции;
- сохранность исходника при ошибочных формах/YAML;
- независимый отказ preview: принятый snapshot, traceable error, traceback без исходника;
- HTTP 500 для неожиданного отказа сервиса;
- HTTP 500 и журналирование ошибки серверной проекции вместо маскировки как невалидного ввода;
- явный Save и реальный CAS/409;
- JSON-ошибки auth/CSRF/DTO;
- overlay записи и компактный HTML-адаптер записи; неоднозначное направление move отклоняется отдельной проверкой.
Счётчик 12 относится к методам тестов: некоторые проверяют несколько связанных условий. После финального удаления повторов source из проекций целевые 12 тестов запускались отдельно.
Существующие тесты используют удалённый `examples/studio-site`. Полная регрессия запускалась на **временной** базовой фикстуре из коммита `231490b`, через подмену `tests/helpers.EXAMPLE` перед unittest discovery. В ней старый inline theme мигрирован в `site.yaml:theme.file: theme.yaml` и отдельный schema 1 minimal@1 с `overrides.colors.primary: '#0b5fff'`, `overrides.custom_colors.hero_dark: '#14213d'`. Остальной контент архивной фикстуры сохранён. Это ограничение тестовой инфраструктуры: обычный discover без такой фикстуры пока не воспроизводит полный успешный прогон. Удалённые примеры не возвращались в репозиторий. Новые тесты имеют собственную фикстуру; браузер проверяет текущий Site Studio.
## Chromium
`scripts/qa_editor_updates.py`: настоящий FastAPI, временная копия `examples/site-studio`, Chromium без proxy. **13 групп сценариев в каждом из двух режимов preview — 26 проверок**:
1. Один POST на свойство, тот же активный input, iframe и Document.
2. Добавление строки списка без потери фокуса; удаление и перенумерация при более новом вводе во время задержки.
3. Удаление scripts/nonce/onload из обновляемого HTML; bridge отклоняет чужой snapshot.
4. Искусственная задержка 2 секунды: продолжение ввода, мгновенное переключение секций, изменения в нескольких инспекторах, максимум один update одновременно.
5. Невалидное число не теряется, Save блокируется, исправление восстанавливает preview.
6. Отказ preview сохраняет принятую редакцию и последнее успешное preview; последующее обновление работает.
7. Обрыв транспорта сохраняет поля, повторное редактирование восстанавливает очередь.
8. Save дожидается update; ввод во время задержанного Save остаётся несохранённым.
9. Две реальные вкладки, CAS-конфликт и явное принятие основы.
10. Expert → конструктор → невалидный YAML → восстановление той же корректной редакции.
11. Каталог, добавление/дублирование/удаление блоков через диалог дизайна.
12. Отмена правок, mobile 390 px без горизонтального переполнения, screenshots 390/1440 px.
13. Фоновое изменение записи коллекции с настоящим preview.
**0 JavaScript-ошибок, 0 native dialogs.** Намеренно вызванные validation/409/preview/network errors проверяются отдельно; traceback QA preview failure в журнале ожидаем.
Desktop/mobile screenshots просмотрены визуально. Стили/композиция экрана сохраняют существующий перенос дизайна; CSS дизайна не менялся.
Артефакты: `/tmp/site-engine-editor-updates/browser.json`, `builder-{passive,bridge}-{1440,390}.png`; журналы — `/tmp/editor-updates-{browser,regression,tests,package}.log`. Время input → применение preview измеряется внутри браузера, включая debounce 200 мс. В контрольном прогоне: **513 мс passive, 547 мс bridge**. Это локальные измерения на Site Studio, не гарантия задержки на рабочем сервере. Серверная часть transform+render при отдельном замере — медиана около 249 мс. Ранее отдельные transform/preview и дополнительные чтения суммарно занимали около секунды серверной работы.
## Пакет и статические проверки
`scripts/verify_package_001.py --site examples/site-studio`: wheel собран и установлен вне checkout/design. Проверены сборка сайта, штатные пресеты, templates/static, новый preview-update.js, фоновый update с одним API call без записи контента и bridge на отдельном origin, существующий Theme Manager.
OpenAPI обновлён в `specs/001-antirion-admin/openapi.json`. Ruff для изменённых Python, синтаксис изменённых JS и `git diff --check` проходят. `preview.js` содержит серверный placeholder конфигурации; его реальное исполнение проверяет Chromium в отдельном origin.
Команды целевой приёмки — в [runtime.md](runtime.md). Рабочие данные, .env, live, design/ не менялись. Развёртывание и коммит не выполнялись. После пересборки образа пользователь проверяет конструктор на своём сервере.
@@ -0,0 +1,137 @@
"""Normalize schema-driven inspector forms into document actions."""
from ..core.models import FieldDef
from .document_fields import parse_props
def field_def(raw):
data = dict(raw)
data["fields"] = [field_def(f) for f in raw.get("fields", [])]
if isinstance(raw.get("of"), dict):
data["of"] = field_def(raw["of"])
return FieldDef(**data)
def walk_blocks(regions, scope, owner):
result = []
def walk(items, region, depth=0):
for block in items or []:
result.append(
dict(
{"hidden": False, "requires": [], "anchor": None, "note": None},
**block,
scope=scope,
owner=owner,
region=region,
depth=depth,
)
)
for name, children in (block.get("slots") or {}).items():
walk(children, region + "/" + block["id"] + "/" + name, depth + 1)
for name, items in regions.items():
walk(items, name)
return result
def form_action(snap, form, legacy="", block_id=""):
op = (
form.first("operation")
or legacy
or ("block" if block_id else "metadata" if snap["kind"] == "page" else "entry_fields")
)
block_id = block_id or form.first("block_id") or form.first("selection")
if op == "format" and snap["kind"] == "page":
return {"type": "metadata", "values": {}}
if op in {"toggle", "delete", "move", "duplicate"}:
action = {"type": op, "block_id": block_id}
if op == "move":
for key in ("direction", "before", "after"):
if form.first(key):
action[key] = form.first(key)
if sum(k in action for k in ("direction", "before", "after")) != 1:
raise ValueError("Укажите одну цель перемещения")
if "direction" in action and action["direction"] not in {"up", "down"}:
raise ValueError("Неизвестное направление перемещения")
return action
if op == "add":
fragment = snap["schema"]["fragments"].get(form.first("fragment"))
errors = []
props = (
parse_props([field_def(f) for f in fragment["fields"]], form, "p", errors)
if fragment
else {}
)
if errors:
raise ValueError("; ".join(errors))
return {
"type": "add",
"props": props,
**{k: form.first(k) or None for k in ("fragment", "region", "parent", "slot")},
}
meta = snap["model"]["meta"]
if op == "metadata":
seo = dict(meta.get("seo") or {})
seo["description"] = form.first("seo_description")
if "seo_title" in form:
seo["title"] = form.first("seo_title")
return {
"type": op,
"values": {
"title": form.first("title"),
"status": form.first("status") or "draft",
"layout": form.first("layout") or None,
"route": form.first("route") or None,
"seo": seo,
},
"body": form.first("body"),
}
if op == "entry_fields":
raw_fields = snap["schema"]["fields"]
else:
block = next(
(
b
for b in walk_blocks(meta.get("regions", {}), "page", snap["id"])
if b["id"] == block_id
),
None,
)
if not block:
raise ValueError("Блок не найден")
raw_fields = snap["schema"]["fragments"][block["fragment"]]["fields"]
errors = []
props = parse_props([field_def(f) for f in raw_fields], form, "p", errors)
if errors:
raise ValueError("; ".join(errors))
if op == "entry_fields":
return {
"type": op,
"values": props,
"unset": [f["key"] for f in raw_fields if f["key"] not in props],
"status": form.first("status") or "draft",
"body": form.first("body") if snap["schema"]["has_body"] else None,
}
# Preserve unrecognized props exactly; the core validator reports them.
merged = {
k: v
for k, v in block.get("props", {}).items()
if k not in {f["key"] for f in raw_fields}
}
merged.update(props)
widths = {}
for key in ("section_width", "content_width"):
if "block_layout." + key in form:
widths[key] = form.first("block_layout." + key)
return {
"type": "block",
"block_id": block_id,
"values": {
**({"layout": widths} if widths else {}),
"props": merged,
"hidden": form.first("hidden") == "1",
"anchor": form.first("anchor") or None,
"note": form.first("note") or None,
"requires": form.all("requires"),
},
}
+233
View File
@@ -0,0 +1,233 @@
"""Формы редактора, построенные из схемы полей (FieldDef): разбор отправленных данных и
модель представления для шаблонов.
Имена полей плоские: `p.title`, `p.items.0.title`, `p.cta.target`; числовой сегмент — строка
списка. У любого поля есть необязательная привязка `<имя>._bind` → значение `{bind: путь}`.
Пустое поле не пишется в файл (UNSET), поэтому форма не раздувает front matter значениями
по умолчанию.
"""
from __future__ import annotations
import datetime as dt
import re
from collections.abc import Mapping, Sequence
from typing import Any
from ..core.models import FieldDef
from ..core.values import ValueShapeError, classify
from ..parsing.yamlio import YamlError, load_yaml
UNSET = object()
_DATE_RE = re.compile(r"^\d{4}-\d{2}-\d{2}$")
_TEXT_TYPES = ("text", "slug", "color", "icon", "asset", "ref")
_LINK_KINDS = ("page", "entry", "url")
class FormData:
"""Многозначные данные формы: имя → список значений."""
def __init__(self, data: Mapping[str, Sequence[str]] | None = None):
self._d: dict[str, list[str]] = {k: list(v) for k, v in (data or {}).items()}
@classmethod
def from_pairs(cls, pairs) -> FormData:
d: dict[str, list[str]] = {}
for key, value in pairs:
d.setdefault(str(key), []).append(str(value))
return cls(d)
def first(self, name: str, default: str = "") -> str:
values = self._d.get(name)
return values[0] if values else default
def all(self, name: str) -> list[str]:
return list(self._d.get(name, []))
def __contains__(self, name: str) -> bool:
return name in self._d
def keys(self):
return self._d.keys()
def child_indices(self, prefix: str) -> list[int]:
found: set[int] = set()
for key in self._d:
if key.startswith(prefix + "."):
head = key[len(prefix) + 1:].split(".", 1)[0]
if head.isdigit():
found.add(int(head))
return sorted(found)
def label_of(fd: FieldDef) -> str:
return fd.label or fd.key
def _norm_text(value: str) -> str:
return value.replace("\r\n", "\n").replace("\r", "\n").rstrip()
def _pick_option(fd: FieldDef, raw: str) -> Any:
for option in fd.options:
if str(option) == raw:
return option
return UNSET
# ── разбор формы → значения ───────────────────────────────────────────────────
def parse_props(fields: list[FieldDef], form: FormData, prefix: str, errors: list[str]) -> dict:
out: dict = {}
for fd in fields:
value = parse_field(fd, form, f"{prefix}.{fd.key}", errors)
if value is not UNSET:
out[fd.key] = value
return out
def parse_field(fd: FieldDef, form: FormData, name: str, errors: list[str]) -> Any:
label = label_of(fd)
bind = form.first(name + "._bind").strip()
if bind:
try:
classify({"bind": bind})
except ValueShapeError as exc:
errors.append(f"{label}: {exc}")
return UNSET
return {"bind": bind}
t = fd.type
if t in _TEXT_TYPES:
value = form.first(name).strip()
return value if value else UNSET
if t in ("textarea", "markdown"):
value = _norm_text(form.first(name))
return value if value.strip() else UNSET
if t == "number":
text = form.first(name).strip().replace(",", ".")
if not text:
return UNSET
try:
return int(text) if re.fullmatch(r"-?\d+", text) else float(text)
except ValueError:
errors.append(f"{label}: ожидается число")
return UNSET
if t == "boolean":
value = form.first(name)
return {"true": True, "false": False}.get(value, UNSET)
if t == "select":
raw = form.first(name)
if not raw:
return UNSET
option = _pick_option(fd, raw)
if option is UNSET:
errors.append(f"{label}: значение «{raw}» не из списка")
return option
if t == "multiselect":
picked = []
for raw in form.all(name):
option = _pick_option(fd, raw)
if option is UNSET:
errors.append(f"{label}: значение «{raw}» не из списка")
else:
picked.append(option)
return picked or UNSET
if t in ("date", "datetime"):
text = form.first(name).strip()
if not text:
return UNSET
if t == "date":
if not _DATE_RE.match(text):
errors.append(f"{label}: ожидается дата ГГГГ-ММ-ДД")
return UNSET
try:
return dt.date.fromisoformat(text)
except ValueError:
errors.append(f"{label}: несуществующая дата")
return UNSET
return text
if t == "refs":
items = [s for s in re.split(r"[,\s]+", form.first(name)) if s]
return items or UNSET
if t == "link":
target = form.first(name + ".target").strip()
if not target:
return UNSET
kind = form.first(name + ".kind") or "url"
if kind not in _LINK_KINDS:
errors.append(f"{label}: неизвестный вид ссылки «{kind}»")
return UNSET
link: dict = {kind: target}
if form.first(name + ".label").strip():
link["label"] = form.first(name + ".label").strip()
if form.first(name + ".new_tab") == "1":
link["target"] = "_blank"
return link
if t == "group":
group = parse_props(fd.fields, form, name, errors)
return group or UNSET
if t == "list":
rows: list = []
for i in form.child_indices(name):
row_name = f"{name}.{i}"
if form.first(row_name + "._del") == "1":
continue
row_bind = form.first(row_name + "._bind").strip()
if row_bind and not fd.of:
try:
classify({"bind": row_bind})
rows.append({"bind": row_bind})
except ValueShapeError as exc:
errors.append(f"{label}[{i + 1}]: {exc}")
continue
if fd.of:
value = parse_field(FieldDef(key=str(i), type=fd.of, label=f"{label}[{i + 1}]"), form, row_name, errors)
else:
value = parse_props(fd.fields, form, row_name, errors) or UNSET
if value is not UNSET:
rows.append(value)
return rows or UNSET
if t == "query":
collection = form.first(name + ".collection").strip()
if not collection:
return UNSET
query: dict = {"collection": collection}
ids = [s for s in re.split(r"[,\s]+", form.first(name + ".ids")) if s]
if ids:
query["ids"] = ids
where_text = form.first(name + ".where").strip()
if where_text:
try:
where = load_yaml(where_text)
except YamlError as exc:
errors.append(f"{label}: where — {exc}")
where = None
if isinstance(where, dict):
query["where"] = where
elif where is not None:
errors.append(f"{label}: where должен быть объектом вида {{поле: значение}}")
if form.first(name + ".sort").strip():
query["sort"] = form.first(name + ".sort").strip()
limit = form.first(name + ".limit").strip()
if limit:
if limit.isdigit() and int(limit) > 0:
query["limit"] = int(limit)
else:
errors.append(f"{label}: limit — целое больше 0")
try:
classify({"query": query}, "query")
except ValueShapeError as exc:
errors.append(f"{label}: {exc}")
return UNSET
return {"query": query}
if t == "json":
text = form.first(name).strip()
if not text:
return UNSET
try:
return load_yaml(text)
except YamlError as exc:
errors.append(f"{label}: {exc}")
return UNSET
errors.append(f"{label}: тип «{t}» не поддерживается редактором")
return UNSET
+37 -3
View File
@@ -17,6 +17,8 @@ from ..parsing.yamlio import YamlError
from ..storage.fs import safe_join
from .auth import AuditLog, Principal
from .content import ABSENT, ContentService
from .document_actions import form_action
from .document_fields import FormData
ID_RE = re.compile(r"^[a-z0-9][a-z0-9_-]*(/[a-z0-9][a-z0-9_-]*)*$")
RESERVED = {"new", "blocks", "add", "meta"}
@@ -209,7 +211,12 @@ class DocumentService:
def transform_buffer(
self, identity: str, source: str, etag: str, action: dict, revision: int = 0
) -> DocumentSnapshot:
before = self.validate_source(identity, source, etag, revision)
reg = self.registry()
before = self.snapshot(reg, identity, self._path(reg, identity), source, etag, revision)
return self._transform(reg, identity, before, action)
def _transform(self, reg, identity, before, action):
etag, revision = before.etag, before.revision
if before.report.errors:
return before
meta, body = copy.deepcopy(before.model["meta"]), before.model["body"]
@@ -291,8 +298,8 @@ class DocumentService:
target[0].insert(index, block)
else:
raise ValueError("Операция недоступна для этого документа")
transformed = self.validate_source(
identity, frontmatter.dumps(meta, body), etag, revision
transformed = self.snapshot(
reg, identity, before.path, frontmatter.dumps(meta, body), etag, revision
)
if transformed.report.errors:
# A refused structural action must keep the valid input buffer/tree.
@@ -367,6 +374,10 @@ class DocumentService:
result = self.snapshot(reg, identity, self._path(reg, identity), source, etag)
if result.report.errors:
raise EngineError("Превью недоступно: исправьте документ", result.report)
self.apply_overlay(reg, identity, result)
return reg, result
def apply_overlay(self, reg, identity, result):
meta, body = result.model["meta"], result.model["body"]
if self.kind == "page":
reg.pages[identity] = parse_page(meta, body, identity, result.path, Report())
@@ -375,4 +386,27 @@ class DocumentService:
reg.entries[self.collection] = [
entry if e.slug == identity else e for e in reg.entries[self.collection]
]
def update_buffer(self, identity, source, etag, operations, revision=0):
"""Request-owned registry and all-or-nothing edits; never writes content."""
reg = self.registry()
before = self.snapshot(reg, identity, self._path(reg, identity), source, etag, revision)
result = before
for operation in operations:
if result.report.errors:
break
try:
action = (form_action({"kind": result.kind, "id": result.id,
"model": result.model, "schema": result.schema},
FormData(operation["fields"]))
if operation.get("type") == "inspector" else operation)
result = self._transform(reg, identity, result, action)
except (ValueError, KeyError, TypeError) as exc:
before.report.add("E_OPERATION", str(exc), before.path)
return reg, before
if result.report.errors and result is not before:
before.report = result.report
result = before
if not result.report.errors:
self.apply_overlay(reg, identity, result)
return reg, result
+9 -4
View File
@@ -208,6 +208,9 @@ class PreviewStore:
def render(self, service, identity, source, etag, revision, principal):
reg, _result = service.overlay(identity, source, etag)
return self.render_document(reg, service, identity, revision, principal)
def render_document(self, reg, service, identity, revision, principal, *, include_html=False):
report = Report()
report.extend(reg.report)
if report.errors:
@@ -227,7 +230,8 @@ class PreviewStore:
css += "\n" + read_static("preview.css")
html = html.replace(ASSETS_HEAD, f"<style>{css}</style>").replace(ASSETS_BODY, "")
return self.store(
reg, html, revision, principal, f"{service.kind}:{service.collection}:{identity}"
reg, html, revision, principal, f"{service.kind}:{service.collection}:{identity}",
include_html=include_html,
)
def render_theme(
@@ -291,7 +295,7 @@ class PreviewStore:
copy_assets=target != "sample",
)
def store(self, reg, html, revision, principal, document, *, copy_assets=True):
def store(self, reg, html, revision, principal, document, *, copy_assets=True, include_html=False):
from ..web.admin.render import read_static
with self.lock:
@@ -335,8 +339,9 @@ class PreviewStore:
raw = rewrite_css(raw.decode(), rel, prefix, token).encode()
atomic_write(folder / "assets" / rel, raw)
html = rewrite_assets(html, prefix, token)
live_html = html
if self.config:
bridge = read_static("preview.js").replace(
bridge = read_static("preview-update.js") + "\n" + read_static("preview.js").replace(
"__CONFIG__",
json.dumps(
{
@@ -377,7 +382,7 @@ class PreviewStore:
"revision": revision,
"interactive": bool(self.config),
"expires_at": data["exp"],
"html": "",
"html": live_html if include_html else "",
"message": "Выберите секцию в предпросмотре или в дереве слева.",
}
except BaseException:
+41 -133
View File
@@ -5,11 +5,12 @@ import re
from contextvars import ContextVar
from urllib.parse import quote
from ...core.models import STATUSES, FieldDef
from ...core.models import STATUSES
from ...services.auth import COOKIE_NAME, is_same_origin
from ...services.document_actions import field_def, form_action, walk_blocks
from .api_client import ApiError, api_for
from .editor import PREVIEW_HEADERS
from .forms import FormData, build_view, parse_props
from .forms import FormData, build_view
from .handlers import HttpResult, htmx_available, page_result, redirect_result
from .render import render
from .views import pages_view, workspace_view
@@ -17,37 +18,6 @@ from .views import pages_view, workspace_view
_navigation = ContextVar("admin_navigation", default=None)
def field_def(raw):
data = dict(raw)
data["fields"] = [field_def(f) for f in raw.get("fields", [])]
if isinstance(raw.get("of"), dict):
data["of"] = field_def(raw["of"])
return FieldDef(**data)
def walk_blocks(regions, scope, owner):
result = []
def walk(items, region, depth=0):
for block in items or []:
result.append(
dict(
{"hidden": False, "requires": [], "anchor": None, "note": None},
**block,
scope=scope,
owner=owner,
region=region,
depth=depth,
)
)
for name, children in (block.get("slots") or {}).items():
walk(children, region + "/" + block["id"] + "/" + name, depth + 1)
for name, items in regions.items():
walk(items, name)
return result
class AdminApplication:
def __init__(self, auth, previews):
self.auth, self.previews = auth, previews
@@ -321,13 +291,15 @@ class AdminApplication:
return result
async def dispatch(self, request):
theme_post = request.method == "POST" and request.url.path.startswith(
("/admin/theme/", "/admin/setup/theme/")
json_post = request.method == "POST" and (
request.url.path.startswith(("/admin/theme/", "/admin/setup/theme/"))
or (request.url.path.startswith("/admin/editor/")
and "application/json" in request.headers.get("accept", ""))
)
cookie = request.cookies.get(COOKIE_NAME)
principal = self.auth.authenticate(cookie)
if principal is None:
if theme_post:
if json_post:
return self.json_failure(
401, "session_expired", "Сессия истекла. Скачайте YAML и войдите снова."
)
@@ -347,7 +319,7 @@ class AdminApplication:
is_same_origin(request.headers, self.auth.cfg.public_host)
and self.auth.verify_csrf(principal, form.first("csrf"))
):
if theme_post:
if json_post:
return self.json_failure(
403, "forbidden", "Недействительный токен или источник запроса"
)
@@ -611,6 +583,24 @@ class AdminApplication:
return self.message(principal, "Такой страницы нет", 404)
identity = match[2]
endpoint = f"/collections/{match[1]}/entries/{quote(identity, safe='')}"
if editor_request and post and "payload" in form:
try:
submitted = json.loads(form.first("payload"))
except (ValueError, TypeError):
return self.json_failure(422, "request_validation", "Некорректный запрос редактора")
if op not in {"update", "save"}:
return self.json_failure(422, "invalid_operation", "Неизвестная операция редактора")
try:
payload = await api.call("POST", endpoint + "/" + op, submitted)
if op == "save":
payload = {"snapshot": payload, "preview": None, "preview_error": None}
payload["projection"] = self.editor_projection(principal, payload["snapshot"], docpath, form)
return self.json_result(payload)
except ApiError as exc:
snapshot = exc.data.get("error", {}).get("buffer")
if snapshot:
exc.data["projection"] = self.editor_projection(principal, snapshot, docpath, form)
return exc.annotate(self.json_result(exc.data, exc.status))
snap = await api.call("GET", endpoint + "/source")
if not post:
if passive:
@@ -754,100 +744,18 @@ class AdminApplication:
result.headers["X-Document-Committed"] = "1"
return exc.annotate(result)
def editor_projection(self, principal, snap, base, form):
context = self.editor_context(
snap, base, form.first("selection"), form.first("mode") or "constructor",
readonly=form.first("readonly"),
)
return render("editor_result.html.j2", **self.ctx(
principal, "pages" if snap["kind"] == "page" else "content",
**context, compact_update=True, submitted_fields=[],
))
def form_action(self, snap, form, legacy="", block_id=""):
op = (
form.first("operation")
or legacy
or ("block" if block_id else "metadata" if snap["kind"] == "page" else "entry_fields")
)
block_id = block_id or form.first("block_id") or form.first("selection")
if op == "format" and snap["kind"] == "page":
return {"type": "metadata", "values": {}}
if op in {"toggle", "delete", "move", "duplicate"}:
action = {"type": op, "block_id": block_id}
if op == "move":
for key in ("direction", "before", "after"):
if form.first(key):
action[key] = form.first(key)
return action
if op == "add":
fragment = snap["schema"]["fragments"].get(form.first("fragment"))
errors = []
props = (
parse_props([field_def(f) for f in fragment["fields"]], form, "p", errors)
if fragment
else {}
)
if errors:
raise ApiError(422, {"error": {"message": "; ".join(errors)}})
return {
"type": "add",
"props": props,
**{k: form.first(k) or None for k in ("fragment", "region", "parent", "slot")},
}
meta = snap["model"]["meta"]
if op == "metadata":
seo = dict(meta.get("seo") or {})
seo["description"] = form.first("seo_description")
if "seo_title" in form:
seo["title"] = form.first("seo_title")
return {
"type": op,
"values": {
"title": form.first("title"),
"status": form.first("status") or "draft",
"layout": form.first("layout") or None,
"route": form.first("route") or None,
"seo": seo,
},
"body": form.first("body"),
}
if op == "entry_fields":
raw_fields = snap["schema"]["fields"]
else:
block = next(
(
b
for b in walk_blocks(meta.get("regions", {}), "page", snap["id"])
if b["id"] == block_id
),
None,
)
if not block:
raise ApiError(422, {"error": {"message": "Блок не найден"}})
raw_fields = snap["schema"]["fragments"][block["fragment"]]["fields"]
errors = []
props = parse_props([field_def(f) for f in raw_fields], form, "p", errors)
if errors:
raise ApiError(422, {"error": {"message": "; ".join(errors)}})
if op == "entry_fields":
return {
"type": op,
"values": props,
"unset": [f["key"] for f in raw_fields if f["key"] not in props],
"status": form.first("status") or "draft",
"body": form.first("body") if snap["schema"]["has_body"] else None,
}
# Preserve unrecognized props exactly; the core validator reports them.
merged = {
k: v
for k, v in block.get("props", {}).items()
if k not in {f["key"] for f in raw_fields}
}
merged.update(props)
widths = {}
for key in ("section_width", "content_width"):
if "block_layout." + key in form:
widths[key] = form.first("block_layout." + key)
return {
"type": "block",
"block_id": block_id,
"values": {
**({"layout": widths} if widths else {}),
"props": merged,
"hidden": form.first("hidden") == "1",
"anchor": form.first("anchor") or None,
"note": form.first("note") or None,
"requires": form.all("requires"),
},
}
try:
return form_action(snap, form, legacy, block_id)
except ValueError as exc:
raise ApiError(422, {"error": {"code": "invalid_operation", "message": str(exc)}}) from exc
+13 -231
View File
@@ -1,237 +1,19 @@
"""Формы редактора, построенные из схемы полей (FieldDef): разбор отправленных данных и
модель представления для шаблонов.
Имена полей плоские: `p.title`, `p.items.0.title`, `p.cta.target`; числовой сегмент — строка
списка. У любого поля есть необязательная привязка `<имя>._bind` → значение `{bind: путь}`.
Пустое поле не пишется в файл (UNSET), поэтому форма не раздувает front matter значениями
по умолчанию.
"""
from __future__ import annotations
import datetime as dt
import re
from collections.abc import Mapping, Sequence
"""Schema field views; parsing is shared with the document update service."""
from collections.abc import Mapping
from typing import Any
from ...core.models import FieldDef
from ...core.values import ValueShapeError, classify
from ...parsing.yamlio import YamlError, dump_yaml, load_yaml
UNSET = object()
_DATE_RE = re.compile(r"^\d{4}-\d{2}-\d{2}$")
_TEXT_TYPES = ("text", "slug", "color", "icon", "asset", "ref")
_LINK_KINDS = ("page", "entry", "url")
class FormData:
"""Многозначные данные формы: имя → список значений."""
def __init__(self, data: Mapping[str, Sequence[str]] | None = None):
self._d: dict[str, list[str]] = {k: list(v) for k, v in (data or {}).items()}
@classmethod
def from_pairs(cls, pairs) -> FormData:
d: dict[str, list[str]] = {}
for key, value in pairs:
d.setdefault(str(key), []).append(str(value))
return cls(d)
def first(self, name: str, default: str = "") -> str:
values = self._d.get(name)
return values[0] if values else default
def all(self, name: str) -> list[str]:
return list(self._d.get(name, []))
def __contains__(self, name: str) -> bool:
return name in self._d
def keys(self):
return self._d.keys()
def child_indices(self, prefix: str) -> list[int]:
found: set[int] = set()
for key in self._d:
if key.startswith(prefix + "."):
head = key[len(prefix) + 1:].split(".", 1)[0]
if head.isdigit():
found.add(int(head))
return sorted(found)
def label_of(fd: FieldDef) -> str:
return fd.label or fd.key
def _norm_text(value: str) -> str:
return value.replace("\r\n", "\n").replace("\r", "\n").rstrip()
def _pick_option(fd: FieldDef, raw: str) -> Any:
for option in fd.options:
if str(option) == raw:
return option
return UNSET
# ── разбор формы → значения ───────────────────────────────────────────────────
def parse_props(fields: list[FieldDef], form: FormData, prefix: str, errors: list[str]) -> dict:
out: dict = {}
for fd in fields:
value = parse_field(fd, form, f"{prefix}.{fd.key}", errors)
if value is not UNSET:
out[fd.key] = value
return out
def parse_field(fd: FieldDef, form: FormData, name: str, errors: list[str]) -> Any:
label = label_of(fd)
bind = form.first(name + "._bind").strip()
if bind:
try:
classify({"bind": bind})
except ValueShapeError as exc:
errors.append(f"{label}: {exc}")
return UNSET
return {"bind": bind}
t = fd.type
if t in _TEXT_TYPES:
value = form.first(name).strip()
return value if value else UNSET
if t in ("textarea", "markdown"):
value = _norm_text(form.first(name))
return value if value.strip() else UNSET
if t == "number":
text = form.first(name).strip().replace(",", ".")
if not text:
return UNSET
try:
return int(text) if re.fullmatch(r"-?\d+", text) else float(text)
except ValueError:
errors.append(f"{label}: ожидается число")
return UNSET
if t == "boolean":
value = form.first(name)
return {"true": True, "false": False}.get(value, UNSET)
if t == "select":
raw = form.first(name)
if not raw:
return UNSET
option = _pick_option(fd, raw)
if option is UNSET:
errors.append(f"{label}: значение «{raw}» не из списка")
return option
if t == "multiselect":
picked = []
for raw in form.all(name):
option = _pick_option(fd, raw)
if option is UNSET:
errors.append(f"{label}: значение «{raw}» не из списка")
else:
picked.append(option)
return picked or UNSET
if t in ("date", "datetime"):
text = form.first(name).strip()
if not text:
return UNSET
if t == "date":
if not _DATE_RE.match(text):
errors.append(f"{label}: ожидается дата ГГГГ-ММ-ДД")
return UNSET
try:
return dt.date.fromisoformat(text)
except ValueError:
errors.append(f"{label}: несуществующая дата")
return UNSET
return text
if t == "refs":
items = [s for s in re.split(r"[,\s]+", form.first(name)) if s]
return items or UNSET
if t == "link":
target = form.first(name + ".target").strip()
if not target:
return UNSET
kind = form.first(name + ".kind") or "url"
if kind not in _LINK_KINDS:
errors.append(f"{label}: неизвестный вид ссылки «{kind}»")
return UNSET
link: dict = {kind: target}
if form.first(name + ".label").strip():
link["label"] = form.first(name + ".label").strip()
if form.first(name + ".new_tab") == "1":
link["target"] = "_blank"
return link
if t == "group":
group = parse_props(fd.fields, form, name, errors)
return group or UNSET
if t == "list":
rows: list = []
for i in form.child_indices(name):
row_name = f"{name}.{i}"
if form.first(row_name + "._del") == "1":
continue
row_bind = form.first(row_name + "._bind").strip()
if row_bind and not fd.of:
try:
classify({"bind": row_bind})
rows.append({"bind": row_bind})
except ValueShapeError as exc:
errors.append(f"{label}[{i + 1}]: {exc}")
continue
if fd.of:
value = parse_field(FieldDef(key=str(i), type=fd.of, label=f"{label}[{i + 1}]"), form, row_name, errors)
else:
value = parse_props(fd.fields, form, row_name, errors) or UNSET
if value is not UNSET:
rows.append(value)
return rows or UNSET
if t == "query":
collection = form.first(name + ".collection").strip()
if not collection:
return UNSET
query: dict = {"collection": collection}
ids = [s for s in re.split(r"[,\s]+", form.first(name + ".ids")) if s]
if ids:
query["ids"] = ids
where_text = form.first(name + ".where").strip()
if where_text:
try:
where = load_yaml(where_text)
except YamlError as exc:
errors.append(f"{label}: where — {exc}")
where = None
if isinstance(where, dict):
query["where"] = where
elif where is not None:
errors.append(f"{label}: where должен быть объектом вида {{поле: значение}}")
if form.first(name + ".sort").strip():
query["sort"] = form.first(name + ".sort").strip()
limit = form.first(name + ".limit").strip()
if limit:
if limit.isdigit() and int(limit) > 0:
query["limit"] = int(limit)
else:
errors.append(f"{label}: limit — целое больше 0")
try:
classify({"query": query}, "query")
except ValueShapeError as exc:
errors.append(f"{label}: {exc}")
return UNSET
return {"query": query}
if t == "json":
text = form.first(name).strip()
if not text:
return UNSET
try:
return load_yaml(text)
except YamlError as exc:
errors.append(f"{label}: {exc}")
return UNSET
errors.append(f"{label}: тип «{t}» не поддерживается редактором")
return UNSET
from ...parsing.yamlio import dump_yaml
from ...services.document_fields import ( # noqa: F401
_LINK_KINDS,
_TEXT_TYPES,
UNSET,
FormData,
_norm_text,
label_of,
parse_field,
parse_props,
)
# ── значения → модель представления ──────────────────────────────────────────
+4 -2
View File
@@ -8,6 +8,7 @@ from __future__ import annotations
from dataclasses import dataclass, field
from pathlib import Path
from typing import ClassVar
from ...errors import EngineError
from ...services.auth import COOKIE_NAME, AuthError, AuthService, is_same_origin
@@ -124,14 +125,15 @@ class AdminHandlers:
ctx["site_error"] = str(exc)
return _page(render("dashboard.html.j2", **ctx))
_STATIC = {"theme-studio.css": "text/css; charset=utf-8",
_STATIC: ClassVar[dict[str, str]] = {"theme-studio.css": "text/css; charset=utf-8",
"theme-studio.js": "text/javascript; charset=utf-8","admin.css": "text/css; charset=utf-8",
"builder.css": "text/css; charset=utf-8", "builder-adapter.css": "text/css; charset=utf-8",
"builder.js": "text/javascript; charset=utf-8",
"antirion-rework.css": "text/css; charset=utf-8", "shell.css": "text/css; charset=utf-8",
"pages.css": "text/css; charset=utf-8", "pages.js": "text/javascript; charset=utf-8",
"htmx.min.js": "text/javascript; charset=utf-8",
"admin.js": "text/javascript; charset=utf-8", "editor.js": "text/javascript; charset=utf-8"}
"admin.js": "text/javascript; charset=utf-8", "editor.js": "text/javascript; charset=utf-8",
"preview-update.js": "text/javascript; charset=utf-8"}
def static_file(self, name: str) -> HttpResult:
content_type = self._STATIC.get(name)
@@ -16,6 +16,7 @@
].filter(Boolean).join(' · ');
box.hidden = false;
}
window.siteAdminError = showRequestError;
function xhrError(xhr) {
try { const value = JSON.parse(xhr.responseText); if (value.error?.message) return value.error; } catch (_) {}
try { const value = JSON.parse(xhr.getResponseHeader('HX-Trigger')); if (value?.['admin:error']) return value['admin:error']; } catch (_) {}
@@ -45,6 +45,7 @@
root.querySelectorAll('[data-inspector-panel]').forEach(p=>p.hidden=p.dataset.inspectorPanel!==tab);
}
function code() {
if(!root?.isConnected)return;
const source=one('#document-source',root), highlighter=one('[data-code-highlight]',root), gutter=one('[data-code-gutter]',root);
if(!source||!highlighter) return;
if(highlightedPane===highlighter&&highlightedSource===source.value){cursor();return;}
@@ -68,6 +69,7 @@
cursor();
}
function cursor() {
if(!root?.isConnected)return;
const source=one('#document-source',root), indicator=one('[data-source-cursor]',root);
if(!source||!indicator) return;
const lines=source.value.slice(0,source.selectionStart).split('\n');
@@ -237,6 +239,7 @@
const edited=one('[data-file-edited]',root);if(edited)edited.hidden=!window.siteDocument.state.dirty;
code();
});
document.addEventListener('document:projection',()=>{layout();tabs();code();});
document.addEventListener('document:selection',event=>{inspectorTab=event.detail.bindings?'bindings':'props';tabs();});
document.addEventListener('htmx:afterSwap',event=>{
if(!root?.isConnected||event.detail.target.id!=='editor-result')return;
+406 -358
View File
@@ -1,386 +1,434 @@
/* Shared memory-only buffer. No document text or credentials are persisted in Web Storage. */
/* Memory-only editing. One serialized background update; local input never waits for it. */
(() => {
'use strict';
if (window.siteEditorLoaded) return;
window.siteEditorLoaded = true;
let current = null;
let applyTimer, expertTimer, queue=Promise.resolve();
if(window.siteEditorLoaded)return;
window.siteEditorLoaded=true;
const one=(s,r=document)=>r.querySelector(s);
const ignored=new Set(['source','etag','csrf','revision','selection','readonly','mode']);
let current=null,actions=Promise.resolve();
const leavingForms=new WeakSet();
const one = (s, root = document) => root.querySelector(s);
function setup() {
const root = one('#document-editor');
if (root && root === current?.root) return;
clearTimeout(applyTimer);clearTimeout(expertTimer);queue=Promise.resolve();
if (!root) {current=null;return;}
const source = one('#document-source', root), form = one('#buffer-form', root);
current = {root, source, form, etag: form.elements.etag.value, saved: JSON.parse(root.dataset.canonicalSource), buffer:JSON.parse(root.dataset.rawSource), rev: Number(root.dataset.revision),
mode:'constructor', selection: form.elements.selection.value, readonlySelection:one('#editor-result').dataset.readonly, inspectorDirty:false, preview:null, viewport:{x:0,y:0},
pending: new Map(), busy:false, page:root.classList.contains('page-builder'), device:'desktop', validated:JSON.parse(root.dataset.rawSource), dirtyForm:null};
root.dataset.ready = '1';
showMode(one('#editor-result')?.dataset.valid==='1' ? (form.elements.mode.value || 'constructor') : 'expert');
status();
requestPreview();
const alive=s=>current===s&&s.root.isConnected;
function notice(message){const el=one('#editor-notice');if(el)el.textContent=message;}
function failure(error,status){
window.siteAdminError?.(error,status);
notice(error.message||'Запрос не выполнен. Правки остаются в редакторе.');
}
function dirty() {return current && current.root.isConnected && (current.buffer !== current.saved || current.inspectorDirty);}
function notice(text) {const n = one('#editor-notice'); if (n) n.textContent = text;}
function status() {
if (!current) return;
one('#buffer-status').textContent = dirty() ? 'Есть несохранённые правки' : 'Нет несохранённых изменений';
current.form.elements.etag.value = current.etag;
current.form.elements.revision.value = current.rev;
current.form.elements.selection.value = current.selection;
current.form.elements.mode.value = current.mode;
one('#buffer-status').classList.toggle('changed',!!dirty());
one('#buffer-status').classList.toggle('good',!dirty());
current.root.dispatchEvent(new CustomEvent('document:state', {bubbles:true}));
function dirty(){return !!current&&(current.buffer!==current.saved||current.edits.size>0);}
function status(){
const s=current;if(!s)return;
const label=one('#buffer-status');
label.textContent=dirty()?'Есть несохранённые правки':'Нет несохранённых изменений';
label.classList.toggle('changed',dirty());label.classList.toggle('good',!dirty());
for(const [key,value] of Object.entries({etag:s.etag,revision:s.rev,selection:s.selection,mode:s.mode}))s.form.elements[key].value=value;
s.root.dataset.revision=String(s.rev);
s.root.dataset.updating=String(!!s.running);
const previewBox=one('#preview-result');
previewBox?.setAttribute('aria-busy',String(!!s.running||s.preview?.revision!==s.rev));
if(previewBox)previewBox.dataset.ready=String(!!s.preview?.ready);
s.root.dispatchEvent(new CustomEvent('document:state',{bubbles:true}));
}
function showMode(mode) {
current.mode = mode;
current.root.dataset.mode = mode;
current.root.querySelectorAll('[data-editor-mode]').forEach(b => {b.setAttribute('aria-pressed', String(b.dataset.editorMode === mode));b.classList.toggle('active', b.dataset.editorMode === mode);});
status();
function showMode(mode){
current.mode=mode;current.root.dataset.mode=mode;
current.root.querySelectorAll('[data-editor-mode]').forEach(b=>{const active=b.dataset.editorMode===mode;b.setAttribute('aria-pressed',String(active));b.classList.toggle('active',active);});status();
}
function params() {return {source:current.buffer, etag:current.etag, csrf:current.form.elements.csrf.value,
revision:current.rev, mode:current.mode, selection:current.selection, readonly:current.readonlySelection};}
function requestPreview() {
if (!current || !window.htmx || current.busy || one('#editor-result')?.dataset.valid !== '1') return;
const state=current;
htmx.ajax('POST', '/admin/editor' + current.root.dataset.base + '/preview', {target:'#preview-result', swap:'outerHTML', values:params()}).catch(()=>{
if(current===state && state.root.isConnected) notice('Превью недоступно. Правки остаются в редакторе.');
});
function fields(form,submitter){
const data=new FormData(form),out={};if(submitter?.name)data.set(submitter.name,submitter.value);
for(const key of new Set(data.keys()))if(!ignored.has(key))out[key]=data.getAll(key).map(String);
return out;
}
function formValues(form, submitter) {
const data=new FormData(form), values={};
if(submitter?.name) data.set(submitter.name,submitter.value);
for(const key of new Set(data.keys())) {const all=data.getAll(key);values[key]=all.length>1?all:all[0];}
const keyOf=f=>(f.operation?.[0]||'entry_fields')+':'+(f.block_id?.[0]||'');
function capture(form){
const values=[];
for(const field of form.querySelectorAll('input,textarea,select'))if(field.name&&!ignored.has(field.name))values.push({name:field.name,type:field.type,value:field.value,checked:field.checked,disabled:field.disabled,selected:field.tagName==='SELECT'?Array.from(field.options).map(o=>o.selected):null});
return values;
}
function liveFieldsHTML(element) {
const clone=element.cloneNode(true), controls=clone.querySelectorAll('input,textarea,select');
element.querySelectorAll('input,textarea,select').forEach((field,i)=>{
const next=controls[i];
if(field.tagName==='TEXTAREA') next.textContent=field.value;
else if(field.tagName==='SELECT') Array.from(next.options).forEach((option,j)=>option.toggleAttribute('selected',field.options[j].selected));
else {next.setAttribute('value',field.value);if(['checkbox','radio'].includes(field.type)) next.toggleAttribute('checked',field.checked);}
});
return clone.innerHTML;
function restore(form,values){
const remaining=[...values];
for(const field of form.querySelectorAll('input,textarea,select')){
const i=remaining.findIndex(v=>v.name===field.name&&v.type===field.type);if(i<0)continue;
const [value]=remaining.splice(i,1);field.value=value.value;field.disabled=value.disabled;
if(['checkbox','radio'].includes(field.type))field.checked=value.checked;
if(value.selected)Array.from(field.options).forEach((o,j)=>o.selected=!!value.selected[j]);
}
function request(action, values={}) {
const state=current;
if(!state?.root.isConnected || state.busy) return Promise.resolve(false);
return new Promise(resolve=>{
const path='/admin/editor'+state.root.dataset.base+'/'+action;
const done=event=>{
if(event.detail.requestConfig?.path!==path) return;
document.removeEventListener('htmx:afterRequest',done);
resolve(current===state && event.detail.xhr.status===200 && one('#editor-result')?.dataset.valid==='1');
}
function remember(target,immediate=false){
const form=target.closest('[data-inspector]');if(!form||!current)return;
const s=current,value=fields(form),key=keyOf(value),previous=s.edits.get(key),fingerprint=JSON.stringify(value);
// Browsers dispatch input and change for the same select/checkbox.
if(s.fieldValues.get(key)===fingerprint){if(immediate&&previous)schedule(0);return;}
s.fieldValues.set(key,fingerprint);
s.rev++;s.failedRev=-1;
s.edits.set(key,{type:'inspector',fields:value,rev:s.rev,controls:capture(form)});
schedule(immediate?0:200);status();
}
function hydrate(root){
root.querySelectorAll('[data-inspector]').forEach(form=>{
const key=keyOf(fields(form)),edit=current.edits.get(key);if(edit)restore(form,edit.controls);
current.fieldValues.set(key,JSON.stringify(fields(form)));
form.querySelectorAll('[data-source-picker]').forEach(button=>{const field=form.elements.namedItem(button.dataset.sourcePicker+'._bind');if(field){button.classList.toggle('bound',!!field.value);button.textContent=field.value||'literal';}});
});
}
function schedule(delay=200){const s=current;if(!s)return;clearTimeout(s.timer);s.timer=setTimeout(()=>flush().catch(e=>failure(e)),delay);}
async function post(s,operation,payload){
const data=new FormData();data.set('csrf',s.form.elements.csrf.value);data.set('payload',JSON.stringify(payload));
for(const [key,value]of Object.entries({selection:s.selection,readonly:s.readonlySelection,mode:s.mode}))data.set(key,value);
let response;
try{response=await fetch('/admin/editor'+s.root.dataset.base+'/'+operation,{method:'POST',credentials:'same-origin',headers:{'HX-Request':'true','Accept':'application/json'},body:data,signal:s.controller.signal});}
catch(e){if(e.name==='AbortError')throw e;throw {code:'network_error',message:'Нет связи с сервером. Правки остаются в открытом редакторе.'};}
let result;try{result=await response.json();}catch{throw {code:'invalid_response',message:'Сервер вернул некорректный ответ. Правки остаются в редакторе.',status:response.status,request_id:response.headers.get('X-Request-ID')};}
if(!response.ok)throw {...result.error,status:response.status,projection:result.projection};
return result;
}
function selectedKey(){
if(current.readonlySelection){try{return JSON.parse(current.readonlySelection);}catch{}}
const el=Array.from(current.root.querySelectorAll('[data-tree-id]')).find(e=>e.dataset.treeScope==='page'&&e.dataset.treeId===current.selection);
return el?{scope:el.dataset.treeScope,owner:el.dataset.treeOwner,id:el.dataset.treeId}:null;
}
function send(type,extra={}){
const s=current,p=s?.preview,frame=one('#preview-result iframe');if(!p?.ready||!frame)return;
if(p.document&&frame.contentDocument===p.document){
if(type==='editor:restore')frame.contentWindow.scrollTo({left:extra.x,top:extra.y,behavior:'instant'});
if(type==='editor:select'){
const matches=e=>['scope','owner','id'].every(k=>e.dataset['preview'+k[0].toUpperCase()+k.slice(1)]===extra.block[k]);
const roots=Array.from(p.document.querySelectorAll('[data-preview-id]'));roots.forEach(e=>e.toggleAttribute('data-preview-selected',matches(e)));
if(extra.scroll){const e=roots.find(matches),r=e?.getBoundingClientRect();if(r&&(r.top<0||r.bottom>frame.clientHeight))e.scrollIntoView({block:'nearest',behavior:'instant'});}
}
}else if(s.root.dataset.previewOrigin)frame.contentWindow.postMessage({type,snapshot:p.snapshot,revision:p.revision,...extra},s.root.dataset.previewOrigin);
}
function syncSelection(scroll=false){
const s=current,key=selectedKey();
s.root.querySelectorAll('[data-tree-id]').forEach(e=>e.classList.toggle('selected',!!key&&['scope','owner','id'].every(k=>e.dataset['tree'+k[0].toUpperCase()+k.slice(1)]===key[k])));
s.root.querySelectorAll('.mapping-card').forEach(e=>e.classList.toggle('map-selected',one('[name=choose]',e)?.value===s.selection));
if(key)send('editor:select',{block:key,scroll});
}
function movePreviewOut(){
const s=current,node=one('#inspectpane #stagepane',s.root),parent=one('#builder',s.root);if(!node)return;
if(parent.moveBefore)parent.moveBefore(node,one('#expert-pane',s.root));else{window.siteDocument.previewReloading();parent.insertBefore(node,one('#expert-pane',s.root));}
}
function choose(block,scroll=true,bindings=false){
const s=current;if(!s?.valid)return;
if(s.page){
const t=Array.from(s.root.querySelectorAll('[data-section-inspector]')).find(e=>e.dataset.blockId===block.id&&e.dataset.blockScope===block.scope&&e.dataset.blockOwner===block.owner);if(!t)return;
const pane=t.content.querySelector('#inspectpane').cloneNode(true);hydrate(pane);movePreviewOut();one('#inspectpane',s.root).replaceWith(pane);
}else{
const pane=one('.doc-inspector',s.root);if(pane&&!s.entryInspector)s.entryInspector=pane.cloneNode(true);
if(block.scope==='display'||block.scope==='layout'){
const view=document.createElement('section');view.className='doc-inspector';const text=document.createElement('p');text.dataset.readonlyInspector='';text.textContent='Только чтение · '+block.scope+' / '+block.owner+' / '+block.id;view.append(text);pane?.replaceWith(view);
}else if(s.entryInspector){const next=s.entryInspector.cloneNode(true);hydrate(next);pane?.replaceWith(next);}
}
s.selection=block.scope==='page'?block.id:'';s.readonlySelection=block.scope==='page'?'':JSON.stringify(block);
const result=one('#editor-result');result.dataset.selection=s.selection;result.dataset.readonly=s.readonlySelection;
s.root.dispatchEvent(new CustomEvent('document:selection',{bubbles:true,detail:{bindings}}));syncSelection(scroll);status();
}
function acknowledgeDeletes(batch){
// A newer full form may still contain a deletion already accepted by the
// server. Rebase row paths before sending it, so the next row is not deleted.
const s=current;
for(const [key,edit]of batch){
const deleted=Object.entries(edit.fields).filter(([name,value])=>/\.\d+\._del$/.test(name)&&value.includes('1')).map(([name])=>name.slice(0,-5));
if(!deleted.length)continue;
const rename=name=>{
if(deleted.some(row=>name===row||name.startsWith(row+'.')))return null;
const parts=name.split('.');
return parts.map((part,i)=>{
if(!/^\d+$/.test(part))return part;
const parent=parts.slice(0,i).join('.');
return String(Number(part)-deleted.filter(row=>row.slice(0,row.lastIndexOf('.'))===parent&&Number(row.slice(row.lastIndexOf('.')+1))<Number(part)).length);
}).join('.');
};
document.addEventListener('htmx:afterRequest',done);
htmx.ajax('POST',path,{target:'#editor-result',swap:'outerHTML',values:{...values,...params()}}).catch(()=>{document.removeEventListener('htmx:afterRequest',done);resolve(false);});
});
const pending=s.edits.get(key);
if(pending&&pending!==edit){
pending.fields=Object.fromEntries(Object.entries(pending.fields).map(([name,value])=>[rename(name),value]).filter(([name])=>name!==null));
pending.controls=pending.controls.map(value=>({...value,name:rename(value.name)})).filter(value=>value.name!==null);
}
async function flush() {
clearTimeout(applyTimer);
if(!current.inspectorDirty) return true;
const form=current.dirtyForm;
if(!form?.isConnected) {notice('Проверьте несохранённые поля инспектора.');return false;}
return request('transform',formValues(form));
}
async function leave(action) {
const state=current;
if(dirty() && !await (state.page?window.siteBuilderConfirm:window.siteAdminConfirm)('Есть несохранённые изменения', 'При переходе правки этой вкладки будут потеряны. Сохраните документ, если хотите оставить изменения.', 'Уйти без сохранения')) return false;
if(current!==state || !state.root.isConnected)return false;
clearTimeout(applyTimer);clearTimeout(expertTimer);
action();return true;
}
function enqueue(work) {
const state=current;
queue=queue.catch(()=>{}).then(async()=>{if(current===state&&state.root.isConnected) await work();}).catch(()=>notice('Запрос не выполнен. Правки остаются в редакторе.'));
}
function editedInspector(target) {
const form=target.closest('[data-inspector]');
if(!form) return;
current.inspectorDirty=true;current.dirtyForm=form;
if(current.page) {clearTimeout(applyTimer);applyTimer=setTimeout(()=>enqueue(flush),650);}
}
window.siteDocument={
get state(){return current?{source:current.buffer,saved:current.saved,dirty:!!dirty(),mode:current.mode,busy:current.busy,base:current.root.dataset.base}:null;},
notice,
leave,
previewReloading:()=>{if(current?.preview) {current.preview.ready=false;current.preview.document=null;}},
change:element=>{editedInspector(element);status();},
transform:values=>enqueue(async()=>{if(await flush()) await request('transform',values);}),
reset:()=>enqueue(async()=>{
if(!await window.siteBuilderConfirm('Отменить изменения?', 'Рабочая редакция вернётся к последней загруженной или сохранённой версии. Файл и опубликованный сайт не изменятся.', 'Отменить изменения')) return;
clearTimeout(applyTimer);clearTimeout(expertTimer);current.inspectorDirty=false;current.dirtyForm=null;
current.buffer=current.saved;current.source.value=current.saved;current.rev++;status();await request('validate');
})
};
function download() {
const url = URL.createObjectURL(new Blob([current.buffer], {type:'text/markdown;charset=utf-8'}));
const a = document.createElement('a'); a.href=url; a.download=current.root.dataset.base.split('/').pop()+'.md'; a.click();
setTimeout(() => URL.revokeObjectURL(url), 1000);
}
function send(type, extra={}) {
const p = current?.preview, frame = one('#preview-result iframe');
if(type==='editor:select' && p) p.selectionScroll=extra.scroll===true;
if(p?.ready && p.document && p.document===frame?.contentDocument) {
if(type==='editor:restore') frame.contentWindow.scrollTo({left:extra.x,top:extra.y,behavior:'instant'});
if(type==='editor:select') {
const roots=Array.from(p.document.querySelectorAll('[data-preview-id]'));
const matches=el=>['scope','owner','id'].every(k=>el.dataset['preview'+k[0].toUpperCase()+k.slice(1)]===extra.block[k]);
roots.forEach(el=>{if(matches(el))el.setAttribute('data-preview-selected','true');else el.removeAttribute('data-preview-selected');});
if(extra.scroll)roots.find(matches)?.scrollIntoView({block:'nearest',behavior:'instant'});
}
return;
}
if (p?.ready && frame && current.root.dataset.previewOrigin) frame.contentWindow.postMessage({type,snapshot:p.snapshot,revision:p.revision,...extra},current.root.dataset.previewOrigin);
}
function treeNode(block) {
return Array.from(current.root.querySelectorAll('[data-tree-id]')).find(e=>
e.dataset.treeId===block.id&&e.dataset.treeScope===block.scope&&e.dataset.treeOwner===block.owner);
}
function syncSelection(scroll=false) {
const node=one('.tree-node.selected,.readonly-block.selected');
if(node)send('editor:select',{block:{scope:node.dataset.treeScope,owner:node.dataset.treeOwner,id:node.dataset.treeId},scroll});
}
function movePreview(node,parent,before=null) {
if(parent.moveBefore&&node.isConnected)parent.moveBefore(node,before);
else {window.siteDocument.previewReloading();parent.insertBefore(node,before);}
}
function selectSection(block, scroll=true, bindings=false) {
if(!treeNode(block))return;
enqueue(async()=>{
if(!await flush())return;
const template=Array.from(current.root.querySelectorAll('[data-section-inspector]')).find(e=>
e.dataset.blockId===block.id&&e.dataset.blockScope===block.scope&&e.dataset.blockOwner===block.owner);
if(!template||one('#editor-result').dataset.valid!=='1')return;
const old=one('#inspectpane'),next=template.content.querySelector('#inspectpane').cloneNode(true);
const preview=one('#stagepane',old);
if(preview)movePreview(preview,one('#builder'),one('#expert-pane'));
old.replaceWith(next);
current.selection=block.scope==='page'?block.id:'';
current.readonlySelection=block.scope==='page'?'':JSON.stringify(block);
const result=one('#editor-result');result.dataset.selection=current.selection;result.dataset.readonly=current.readonlySelection;
const selected=treeNode(block);
current.root.querySelectorAll('[data-tree-id]').forEach(e=>e.classList.toggle('selected',e===selected));
current.root.querySelectorAll('.mapping-card').forEach(e=>e.classList.toggle('map-selected',one('[name=choose]',e)?.value===current.selection));
current.root.dispatchEvent(new CustomEvent('document:selection',{bubbles:true,detail:{bindings}}));
status();syncSelection(scroll);
});
}
function chooseFromPreview(block) {
if(!treeNode(block))return;
if(current.page){selectSection(block,false);return;}
if(current.inspectorDirty||current.busy){notice('Сначала примените изменения инспектора.');return;}
current.selection=block.scope==='page'?block.id:'';
current.readonlySelection=block.scope==='page'?'':JSON.stringify(block);
const state=current;
htmx.ajax('POST','/admin/editor'+current.root.dataset.base+'/select',{target:'#editor-result',swap:'outerHTML',values:params()}).catch(()=>{
if(current===state && state.root.isConnected) notice('Не удалось выбрать блок. Правки остаются в редакторе.');
});
}
function passivePreview(frame) {
const state=current,p=state?.preview;
if(!p||one('#preview-result').dataset.interactive!=='0'||p.revision!==state.rev)return;
const url=new URL(frame.src,location.href);
if(url.origin!==location.origin||url.pathname!==`/admin/preview/s/${p.snapshot}/`)return;
const doc=frame.contentDocument;
if(!doc||doc.URL!==url.href||p.document===doc)return;
const valid=()=>current===state&&state.preview===p&&one('#preview-result iframe')===frame&&frame.contentDocument===doc&&p.revision===state.rev;
p.document=doc;p.ready=true;
doc.addEventListener('click',event=>{
if(!valid())return;
if(event.target.closest('a,button,input,select,textarea'))event.preventDefault();
const section=event.target.closest('[data-preview-id]');if(!section)return;
event.preventDefault();event.stopPropagation();
chooseFromPreview({scope:section.dataset.previewScope,owner:section.dataset.previewOwner,id:section.dataset.previewId});
},true);
doc.addEventListener('submit',event=>event.preventDefault(),true);
frame.contentWindow.addEventListener('scroll',()=>{if(valid())state.viewport={x:frame.contentWindow.scrollX,y:frame.contentWindow.scrollY};},{passive:true});
send('editor:restore',state.viewport);syncSelection(p.selectionScroll===true);
}
document.addEventListener('load',event=>{if(event.target===one('#preview-result iframe'))passivePreview(event.target);},true);
document.addEventListener('click', event => {
if (!current || !current.root.isConnected) return;
const b = event.target.closest('button');
if (b?.matches('[data-editor-mode]')) {
if(current.page) enqueue(async()=>{
if(!await flush()) return;
if(b.dataset.editorMode==='constructor' && current.buffer!==current.validated && !await request('validate')) return;
if(b.dataset.editorMode==='constructor' && one('#editor-result')?.dataset.valid!=='1') {notice('Исправьте исходник в «Эксперте».');return;}
showMode(b.dataset.editorMode);
});
else if(!current.inspectorDirty) showMode(b.dataset.editorMode);
else notice('Примените изменения инспектора перед сменой режима.');
}
if (b?.hasAttribute('data-download')) download();
if (b?.hasAttribute('data-preview')) requestPreview();
if (b?.hasAttribute('data-rebase')) {event.preventDefault();if(!current.page||one('[name=confirm_rebase]', b.form)?.checked) {current.etag=b.dataset.rebase; status(); b.disabled=true;notice('Новая основа принята. Проверьте исходник и сохраните отдельной кнопкой.');one('[data-conflict-dialog]')?.close();}}
if (b?.hasAttribute('data-viewport')) {
current.device=b.dataset.viewport;
current.root.querySelectorAll('[data-viewport]').forEach(el=>{el.classList.toggle('active',el.dataset.viewport===current.device);el.setAttribute('aria-pressed',String(el.dataset.viewport===current.device));});
const frame=one('#preview-result iframe');
frame?.classList.toggle('mobile-viewport',current.device==='mobile');frame?.classList.toggle('tablet-viewport',current.device==='tablet');
}
if (b?.hasAttribute('data-validate')) {event.preventDefault();clearTimeout(expertTimer); if(current.page) enqueue(async()=>{if(await flush()) await request('validate');});else if(!current.busy) request('validate');}
const link = event.target.closest('a[href]');
if(link && !event.defaultPrevented && event.button===0 && !event.ctrlKey && !event.metaKey && !event.shiftKey && !event.altKey && !link.hasAttribute('download') && (!link.target || link.target==='_self') && !(link.href.includes('#')&&link.href.split('#')[0]===location.href.split('#')[0]) && dirty()) {
event.preventDefault();event.stopImmediatePropagation();
leave(()=>location.assign(link.href));
}
}, true);
document.addEventListener('input', event => {
if (!current || !current.root.contains(event.target)) return;
if (event.target === current.source) {current.buffer=current.source.value;current.rev++; notice('Исходник изменён.');if(current.page){clearTimeout(expertTimer);expertTimer=setTimeout(()=>enqueue(()=>request('validate')),650);}}
else editedInspector(event.target);
status();
});
document.addEventListener('change', event => {if(current && current.root.contains(event.target) && event.target.closest('[data-inspector]')) {editedInspector(event.target);status();}});
document.addEventListener('submit', event => {
if (!current) return;
const form = event.target;
if (form.closest('#document-editor')) {
if(current.page && window.htmx) {
event.preventDefault();event.stopImmediatePropagation();
const submitter=event.submitter, values=formValues(form,submitter), action=new URL(submitter?.formAction&&submitter.hasAttribute('formaction')?submitter.formAction:form.action).pathname.split('/').pop();
if(action==='select' && submitter?.dataset.treeId){selectSection({scope:submitter.dataset.treeScope,owner:submitter.dataset.treeOwner,id:submitter.dataset.treeId},true,submitter.hasAttribute('data-focus-bind'));return;}
if(action==='select' && values.choose!==undefined){const node=Array.from(current.root.querySelectorAll('[data-tree-id]')).find(e=>e.dataset.treeScope==='page'&&e.dataset.treeId===values.choose);if(node){selectSection({scope:node.dataset.treeScope,owner:node.dataset.treeOwner,id:node.dataset.treeId},true,submitter?.hasAttribute('data-focus-bind'));return;}}
clearTimeout(expertTimer);
enqueue(async()=>{
if(form.matches('[data-inspector]')) {current.dirtyForm=form;current.inspectorDirty=true;if(!await flush()) return;}
else {
if(!await flush()) return;
if(action==='transform' && values.operation==='delete' && !await window.siteBuilderConfirm('Удалить блок?', 'Будет удалён блок '+values.block_id+' вместе с вложенными блоками. Изменения затронут только текущую редакцию до сохранения файла.', 'Удалить из редакции')) return;
if(values.choose!==undefined) {current.selection=values.choose;current.readonlySelection='';}
if(values.choose_readonly) {current.selection='';current.readonlySelection=values.choose_readonly;}
await request(action,values);
const form=Array.from(s.root.querySelectorAll('[data-inspector]')).find(e=>keyOf(fields(e))===key);if(!form)continue;
const active=document.activeElement,wasInside=form.contains(active);
form.querySelectorAll('[data-list-row]').forEach(row=>{if(rename(row.dataset.listRow)===null)row.remove();});
form.querySelectorAll('[name],[data-list-name],[data-list-row],[id^="dl-"],[list^="dl-"]').forEach(node=>{
for(const attr of ['name','data-list-name','data-list-row','id','list']){
const value=node.getAttribute(attr);if(!value||(['id','list'].includes(attr)&&!value.startsWith('dl-')))continue;
const prefix=['id','list'].includes(attr)?'dl-':'',next=rename(value.slice(prefix.length));if(next!==null)node.setAttribute(attr,prefix+next);
}
});
return;
if(wasInside&&!active.isConnected)one('input:not([type=hidden]),textarea,select',form)?.focus({preventScroll:true});
s.fieldValues.set(key,JSON.stringify(fields(form)));
}
}
function reconcileLists(form,fresh){
// Only acknowledged forms reach here. Preserve live controls and caret when a
// trailing blank row becomes an item; deletion alone renumbers that list.
for(const list of form.querySelectorAll('[data-list-name]')){
if(!form.contains(list))continue;
const next=Array.from(fresh.querySelectorAll('[data-list-name]')).find(e=>e.dataset.listName===list.dataset.listName);if(!next)continue;
const rows=Array.from(list.children).filter(e=>e.hasAttribute('data-list-row'));
const newRows=Array.from(next.children).filter(e=>e.hasAttribute('data-list-row'));
if(rows.some(row=>one(':scope > [data-list-delete] input:checked',row))){
const active=document.activeElement,name=active?.name,focused=list.contains(active);
rows.forEach(row=>row.remove());list.append(...newRows.map(row=>row.cloneNode(true)));
if(focused){const target=Array.from(list.querySelectorAll('[name]')).find(e=>e.name===name)||one('input,textarea,select',list);target?.focus({preventScroll:true});}
continue;
}
for(const nextRow of newRows){
const row=rows.find(e=>e.dataset.listRow===nextRow.dataset.listRow);
if(!row){list.append(nextRow.cloneNode(true));continue;}
row.classList.toggle('blank',nextRow.classList.contains('blank'));
for(const selector of [':scope > [data-list-hint]',':scope > [data-list-delete]']){
const old=one(selector,row),value=one(selector,nextRow);
if(old&&!value)old.remove();else if(!old&&value)row.append(value.cloneNode(true));
}
}
rows.filter(row=>!newRows.some(e=>e.dataset.listRow===row.dataset.listRow)).forEach(row=>row.remove());
}
current.fieldValues.set(keyOf(fields(form)),JSON.stringify(fields(form)));
}
function reconcileInspector(){
const s=current,key=selectedKey();
const template=s.page&&key?Array.from(s.root.querySelectorAll('[data-section-inspector]')).find(e=>e.dataset.blockId===key.id&&e.dataset.blockScope===key.scope&&e.dataset.blockOwner===key.owner):null;
const fresh=s.page?template?.content:s.entryInspector;if(!fresh)return;
s.root.querySelectorAll('[data-inspector]').forEach(form=>{
const id=keyOf(fields(form));if(s.edits.has(id))return;
const next=Array.from(fresh.querySelectorAll('[data-inspector]')).find(e=>keyOf(fields(e))===id);
if(next)reconcileLists(form,next);
});
}
function projection(html,replaceInspector=false,operation=null){
if(!html)return;
const s=current,doc=new DOMParser().parseFromString(html,'text/html'),next=one('#editor-result',doc),old=one('#editor-result');if(!next)return;
const valid=next.dataset.valid==='1';s.valid=valid;
for(const [key,value]of Object.entries(next.dataset))if(!['selection','readonly','rawSource','revision','saved'].includes(key))old.dataset[key]=value;
if(!valid){if(s.mode==='constructor')showMode('expert');return;}
if(s.page){
const oldTree=one('#treepane'),newTree=one('#treepane',next),treeScroll=one('.pane-scroll',oldTree)?.scrollTop;
const oldIDs=Array.from(oldTree.querySelectorAll('[data-tree-scope=page]')).map(e=>e.dataset.treeId);
const newIDs=Array.from(newTree.querySelectorAll('[data-tree-scope=page]')).map(e=>e.dataset.treeId);
if(operation&&['add','duplicate'].includes(operation)&&s.selection===s.requestSelection){s.selection=newIDs.find(id=>!oldIDs.includes(id))||s.selection;s.readonlySelection='';}
if(s.selection&&!newIDs.includes(s.selection))s.selection=newIDs[Math.min(Math.max(0,oldIDs.indexOf(s.selection)),newIDs.length-1)]||'';
oldTree.replaceWith(newTree);const scroller=one('.pane-scroll',newTree);if(scroller)scroller.scrollTop=treeScroll||0;
if(s.readonlySelection){
const key=selectedKey();
if(!key||!Array.from(newTree.querySelectorAll('[data-tree-id]')).some(e=>['scope','owner','id'].every(k=>e.dataset['tree'+k[0].toUpperCase()+k.slice(1)]===key[k]))){s.readonlySelection='';s.selection=s.selection||newIDs[0]||'';}
}
if (current.busy) {event.preventDefault(); event.stopImmediatePropagation(); return;}
if (current.inspectorDirty && !form.matches('[data-inspector]')) {event.preventDefault(); event.stopImmediatePropagation(); notice('Примените изменения инспектора к буферу. Затем сохраните документ.'); return;}
if(event.submitter?.name==='choose') {current.selection=event.submitter.value;current.readonlySelection='';}
if(event.submitter?.name==='choose_readonly') {current.selection='';current.readonlySelection=event.submitter.value;}
} else if(form.method!=='dialog' && dirty() && !leavingForms.has(form)) {
event.preventDefault();event.stopImmediatePropagation();
const submitter=event.submitter;
leave(()=>{leavingForms.add(form);try{form.requestSubmit(submitter);}finally{leavingForms.delete(form);}});
s.root.querySelectorAll('[data-section-inspector]').forEach(e=>e.remove());one('[data-constructor]').append(...next.querySelectorAll('[data-section-inspector]'));
if(replaceInspector){
const key=selectedKey(),t=key&&Array.from(s.root.querySelectorAll('[data-section-inspector]')).find(e=>e.dataset.blockId===key.id&&e.dataset.blockScope===key.scope&&e.dataset.blockOwner===key.owner);
const pane=(t?t.content.querySelector('#inspectpane'):one('#inspectpane',next)).cloneNode(true);hydrate(pane);movePreviewOut();one('#inspectpane').replaceWith(pane);
}
if(replaceInspector){
const catalog=one('#builder-catalog-dialog'),fresh=one('#builder-catalog-dialog',next);if(catalog&&!catalog.open&&fresh)catalog.replaceWith(fresh);
}
}else{
const tree=one('.doc-tree'),fresh=one('.doc-tree',next);if(tree&&fresh)tree.replaceWith(fresh);
s.entryInspector=one('.doc-inspector',next)?.cloneNode(true)||s.entryInspector;
if(replaceInspector&&!s.readonlySelection&&s.entryInspector){const pane=s.entryInspector.cloneNode(true);hydrate(pane);one('.doc-inspector')?.replaceWith(pane);}
}
if(!replaceInspector)reconcileInspector();
syncSelection();s.root.dispatchEvent(new CustomEvent('document:projection',{bubbles:true}));
}
function passive(frame){
const s=current,p=s?.preview;if(!p||p.interactive||p.document)return;
const url=new URL(frame.src,location.href);if(url.origin!==location.origin||url.pathname!==`/admin/preview/s/${p.snapshot}/`)return;
const doc=frame.contentDocument;if(!doc||doc.URL!==url.href)return;
p.document=doc;p.ready=true;
const valid=()=>alive(s)&&one('#preview-result iframe')===frame&&frame.contentDocument===doc;
doc.addEventListener('click',e=>{if(!valid())return;if(e.target.closest('a,button,input,select,textarea'))e.preventDefault();const block=e.target.closest('[data-preview-id]');if(block){e.preventDefault();e.stopPropagation();choose({scope:block.dataset.previewScope,owner:block.dataset.previewOwner,id:block.dataset.previewId},false);}},true);
doc.addEventListener('submit',e=>e.preventDefault(),true);
frame.contentWindow.addEventListener('scroll',()=>{if(valid())s.viewport={x:frame.contentWindow.scrollX,y:frame.contentWindow.scrollY};},{passive:true});
send('editor:restore',s.viewport);syncSelection();status();
}
function device(frame){frame.classList.toggle('mobile-viewport',current.device==='mobile');frame.classList.toggle('tablet-viewport',current.device==='tablet');}
function displayPreview(value){
const s=current;if(value.revision!==s.rev)return;
const box=one('#preview-result'),frame=one('iframe',box),p=s.preview;
if(frame&&p?.ready&&value.html){
if(p.document&&p.document===frame.contentDocument){
window.sitePreviewDocument(p.document,value.html);Object.assign(p,value,{ready:true,document:p.document});
box.dataset.snapshot=value.snapshot;box.dataset.revision=String(value.revision);syncSelection();status();
}else if(value.interactive&&s.root.dataset.previewOrigin){
if(s.nextPreview){s.queuedPreview=value;return;}
s.nextPreview=value;
frame.contentWindow.postMessage({type:'editor:render',snapshot:p.snapshot,revision:p.revision,next:{snapshot:value.snapshot,revision:value.revision,html:value.html}},s.root.dataset.previewOrigin);
}
}, true);
document.addEventListener('htmx:configRequest', event => {
if (!current || !event.detail.path.startsWith('/admin/editor'+current.root.dataset.base+'/')) return;
const d=event.detail, preview=d.path.endsWith('/preview');
if (!preview) {if(!d.path.endsWith('/select')) current.rev++; current.busy=true;}
const values=params();
// Selection is the clicked submitter's value, not the hidden previous selection.
const submitter=d.triggeringEvent?.submitter;
if (submitter?.name==='choose') values.selection=submitter.value;
Object.assign(d.parameters, values);
current.selection=values.selection;
current.form.elements.source.readOnly=!preview;
if(!preview) {const constructor=one('[data-constructor]');if(constructor)constructor.inert=true;}
status();
});
document.addEventListener('htmx:beforeRequest', event => {
if (!current || !event.detail.requestConfig.path.startsWith('/admin/editor'+current.root.dataset.base+'/')) return;
const cfg=event.detail.requestConfig;
current.pending.set(event.detail.xhr,{rev: Number(cfg.parameters.revision),source:cfg.parameters.source,path:cfg.path,
selection:cfg.parameters.selection,operation:cfg.parameters.operation,focus:document.activeElement?.name,caret:document.activeElement?.selectionStart,scroll:one('#treepane .pane-scroll')?.scrollTop, inspectorScroll:one('.inspect-scroll')?.scrollTop});
});
document.addEventListener('htmx:beforeSwap', event => {
if (!current) return;
const d=event.detail, pending=current.pending.get(d.xhr);
if (!pending) return;
if (d.xhr.status===401) {d.shouldSwap=false; notice('Сессия истекла. Скачайте исходник и войдите снова: /admin/login'); return;}
const revision=Number(d.xhr.getResponseHeader('X-Editor-Revision'));
if (revision!==current.rev || pending.rev!==current.rev) {d.shouldSwap=false; return;}
if (pending.path.endsWith('/preview')) {
if(d.xhr.status!==200) {d.shouldSwap=false; notice('Превью недоступно. Правки остаются в редакторе.');}
return;
}
if (d.xhr.status>=500 && d.xhr.getResponseHeader('X-Document-Committed')!=='1') {d.shouldSwap=false; notice('Сервер не завершил запрос. Правки остаются в редакторе; проверьте серверную версию перед повтором.'); return;}
if(d.xhr.getResponseHeader('X-Document-Committed')==='1') {d.shouldSwap=true;d.isError=false;}
const doc=new DOMParser().parseFromString(d.serverResponse,'text/html');
const result=doc.querySelector('#editor-result');
if(!result) {d.shouldSwap=false; notice('Ответ сервера не принят. Правки остаются в редакторе.'); return;}
// Keep the last valid tree when Expert source cannot be projected.
if(result.dataset.valid!=='1') {
const old=one(current.page?'#treepane':'[data-constructor]');
const next=result.querySelector(current.page?'#treepane':'[data-constructor]');
if(old&&next) {next.innerHTML=old.innerHTML; next.inert=true;}
showMode('expert');
}
if(d.xhr.status===422 && result.dataset.valid==='1') {
for(const selector of current.page?['[data-inspector-panel="props"]','[data-inspector-panel="page"]']:['.doc-inspector']) {
const old=one(selector),next=result.querySelector(selector);
if(old&&next) next.innerHTML=liveFieldsHTML(old);
}
}
d.serverResponse=result.outerHTML;
});
document.addEventListener('htmx:afterSwap', event => {
if(!current) return;
if(event.detail.target.id==='editor-result') {
const el=one('#editor-result');
if(el.dataset.revision!==String(current.rev)) return;
current.buffer=JSON.parse(el.dataset.rawSource);
current.source.value=current.buffer;
current.etag=el.dataset.etag;
current.readonlySelection=el.dataset.readonly;
if(current.page) current.selection=el.dataset.selection;
if(el.dataset.valid==='1') current.validated=current.buffer;
const pageStatus=one('[data-page-status]');if(pageStatus)pageStatus.textContent=el.dataset.status;
one('.doc-toolbar h1').textContent=el.dataset.title;
if(event.detail.xhr.status!==422) {current.inspectorDirty=false;current.dirtyForm=null;}
if(el.dataset.saved==='1') current.saved=current.buffer;
const next=document.createElement('iframe');next.title=value.interactive?'Интерактивный предпросмотр документа':'Пассивный предпросмотр документа';next.setAttribute('sandbox',value.interactive?'allow-scripts allow-same-origin':'allow-same-origin');next.referrerPolicy='no-referrer';device(next);
next.src=value.url;
if(frame){next.hidden=true;box.append(next);}else box.replaceChildren(next);
// ready from an initial interactive iframe can arrive before its load event.
s.loadingPreview={...value,frame:next};
const loaded=()=>{
if(!alive(s)||value.revision!==s.rev){next.remove();return;}
frame?.remove();next.hidden=false;s.preview={...value,ready:false};s.loadingPreview=null;
box.dataset.snapshot=value.snapshot;box.dataset.revision=String(value.revision);box.dataset.interactive=value.interactive?'1':'0';
if(!value.interactive)passive(next);else if(s.earlyReady===value.snapshot){s.preview.ready=true;s.earlyReady=null;syncSelection();send('editor:restore',s.viewport);}
status();
notice(el.dataset.valid!=='1'?'Исправьте исходник. Последнее корректное дерево доступно для просмотра.':event.detail.xhr.status===422?'Изменения не применены. Исправьте поля формы.':'Изменения проверены.');
const selected=one('.tree-node.selected,.readonly-block.selected');
if(selected) send('editor:select',{block:{scope:selected.dataset.treeScope,owner:selected.dataset.treeOwner,id:selected.dataset.treeId},scroll:false});
const pending=current.pending.get(event.detail.xhr);
const focus=Array.from(el.querySelectorAll('input,select,textarea,button')).find(e=>e.name===pending?.focus&&!e.hidden&&e.type!=='hidden');
focus?.focus({preventScroll:true});
if(focus?.setSelectionRange&&Number.isInteger(pending?.caret)) {try{focus.setSelectionRange(pending.caret,pending.caret);}catch{}}
const treeScroll=one('#treepane .pane-scroll');if(treeScroll&&Number.isFinite(pending?.scroll))treeScroll.scrollTop=pending.scroll;
const inspectScroll=one('.inspect-scroll');if(inspectScroll&&Number.isFinite(pending?.inspectorScroll))inspectScroll.scrollTop=pending.inspectorScroll;
if(current.inspectorDirty) current.dirtyForm=Array.from(el.querySelectorAll('[data-inspector]')).find(form=>form.elements.operation.value===pending?.operation);
};
next.addEventListener('load',loaded,{once:true});
}
if(event.detail.target.id==='preview-result') {
const p=one('#preview-result'); current.preview={snapshot:p.dataset.snapshot,revision:Number(p.dataset.revision),ready:false};
one('iframe',p)?.classList.toggle('mobile-viewport',current.device==='mobile');one('iframe',p)?.classList.toggle('tablet-viewport',current.device==='tablet');
const frame=one('iframe',p);if(frame)passivePreview(frame);
async function flush(force=false){
const s=current;if(!s||!alive(s))return false;
clearTimeout(s.timer);
if(s.saving)await s.saving;
while(s.running){const ok=await s.running;if(!ok||!alive(s))return false;}
if(!force&&s.failedRev===s.rev)return false;
while(alive(s)&&(force||s.edits.size||s.validationPending||!s.valid||s.buffer!==s.validated)){
force=false;
const rev=s.rev,source=s.buffer,sourceChanged=source!==s.validated,sourceEpoch=s.sourceEpoch,batch=Array.from(s.edits.entries()),operations=batch.map(([,e])=>({type:e.type,fields:e.fields}));
s.requestSelection=s.selection;
s.running=(async()=>{
try{
const result=await post(s,'update',{source,etag:s.etag,revision:rev,operations});
if(!alive(s))return false;
if(result.snapshot.revision!==rev)throw {code:'revision_mismatch',message:'Ответ редактора относится к другой версии.'};
acknowledgeDeletes(batch);
for(const [key,edit]of batch)if(s.edits.get(key)===edit)s.edits.delete(key);
if(s.sourceEpoch===sourceEpoch){s.buffer=result.snapshot.source;s.validated=s.buffer;s.validationPending=false;s.source.value=s.buffer;}
const structural=sourceChanged||operations.some(op=>['add','delete','duplicate','move','toggle','format'].includes(op.fields.operation?.[0]))||(s.layout&&s.layout!==result.snapshot.schema.layout);
s.layout=result.snapshot.schema.layout;
const metadata=one('[data-inspector] [name=title]',s.root);
const title=s.edits.has('metadata:')&&metadata?metadata.value:result.snapshot.model?.meta.title||result.snapshot.id;
const heading=one('.doc-toolbar h1');if(heading)heading.textContent=title;
const badge=one('[data-page-status]');if(badge)badge.textContent=result.snapshot.model?.meta.status||'draft';
const operation=operations.at(-1)?.fields.operation?.[0];
projection(result.projection,structural,operation);
if(rev===s.rev){
if(result.preview)displayPreview(result.preview);
if(result.preview_error)failure(result.preview_error);else notice(dirty()?'Изменения проверены. Сохранение — отдельным действием.':'Превью обновлено.');
}
return true;
}catch(e){
if(!alive(s)||e.name==='AbortError')return false;
s.failedRev=rev;
if(e.buffer&&s.sourceEpoch===sourceEpoch&&!batch.length){s.valid=false;projection(e.projection);}
failure(e,e.status);return false;
}finally{if(alive(s)){s.running=null;status();}}
})();
status();
if(!await s.running)return false;
}
return alive(s)&&s.valid;
}
function enqueue(work){const s=current;actions=actions.catch(()=>{}).then(async()=>{if(alive(s))await work();}).catch(e=>{if(alive(s))failure(e);});return actions;}
async function transform(values){
const s=current;if(!await flush())return false;
const normalized=Object.fromEntries(Object.entries(values).filter(([k])=>!ignored.has(k)).map(([k,v])=>[k,Array.isArray(v)?v.map(String):[String(v)]]));
s.rev++;s.failedRev=-1;s.edits.set('command:'+s.rev,{type:'inspector',fields:normalized,rev:s.rev,controls:[]});
return flush();
}
async function save(){
const s=current;if(!await flush()||!alive(s))return;
const rev=s.rev,source=s.buffer;
s.saving=(async()=>{
try{
const result=await post(s,'save',{source,etag:s.etag,revision:rev});if(!alive(s))return;
s.etag=result.snapshot.etag;s.saved=source;
notice(s.rev===rev?'Документ сохранён. Публикация не выполнялась.':'Документ сохранён; новые правки ещё не сохранены.');
}catch(e){
if(!alive(s)||e.name==='AbortError')return;
if(e.committed){s.etag=e.committed.etag;s.saved=e.committed.source;}
if(e.current)conflict(e,source);
failure(e,e.status);
}finally{if(alive(s)){s.saving=null;status();if(s.edits.size||s.buffer!==s.validated)schedule(0);}}
})();status();await s.saving;
}
function conflict(error,source){
const s=current;one('[data-conflict-dialog]',s.root)?.remove();
const dialog=document.createElement('dialog');dialog.className='modal builder-dialog expert-conflict-dialog conflict-panel';dialog.dataset.conflictDialog='';
dialog.innerHTML='<div class="modal-head"><h2>Документ изменён на сервере</h2><p>Ваши правки остаются в редакторе. Сравните версии и выполните слияние в «Эксперте».</p></div><div class="modal-body"><div class="conflict-columns"><label>Отправленный исходник<textarea rows="14" readonly></textarea></label><label>Серверный исходник<textarea rows="14" readonly></textarea></label></div><label class="checkrow"><input type="checkbox"> Принимаю серверную версию как новую основу</label></div><div class="modal-foot"><button type="button" class="button" data-close-dialog>Закрыть</button><button type="button" class="button primary" data-accept-base>Принять эту серверную версию как основу</button></div>';
const texts=dialog.querySelectorAll('textarea');texts[0].value=source;texts[1].value=error.current.source;
one('[data-accept-base]',dialog).addEventListener('click',()=>{if(!one('input',dialog).checked){one('input',dialog).focus();return;}s.etag=error.current.etag;dialog.close();status();notice('Новая основа принята. Проверьте исходник и сохраните отдельной кнопкой.');});
s.root.append(dialog);dialog.addEventListener('close',()=>dialog.remove(),{once:true});dialog.showModal();
}
async function leave(action){
const s=current,confirm=s.page?window.siteBuilderConfirm:window.siteAdminConfirm;
if(dirty()&&!await confirm('Есть несохранённые изменения','При переходе правки этой вкладки будут потеряны. Сохраните документ, если хотите оставить изменения.','Уйти без сохранения'))return false;
if(!alive(s))return false;clearTimeout(s.timer);s.controller.abort();action();return true;
}
async function download(){
const s=current;await flush();if(!alive(s))return;
const url=URL.createObjectURL(new Blob([s.buffer],{type:'text/markdown;charset=utf-8'})),a=document.createElement('a');a.href=url;a.download=s.root.dataset.base.split('/').pop()+'.md';a.click();setTimeout(()=>URL.revokeObjectURL(url),1000);
}
function setup(){
const root=one('#document-editor');if(root===current?.root)return;
if(current){clearTimeout(current.timer);current.controller.abort();}actions=Promise.resolve();
if(!root){current=null;return;}
const form=one('#buffer-form',root),raw=JSON.parse(root.dataset.rawSource);
current={root,form,source:one('#document-source',root),buffer:raw,saved:JSON.parse(root.dataset.canonicalSource),validated:raw,rev:Number(root.dataset.revision),etag:form.elements.etag.value,
page:root.classList.contains('page-builder'),mode:form.elements.mode.value||'constructor',selection:form.elements.selection.value,readonlySelection:one('#editor-result').dataset.readonly||'',valid:one('#editor-result').dataset.valid==='1',
edits:new Map(),fieldValues:new Map(),validationPending:false,sourceEpoch:0,failedRev:-1,timer:null,running:null,saving:null,controller:new AbortController(),preview:null,viewport:{x:0,y:0},device:'desktop'};
hydrate(root);root.dataset.ready='1';showMode(current.valid?current.mode:'expert');flush(true);
}
window.siteDocument={
get state(){const s=current;return s?{source:s.buffer,saved:s.saved,dirty:dirty(),mode:s.mode,busy:!!(s.running||s.saving),base:s.root.dataset.base}:null;},
notice,leave,flush,
previewReloading:()=>{const s=current;if(s?.preview){s.preview.ready=false;s.preview.document=null;setTimeout(()=>{if(alive(s)&&!s.preview.ready)displayPreview({...s.preview,html:''});},0);}},
change:element=>remember(element,true),
transform:values=>enqueue(()=>transform(values)),
reset:()=>enqueue(async()=>{
const s=current;if(!await (s.page?window.siteBuilderConfirm:window.siteAdminConfirm)('Отменить изменения?','Рабочая редакция вернётся к последней загруженной или сохранённой версии. Файл и опубликованный сайт не изменятся.','Отменить изменения'))return;
if(s.saving)await s.saving;if(s.running)await s.running;s.edits.clear();s.buffer=s.saved;s.source.value=s.saved;s.sourceEpoch++;s.rev++;s.failedRev=-1;s.validated=null;await flush(true);
})
};
document.addEventListener('click',event=>{
const s=current;if(!s||!alive(s))return;const b=event.target.closest('button');
if(b?.matches('[data-editor-mode]'))enqueue(async()=>{if(!await flush())return;if(b.dataset.editorMode==='constructor'&&!s.valid){notice('Исправьте исходник в «Эксперте».');return;}showMode(b.dataset.editorMode);});
if(b?.hasAttribute('data-download'))download();
if(b?.hasAttribute('data-preview'))flush(true);
if(b?.hasAttribute('data-validate')){event.preventDefault();enqueue(()=>flush(true));}
if(b?.hasAttribute('data-viewport')){s.device=b.dataset.viewport;s.root.querySelectorAll('[data-viewport]').forEach(el=>{el.classList.toggle('active',el.dataset.viewport===s.device);el.setAttribute('aria-pressed',String(el.dataset.viewport===s.device));});const frame=one('#preview-result iframe');if(frame)device(frame);}
const link=event.target.closest('a[href]');
if(link&&!event.defaultPrevented&&event.button===0&&!event.ctrlKey&&!event.metaKey&&!event.shiftKey&&!event.altKey&&!link.hasAttribute('download')&&(!link.target||link.target==='_self')&&!(link.href.includes('#')&&link.href.split('#')[0]===location.href.split('#')[0])&&dirty()){
event.preventDefault();event.stopImmediatePropagation();leave(()=>location.assign(link.href));
}
},true);
document.addEventListener('input',event=>{
const s=current;if(!s?.root.contains(event.target))return;
if(event.target===s.source){s.buffer=s.source.value;s.validationPending=true;s.sourceEpoch++;s.rev++;s.failedRev=-1;schedule(200);status();}
else remember(event.target,event.target.matches('select,input[type=checkbox],input[type=radio]'));
});
document.addEventListener('htmx:afterRequest', event => {
if(!current) return;
const pending=current.pending.get(event.detail.xhr);
if(!pending) return;
current.pending.delete(event.detail.xhr);
if(!pending.path.endsWith('/preview')) {
current.busy=false; current.source.readOnly=false;
const constructor=one('[data-constructor]');if(constructor)constructor.inert=one('#editor-result')?.dataset.valid!=='1';
if(event.detail.xhr.status===0) notice('Нет связи с сервером. Правки остаются в открытом редакторе.');
if(event.detail.xhr.status===200 && !pending.path.endsWith('/select')) setTimeout(requestPreview,0);
if(pending.path.endsWith('/select')) {
const b=one('.tree-node.selected,.readonly-block.selected');
if(b) send('editor:select',{block:{scope:b.dataset.treeScope,owner:b.dataset.treeOwner,id:b.dataset.treeId},scroll:true});
}
document.addEventListener('change',event=>{if(current?.root.contains(event.target)&&event.target.closest('[data-inspector]'))remember(event.target,true);});
document.addEventListener('submit',event=>{
const s=current;if(!s)return;const form=event.target;
if(form.closest('#document-editor')){
if(form.method==='dialog')return;
event.preventDefault();event.stopImmediatePropagation();
const submitter=event.submitter,data=fields(form,submitter),action=new URL(submitter?.hasAttribute('formaction')?submitter.formAction:form.action).pathname.split('/').pop();
if(action==='select'){
if(data.choose_readonly){try{choose(JSON.parse(data.choose_readonly[0]),true); }catch{}return;}
const node=submitter?.dataset.treeId?submitter:Array.from(s.root.querySelectorAll('[data-tree-id]')).find(e=>e.dataset.treeScope==='page'&&e.dataset.treeId===data.choose?.[0]);
if(node)choose({scope:node.dataset.treeScope,owner:node.dataset.treeOwner,id:node.dataset.treeId},true,submitter?.hasAttribute('data-focus-bind'));
else if(!s.page)choose({scope:'page',owner:'',id:''},false);
return;
}
if(form.matches('[data-inspector]')){remember(form,true);enqueue(()=>flush(true));return;}
if(action==='save'){enqueue(save);return;}
if(action==='validate'){enqueue(()=>flush(true));return;}
if(action==='transform'){
const values=Object.fromEntries(Object.entries(data).map(([k,v])=>[k,v.length===1?v[0]:v]));
enqueue(async()=>{
if(values.operation==='delete'&&!await (s.page?window.siteBuilderConfirm:window.siteAdminConfirm)('Удалить блок?','Будет удалён блок '+values.block_id+' вместе с вложенными блоками. Изменения затронут текущую редакцию до сохранения файла.','Удалить из редакции'))return;
if(await transform(values)){one('#builder-catalog-dialog')?.close();}
});
addEventListener('message', event => {
const p=current?.preview, frame=one('#preview-result iframe'), m=event.data;
if(!p || !m || event.origin!==current.root.dataset.previewOrigin || event.source!==frame?.contentWindow || m.snapshot!==p.snapshot || m.revision!==p.revision || p.revision!==current.rev) return;
if(m.type==='preview:ready' && Array.isArray(m.blocks)) {p.ready=true;send('editor:restore',current.viewport); if(current.selection||current.readonlySelection) {
syncSelection(p.selectionScroll===true);
}}
if(m.type==='preview:viewport' && Number.isFinite(m.x)&&Number.isFinite(m.y)) current.viewport={x:m.x,y:m.y};
if(m.type==='preview:select' && m.block && typeof m.block.id==='string') {
chooseFromPreview(m.block);
}
}else if(form.method!=='dialog'&&dirty()&&!leavingForms.has(form)){
event.preventDefault();event.stopImmediatePropagation();const submitter=event.submitter;
leave(()=>{leavingForms.add(form);try{form.requestSubmit(submitter);}finally{leavingForms.delete(form);}});
}
},true);
document.addEventListener('load',event=>{if(event.target===one('#preview-result iframe'))passive(event.target);},true);
addEventListener('message',event=>{
const s=current,m=event.data;if(!s||!m||event.origin!==s.root.dataset.previewOrigin)return;
const frame=one('#preview-result iframe'),loading=s.loadingPreview;
if(loading&&event.source===loading.frame.contentWindow&&m.snapshot===loading.snapshot&&m.revision===loading.revision&&m.type==='preview:ready'){s.earlyReady=m.snapshot;return;}
if(event.source!==frame?.contentWindow)return;
if(m.type==='preview:ready'&&s.nextPreview&&m.snapshot===s.nextPreview.snapshot&&m.revision===s.nextPreview.revision){
s.preview={...s.nextPreview,ready:true};s.nextPreview=null;const box=one('#preview-result');box.dataset.snapshot=m.snapshot;box.dataset.revision=String(m.revision);syncSelection();status();
const queued=s.queuedPreview;s.queuedPreview=null;if(queued)displayPreview(queued);return;
}
const p=s.preview;if(!p||m.snapshot!==p.snapshot||m.revision!==p.revision)return;
if(m.type==='preview:ready'){p.ready=true;send('editor:restore',s.viewport);syncSelection();status();}
if(m.type==='preview:viewport'&&Number.isFinite(m.x)&&Number.isFinite(m.y))s.viewport={x:m.x,y:m.y};
if(m.type==='preview:select'&&m.block&&typeof m.block.id==='string')choose(m.block,false);
});
document.addEventListener('htmx:load',setup);
setup();
document.addEventListener('htmx:load',setup);setup();
})();
@@ -0,0 +1,22 @@
/* Shared by the parent of a passive frame and the nonce-authorized preview bridge. */
(() => {
'use strict';
window.sitePreviewDocument = (doc, html) => {
const next = new DOMParser().parseFromString(html, 'text/html');
// A live update is markup only. Keep the original HTTP CSP and running bridge.
next.querySelectorAll('script,base,meta[http-equiv],link[rel=modulepreload],link[as=script]').forEach(e=>e.remove());
next.querySelectorAll('*').forEach(e=>Array.from(e.attributes).forEach(a=>{
if(/^on/i.test(a.name)||a.name==='nonce'||a.name==='srcdoc')e.removeAttribute(a.name);
}));
const syncAttributes=(old,node)=>{
Array.from(old.attributes).forEach(a=>old.removeAttribute(a.name));
Array.from(node.attributes).forEach(a=>old.setAttribute(a.name,a.value));
};
const x=doc.defaultView.scrollX,y=doc.defaultView.scrollY;
syncAttributes(doc.documentElement,next.documentElement);
syncAttributes(doc.body,next.body);
doc.head.replaceChildren(...Array.from(next.head.childNodes).map(n=>doc.importNode(n,true)));
doc.body.replaceChildren(...Array.from(next.body.childNodes).map(n=>doc.importNode(n,true)));
doc.defaultView.scrollTo({left:x,top:y,behavior:'instant'});
};
})();
@@ -27,6 +27,11 @@
addEventListener('message', event => {
const m = event.data;
if (event.origin !== cfg.origin || event.source !== parent || !m || m.snapshot !== cfg.snapshot || m.revision !== cfg.revision) return;
if (m.type === 'editor:render' && m.next && /^[a-f0-9]{32}$/.test(m.next.snapshot) && Number.isSafeInteger(m.next.revision) && m.next.revision >= cfg.revision && typeof m.next.html === 'string') {
window.sitePreviewDocument(document, m.next.html);
cfg.snapshot=m.next.snapshot; cfg.revision=m.next.revision;
if(chosen)select(chosen,false);send('preview:ready',{blocks:roots().map(key)});
}
if (m.type === 'editor:select' && m.block && roots().some(e => same(key(e), m.block))) select(m.block, m.scroll === true);
if (m.type === 'editor:restore' && Number.isFinite(m.x) && Number.isFinite(m.y)) scrollTo({left:Math.max(0,m.x), top:Math.max(0,m.y), behavior:'instant'});
});
@@ -1,6 +1,6 @@
{% from '_builder_icons.html.j2' import bi %}
{% from '_builder_fields.html.j2' import bf %}
{% macro state() %}<input type='hidden' name='csrf' value='{{ csrf }}'><input type='hidden' name='etag' value='{{ snap.etag }}'><input type='hidden' name='revision' value='{{ snap.revision }}'><input type='hidden' name='selection' value='{{ selection }}'><input type='hidden' name='mode' value='{{ mode }}'><textarea name='source' hidden>{{ '' if inspector_cached|default(false) else snap.source }}</textarea>{% endmacro %}
{% macro state() %}<input type='hidden' name='csrf' value='{{ csrf }}'><input type='hidden' name='etag' value='{{ snap.etag }}'><input type='hidden' name='revision' value='{{ snap.revision }}'><input type='hidden' name='selection' value='{{ selection }}'><input type='hidden' name='mode' value='{{ mode }}'>{% if not compact_update|default(false) %}<textarea name='source' hidden>{{ '' if inspector_cached|default(false) else snap.source }}</textarea>{% endif %}{% endmacro %}
<section class='pane inspectpane doc-inspector' id='inspectpane' aria-label='Инспектор'>
<div class='pane-head'><div><b class='constructor-only'>Инспектор</b><b class='expert-only'>Превью и проверки</b><br><small>Схема полей Fragment</small></div>{{ bi('setting') }}</div>
<div class='panel-tabs constructor-only'>{% for key, label in [('props','Свойства'),('bindings','Связи'),('page','Страница')] %}<button type='button' data-inspector-tab='{{ key }}'{% if key == ('props' if selected or readonly_selected else 'page') %} class='active'{% endif %}>{{ label }}</button>{% endfor %}</div>
@@ -19,16 +19,16 @@
{{ bind_box(f.name, f.bind) }}
</fieldset>
{% elif f.kind == 'list' %}
<fieldset class='list'>
<fieldset class='list' data-list-name='{{ f.name }}'>
<legend>{{ f.label }}{% if f.required %} *{% endif %}</legend>
{% for row in f.rows %}
<div class='row{% if row.blank %} blank{% endif %}'>
<div class='row{% if row.blank %} blank{% endif %}' data-list-row='{{ row.name }}'>
{% if row.item %}{{ field(row.item) }}{% else %}{% for c in row.children %}{{ field(c) }}{% endfor %}{% endif %}
{{ bind_box(row.name, row.bind) }}
{% if row.blank %}
<span class='hint'>Пустая строка: заполните её, чтобы добавить элемент.</span>
<span class='hint' data-list-hint>Пустая строка: заполните её, чтобы добавить элемент.</span>
{% else %}
<label class='inline'><input type='checkbox' name='{{ row.name }}._del' value='1'> удалить элемент</label>
<label class='inline' data-list-delete><input type='checkbox' name='{{ row.name }}._del' value='1'> удалить элемент</label>
{% endif %}
</div>
{% endfor %}
@@ -20,6 +20,7 @@
{% block scripts %}{% endblock %}
<script src='{{ static_url("admin.js") }}' defer></script>
<script src='{{ static_url("pages.js") }}' defer></script>
<script src='{{ static_url("preview-update.js") }}' defer></script>
<script src='{{ static_url("editor.js") }}' defer></script>
<script src='{{ static_url("builder.js") }}' defer></script>
<script src='{{ static_url("theme-studio.js") }}' defer></script>
@@ -1,6 +1,6 @@
{% from '_builder_icons.html.j2' import bi %}
{% from '_builder_fields.html.j2' import bf %}
{% macro state() %}<input type='hidden' name='csrf' value='{{ csrf }}'><input type='hidden' name='etag' value='{{ snap.etag }}'><input type='hidden' name='revision' value='{{ snap.revision }}'><input type='hidden' name='selection' value='{{ selection }}'><input type='hidden' name='mode' value='{{ mode }}'><textarea name='source' hidden>{{ snap.source }}</textarea>{% endmacro %}
{% macro state() %}<input type='hidden' name='csrf' value='{{ csrf }}'><input type='hidden' name='etag' value='{{ snap.etag }}'><input type='hidden' name='revision' value='{{ snap.revision }}'><input type='hidden' name='selection' value='{{ selection }}'><input type='hidden' name='mode' value='{{ mode }}'>{% if not compact_update|default(false) and not inspector_cached|default(false) %}<textarea name='source' hidden>{{ snap.source }}</textarea>{% endif %}{% endmacro %}
{% macro select_block(b, locked=false) %}
<form class='tree-select-form' method='post' action='/admin/editor{{ base }}/select' hx-post='/admin/editor{{ base }}/select' hx-target='#editor-result' hx-swap='outerHTML'>{{ state() }}
<button type='submit' class='tree-item {{ "fixed readonly-block" if locked else "tree-node" }}{% if (locked and readonly_selected and readonly_selected.id == b.id and readonly_selected.owner == b.owner) or (not locked and selected and selected.id == b.id) %} selected{% endif %}{% if b.hidden %} hidden{% endif %}' name='{{ "choose_readonly" if locked else "choose" }}' value='{{ {"scope": b.scope, "owner": b.owner, "id": b.id}|tojson if locked else b.id }}' data-tree-id='{{ b.id }}' data-tree-scope='{{ b.scope }}' data-tree-owner='{{ b.owner }}' data-depth='{{ b.depth }}'{% if not locked %} draggable='true'{% endif %} title='{{ b.id }}{% if b.requires %} · {{ b.requires|join(", ") }}{% endif %}'>
@@ -8,8 +8,8 @@
</button>
</form>
{% endmacro %}
<div id='editor-result' data-revision='{{ snap.revision }}' data-valid='{{ 1 if snap.model else 0 }}' data-saved='{{ 1 if saved else 0 }}' data-etag='{{ snap.etag }}' data-raw-source='{{ snap.source|tojson }}' data-title='{{ meta.get("title", snap.id) }}' data-status='{{ meta.get("status", "draft") }}' data-selection='{{ selected.id if selected else "" }}' data-readonly='{{ readonly_key }}'>
<textarea data-next-source hidden>{{ snap.source }}</textarea>
<div id='editor-result' data-revision='{{ snap.revision }}' data-valid='{{ 1 if snap.model else 0 }}' data-saved='{{ 1 if saved else 0 }}' data-etag='{{ snap.etag }}' {% if not compact_update|default(false) %}data-raw-source='{{ snap.source|tojson }}'{% endif %} data-title='{{ meta.get("title", snap.id) }}' data-status='{{ meta.get("status", "draft") }}' data-selection='{{ selected.id if selected else "" }}' data-readonly='{{ readonly_key }}'>
{% if not compact_update|default(false) %}<textarea data-next-source hidden>{{ snap.source }}</textarea>{% endif %}
<div data-constructor class='builder-projection'>
<section class='pane treepane' id='treepane' aria-label='Структура страницы'>
<div class='pane-head constructor-only'><div><b>Структура страницы</b><br><small>{{ blocks|length }} блоков · {{ snap.schema.layout }}</small></div><button class='button icon small' type='button' data-catalog-open title='Добавить блок'>{{ bi('plus') }}</button></div>
@@ -1,7 +1,7 @@
{% from '_fields.html.j2' import field %}
{% macro buffer_fields() %}<input type='hidden' name='csrf' value='{{ csrf }}'><input type='hidden' name='etag' value='{{ snap.etag }}'><input type='hidden' name='revision' value='{{ snap.revision }}'><input type='hidden' name='selection' value='{{ selection }}'><textarea name='source' hidden>{{ snap.source }}</textarea>{% endmacro %}
<div id='editor-result' data-revision='{{ snap.revision }}' data-valid='{{ 1 if snap.model else 0 }}' data-saved='{{ 1 if saved else 0 }}' data-etag='{{ snap.etag }}' data-raw-source='{{ snap.source|tojson }}' data-title='{{ meta.get("title", snap.id) }}' data-readonly='{{ readonly_key }}'>
<textarea data-next-source hidden>{{ snap.source }}</textarea>
{% macro buffer_fields() %}<input type='hidden' name='csrf' value='{{ csrf }}'><input type='hidden' name='etag' value='{{ snap.etag }}'><input type='hidden' name='revision' value='{{ snap.revision }}'><input type='hidden' name='selection' value='{{ selection }}'>{% if not compact_update|default(false) %}<textarea name='source' hidden>{{ snap.source }}</textarea>{% endif %}{% endmacro %}
<div id='editor-result' data-revision='{{ snap.revision }}' data-valid='{{ 1 if snap.model else 0 }}' data-saved='{{ 1 if saved else 0 }}' data-etag='{{ snap.etag }}' {% if not compact_update|default(false) %}data-raw-source='{{ snap.source|tojson }}'{% endif %} data-title='{{ meta.get("title", snap.id) }}' data-readonly='{{ readonly_key }}'>
{% if not compact_update|default(false) %}<textarea data-next-source hidden>{{ snap.source }}</textarea>{% endif %}
{% if saved %}<p class='success' role='status'>Документ сохранён. Публикация не выполнялась.</p>{% endif %}
{% if errors %}<ul class='issues' role='alert'>{% for e in errors %}<li class='error'>{{ e }}</li>{% endfor %}</ul>{% endif %}
{% if submitted_fields %}<details class='submitted-fields'><summary>Отправленные значения формы</summary>{% for key, values in submitted_fields %}{% if key not in ['csrf','source'] %}<p><code>{{ key }}</code>: {{ values|join(', ') }}</p>{% endif %}{% endfor %}</details>{% endif %}
+15
View File
@@ -101,6 +101,15 @@ class Transform(Buffer):
action: Action
class InspectorEdit(DTO):
type: Literal["inspector"]
fields: dict[str, list[str]]
class EditorUpdate(Buffer):
operations: list[Action | InspectorEdit] = Field(default_factory=list, max_length=100)
class Create(DTO):
id: str = Field(min_length=1, max_length=200)
title: str = ""
@@ -241,6 +250,12 @@ class Preview(DTO):
html: str = ""
class EditorUpdateResult(DTO):
snapshot: Snapshot
preview: Preview | None = None
preview_error: ErrorBody | None = None
class Rollback(DTO):
build_id: str = Field(pattern=r"^\d{8}T\d{6}-[0-9a-f]{8}$")
+44 -2
View File
@@ -24,6 +24,8 @@ from .models import (
Buffer,
CollectionRow,
Create,
EditorUpdate,
EditorUpdateResult,
Entries,
ErrorEnvelope,
OnboardingState,
@@ -108,7 +110,7 @@ def install_api(app, auth, root, dist, previews):
409,
"conflict",
exc,
submitted=buf.model_dump(exclude={"action"}) if buf else None,
submitted=buf.model_dump(exclude={"action", "operations"}) if buf else None,
current=current,
)
except AuditCommitError as exc:
@@ -129,7 +131,7 @@ def install_api(app, auth, root, dist, previews):
"validation",
exc,
issues=[i.to_dict() for i in exc.report.issues],
submitted=buf.model_dump(exclude={"action"}) if buf else None,
submitted=buf.model_dump(exclude={"action", "operations"}) if buf else None,
)
except (ValueError, KeyError) as exc:
return error(422, "invalid_operation", exc)
@@ -368,6 +370,46 @@ def install_api(app, auth, root, dist, previews):
return invoke(run, svc, identity, body)
def update(kind, identity, body, ctx, collection=""):
svc = service(kind, collection)
def run():
reg, result = svc.update_buffer(
identity, body.source, body.etag,
[op.model_dump(exclude_unset=True) for op in body.operations], body.revision,
)
dto = snapshot_dto(result)
if result.report.errors:
return error(422, "validation", "Исправьте ошибки документа",
buffer=dto.model_dump(by_alias=True, mode="json"),
issues=[issue.to_dict() for issue in result.report.issues])
preview, preview_error = None, None
try:
preview = previews.render_document(
reg, svc, identity, body.revision, ctx.principal, include_html=True
)
except Exception as exc: # noqa: BLE001 - preview failure is an independent result
# A failed preview must never roll back accepted in-memory edits.
log.exception("editor_preview_failed request_id=%s", request_id())
expected = isinstance(exc, EngineError)
preview_error = {"code": "preview_validation" if expected else "preview_failed",
"message": str(exc) if expected else "Не удалось обновить превью. Правки остаются в редакторе.",
"request_id": request_id(), "revision": body.revision,
"issues": [i.to_dict() for i in exc.report.issues] if expected else []}
return {"snapshot": dto, "preview": preview, "preview_error": preview_error}
return invoke(run, svc, identity, body)
@router.post("/editor/pages/{identity:path}/update", response_model=EditorUpdateResult)
@router.post("/pages/{identity:path}/update", response_model=EditorUpdateResult)
def page_update(identity: str, body: EditorUpdate, ctx: Ctx):
return update("page", identity, body, ctx)
@router.post("/editor/entries/{collection}/{identity}/update", response_model=EditorUpdateResult)
@router.post("/collections/{collection}/entries/{identity}/update", response_model=EditorUpdateResult)
def entry_update(collection: str, identity: str, body: EditorUpdate, ctx: Ctx):
return update("entry", identity, body, ctx, collection)
@router.post("/editor/pages/{identity:path}/validate", response_model=Snapshot)
@router.post("/pages/{identity:path}/validate", response_model=Snapshot)
def page_validate(identity: str, body: Buffer, ctx: Ctx):
+219
View File
@@ -0,0 +1,219 @@
"""Stateless editor updates: batching, API isolation, one registry and explicit saves."""
import json
import os
import tempfile
import unittest
from pathlib import Path
from unittest.mock import patch
from fastapi.testclient import TestClient
from theme_fixture import seed
from site_engine.core.registry import load_site
from site_engine.services.auth import hash_password
from site_engine.services.documents import DocumentService
from site_engine.services.pages import PageService
from site_engine.services.preview import PreviewStore
from site_engine.web.app import create_app
class EditorUpdateTests(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.password = "editor background test password"
cls.password_hash = hash_password(cls.password, n=2**10)
def setUp(self):
tmp = tempfile.TemporaryDirectory()
self.addCleanup(tmp.cleanup)
self.work = Path(tmp.name)
self.site = self.work / "site"
seed(self.site)
env = patch.dict(os.environ, {
"SITE_ROOT": str(self.site), "SITE_DIST": str(self.work / "dist"),
"SITE_STATE_DIR": str(self.work / "state"), "SITE_ADMIN_LOGIN": "admin",
"SITE_ADMIN_PASSWORD_HASH": self.password_hash,
"SITE_SECRET_KEY": "editor-update-test-secret-" * 3, "SITE_COOKIE_SECURE": "0",
"SITE_ADMIN_ORIGIN": "", "SITE_PREVIEW_ORIGIN": "",
})
env.start()
self.addCleanup(env.stop)
self.app = create_app()
self.client = TestClient(self.app)
self.addCleanup(self.client.close)
auth = self.app.state.auth
cookie = auth.login("admin", self.password, "testclient")
self.client.cookies.set("se_session", cookie)
self.app.state.api_credentials["test"] = (cookie, "testclient")
self.csrf = auth.csrf_token(auth.authenticate(cookie))
self.svc = PageService(self.site)
self.snap = self.svc.get("index")
self.payload = {"source": self.snap.source, "etag": self.snap.etag, "revision": 3,
"operations": []}
def api(self, payload=None, identity="pages/index", operation="update"):
return self.client.post("/admin/api/v1/" + identity + "/" + operation,
json=self.payload if payload is None else payload,
headers={"Authorization": "Bearer test"})
def ui(self, payload=None, csrf=None, operation="update"):
return self.client.post("/admin/editor/pages/index/" + operation,
data={"csrf": self.csrf if csrf is None else csrf,
"payload": json.dumps(self.payload if payload is None else payload),
"selection": "hero_home", "mode": "constructor"},
headers={"Origin": "http://testserver", "HX-Request": "true",
"Accept": "application/json"})
@staticmethod
def block(identity, **values):
return {"type": "block", "block_id": identity, "values": values}
def test_html_adapter_one_api_call_and_one_registry_for_update_and_preview(self):
self.payload["operations"] = [self.block("hero_home", note="First"),
self.block("richtext_child", note="Second")]
before = (self.site / "pages/index.md").read_bytes()
calls = self.app.state.api_calls
with patch("site_engine.services.documents.load_site", wraps=load_site) as load:
response = self.ui()
self.assertEqual(response.status_code, 200, response.text)
self.assertEqual(load.call_count, 1)
self.assertEqual(self.app.state.api_calls - calls, 1)
result = response.json()
self.assertIn("First", result["snapshot"]["source"])
self.assertIn("Second", result["snapshot"]["source"])
self.assertEqual(result["preview"]["revision"], 3)
self.assertIn("data-preview-id=", result["preview"]["html"])
self.assertIn("data-section-inspector", result["projection"])
self.assertNotIn("<textarea name='source'", result["projection"])
self.assertNotIn("data-raw-source", result["projection"])
self.assertNotIn("data-next-source", result["projection"])
self.assertEqual(before, (self.site / "pages/index.md").read_bytes())
self.assertFalse((self.site / ".engine/history").exists())
self.assertFalse((self.work / "dist/current").exists())
def test_no_operations_preserves_expert_source_bytes(self):
self.payload["source"] = self.snap.source.replace("---\n", "---\n# Keep comment\n", 1)
response = self.api()
self.assertEqual(response.status_code, 200, response.text)
self.assertEqual(response.json()["snapshot"]["source"], self.payload["source"])
def test_shared_inspector_parser_handles_nested_bindings_and_widths(self):
self.payload["operations"] = [{"type": "inspector", "fields": {
"operation": ["block"], "block_id": ["hero_home"],
"p.title._bind": ["page.title"], "p.subtitle": ["Updated subtitle"],
"p.actions.0.url.kind": ["url"], "p.actions.0.url.target": ["https://example.org"],
"p.actions.0.label": ["Background button"],
"block_layout.section_width": ["fluid"], "block_layout.content_width": ["boxed"],
}}]
response = self.api()
self.assertEqual(response.status_code, 200, response.text)
block = response.json()["snapshot"]["model"]["meta"]["regions"]["main"][0]
self.assertEqual(block["props"]["title"], {"bind": "page.title"})
self.assertEqual(block["layout"], {"section_width": "fluid", "content_width": "boxed"})
self.assertIn("Updated subtitle", response.json()["preview"]["html"])
def test_batch_is_all_or_nothing_for_invalid_later_action(self):
self.payload["operations"] = [self.block("hero_home", note="Must not leak"),
self.block("missing_block", note="Invalid")]
response = self.api()
self.assertEqual(response.status_code, 422)
error = response.json()["error"]
self.assertEqual(error["buffer"]["source"], self.snap.source)
self.assertNotIn("Must not leak", error["buffer"]["source"])
self.assertTrue(error["request_id"])
def test_invalid_form_and_malformed_source_preserve_input(self):
self.payload["operations"] = [{"type": "inspector", "fields": {
"operation": ["block"], "block_id": ["hero_home"],
"block_layout.section_width": ["wrong"],
}}]
response = self.ui()
self.assertEqual(response.status_code, 422, response.text)
self.assertEqual(response.json()["error"]["buffer"]["source"], self.snap.source)
self.assertIn("projection", response.json())
self.payload.update(source="---\ntitle: [broken\n---\n", operations=[])
response = self.ui()
self.assertEqual(response.status_code, 422, response.text)
self.assertEqual(response.json()["error"]["buffer"]["source"], self.payload["source"])
def test_preview_failure_returns_accepted_edit_and_traceable_error(self):
self.payload["operations"] = [self.block("hero_home", note="Accepted without preview")]
with patch.object(PreviewStore, "render_document", side_effect=OSError("disk full")), \
self.assertLogs("uvicorn.error", level="ERROR") as logs:
response = self.api()
self.assertEqual(response.status_code, 200, response.text)
result = response.json()
self.assertIn("Accepted without preview", result["snapshot"]["source"])
self.assertIsNone(result["preview"])
self.assertEqual(result["preview_error"]["code"], "preview_failed")
self.assertTrue(result["preview_error"]["request_id"])
self.assertIn("disk full", "\n".join(logs.output))
self.assertNotIn("Accepted without preview", "\n".join(logs.output))
def test_update_exception_uses_existing_error_boundary(self):
with patch.object(DocumentService, "update_buffer", side_effect=OSError("read failure")), \
self.assertLogs("uvicorn.error", level="ERROR"):
response = self.ui()
self.assertEqual(response.status_code, 500)
self.assertTrue(response.json()["error"]["request_id"])
def test_projection_programming_error_is_logged_as_500_not_invalid_input(self):
from site_engine.web.admin.application import AdminApplication
with patch.object(AdminApplication, "editor_projection", side_effect=TypeError("projection failure")), \
self.assertLogs("uvicorn.error", level="ERROR") as logs:
response = self.ui()
self.assertEqual(response.status_code, 500, response.text)
self.assertTrue(response.json()["error"]["request_id"])
self.assertIn("projection failure", "\n".join(logs.output))
def test_save_is_explicit_and_keeps_cas_conflict(self):
self.payload["operations"] = [self.block("hero_home", note="Explicit save")]
updated = self.ui().json()["snapshot"]
self.assertEqual((self.site / "pages/index.md").read_text(), self.snap.source)
save = {key: updated[key] for key in ("source", "etag", "revision")}
response = self.ui(save, operation="save")
self.assertEqual(response.status_code, 200, response.text)
self.assertEqual((self.site / "pages/index.md").read_text(), updated["source"])
conflict = self.ui(save, operation="save")
self.assertEqual(conflict.status_code, 409, conflict.text)
self.assertEqual(conflict.json()["error"]["current"]["source"], updated["source"])
def test_csrf_auth_and_invalid_payload_errors_are_json(self):
response = self.ui(csrf="wrong")
self.assertEqual(response.status_code, 403)
self.assertEqual(response.json()["error"]["code"], "forbidden")
response = self.ui({**self.payload, "unknown": True})
self.assertEqual(response.status_code, 422)
self.assertTrue(response.json()["error"]["request_id"])
self.client.cookies.clear()
response = self.ui()
self.assertEqual(response.status_code, 401)
self.assertEqual(response.json()["error"]["code"], "session_expired")
def test_entry_update_uses_own_overlay_and_never_writes(self):
from site_engine.services.entries import EntryService
snap = EntryService(self.site, collection="articles").get("first")
payload = {"source": snap.source, "etag": snap.etag, "revision": 7, "operations": [
{"type": "entry_fields", "values": {"title": "New article title"}, "body": "Updated body"}
]}
response = self.api(payload, identity="collections/articles/entries/first")
self.assertEqual(response.status_code, 200, response.text)
self.assertIn("Updated body", response.json()["preview"]["html"])
self.assertEqual((self.site / "content/articles/first.md").read_text(), snap.source)
response = self.client.post('/admin/editor/entries/articles/first/update',
data={"csrf": self.csrf, "payload": json.dumps(payload)},
headers={"Origin": "http://testserver", "Accept": "application/json"})
self.assertEqual(response.status_code, 200, response.text)
self.assertNotIn("<textarea name='source'", response.json()["projection"])
self.assertNotIn("data-raw-source", response.json()["projection"])
def test_form_move_rejects_ambiguous_target(self):
self.payload["operations"] = [{"type": "inspector", "fields": {
"operation": ["move"], "block_id": ["hero_home"], "direction": ["down"],
"before": ["section_outer"],
}}]
response = self.api()
self.assertEqual(response.status_code, 422, response.text)
self.assertEqual(response.json()["error"]["buffer"]["source"], self.snap.source)