mnote/rust/crates/mnote-web/src/routes/web_shell.rs

use crate::app::{AppConfig, AppState};
use crate::context::RequestContext;
use crate::error::WebError;
use crate::page_aggregate::PageAggregate;
use crate::routes::documents::{
    load_document_content_result, load_document_meta_result, DocumentContentQuery,
    DocumentMetaQuery,
};
use crate::routes::local_folder_source::{
    load_local_folder_file_tree_snapshot, load_local_folder_page_tree_snapshot,
    resolve_local_markdown_page_aggregate,
};
use crate::routes::query_support::execute_runtime_query_against_data;
use crate::routes::snapshot_support::{
    execute_kernel_query, load_projection_snapshot, projection_query, ProjectionSnapshotSpec,
};
use crate::routes::tree::{collect_filetree_render_rows, collect_page_tree_render_rows};
use crate::ssr::pages::document::DocumentPage;
use crate::tree_shell::filetree_renderer::{
    render_initial_filetree_html, FileTreeInitialRenderInput,
};
use crate::tree_shell::page_renderer::{render_initial_page_tree_html, PageTreeInitialRenderInput};
use crate::workspace_shell::{
    apply_active_page, build_workspace_shell_projection, render_workspace_shell_sidebar_html,
    WorkspaceShellProjection,
};
use axum::body::Body;
use axum::extract::{Extension, Path, Query, State};
use axum::http::{header, HeaderMap, HeaderName, HeaderValue, StatusCode};
use axum::response::{Html, IntoResponse, Response};
use axum::Json;
use bridge_runtime::RuntimeQueryEnvelopeWire;
use core_protocol::KernelProjectionKind;
use serde::Deserialize;
use serde_json::json;
use std::path::{Component, Path as FsPath, PathBuf};

const HEADER_MNOTE_WEB_OWNER: &str = "x-mnote-web-owner";
const HEADER_MNOTE_WEB_SHELL: &str = "x-mnote-web-shell";
const COOKIE_RECENT_PAGE_ID: &str = "mnote_recent_page_id";

#[derive(Debug, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct DocumentShellQuery {
    pub workspace_id: Option<String>,
    pub source_kind: Option<String>,
    pub root_uri: Option<String>,
}

#[derive(Debug, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct DocumentPageCompatQuery {
    pub document_id: String,
    pub workspace_id: Option<String>,
}

pub async fn document_page_shell(
    State(state): State<AppState>,
    Extension(context): Extension<RequestContext>,
    Path(document_id): Path<String>,
    Query(query): Query<DocumentShellQuery>,
) -> Result<Response, WebError> {
    let aggregate = build_page_aggregate_snapshot(
        &state,
        &context,
        &document_id,
        query.workspace_id.as_deref(),
        query.source_kind.as_deref(),
        query.root_uri.as_deref(),
    )
    .await?;
    let title = aggregate.head.title.as_str();
    let workspace_id = aggregate.identity.workspace_id.clone();
    let default_workspace_name = format!("{} 的空间", state.config().dev_user_name);
    let mut workspace_projection = load_workspace_shell_projection(
        state.config(),
        &context,
        &workspace_id,
        Some(&document_id),
        &default_workspace_name,
    )
    .await;
    apply_active_page(&mut workspace_projection, Some(&document_id));
    let is_local_folder = query
        .source_kind
        .as_deref()
        .map(str::trim)
        .filter(|value| !value.is_empty())
        == Some("local_folder");
    let (sidebar_tree_html, file_tree_html) = if is_local_folder {
        let root_uri = query.root_uri.as_deref().unwrap_or_default();
        (
            render_local_sidebar_tree_html(root_uri, Some(&document_id)).unwrap_or_default(),
            render_local_file_tree_html(root_uri, Some(&document_id)).unwrap_or_default(),
        )
    } else {
        (
            load_sidebar_tree_html(state.config(), &context, &workspace_id, Some(&document_id))
                .await
                .unwrap_or_default(),
            load_file_tree_html(state.config(), &context, &workspace_id, Some(&document_id))
                .await
                .unwrap_or_default(),
        )
    };
    let workspace_sidebar_html = render_workspace_shell_sidebar_html(
        &workspace_projection,
        Some(sidebar_tree_html.as_str()),
        Some(file_tree_html.as_str()),
    );
    let workspace_name = workspace_projection.workspace_name.clone();
    let page_subtree_json =
        serde_json::to_string(&aggregate.tree.page_subtree).unwrap_or_else(|_| "null".to_string());
    let page_options_json = serde_json::to_string(&aggregate.layout.page_options)
        .unwrap_or_else(|_| "null".to_string());
    let snapshot_json = serde_json::to_string(&aggregate).unwrap_or_else(|_| "null".to_string());
    let bootstrap_json = build_editor_bootstrap_json(
        &aggregate,
        &context,
        query.source_kind.as_deref(),
        query.root_uri.as_deref(),
    );
    let body_content = crate::ssr::render_view(leptos::view! {
        <DocumentPage
            title={title.to_string()}
            document_id={document_id.clone()}
            workspace_id={workspace_id.clone()}
            sidebar_tree_html={sidebar_tree_html}
            workspace_name={workspace_name}
            workspace_sidebar_html={workspace_sidebar_html}
            page_subtree_json={page_subtree_json}
            page_options_json={page_options_json}
        />
    });
    let html = format!(
        r#"<!doctype html>
<html lang="zh-CN">
  <head>
    <meta charset="utf-8">
    <title>{}</title>
    <style>{}</style>
  </head>
  <body data-mnote-web-owner="mnote-web" data-mnote-shell="document" data-document-id="{}">
    {}
    <script id="__MNOTE_PAGE_AGGREGATE__" type="application/json">{}</script>
    <script id="__MNOTE_EDITOR_BOOTSTRAP__" type="application/json">{}</script>
    {}
    {}
  </body>
</html>"#,
        escape_html(title),
        crate::ssr::MNOTE_CSS,
        escape_html(&document_id),
        body_content,
        escape_script_json(&snapshot_json),
        escape_script_json(&bootstrap_json),
        render_document_title_controller_script(),
        render_editor_island_adapter_script(),
    );
    let mut response = Html(html).into_response();
    stamp_shell_headers(response.headers_mut(), "document");
    stamp_recent_page_cookie(response.headers_mut(), &document_id);
    Ok(response)
}

pub(crate) fn build_editor_bootstrap_json(
    aggregate: &PageAggregate,
    context: &RequestContext,
    source_kind: Option<&str>,
    root_uri: Option<&str>,
) -> String {
    serde_json::to_string(&json!({
        "schema": "mnote.editor_bootstrap.v1",
        "documentId": aggregate.identity.document_id,
        "workspaceId": aggregate.identity.workspace_id,
        "sourceKind": source_kind
            .map(str::trim)
            .filter(|value| !value.is_empty())
            .unwrap_or("convex_workspace"),
        "rootUri": root_uri
            .map(str::trim)
            .filter(|value| !value.is_empty())
            .unwrap_or(""),
        "pageAggregateScriptId": "__MNOTE_PAGE_AGGREGATE__",
        "saveEndpoint": "/api/documents/save",
        "titleEndpoint": "/api/documents/title",
        "editorHostKind": "leptos_tiptap_island",
        "assetMode": "rust-web-leptos-tiptap-spike-island-bundle",
        "requestId": context.trace.request_id,
        "traceId": context.trace.trace_id,
    }))
    .unwrap_or_else(|_| "{}".to_string())
}

pub(crate) fn render_document_title_controller_script() -> &'static str {
    r#"<script>
