diff --git a/.env.example b/.env.example index c709a23..3cac389 100644 --- a/.env.example +++ b/.env.example @@ -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. diff --git a/AGENTS.md b/AGENTS.md index 8c98303..e9fe518 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -8,8 +8,7 @@ ## Куда подключать дизайн -- Публичный сайт-пример: `examples/studio-site/`. Каркас — `layouts//{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//{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///` — `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` атомарно. diff --git a/scripts/qa_editor_updates.py b/scripts/qa_editor_updates.py new file mode 100644 index 0000000..1306652 --- /dev/null +++ b/scripts/qa_editor_updates.py @@ -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('', '') + 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:'FORGED UPDATE'}},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() diff --git a/scripts/verify_package_001.py b/scripts/verify_package_001.py index 7b30f8a..e447dd0 100644 --- a/scripts/verify_package_001.py +++ b/scripts/verify_package_001.py @@ -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) diff --git a/specs/001-antirion-admin/openapi.json b/specs/001-antirion-admin/openapi.json index ce683b2..d7ebec3 100644 --- a/specs/001-antirion-admin/openapi.json +++ b/specs/001-antirion-admin/openapi.json @@ -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", diff --git a/specs/003-background-editor/plan.md b/specs/003-background-editor/plan.md new file mode 100644 index 0000000..4e21d91 --- /dev/null +++ b/specs/003-background-editor/plan.md @@ -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 остаются зависимыми от полного серверного рендера; дальнейшая оптимизация требует отдельных измерений. diff --git a/specs/003-background-editor/runtime.md b/specs/003-background-editor/runtime.md new file mode 100644 index 0000000..48b212b --- /dev/null +++ b/specs/003-background-editor/runtime.md @@ -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": "...", "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 требует пересборки образа. diff --git a/specs/003-background-editor/spec.md b/specs/003-background-editor/spec.md new file mode 100644 index 0000000..7ee7ed7 --- /dev/null +++ b/specs/003-background-editor/spec.md @@ -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/. diff --git a/specs/003-background-editor/tasks.md b/specs/003-background-editor/tasks.md new file mode 100644 index 0000000..d6c3f5d --- /dev/null +++ b/specs/003-background-editor/tasks.md @@ -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 и спецификацию. + +Проверка пользователем на сервере после пересборки контейнера остаётся отдельной приёмкой. Коммит и развёртывание не выполняются этой задачей. diff --git a/specs/003-background-editor/verification.md b/specs/003-background-editor/verification.md new file mode 100644 index 0000000..55400b8 --- /dev/null +++ b/specs/003-background-editor/verification.md @@ -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/ не менялись. Развёртывание и коммит не выполнялись. После пересборки образа пользователь проверяет конструктор на своём сервере. diff --git a/src/site_engine/services/document_actions.py b/src/site_engine/services/document_actions.py new file mode 100644 index 0000000..b679365 --- /dev/null +++ b/src/site_engine/services/document_actions.py @@ -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"), + }, + } diff --git a/src/site_engine/services/document_fields.py b/src/site_engine/services/document_fields.py new file mode 100644 index 0000000..626745a --- /dev/null +++ b/src/site_engine/services/document_fields.py @@ -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 diff --git a/src/site_engine/services/documents.py b/src/site_engine/services/documents.py index 2ba8d3a..d8d0274 100644 --- a/src/site_engine/services/documents.py +++ b/src/site_engine/services/documents.py @@ -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 diff --git a/src/site_engine/services/preview.py b/src/site_engine/services/preview.py index 4b3c91e..de0de45 100644 --- a/src/site_engine/services/preview.py +++ b/src/site_engine/services/preview.py @@ -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"").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: diff --git a/src/site_engine/web/admin/application.py b/src/site_engine/web/admin/application.py index 840d39f..ea455d2 100644 --- a/src/site_engine/web/admin/application.py +++ b/src/site_engine/web/admin/application.py @@ -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 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") + 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"), ) - 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"), - }, - } + 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=""): + 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 diff --git a/src/site_engine/web/admin/forms.py b/src/site_engine/web/admin/forms.py index 78a0eba..7c34f2e 100644 --- a/src/site_engine/web/admin/forms.py +++ b/src/site_engine/web/admin/forms.py @@ -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, +) # ── значения → модель представления ────────────────────────────────────────── diff --git a/src/site_engine/web/admin/handlers.py b/src/site_engine/web/admin/handlers.py index 81afbb2..7288479 100644 --- a/src/site_engine/web/admin/handlers.py +++ b/src/site_engine/web/admin/handlers.py @@ -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) diff --git a/src/site_engine/web/admin/static/admin.js b/src/site_engine/web/admin/static/admin.js index 68cd85e..7aeabc5 100644 --- a/src/site_engine/web/admin/static/admin.js +++ b/src/site_engine/web/admin/static/admin.js @@ -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 (_) {} diff --git a/src/site_engine/web/admin/static/builder.js b/src/site_engine/web/admin/static/builder.js index 2c143c0..5c9b7a9 100644 --- a/src/site_engine/web/admin/static/builder.js +++ b/src/site_engine/web/admin/static/builder.js @@ -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; diff --git a/src/site_engine/web/admin/static/editor.js b/src/site_engine/web/admin/static/editor.js index 713dae3..1046447 100644 --- a/src/site_engine/web/admin/static/editor.js +++ b/src/site_engine/web/admin/static/editor.js @@ -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'); - }; - 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);}); + 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';}}); }); } - 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)); + 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; } - 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 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 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'}); + 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'});} } - return; + }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);} } - if (p?.ready && frame && current.root.dataset.previewOrigin) frame.contentWindow.postMessage({type,snapshot:p.snapshot,revision:p.revision,...extra},current.root.dataset.previewOrigin); + 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 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); + 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))[rename(name),value]).filter(([name])=>name!==null)); + pending.controls=pending.controls.map(value=>({...value,name:rename(value.name)})).filter(value=>value.name!==null); + } + 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); + } }); - else if(!current.inspectorDirty) showMode(b.dataset.editorMode); - else notice('Примените изменения инспектора перед сменой режима.'); + if(wasInside&&!active.isConnected)one('input:not([type=hidden]),textarea,select',form)?.focus({preventScroll:true}); + s.fieldValues.set(key,JSON.stringify(fields(form))); } - 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'); + } + 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()); } - 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); - } - }); - return; + 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);} } - }, 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('Превью недоступно. Правки остаются в редакторе.');} + 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); + } 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}); + } + 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; } - 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); + 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=''; + 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();} + }); + } + }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);}}); } - }); - 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); + },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(); })(); diff --git a/src/site_engine/web/admin/static/preview-update.js b/src/site_engine/web/admin/static/preview-update.js new file mode 100644 index 0000000..b30ee4e --- /dev/null +++ b/src/site_engine/web/admin/static/preview-update.js @@ -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'}); + }; +})(); diff --git a/src/site_engine/web/admin/static/preview.js b/src/site_engine/web/admin/static/preview.js index 3f0778e..b87c0ff 100644 --- a/src/site_engine/web/admin/static/preview.js +++ b/src/site_engine/web/admin/static/preview.js @@ -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'}); }); diff --git a/src/site_engine/web/admin/templates/_builder_inspector.html.j2 b/src/site_engine/web/admin/templates/_builder_inspector.html.j2 index dee78bd..9553e64 100644 --- a/src/site_engine/web/admin/templates/_builder_inspector.html.j2 +++ b/src/site_engine/web/admin/templates/_builder_inspector.html.j2 @@ -1,6 +1,6 @@ {% from '_builder_icons.html.j2' import bi %} {% from '_builder_fields.html.j2' import bf %} -{% macro state() %}{% endmacro %} +{% macro state() %}{% if not compact_update|default(false) %}{% endif %}{% endmacro %}
ИнспекторПревью и проверки
Схема полей Fragment
{{ bi('setting') }}
{% for key, label in [('props','Свойства'),('bindings','Связи'),('page','Страница')] %}{% endfor %}
diff --git a/src/site_engine/web/admin/templates/_fields.html.j2 b/src/site_engine/web/admin/templates/_fields.html.j2 index 93e7bff..7214150 100644 --- a/src/site_engine/web/admin/templates/_fields.html.j2 +++ b/src/site_engine/web/admin/templates/_fields.html.j2 @@ -19,16 +19,16 @@ {{ bind_box(f.name, f.bind) }} {% elif f.kind == 'list' %} -
+
{{ f.label }}{% if f.required %} *{% endif %} {% for row in f.rows %} -
+
{% 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 %} - Пустая строка: заполните её, чтобы добавить элемент. + Пустая строка: заполните её, чтобы добавить элемент. {% else %} - + {% endif %}
{% endfor %} diff --git a/src/site_engine/web/admin/templates/base.html.j2 b/src/site_engine/web/admin/templates/base.html.j2 index 5ff37ad..190a34a 100644 --- a/src/site_engine/web/admin/templates/base.html.j2 +++ b/src/site_engine/web/admin/templates/base.html.j2 @@ -20,6 +20,7 @@ {% block scripts %}{% endblock %} + diff --git a/src/site_engine/web/admin/templates/builder_result.html.j2 b/src/site_engine/web/admin/templates/builder_result.html.j2 index 3807285..838f43a 100644 --- a/src/site_engine/web/admin/templates/builder_result.html.j2 +++ b/src/site_engine/web/admin/templates/builder_result.html.j2 @@ -1,6 +1,6 @@ {% from '_builder_icons.html.j2' import bi %} {% from '_builder_fields.html.j2' import bf %} -{% macro state() %}{% endmacro %} +{% macro state() %}{% if not compact_update|default(false) and not inspector_cached|default(false) %}{% endif %}{% endmacro %} {% macro select_block(b, locked=false) %}
{{ state() }}
{% endmacro %} -
- +
+{% if not compact_update|default(false) %}{% endif %}
Структура страницы
{{ blocks|length }} блоков · {{ snap.schema.layout }}
diff --git a/src/site_engine/web/admin/templates/entry_editor_result.html.j2 b/src/site_engine/web/admin/templates/entry_editor_result.html.j2 index 6bc091d..3da5805 100644 --- a/src/site_engine/web/admin/templates/entry_editor_result.html.j2 +++ b/src/site_engine/web/admin/templates/entry_editor_result.html.j2 @@ -1,7 +1,7 @@ {% from '_fields.html.j2' import field %} -{% macro buffer_fields() %}{% endmacro %} -
- +{% macro buffer_fields() %}{% if not compact_update|default(false) %}{% endif %}{% endmacro %} +
+ {% if not compact_update|default(false) %}{% endif %} {% if saved %}

Документ сохранён. Публикация не выполнялась.

{% endif %} {% if errors %}{% endif %} {% if submitted_fields %}{% endif %} diff --git a/src/site_engine/web/api/models.py b/src/site_engine/web/api/models.py index 1fe9502..c012525 100644 --- a/src/site_engine/web/api/models.py +++ b/src/site_engine/web/api/models.py @@ -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}$") diff --git a/src/site_engine/web/api/routes.py b/src/site_engine/web/api/routes.py index 9f093b6..06806b9 100644 --- a/src/site_engine/web/api/routes.py +++ b/src/site_engine/web/api/routes.py @@ -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): diff --git a/tests/test_editor_updates.py b/tests/test_editor_updates.py new file mode 100644 index 0000000..dbdf07c --- /dev/null +++ b/tests/test_editor_updates.py @@ -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("