(() => {
  const CONTRACT = 'mnote.document_title_controller.v1';
  const input = document.querySelector('[data-page-title-input="true"]');
  if (!(input instanceof HTMLTextAreaElement)) return;

  input.setAttribute('data-title-controller', CONTRACT);
  const endpoint = input.getAttribute('data-title-endpoint') || '/api/documents/title';
  const documentId = (input.getAttribute('data-document-id') || document.body?.dataset.documentId || '').trim();
  const query = new URLSearchParams(window.location.search);
  const workspaceId = (input.getAttribute('data-workspace-id') || query.get('workspaceId') || '').trim();
  const sourceKind = (query.get('sourceKind') || '').trim();
  const rootUri = (query.get('rootUri') || '').trim();
  let lastSavedTitle = input.value.trim() || '无标题';
  let saving = false;

  const cssEscape = (value) => {
    if (window.CSS && typeof window.CSS.escape === 'function') return window.CSS.escape(value);
    return String(value).replace(/["\\]/g, '\\$&');
  };

  const autosize = () => {
    input.style.height = 'auto';
    input.style.height = `${Math.max(48, input.scrollHeight)}px`;
  };

  const setStatus = (status, message) => {
    input.setAttribute('data-title-save-status', status);
    const shell = input.closest('.document-shell');
    if (shell instanceof HTMLElement) shell.setAttribute('data-title-save-status', status);
    if (message) input.setAttribute('data-title-save-error', message);
    else input.removeAttribute('data-title-save-error');
  };

  const setText = (selector, title) => {
    document.querySelectorAll(selector).forEach((node) => {
      if (node instanceof HTMLElement) node.textContent = title;
    });
  };

  const updateVisibleTitle = (title) => {
    document.title = title;
    setText('[data-page-title-current]', title);
    const current = document.querySelector('.wolai-breadcrumb-current');
    if (current instanceof HTMLElement) {
      let titleNode = current.querySelector('[data-page-title-current]');
      if (!(titleNode instanceof HTMLElement)) {
        titleNode = document.createElement('span');
        titleNode.setAttribute('data-page-title-current', 'true');
        current.appendChild(titleNode);
      }
      titleNode.textContent = title;
    }
    if (!documentId) return;
    const escapedId = cssEscape(documentId);
    const escapedDocRowId = cssEscape(`doc:${documentId}`);
    setText(`.tree-row[data-shell-mode="page"][data-node-id="${escapedId}"] > .tree-link > .tree-link-title`, title);
    setText(`.tree-row[data-shell-mode="filetree"][data-row-id="${escapedDocRowId}"] > .tree-link > .tree-link-title`, title);
    setText(`.wolai-page-row[data-node-id="${escapedId}"] > .wolai-row-title`, title);
    setText(`a[href="/documents/${escapedId}"] > .wolai-row-title`, title);
    setText(`a[href^="/documents/${escapedId}?"] > .wolai-row-title`, title);
  };

  const saveTitle = async () => {
    const title = input.value.trim() || '无标题';
    autosize();
    if (!documentId || saving || title === lastSavedTitle) {
      updateVisibleTitle(title);
      setStatus('saved');
      return;
    }
    saving = true;
    setStatus('saving');
    try {
      const response = await fetch(endpoint, {
        method: 'POST',
        headers: { 'content-type': 'application/json' },
        body: JSON.stringify({
          documentId,
          workspaceId: workspaceId || null,
          sourceKind: sourceKind || undefined,
          rootUri: rootUri || undefined,
          title,
          commandName: 'page.head.updateTitle',
        }),
      });
      const payload = await response.json().catch(() => null);
      if (!response.ok || !payload || payload.ok !== true) {
        throw new Error(payload?.error?.message || payload?.message || `title_failed_${response.status}`);
      }
      lastSavedTitle = title;
      updateVisibleTitle(title);
      setStatus('saved');
      window.dispatchEvent(new CustomEvent('tree:title-updated', {
        detail: { documentId, workspaceId: workspaceId || null, title, payload },
      }));
    } catch (error) {
      setStatus('error', error instanceof Error ? error.message : String(error));
    } finally {
      saving = false;
    }
  };

  input.addEventListener('input', () => {
    autosize();
    setStatus(input.value.trim() === lastSavedTitle ? 'saved' : 'dirty');
  });
  input.addEventListener('keydown', (event) => {
    if (event.key === 'Enter' && !event.shiftKey) {
      event.preventDefault();
      input.blur();
    }
  });
  input.addEventListener('blur', () => { void saveTitle(); });
  autosize();
  updateVisibleTitle(lastSavedTitle);
  setStatus('saved');
})();
</script>"#
}

pub(crate) fn render_editor_island_adapter_script() -> &'static str {
    r#"<script type="module">
(() => {
  const ROOT_SELECTOR = '[data-testid="mnote-leptos-tiptap-island-editor-root"]';
  const EVENT_PREFIX = 'mnote:leptos-tiptap-spike';
  const CHANGE_EVENT = `${EVENT_PREFIX}:change`;
  const SAVE_EVENT = `${EVENT_PREFIX}:save-request`;
  const READY_EVENT = `${EVENT_PREFIX}:ready`;
  const ERROR_EVENT = `${EVENT_PREFIX}:error`;
  const COMMAND_EVENT = `${EVENT_PREFIX}:command`;
  const BRIDGE_PROTOCOL = 'mnote.leptos_tiptap.bridge.v1';

  const parseJsonScript = (id) => {
    const node = document.getElementById(id);
    if (!node) return null;
    try {
      return JSON.parse(node.textContent || 'null');
    } catch (error) {
      console.warn(`mnote rust-web editor bootstrap JSON 解析失败: ${id}`, error);
      return null;
    }
  };

  const root = document.querySelector(ROOT_SELECTOR);
  const observability = document.querySelector('[data-editor-host-observability]');
  const aggregate = parseJsonScript('__MNOTE_PAGE_AGGREGATE__');
  const bootstrap = parseJsonScript('__MNOTE_EDITOR_BOOTSTRAP__');
  if (!(root instanceof HTMLElement) || !aggregate || !bootstrap) return;

  const setStatus = (status, message) => {
    root.setAttribute('data-runtime-editor-status', status);
    if (message) root.setAttribute('data-runtime-editor-error', message);
    if (observability instanceof HTMLElement) {
      observability.setAttribute('data-editor-host-status', status);
      observability.setAttribute('data-editor-host-active', 'leptos_tiptap_island');
    }
  };

  const flattenText = (value) => {
    if (typeof value === 'string') return value;
    if (Array.isArray(value)) return value.map(flattenText).join('');
    if (value && typeof value === 'object') {
      return `${flattenText(value.text)}${flattenText(value.content)}`;
    }
    return '';
  };

  const legacyStylesToTiptapMarks = (styles) => {
    if (!styles || typeof styles !== 'object') return [];
    const marks = [];
    if (styles.bold) marks.push({ type: 'bold' });
    if (styles.italic) marks.push({ type: 'italic' });
    if (styles.underline) marks.push({ type: 'underline' });
    if (styles.strike || styles.strikethrough) marks.push({ type: 'strike' });
    if (styles.code || styles.inlineCode) marks.push({ type: 'code' });
    const href = typeof styles.link === 'string' && styles.link.trim()
      ? styles.link.trim()
      : typeof styles.href === 'string' && styles.href.trim()
        ? styles.href.trim()
        : '';
    if (href) marks.push({ type: 'link', attrs: { href } });
    return marks;
  };

  const legacyInlineContentToTiptap = (value) => {
    if (typeof value === 'string') return value ? [{ type: 'text', text: value }] : [];
    if (Array.isArray(value)) return value.flatMap(legacyInlineContentToTiptap);
    if (value && typeof value === 'object') {
      const text = typeof value.text === 'string' ? value.text : '';
      if (text) {
        const marks = legacyStylesToTiptapMarks(value.styles);
        return [{ type: 'text', text, ...(marks.length ? { marks } : {}) }];
      }
      return legacyInlineContentToTiptap(value.content || value.contentNodes);
    }
    return [];
  };

  const legacyBlockToTiptap = (block, index = 0) => {
    const type = typeof block?.type === 'string' ? block.type : 'paragraph';
    const blockId = typeof block?.id === 'string' && block.id.trim()
      ? block.id.trim()
      : typeof block?.blockId === 'string' && block.blockId.trim()
        ? block.blockId.trim()
        : `block-${index + 1}`;
    const content = legacyInlineContentToTiptap(block?.content ?? block?.contentNodes);
    const textAlign = typeof block?.props?.textAlign === 'string'
      ? block.props.textAlign
      : typeof block?.props?.text_align === 'string'
        ? block.props.text_align
        : undefined;
    const withTextAlign = (attrs = {}) => textAlign ? { ...attrs, textAlign } : attrs;
    const nestedChildren = Array.isArray(block?.children)
      ? block.children.map((child, childIndex) => legacyBlockToTiptap(child, childIndex)).filter(Boolean)
      : [];
    const withListChildren = (itemType, listType, attrs = {}) => ({
      type: listType,
      attrs: { blockId },
      content: [{
        type: itemType,
        attrs: { blockId, ...attrs },
        content: [
          { type: 'paragraph', attrs: { blockId }, content },
          ...nestedChildren,
        ],
      }],
    });
    if (type === 'heading') {
      const level = Number(block?.props?.level || block?.level || 1) || 1;
      const collapsed = typeof block?.props?.collapsed === 'boolean' ? { collapsed: block.props.collapsed } : {};
      return { type: 'heading', attrs: withTextAlign({ blockId, level: Math.max(1, Math.min(6, level)), ...collapsed }), content };
    }
    if (type === 'bulletListItem' || type === 'bullet_list_item') {
      return withListChildren('listItem', 'bulletList');
    }
    if (type === 'numberedListItem' || type === 'numbered_list_item') {
      return withListChildren('listItem', 'orderedList');
    }
    if (type === 'checkListItem' || type === 'advancedTodo' || type === 'todo') {
      return withListChildren('taskItem', 'taskList', { checked: Boolean(block?.props?.checked) });
    }
    if (type === 'quote' || type === 'blockquote') {
      return { type: 'blockquote', attrs: withTextAlign({ blockId }), content: [{ type: 'paragraph', attrs: withTextAlign({ blockId }), content }] };
    }
    if (type === 'codeBlock' || type === 'code_block') {
      return { type: 'codeBlock', attrs: withTextAlign({ blockId, language: block?.props?.language || null }), content };
    }
    if (type === 'divider' || type === 'horizontalRule' || type === 'horizontal_rule') {
      return { type: 'horizontalRule', attrs: { blockId } };
    }
    if (type === 'table') {
      const tableSnapshot = block?.props?.tiptapTable;
      if (tableSnapshot && typeof tableSnapshot === 'object' && tableSnapshot.type === 'table') {
        return tableSnapshot;
      }
      return {
        type: 'table',
        content: [{
          type: 'tableRow',
          content: [{
            type: 'tableCell',
            attrs: { colspan: 1, rowspan: 1, colwidth: null },
            content: [{ type: 'paragraph', content }],
          }],
        }],
      };
    }
    if (type === 'toc' || type === 'tocNode' || type === 'toc_node') {
      const tocSnapshot = block?.props?.tiptapTocNode || block?.props?.tiptapToc;
      if (tocSnapshot && typeof tocSnapshot === 'object' && tocSnapshot.type === 'tocNode') {
        return tocSnapshot;
      }
      return {
        type: 'tocNode',
        attrs: {
          topOffset: Number(block?.props?.topOffset || block?.props?.top_offset || 0) || 0,
          maxShowCount: Number(block?.props?.maxShowCount || block?.props?.max_show_count || 20) || 20,
          showTitle: block?.props?.showTitle !== false,
        },
      };
    }
    if (type === 'image') {
      const imageSnapshot = block?.props?.tiptapImage;
      if (imageSnapshot && typeof imageSnapshot === 'object' && imageSnapshot.type === 'image') {
        return imageSnapshot;
      }
      const attrs = {
        src: String(block?.props?.src || block?.src || ''),
        alt: block?.props?.alt || block?.alt || null,
        title: block?.props?.title || block?.title || null,
      };
      return attrs.src ? { type: 'image', attrs: { blockId, ...attrs } } : null;
    }
    return { type: 'paragraph', attrs: withTextAlign({ blockId }), content };
  };

  const textToTiptapDocument = (text) => ({
    type: 'doc',
    content: [{
      type: 'paragraph',
      content: text ? [{ type: 'text', text }] : [],
    }],
  });

  const currentEditorText = () => {
    const editor = root.querySelector('.editor-surface .ProseMirror');
    return editor?.textContent || '';
  };

  const isTiptapDocument = (content) => (
    content &&
    typeof content === 'object' &&
    !Array.isArray(content) &&
    content.type === 'doc'
  );

  const toTiptapDocument = (content, fallbackText = '') => {
    if (isTiptapDocument(content)) {
      return content;
    }
    const blocks = Array.isArray(content)
      ? content
      : Array.isArray(content?.blocks)
        ? content.blocks
        : [];
    const nodes = blocks.map(legacyBlockToTiptap).filter(Boolean);
    if (nodes.length) {
      return { type: 'doc', content: nodes };
    }
    return textToTiptapDocument(fallbackText);
  };

  const inlineTextNodes = (node) => {
    if (!node || typeof node !== 'object') return [];
    if (Array.isArray(node.content)) {
      return node.content.flatMap((child) => {
        if (child?.type === 'text') {
          const text = typeof child.text === 'string' ? child.text : '';
          if (!text) return [];
          const styles = {};
          for (const mark of Array.isArray(child.marks) ? child.marks : []) {
            if (mark?.type === 'bold') styles.bold = true;
            if (mark?.type === 'italic') styles.italic = true;
            if (mark?.type === 'underline') styles.underline = true;
            if (mark?.type === 'strike') styles.strike = true;
            if (mark?.type === 'code') styles.code = true;
            if (mark?.type === 'link') {
              const href = typeof mark?.attrs?.href === 'string' ? mark.attrs.href.trim() : '';
              if (href) styles.link = href;
            }
          }
          return [{ type: 'text', text, ...(Object.keys(styles).length ? { styles } : {}) }];
        }
        if (child?.type === 'hardBreak') {
          return [{ type: 'text', text: '\n' }];
        }
        return inlineTextNodes(child);
      });
    }
    return [];
  };

  const firstChild = (node) => Array.isArray(node?.content) ? node.content[0] : null;
  const blockIdOf = (node, index) => {
    const raw = typeof node?.attrs?.blockId === 'string' ? node.attrs.blockId.trim() : '';
    return raw || `block-${index + 1}`;
  };

  const tiptapNodeToEditorBlock = (node, index) => {
    const blockId = blockIdOf(node, index);
    if (node?.type === 'paragraph') {
      return { blockId, blockType: 'paragraph', props: {}, contentNodes: inlineTextNodes(node), childBlockIds: [] };
    }
    if (node?.type === 'heading') {
      const level = Math.max(1, Math.min(6, Number(node?.attrs?.level || 1) || 1));
      return { blockId, blockType: 'heading', props: { headingLevel: level }, contentNodes: inlineTextNodes(node), childBlockIds: [] };
    }
    if (node?.type === 'bulletList') {
      return { blockId, blockType: 'bullet_list_item', props: {}, contentNodes: inlineTextNodes(firstChild(firstChild(node))), childBlockIds: [] };
    }
    if (node?.type === 'orderedList') {
      return { blockId, blockType: 'numbered_list_item', props: {}, contentNodes: inlineTextNodes(firstChild(firstChild(node))), childBlockIds: [] };
    }
    if (node?.type === 'taskList') {
      const taskItem = firstChild(node);
      return { blockId, blockType: 'todo', props: { checked: Boolean(taskItem?.attrs?.checked) }, contentNodes: inlineTextNodes(firstChild(taskItem)), childBlockIds: [] };
    }
    if (node?.type === 'blockquote') {
      return { blockId, blockType: 'quote', props: {}, contentNodes: inlineTextNodes(firstChild(node)), childBlockIds: [] };
    }
    if (node?.type === 'codeBlock') {
      return { blockId, blockType: 'code_block', props: { language: typeof node?.attrs?.language === 'string' ? node.attrs.language : null }, contentNodes: inlineTextNodes(node), childBlockIds: [] };
    }
    if (node?.type === 'horizontalRule') {
      return { blockId, blockType: 'divider', props: {}, contentNodes: [], childBlockIds: [] };
    }
    if (node?.type === 'image') {
      return { blockId, blockType: 'image', props: { src: node?.attrs?.src || '', alt: node?.attrs?.alt || null, title: node?.attrs?.title || null, tiptapImage: node }, contentNodes: [], childBlockIds: [] };
    }
    if (node?.type === 'tocNode') {
      return { blockId, blockType: 'toc', props: { tiptapTocNode: node }, contentNodes: [], childBlockIds: [] };
    }
    if (node?.type === 'table') {
      return { blockId, blockType: 'table', props: { tiptapTable: node }, contentNodes: inlineTextNodes(node), childBlockIds: [] };
    }
    return null;
  };

  const editorDocumentFromTiptapDocument = (tiptapDocument) => {
    const content = Array.isArray(tiptapDocument?.content) ? tiptapDocument.content : [];
    const blocks = content.map(tiptapNodeToEditorBlock).filter(Boolean);
    return {
      documentId: bootstrap.documentId,
      rootBlockIds: blocks.map((block) => block.blockId),
      blocks,
    };
  };

  const legacyBlocksFromEditorDocument = (editorDocument) => (
    Array.isArray(editorDocument?.blocks) ? editorDocument.blocks : []
  ).map((block) => ({
    id: block.blockId,
    type: block.blockType,
    props: block.blockType === 'heading'
      ? { level: block.props?.headingLevel || 1 }
      : block.blockType === 'todo'
        ? { checked: Boolean(block.props?.checked) }
        : block.blockType === 'code_block'
          ? { language: block.props?.language || null }
          : block.blockType === 'image'
            ? { ...(block.props || {}) }
            : block.blockType === 'toc'
              ? { ...(block.props || {}) }
              : block.blockType === 'table'
                ? { ...(block.props || {}) }
                : undefined,
    content: Array.isArray(block.contentNodes)
      ? block.contentNodes.map((node) => {
        if (!node || typeof node !== 'object') return null;
        const text = typeof node.text === 'string' ? node.text : '';
        if (!text) return null;
        return {
          type: 'text',
          text,
          ...(node.styles && typeof node.styles === 'object' ? { styles: node.styles } : {}),
        };
      }).filter(Boolean)
      : '',
  }));

  const pageBody = aggregate.body || {};
  const permissions = aggregate.head?.permissions || {};
  const conflictDetectionKeyFromBody = (body) => typeof body?.conflictDetectionKey === 'string'
    ? body.conflictDetectionKey
    : typeof body?.conflict_detection_key === 'string'
      ? body.conflict_detection_key
      : null;
  const conflictDetectionKey = conflictDetectionKeyFromBody(pageBody);
  const revisionFromConflictKey = (value) => {
    const match = String(value || '').match(/:(\d+)$/);
    return match ? Number(match[1]) : null;
  };
  const pageBodyRevision = Number.isInteger(pageBody.revision) ? pageBody.revision : null;
  const keyRevision = revisionFromConflictKey(conflictDetectionKey);
  const editorMeta = {
    revision: pageBodyRevision && pageBodyRevision > 0 ? pageBodyRevision : keyRevision,
    conflictDetectionKey,
  };
  const mountOptions = {
    documentId: bootstrap.documentId,
    workspaceId: bootstrap.workspaceId,
    title: aggregate.head?.title || '无标题',
    content: toTiptapDocument(pageBody.content),
    revision: editorMeta.revision,
    conflictDetectionKey: editorMeta.conflictDetectionKey,
    readOnly: Boolean(permissions.readOnly),
    editable: !Boolean(permissions.readOnly),
    pageOptions: aggregate.layout?.pageOptions || {},
  };

  const clearEmbeddedLocalDraft = () => {
    if (bootstrap.sourceKind !== 'local_folder') return;
    try {
      const storage = window.localStorage;
      const base = 'mnote.leptos-tiptap-spike.document';
      const keys = [
        `${base}:${bootstrap.workspaceId}:${bootstrap.documentId}`,
        `${base}:${bootstrap.documentId}`,
      ];
      for (const key of keys) storage.removeItem(key);
    } catch (error) {
      console.warn('mnote local folder 草稿清理失败', error);
    }
  };

  let saveTimer = 0;
  let lastSavedSerialized = '';
  let hasPendingLocalChanges = false;
  let suppressNextHostSyncChange = false;
  let localExternalEvents = null;
  let lastExternalConflictDetectionKey = editorMeta.conflictDetectionKey || '';
  const normalizeBridgeValue = (value) => {
    if (value instanceof Map) {
      const out = {};
      for (const [key, item] of value.entries()) {
        out[key] = normalizeBridgeValue(item);
      }
      return out;
    }
    if (Array.isArray(value)) {
      return value.map(normalizeBridgeValue);
    }
    if (value && typeof value === 'object') {
      return Object.fromEntries(
        Object.entries(value).map(([key, item]) => [key, normalizeBridgeValue(item)]),
      );
    }
    return value;
  };
  const normalizeEnvelopePayload = (event) => {
    const detail = normalizeBridgeValue(event?.detail);
    if (!detail || typeof detail !== 'object') return null;
    const payload = detail.payload && typeof detail.payload === 'object' ? detail.payload : detail;
    return payload && typeof payload === 'object' ? payload : null;
  };

  const savePayload = async (payload) => {
    const tiptapDocument = toTiptapDocument(
      payload?.tiptapDocument || payload?.editorDocument || payload?.content,
      currentEditorText(),
    );
    const serialized = JSON.stringify(tiptapDocument);
    if (suppressNextHostSyncChange && serialized === lastSavedSerialized) {
      suppressNextHostSyncChange = false;
      hasPendingLocalChanges = false;
      setStatus('saved');
      return;
    }
    if (serialized === lastSavedSerialized) {
      hasPendingLocalChanges = false;
      setStatus('saved');
      return;
    }
    const editorDocument = editorDocumentFromTiptapDocument(tiptapDocument);
    const content = legacyBlocksFromEditorDocument(editorDocument);
    setStatus('saving');
    const response = await fetch(bootstrap.saveEndpoint || '/api/documents/save', {
      method: 'POST',
      headers: { 'content-type': 'application/json' },
      body: JSON.stringify({
        documentId: bootstrap.documentId,
        workspaceId: bootstrap.workspaceId,
        sourceKind: bootstrap.sourceKind,
        rootUri: bootstrap.rootUri,
        revision: editorMeta.revision,
        conflictDetectionKey: editorMeta.conflictDetectionKey,
        editorDocument,
        content,
        tiptapDocument,
        blockCount: editorDocument.blocks.length,
      }),
    });
    const result = await response.json().catch(() => null);
    if (!response.ok || !result || result.ok !== true) {
      const message = result?.error?.message || result?.message || `save_failed_${response.status}`;
      throw new Error(message);
    }
    const saved = result.result || {};
    if (Number.isInteger(saved.revision)) editorMeta.revision = saved.revision;
    if (typeof saved.conflict_detection_key === 'string') editorMeta.conflictDetectionKey = saved.conflict_detection_key;
    if (typeof saved.conflictDetectionKey === 'string') editorMeta.conflictDetectionKey = saved.conflictDetectionKey;
    if (editorMeta.conflictDetectionKey) lastExternalConflictDetectionKey = editorMeta.conflictDetectionKey;
    lastSavedSerialized = serialized;
    hasPendingLocalChanges = false;
    if (typeof window.__mnoteRecordPageHistorySnapshot === 'function') {
      window.__mnoteRecordPageHistorySnapshot('save', {
        wordCount: content.filter((block) => typeof block?.content === 'string' && block.content.trim()).length,
        characterCount: currentEditorText().replace(/\s/g, '').length,
        blockCount: editorDocument.blocks.length,
        todoTotal: editorDocument.blocks.filter((block) => block.blockType === 'todo').length,
        todoDone: editorDocument.blocks.filter((block) => block.blockType === 'todo' && block.props?.checked).length,
      });
    }
    setStatus('saved');
  };

  const queueSave = (event) => {
    const payload = normalizeEnvelopePayload(event);
    if (!payload) return;
    if (suppressNextHostSyncChange) {
      const tiptapDocument = toTiptapDocument(
        payload?.tiptapDocument || payload?.editorDocument || payload?.content,
        currentEditorText(),
      );
      if (JSON.stringify(tiptapDocument) === lastSavedSerialized) {
        suppressNextHostSyncChange = false;
        hasPendingLocalChanges = false;
        setStatus('saved');
        return;
      }
    }
    if (saveTimer) window.clearTimeout(saveTimer);
    hasPendingLocalChanges = true;
    setStatus('dirty');
    saveTimer = window.setTimeout(() => {
      saveTimer = 0;
      savePayload(payload).catch((error) => {
        setStatus('error', error instanceof Error ? error.message : String(error));
      });
    }, 650);
  };

  root.addEventListener(READY_EVENT, () => setStatus('ready'));
  root.addEventListener(ERROR_EVENT, (event) => {
    const payload = normalizeEnvelopePayload(event);
    setStatus('error', payload?.message || 'runtime_error');
  });
  root.addEventListener(CHANGE_EVENT, queueSave);
  root.addEventListener(SAVE_EVENT, queueSave);

  const pageAggregateUrl = () => {
    const url = new URL(`/api/page-aggregate/${encodeURIComponent(bootstrap.documentId)}`, window.location.origin);
    url.searchParams.set('sourceKind', bootstrap.sourceKind || 'local_folder');
    if (bootstrap.rootUri) url.searchParams.set('rootUri', bootstrap.rootUri);
    return url;
  };

  const dispatchReplaceContent = (nextAggregate) => {
    const nextBody = nextAggregate?.body || {};
    const nextPermissions = nextAggregate?.head?.permissions || {};
    const nextConflictKey = conflictDetectionKeyFromBody(nextBody);
    const nextRevision = Number.isInteger(nextBody.revision) ? nextBody.revision : revisionFromConflictKey(nextConflictKey);
    const nextTiptapDocument = toTiptapDocument(nextBody.content);
    editorMeta.revision = nextRevision;
    editorMeta.conflictDetectionKey = nextConflictKey;
    lastExternalConflictDetectionKey = nextConflictKey || '';
    lastSavedSerialized = JSON.stringify(nextTiptapDocument);
    hasPendingLocalChanges = false;
    suppressNextHostSyncChange = true;
    clearEmbeddedLocalDraft();
    root.dispatchEvent(new CustomEvent(COMMAND_EVENT, {
      bubbles: true,
      detail: {
        protocol: BRIDGE_PROTOCOL,
        runtime: 'mnote-leptos-tiptap-spike',
        version: '1.1.0',
        source: 'mnote-web-local-folder-watch',
        event: COMMAND_EVENT,
        payload: {
          command: 'replaceContent',
          documentId: bootstrap.documentId,
          workspaceId: bootstrap.workspaceId,
          title: nextAggregate?.head?.title || mountOptions.title,
          content: nextTiptapDocument,
          revision: editorMeta.revision,
          conflictDetectionKey: editorMeta.conflictDetectionKey,
          readOnly: Boolean(nextPermissions.readOnly),
        },
      },
    }));
    setStatus('synced-external-change');
  };

  const refreshFromExternalFileChange = async () => {
    if (bootstrap.sourceKind !== 'local_folder' || !bootstrap.rootUri || document.hidden) return;
    try {
      const response = await fetch(pageAggregateUrl().toString(), {
        cache: 'no-store',
        headers: { accept: 'application/json' },
      });
      if (!response.ok) return;
      const payload = await response.json();
      const nextAggregate = payload?.result;
      const nextConflictKey = conflictDetectionKeyFromBody(nextAggregate?.body || {});
      if (!nextConflictKey || !lastExternalConflictDetectionKey) {
        lastExternalConflictDetectionKey = nextConflictKey || lastExternalConflictDetectionKey;
        return;
      }
      if (nextConflictKey === lastExternalConflictDetectionKey) return;
      if (hasPendingLocalChanges || saveTimer) {
        setStatus('external-change-conflict', '本地 Markdown 文件已在外部更新，请刷新或保存前先处理冲突');
        return;
      }
      dispatchReplaceContent(nextAggregate);
    } catch (error) {
      console.warn('mnote local folder 外部更新检测失败', error);
    }
  };

  const connectLocalMarkdownExternalEvents = () => {
    if (bootstrap.sourceKind !== 'local_folder' || !bootstrap.rootUri || typeof window.EventSource !== 'function') {
      return;
    }
    const url = new URL('/api/local-folder/events', window.location.origin);
    url.searchParams.set('rootUri', bootstrap.rootUri);
    url.searchParams.set('documentId', bootstrap.documentId);
    localExternalEvents = new EventSource(url.toString());
    localExternalEvents.addEventListener('change', () => {
      void refreshFromExternalFileChange();
    });
    localExternalEvents.onerror = () => {
      console.warn('mnote local folder 外部更新事件流中断，将等待浏览器自动重连');
    };
  };

  const start = async () => {
    setStatus('loading-assets');
    const manifestResponse = await fetch('/api/leptos-tiptap-runtime/manifest.json', { cache: 'no-store' });
    if (!manifestResponse.ok) throw new Error(`manifest_failed_${manifestResponse.status}`);
    const manifest = await manifestResponse.json();
    if (!manifest.entryAssetPath) throw new Error('island manifest 缺少 entryAssetPath');
    const entryUrl = `/api/leptos-tiptap-runtime/${manifest.entryAssetPath}`;
    const wasmUrl = manifest.wasmAssetPath ? `/api/leptos-tiptap-runtime/${manifest.wasmAssetPath}` : undefined;
    const runtime = await import(entryUrl);
    if (typeof runtime.default !== 'function' || typeof runtime.mount !== 'function') {
      throw new Error('island runtime 导出不完整');
    }
    await runtime.default(wasmUrl);
    clearEmbeddedLocalDraft();
    const mountId = runtime.mount(root, mountOptions);
    lastSavedSerialized = JSON.stringify(mountOptions.content);
    root.setAttribute('data-runtime-mount-id', String(mountId));
    root.setAttribute('data-editor-host-kind', 'leptos_tiptap_island');
    if (typeof window.__mnoteApplyPageOptionsToShell === 'function') {
      window.__mnoteApplyPageOptionsToShell();
    }
    connectLocalMarkdownExternalEvents();
    setStatus('ready');
  };

  start().catch((error) => {
    setStatus('error', error instanceof Error ? error.message : String(error));
  });
})();
</script>"#
}

fn runtime_asset_root() -> PathBuf {
    PathBuf::from(env!("CARGO_MANIFEST_DIR"))
        .join("../../spikes/leptos-tiptap-spike/generated/island")
}

fn resolve_runtime_asset_path(asset_path: &str) -> Option<PathBuf> {
    let asset_path = asset_path.trim();
    if asset_path.is_empty() || asset_path.starts_with('/') || asset_path.contains('\\') {
        return None;
    }
    let mut resolved = runtime_asset_root();
    for component in FsPath::new(asset_path).components() {
        match component {
            Component::Normal(part) => resolved.push(part),
            _ => return None,
        }
    }
    Some(resolved)
}

fn runtime_asset_content_type(asset_path: &str) -> &'static str {
    if asset_path.ends_with(".wasm") {
        "application/wasm"
    } else if asset_path.ends_with(".js") {
        "application/javascript; charset=utf-8"
    } else if asset_path.ends_with(".json") {
        "application/json; charset=utf-8"
    } else {
        "application/octet-stream"
    }
}

pub async fn editor_image_placeholder_asset() -> Response {
    const SVG: &str = r##"<svg xmlns="http://www.w3.org/2000/svg" width="640" height="360" viewBox="0 0 640 360" role="img" aria-label="E24 image placeholder">
  <rect width="640" height="360" rx="18" fill="#f3f4f6"/>
  <rect x="42" y="42" width="556" height="276" rx="14" fill="#ffffff" stroke="#d1d5db" stroke-width="2"/>
  <circle cx="168" cy="132" r="34" fill="#93c5fd"/>
  <path d="M98 278 246 174 340 242 410 192 542 278Z" fill="#86efac"/>
  <path d="M98 278 246 174 340 242 410 192 542 278" fill="none" stroke="#16a34a" stroke-width="8" stroke-linejoin="round"/>
  <text x="320" y="322" text-anchor="middle" font-family="Arial, sans-serif" font-size="22" fill="#374151">E24 Image</text>
</svg>"##;
    Response::builder()
        .status(StatusCode::OK)
        .header(header::CONTENT_TYPE, "image/svg+xml; charset=utf-8")
        .header(header::CACHE_CONTROL, "no-store")
        .header(HEADER_MNOTE_WEB_OWNER, "mnote-web")
        .body(Body::from(SVG))
        .unwrap_or_else(|_| Response::new(Body::empty()))
}

pub async fn leptos_tiptap_manifest() -> Response {
    let manifest = json!({
        "entryAssetPath": "mnote-leptos-tiptap-spike-island.js",
        "wasmAssetPath": "mnote-leptos-tiptap-spike-island_bg.wasm",
        "assetPaths": [
            "mnote-leptos-tiptap-spike-island.js",
            "mnote-leptos-tiptap-spike-island_bg.wasm"
        ],
        "generatedRootPath": "rust/spikes/leptos-tiptap-spike/generated/island"
    });
    let mut response = Json(manifest).into_response();
    stamp_shell_headers(response.headers_mut(), "leptos-tiptap-runtime");
    response
}

pub async fn leptos_tiptap_asset(Path(asset_path): Path<String>) -> Result<Response, WebError> {
    let Some(resolved) = resolve_runtime_asset_path(&asset_path) else {
        return Err(WebError::bad_request_code(
            "runtime_asset_path_invalid",
            "leptos-tiptap runtime asset 路径非法",
        ));
    };
    let bytes = std::fs::read(&resolved).map_err(|_| {
        WebError::new(
            StatusCode::NOT_FOUND,
            "runtime_asset_not_found",
            format!("leptos-tiptap runtime asset 不存在: {asset_path}"),
        )
    })?;
    let response = Response::builder()
        .status(StatusCode::OK)
        .header(
            header::CONTENT_TYPE,
            runtime_asset_content_type(&asset_path),
        )
        .header(header::CACHE_CONTROL, "no-store")
        .header(HEADER_MNOTE_WEB_OWNER, "mnote-web")
        .body(Body::from(bytes))
        .map_err(|error| WebError::internal(format!("runtime asset 响应构造失败: {error}")))?;
    Ok(response)
}

pub async fn documents_page_compat(
    State(state): State<AppState>,
    Extension(context): Extension<RequestContext>,
    Query(query): Query<DocumentPageCompatQuery>,
) -> Result<Response, WebError> {
    let document_id = query.document_id.trim().to_string();
    if document_id.is_empty() {
        return Err(
            WebError::bad_request_code("document_id_required", "缺少有效 documentId")
                .with_context(&context),
        );
    }
    let aggregate = build_page_aggregate_snapshot(
        &state,
        &context,
        &document_id,
        query.workspace_id.as_deref(),
        None,
        None,
    )
    .await?;
    let projection_owner = aggregate.source_label();
    let mut response = (
        StatusCode::OK,
        Json(json!({
            "ok": true,
            "owner": "mnote-web",
            "schema": "mnote.documents_page_compat.v1",
            "page": aggregate,
            "requestId": context.trace.request_id,
            "traceId": context.trace.trace_id,
        })),
    )
        .into_response();
    stamp_shell_headers(response.headers_mut(), "documents-page-compat");
    if let Ok(name) = HeaderName::from_lowercase(b"x-mnote-page-aggregate-owner") {
        if let Ok(value) = HeaderValue::from_str(projection_owner) {
            response.headers_mut().insert(name, value);
        }
    }
    Ok(response)
}

pub async fn page_aggregate(
    State(state): State<AppState>,
    Extension(context): Extension<RequestContext>,
    Path(document_id): Path<String>,
    Query(query): Query<DocumentShellQuery>,
) -> Result<Response, WebError> {
    let aggregate = build_page_aggregate_snapshot(
        &state,
        &context,
        &document_id,
        query.workspace_id.as_deref(),
        query.source_kind.as_deref(),
        query.root_uri.as_deref(),
    )
    .await?;
    let projection_owner = aggregate.source_label();
    let mut response = (
        StatusCode::OK,
        Json(json!({
            "ok": true,
            "owner": "mnote-web",
            "schema": "mnote.page_aggregate.v1",
            "result": aggregate,
            "requestId": context.trace.request_id,
            "traceId": context.trace.trace_id,
        })),
    )
        .into_response();
    stamp_shell_headers(response.headers_mut(), "page-aggregate");
    if let Ok(name) = HeaderName::from_lowercase(b"x-mnote-page-aggregate-owner") {
        if let Ok(value) = HeaderValue::from_str(projection_owner) {
            response.headers_mut().insert(name, value);
        }
    }
    Ok(response)
}

pub(crate) async fn build_page_aggregate_snapshot(
    state: &AppState,
    context: &RequestContext,
    document_id: &str,
    workspace_id: Option<&str>,
    source_kind: Option<&str>,
    root_uri: Option<&str>,
) -> Result<PageAggregate, WebError> {
    if source_kind.map(str::trim).filter(|value| !value.is_empty()) == Some("local_folder") {
        let root_uri = root_uri
            .map(str::trim)
            .filter(|value| !value.is_empty())
            .ok_or_else(|| {
                WebError::bad_request_code("local_folder_root_required", "缺少本地文件夹 rootUri")
            })?;
        return resolve_local_markdown_page_aggregate(root_uri, document_id);
    }

    let meta = load_document_meta_result(
        state,
        context,
        DocumentMetaQuery {
            document_id: document_id.to_string(),
            workspace_id: workspace_id.map(str::to_string),
        },
    )
    .await?;
    let content = load_document_content_result(
        state,
        context,
        DocumentContentQuery {
            document_id: document_id.to_string(),
            workspace_id: workspace_id.map(str::to_string),
        },
    )
    .await?;

    let projection = execute_runtime_query_against_data(
        context,
        workspace_id,
        RuntimeQueryEnvelopeWire {
            name: "page.aggregate.get".into(),
            payload: json!({
                "documentId": document_id,
                "workspaceId": workspace_id,
            }),
        },
        json!({
            "meta": meta,
            "content": content,
        }),
    )?;

    serde_json::from_value::<PageAggregate>(projection).map_err(|error| {
        WebError::internal(format!("Page Aggregate projection 反序列化失败: {error}"))
    })
}

fn stamp_recent_page_cookie(headers: &mut HeaderMap, document_id: &str) {
    let value = document_id
        .chars()
        .map(|ch| {
            if ch.is_ascii_alphanumeric() || matches!(ch, '_' | '-' | '.') {
                ch
            } else {
                '_'
            }
        })
        .collect::<String>();
    if value.is_empty() {
        return;
    }
    let cookie = format!("{COOKIE_RECENT_PAGE_ID}={value}; Path=/; SameSite=Lax");
    if let Ok(value) = HeaderValue::from_str(&cookie) {
        headers.append(header::SET_COOKIE, value);
    }
}

fn stamp_shell_headers(headers: &mut HeaderMap, shell: &'static str) {
    if let Ok(name) = HeaderName::from_lowercase(HEADER_MNOTE_WEB_OWNER.as_bytes()) {
        headers.insert(name, HeaderValue::from_static("mnote-web"));
    }
    if let Ok(name) = HeaderName::from_lowercase(HEADER_MNOTE_WEB_SHELL.as_bytes()) {
        headers.insert(name, HeaderValue::from_static(shell));
    }
    headers.insert(header::CACHE_CONTROL, HeaderValue::from_static("no-store"));
}

pub(crate) fn escape_html(value: &str) -> String {
    value
        .replace('&', "&amp;")
        .replace('<', "&lt;")
        .replace('>', "&gt;")
        .replace('"', "&quot;")
}

pub(crate) fn escape_script_json(value: &str) -> String {
    value.replace("</script", "<\\/script")
}

pub(crate) async fn load_workspace_shell_projection(
    config: &AppConfig,
    context: &RequestContext,
    workspace_id: &str,
    active_document_id: Option<&str>,
    default_workspace_name: &str,
) -> WorkspaceShellProjection {
    let spec = ProjectionSnapshotSpec {
        workspace_id,
        root_node_id: None,
        depth: Some(99),
        projection: KernelProjectionKind::SidebarTree,
        query: None,
        max_results: None,
    };
    let dataset = load_projection_snapshot(config, context, &spec)
        .await
        .map(|snapshot| snapshot.dataset)
        .unwrap_or_else(|_| {
            let documents = active_document_id
                .map(|document_id| {
                    json!([{
                        "id": document_id,
                        "workspace_id": workspace_id,
                        "title": "个人",
                        "parent_id": null,
                        "sort_order": 0,
                        "is_starred": false
                    }])
                })
                .unwrap_or_else(|| json!([]));
            json!({
                "active_workspace_id": workspace_id,
                "active_page_id": active_document_id,
                "workspaces": [{ "id": workspace_id, "name": default_workspace_name }],
                "documents": documents
            })
        });

    build_workspace_shell_projection(
        &dataset,
        workspace_id,
        active_document_id,
        default_workspace_name,
    )
}

/// 加载侧栏页面树 HTML（SSR）
///
/// 从 sidebar projection snapshot 中构建页面树 HTML 字符串。
/// 如果加载失败（如 Convex 未配置），返回空字符串，侧栏静默降级为无树状态。
/// 当 allow_dev_fixtures 启用且 Convex 不可用时，使用内建示例数据展示页面树。
pub(crate) async fn load_sidebar_tree_html(
    config: &AppConfig,
    context: &RequestContext,
    workspace_id: &str,
    active_document_id: Option<&str>,
) -> Option<String> {
    let spec = ProjectionSnapshotSpec {
        workspace_id,
        root_node_id: None,
        depth: Some(99),
        projection: KernelProjectionKind::SidebarTree,
        query: None,
        max_results: None,
    };
    let result = match load_projection_snapshot(config, context, &spec).await {
        Ok(snapshot) => Some(snapshot.projection),
        Err(_) if config.allow_dev_fixtures => {
            // Dev 模式降级：如果调用方已经有 active 页面，优先保留这条真实选择链。
            let documents = active_document_id
                .map(|document_id| {
                    serde_json::json!([
                        { "id": document_id, "workspace_id": workspace_id, "title": "个人", "parent_id": null, "sort_order": 0 }
                    ])
                })
                .unwrap_or_else(|| {
                    serde_json::json!([
                        { "id": "dev_welcome", "workspace_id": workspace_id, "title": "欢迎使用 MNOTE", "parent_id": null, "sort_order": 0 },
                        { "id": "dev_guide", "workspace_id": workspace_id, "title": "使用指南", "parent_id": "dev_welcome", "sort_order": 1 },
                        { "id": "dev_api", "workspace_id": workspace_id, "title": "API 文档", "parent_id": "dev_welcome", "sort_order": 2 }
                    ])
                });
            let dev_dataset = serde_json::json!({
                "active_workspace_id": workspace_id,
                "documents": documents,
                "trashed_documents": [],
                "media_assets": [],
                "trashed_media_assets": [],
                "mindmap_assets": [],
                "trashed_mindmap_assets": [],
                "table_assets": [],
                "trashed_table_assets": [],
                "mindmap_docs": [],
                "mindmap_asset_children": {}
            });
            execute_kernel_query(context, workspace_id, projection_query(&spec), dev_dataset).ok()
        }
        Err(_) => None,
    };
    result.map(|projection| {
        let rows = collect_page_tree_render_rows(&projection);
        render_initial_page_tree_html(&PageTreeInitialRenderInput {
            rows,
            active_node_id: active_document_id.map(ToOwned::to_owned),
            focused_node_id: None,
        })
    })
}

/// 加载文件树 HTML（SSR）
///
/// 文件树与页面树共用同一份 sidebar dataset，再由 Rust kernel 输出 file_tree projection。
pub(crate) async fn load_file_tree_html(
    config: &AppConfig,
    context: &RequestContext,
    workspace_id: &str,
    active_document_id: Option<&str>,
) -> Option<String> {
    let spec = ProjectionSnapshotSpec {
        workspace_id,
        root_node_id: None,
        depth: Some(99),
        projection: KernelProjectionKind::FileTree,
        query: None,
        max_results: None,
    };
    let result = match load_projection_snapshot(config, context, &spec).await {
        Ok(snapshot) => Some(snapshot.projection),
        Err(_) if config.allow_dev_fixtures => {
            let documents = active_document_id
                .map(|document_id| {
                    serde_json::json!([
                        { "id": document_id, "workspace_id": workspace_id, "title": "个人", "parent_id": null, "sort_order": 0 }
                    ])
                })
                .unwrap_or_else(|| {
                    serde_json::json!([
                        { "id": "dev_welcome", "workspace_id": workspace_id, "title": "欢迎使用 MNOTE", "parent_id": null, "sort_order": 0 },
                        { "id": "dev_guide", "workspace_id": workspace_id, "title": "使用指南", "parent_id": "dev_welcome", "sort_order": 1 }
                    ])
                });
            let dev_dataset = serde_json::json!({
                "active_workspace_id": workspace_id,
                "documents": documents,
                "trashed_documents": [],
                "media_assets": [],
                "trashed_media_assets": [],
                "mindmap_assets": [],
                "trashed_mindmap_assets": [],
                "table_assets": [],
                "trashed_table_assets": [],
                "mindmap_docs": [],
                "mindmap_asset_children": {}
            });
            execute_kernel_query(context, workspace_id, projection_query(&spec), dev_dataset).ok()
        }
        Err(_) => None,
    };
    result.map(|projection| {
        let rows = collect_filetree_render_rows(&projection, active_document_id);
        render_initial_filetree_html(&FileTreeInitialRenderInput { rows })
    })
}

pub(crate) fn render_local_sidebar_tree_html(
    root_uri: &str,
    active_document_id: Option<&str>,
) -> Result<String, WebError> {
    let snapshot = load_local_folder_page_tree_snapshot(root_uri)?;
    let rows = collect_page_tree_render_rows(&snapshot.projection);
    Ok(render_initial_page_tree_html(&PageTreeInitialRenderInput {
        rows,
        active_node_id: active_document_id.map(ToOwned::to_owned),
        focused_node_id: None,
    }))
}

pub(crate) fn render_local_file_tree_html(
    root_uri: &str,
    active_document_id: Option<&str>,
) -> Result<String, WebError> {
    let snapshot = load_local_folder_file_tree_snapshot(root_uri)?;
    let rows = collect_filetree_render_rows(&snapshot.projection, active_document_id);
    Ok(render_initial_filetree_html(&FileTreeInitialRenderInput {
        rows,
    }))
}

#[cfg(test)]
mod tests {
    use crate::app::{build_app, AppConfig, AppState};
    use axum::body::{to_bytes, Body};
    use axum::http::{header, Request, StatusCode};
    use serde_json::Value;
    use tower::util::ServiceExt;

    fn app() -> axum::Router {
        build_app(AppState::new(AppConfig {
            service_name: "mnote-web".into(),
            service_version: "0.1.0".into(),
            bind_addr: "127.0.0.1:0".into(),
            public_bind_addr: "127.0.0.1:3000".into(),
            legacy_next_base_url: Some("http://127.0.0.1:3100".into()),
            enable_legacy_next_compat: true,
            enable_debug_shell_routes: false,
            hermes_base_path: "/api/hermes".into(),
            compat_next_base_path: "/api/compat/next".into(),
            convex_url: None,
            convex_admin_key: None,
            allow_dev_fixtures: true,
            query_fixtures_json: Some(
                r#"{
                  "documents:getMeta": {
                    "id": "doc_1",
                    "workspace_id": "ws_demo",
                    "title": "服务端页面",
                    "updated_at": "2026-04-18T09:30:00Z",
                    "can_edit": true,
                    "word_count": 42,
                    "character_count": 128,
                    "block_count": 3
                  },
                  "documents:getContent": {
                    "content": [{"id": "block_1", "type": "paragraph", "content": []}],
                    "revision": 7,
                    "conflict_detection_key": "doc_1:7",
                    "pageSubtree": {"rootNodeId": "doc_1", "outline": []}
                  }
                }"#
                .into(),
            ),
            mutation_fixtures_json: None,
            dev_user_id: "dev-user".into(),
            dev_user_name: "开发用户".into(),
            dev_user_email: "dev@mnote.local".into(),
        }))
    }

    #[tokio::test]
    async fn document_shell_returns_page_aggregate_snapshot() {
        let response = app()
            .oneshot(
                Request::builder()
                    .uri("/documents/doc_1?workspaceId=ws_demo")
                    .body(Body::empty())
                    .expect("request"),
            )
            .await
            .expect("response");

        assert_eq!(response.status(), StatusCode::OK);
        assert_eq!(
            response
                .headers()
                .get("x-mnote-web-owner")
                .and_then(|value| value.to_str().ok()),
            Some("mnote-web")
        );
        assert_eq!(
            response
                .headers()
                .get("x-mnote-web-shell")
                .and_then(|value| value.to_str().ok()),
            Some("document")
        );
        assert!(response
            .headers()
            .get_all("set-cookie")
            .iter()
            .any(|value| value
                .to_str()
                .unwrap_or_default()
                .contains("mnote_recent_page_id=doc_1")));
        let body = to_bytes(response.into_body(), usize::MAX)
            .await
            .expect("body");
        let html = String::from_utf8(body.to_vec()).expect("html");
        assert!(html.contains("data-testid=\"wolai-sidebar\""));
        assert!(html.contains("data-testid=\"wolai-topbar\""));
        assert!(html.contains("data-testid=\"wolai-floating-ai\""));
        assert!(html.contains("星标置顶"));
        assert!(html.contains("我的页面"));
        assert!(html.contains("垃圾箱"));
        assert!(html.contains("模板中心"));
        assert!(html.contains("data-page-aggregate-snapshot=\"mnote.page_aggregate.v1\""));
        assert!(html.contains("data-testid=\"mnote-page-subtree\""));
        assert!(html.contains("data-page-tree-source=\"page_aggregate.tree.pageSubtree\""));
        assert!(html.contains("data-editor-host=\"leptos_tiptap_island\""));
        assert!(html.contains("aria-label=\"页面标题\""));
        assert!(html.contains("data-page-title-input=\"true\""));
        assert!(html.contains("data-title-endpoint=\"/api/documents/title\""));
        assert!(html.contains("mnote.document_title_controller.v1"));
        assert!(html.contains(
            r#".tree-row[data-shell-mode="page"][data-node-id="' + escaped + '"] > .tree-link > .tree-link-title"#
        ));
        assert!(!html.contains("[data-node-id=\"${escapedId}\"] .tree-link-title"));
        assert!(html.contains("data-testid=\"wolai-page-settings-trigger\""));
        assert!(html.contains("data-mnote-action=\"open-page-settings\""));
        assert!(html.contains("data-mnote-action=\"open-page-ai\""));
        assert!(html.contains("\"titleEndpoint\":\"/api/documents/title\""));
        assert!(html.contains("__MNOTE_TREE_LIVE_BOOTSTRAP__"));
        assert!(html.contains("mnote.tree_live_bootstrap.v1"));
        assert!(html.contains("/api/tree/events"));
        assert!(html.contains("data-mnote-tree-live-transport"));
        assert!(!html.contains("mnote-web-document-shell"));
    }

    #[tokio::test]
    async fn page_aggregate_endpoint_returns_snapshot_contract() {
        let response = app()
            .oneshot(
                Request::builder()
                    .uri("/api/page-aggregate/doc_1?workspaceId=ws_demo")
                    .body(Body::empty())
                    .expect("request"),
            )
            .await
            .expect("response");

        assert_eq!(response.status(), StatusCode::OK);
        assert_eq!(
            response
                .headers()
                .get("x-mnote-page-aggregate-owner")
                .and_then(|value| value.to_str().ok()),
            Some("rust-kernel")
        );
        assert_eq!(
            response
                .headers()
                .get(header::CACHE_CONTROL)
                .and_then(|value| value.to_str().ok()),
            Some("no-store")
        );
        let body = to_bytes(response.into_body(), usize::MAX)
            .await
            .expect("body");
        let payload: Value = serde_json::from_slice(&body).expect("json");
        assert_eq!(payload["owner"], "mnote-web");
        assert_eq!(payload["schema"], "mnote.page_aggregate.v1");
        assert_eq!(payload["result"]["source"], "KernelProjection");
        assert_eq!(payload["result"]["projectionVersion"], 1);
        assert_eq!(payload["result"]["identity"]["documentId"], "doc_1");
        assert_eq!(payload["result"]["body"]["revision"], 7);
    }

    #[tokio::test]
    async fn page_aggregate_endpoint_returns_local_markdown_readonly_snapshot() {
        let root =
            std::env::temp_dir().join(format!("mnote-local-page-aggregate-{}", std::process::id()));
        let _ = std::fs::remove_dir_all(&root);
        std::fs::create_dir_all(&root).expect("create local root");
        std::fs::write(
            root.join("README.md"),
            "---\ntitle: Local Aggregate\n---\n# Local Heading\n正文内容\n",
        )
        .expect("write local md");

        let root_uri = format!("file://{}", root.display());
        let response = app()
            .oneshot(
                Request::builder()
                    .uri(format!(
                        "/api/page-aggregate/local-md:README.md?sourceKind=local_folder&rootUri={root_uri}"
                    ))
                    .body(Body::empty())
                    .expect("request"),
            )
            .await
            .expect("response");

        let _ = std::fs::remove_dir_all(&root);

        assert_eq!(response.status(), StatusCode::OK);
        assert_eq!(
            response
                .headers()
                .get(header::CACHE_CONTROL)
                .and_then(|value| value.to_str().ok()),
            Some("no-store")
        );
        let body = to_bytes(response.into_body(), usize::MAX)
            .await
            .expect("body");
        let payload: Value = serde_json::from_slice(&body).expect("json");
        assert_eq!(payload["schema"], "mnote.page_aggregate.v1");
        assert_eq!(
            payload["result"]["identity"]["documentId"],
            "local-md:README.md"
        );
        assert_eq!(payload["result"]["head"]["title"], "Local Aggregate");
        assert_eq!(payload["result"]["head"]["permissions"]["readOnly"], false);
        assert_eq!(payload["result"]["body"]["revision"], 0);
        assert!(payload["result"]["body"]["content"]
            .to_string()
            .contains("Local Heading"));
    }

    #[tokio::test]
    async fn document_shell_renders_local_markdown_with_same_sidebar_surfaces() {
        let root =
            std::env::temp_dir().join(format!("mnote-local-document-shell-{}", std::process::id()));
        let _ = std::fs::remove_dir_all(&root);
        std::fs::create_dir_all(root.join("docs")).expect("create local docs");
        std::fs::write(root.join("README.md"), "# Local Shell\n正文\n").expect("write root md");
        std::fs::write(root.join("docs").join("child.md"), "# Child Page\n")
            .expect("write child md");
        std::fs::write(root.join("asset.png"), b"png").expect("write asset");

        let root_uri = format!("file://{}", root.display());
        let response = app()
            .oneshot(
                Request::builder()
                    .uri(format!(
                        "/documents/local-md:README.md?sourceKind=local_folder&rootUri={root_uri}&treeView=filetree"
                    ))
                    .body(Body::empty())
                    .expect("request"),
            )
            .await
            .expect("response");

        let _ = std::fs::remove_dir_all(&root);

        assert_eq!(response.status(), StatusCode::OK);
        assert_eq!(
            response
                .headers()
                .get(header::CACHE_CONTROL)
                .and_then(|value| value.to_str().ok()),
            Some("no-store")
        );
        let body = to_bytes(response.into_body(), usize::MAX)
            .await
            .expect("body");
        let html = String::from_utf8(body.to_vec()).expect("html");
        assert!(html.contains("Local Shell"));
        assert!(html.contains("data-page-aggregate-snapshot=\"mnote.page_aggregate.v1\""));
        assert!(html.contains("Child Page"));
        assert!(html.contains("asset.png"));
        assert!(html.contains("data-row-kind=\"markdown\""));
        assert!(html.contains("data-mnote-action=\"open-local-folder\""));
        assert!(html.contains("refreshFromExternalFileChange"));
        assert!(html.contains("/api/local-folder/events"));
        assert!(html.contains("new EventSource(url.toString())"));
        assert!(html.contains("command: 'replaceContent'"));
        assert!(html.contains("external-change-conflict"));
        assert!(!html.contains("setInterval(() => {\n        void pollLocalMarkdownExternalChange();\n      }, 1200);"));
    }

    #[tokio::test]
    async fn document_shell_bootstrap_preserves_inline_mark_conversion() {
        let response = app()
            .oneshot(
                Request::builder()
                    .uri("/documents/doc_1?workspaceId=ws_demo")
                    .body(Body::empty())
                    .expect("request"),
            )
            .await
            .expect("response");

        assert_eq!(response.status(), StatusCode::OK);
        let body = to_bytes(response.into_body(), usize::MAX)
            .await
            .expect("body");
        let html = String::from_utf8(body.to_vec()).expect("html");
        assert!(html.contains("legacyInlineContentToTiptap"));
        assert!(html.contains("legacyStylesToTiptapMarks"));
        assert!(html.contains("marks.push({ type: 'code' })"));
        assert!(html.contains("marks.push({ type: 'link', attrs: { href } })"));
        assert!(html.contains("styles.link = href"));
        assert!(html.contains("contentNodes.map((node) => {"));
        assert!(!html.contains(
            "block.contentNodes.map((node) => typeof node?.text === 'string' ? node.text : '').join('')"
        ));
    }
}