AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.
HTML ai-agentcloudflarecloudflare-d1cloudflare-r2cloudflare-workersdockerelectronevernoteevernote-alternativeknowledge-basemcpnote-takingobsidian-alternativeoffline-firstpersonal-knowledge-basepwaself-hostedsqlitetiptapweb-clipper
feat(web): follow editor scroll in phone preview
tianma-ifc614dd4aa081
diff --git a/apps/web/src/components/EditorPane.tsx b/apps/web/src/components/EditorPane.tsxindex 207ac89d..8c284f78 100644--- a/apps/web/src/components/EditorPane.tsx+++ b/apps/web/src/components/EditorPane.tsx@@ -4338,7 +4338,11 @@ const RichEditorPane = ({)}</div>{!isMobileViewport && !useMobilePlainTextEditor && !useMarkdownSourceEditor && phonePreviewOpen && (- <EditorPhonePreview editor={editor} title={getEditableMemoTitle(memo?.title)} />+ <EditorPhonePreview+ editor={editor}+ title={getEditableMemoTitle(memo?.title)}+ scrollContainer={editorScrollContainer}+ />)}{!isMobileViewport && !useMobilePlainTextEditor && !useMarkdownSourceEditor && !phonePreviewOpen && (<EditorOutlinediff --git a/apps/web/src/components/EditorPhonePreview.tsx b/apps/web/src/components/EditorPhonePreview.tsxindex bc085321..b2497a73 100644--- a/apps/web/src/components/EditorPhonePreview.tsx+++ b/apps/web/src/components/EditorPhonePreview.tsx@@ -1,24 +1,77 @@-import { useEffect, useState } from "react";+import { useCallback, useEffect, useRef, useState } from "react";import type { Editor } from "@tiptap/react";import { useTranslation } from "react-i18next";import { cn } from "@/lib/utils";-import { useEditorTheme } from "@/components/ThemeProvider";+import { useEditorTheme, useMermaidTheme } from "@/components/ThemeProvider";+import { embedMermaidForPreview } from "@/lib/phone-preview-mermaid";+import { Switch } from "@/components/ui/switch";import { buildPhonePreviewHtml } from "@/lib/publish-layout";+import {+ readEditorPhonePreviewFollowPreference,+ writeEditorPhonePreviewFollowPreference,+} from "@/lib/app-helpers";type EditorPhonePreviewProps = {editor: Editor | null;title?: string;+ scrollContainer?: HTMLDivElement | null;className?: string;};const formatPhoneTime = () =>new Intl.DateTimeFormat(undefined, { hour: "numeric", minute: "2-digit" }).format(new Date());-export const EditorPhonePreview = ({ editor, title, className }: EditorPhonePreviewProps) => {+const BLOCK_SELECTOR =+ "p, h1, h2, h3, li, blockquote, pre, img, table, hr, figure, [data-edgeever-theme-block]";++export const collectPhonePreviewBlocks = (root: Element, skipTitle = "") => {+ const blocks = [...root.querySelectorAll<HTMLElement>(BLOCK_SELECTOR)].filter((element) => {+ if (element.matches("[data-ee-publish-chrome]") || element.closest("[data-ee-publish-chrome]")) {+ return false;+ }+ const parentBlock = element.parentElement?.closest(BLOCK_SELECTOR);+ if (parentBlock && parentBlock !== element && root.contains(parentBlock)) {+ return false;+ }+ return true;+ });++ const trimmedTitle = skipTitle.trim();+ if (trimmedTitle && blocks[0]?.tagName === "H1" && blocks[0].textContent?.trim() === trimmedTitle) {+ return blocks.slice(1);+ }+ return blocks;+};++const fingerprint = (element: HTMLElement) =>+ `${element.tagName}:${(element.innerText || element.getAttribute("src") || "").replace(/\s+/g, " ").trim().slice(0, 48)}`;++const blockAtReadLine = (blocks: HTMLElement[], viewportTop: number) =>+ blocks.find((element) => element.getBoundingClientRect().bottom > viewportTop + 8) ?? blocks[0] ?? null;++const matchPreviewBlock = (editorBlocks: HTMLElement[], previewBlocks: HTMLElement[], source: HTMLElement) => {+ const index = editorBlocks.indexOf(source);+ if (index >= 0 && previewBlocks[index]) return previewBlocks[index];+ const key = fingerprint(source);+ return previewBlocks.find((element) => fingerprint(element) === key) ?? null;+};++const alignElement = (scroller: HTMLElement, target: HTMLElement, viewportTop: number) => {+ const delta = target.getBoundingClientRect().top - viewportTop;+ if (Math.abs(delta) < 4) return;+ scroller.scrollTop += delta;+};++export const EditorPhonePreview = ({ editor, title, scrollContainer, className }: EditorPhonePreviewProps) => {const { t } = useTranslation();const { editorTheme } = useEditorTheme();+ const { mermaidTheme } = useMermaidTheme();+ const previewSyncGeneration = useRef(0);const [markup, setMarkup] = useState({ html: "", style: "", paper: false });const [clock, setClock] = useState(formatPhoneTime);+ const [follow, setFollow] = useState(readEditorPhonePreviewFollowPreference);+ const previewRef = useRef<HTMLDivElement | null>(null);+ const syncingRef = useRef(false);useEffect(() => {const tick = () => setClock(formatPhoneTime());@@ -34,7 +87,17 @@ export const EditorPhonePreview = ({ editor, title, className }: EditorPhonePrevconst sync = () => {if (editor.isDestroyed) return;- setMarkup(buildPhonePreviewHtml(editor.getHTML(), title ?? "", editorTheme));+ const generation = ++previewSyncGeneration.current;+ const nextMarkup = buildPhonePreviewHtml(editor.getHTML(), title ?? "", editorTheme);+ const holder = document.createElement("div");+ holder.innerHTML = nextMarkup.html;+ void embedMermaidForPreview(holder, editor, mermaidTheme).then(() => {+ if (generation !== previewSyncGeneration.current) return;+ setMarkup({+ ...nextMarkup,+ html: holder.innerHTML,+ });+ });};sync();@@ -44,13 +107,97 @@ export const EditorPhonePreview = ({ editor, title, className }: EditorPhonePreveditor.off("update", sync);editor.off("create", sync);};- }, [editor, editorTheme, title]);+ }, [editor, editorTheme, mermaidTheme, title]);++ const handleFollowChange = (enabled: boolean) => {+ setFollow(enabled);+ writeEditorPhonePreviewFollowPreference(enabled);+ };++ const syncFromEditor = useCallback(() => {+ if (!follow || syncingRef.current || !editor || editor.isDestroyed) return;+ const preview = previewRef.current;+ const editorRoot = editor.view.dom;+ if (!preview || !scrollContainer) return;++ const editorBlocks = collectPhonePreviewBlocks(editorRoot);+ const previewBlocks = collectPhonePreviewBlocks(preview, title);+ if (editorBlocks.length === 0 || previewBlocks.length === 0) return;++ const source = blockAtReadLine(editorBlocks, scrollContainer.getBoundingClientRect().top + 72);+ if (!source) return;+ const dest = matchPreviewBlock(editorBlocks, previewBlocks, source);+ if (!dest) return;++ syncingRef.current = true;+ alignElement(preview, dest, preview.getBoundingClientRect().top + 52);+ window.requestAnimationFrame(() => {+ syncingRef.current = false;+ });+ }, [editor, follow, scrollContainer, title]);++ const syncFromPreview = useCallback(() => {+ if (!follow || syncingRef.current || !editor || editor.isDestroyed) return;+ const preview = previewRef.current;+ const editorRoot = editor.view.dom;+ if (!preview || !scrollContainer) return;++ const editorBlocks = collectPhonePreviewBlocks(editorRoot);+ const previewBlocks = collectPhonePreviewBlocks(preview, title);+ if (editorBlocks.length === 0 || previewBlocks.length === 0) return;++ const source = blockAtReadLine(previewBlocks, preview.getBoundingClientRect().top + 52);+ if (!source) return;+ const dest = matchPreviewBlock(previewBlocks, editorBlocks, source);+ if (!dest) return;++ syncingRef.current = true;+ alignElement(scrollContainer, dest, scrollContainer.getBoundingClientRect().top + 72);+ window.requestAnimationFrame(() => {+ syncingRef.current = false;+ });+ }, [editor, follow, scrollContainer, title]);++ useEffect(() => {+ if (!follow) return;+ const frame = window.requestAnimationFrame(syncFromEditor);+ return () => window.cancelAnimationFrame(frame);+ }, [follow, markup.html, syncFromEditor]);++ useEffect(() => {+ if (!follow || !scrollContainer) return;+ scrollContainer.addEventListener("scroll", syncFromEditor, { passive: true });+ return () => scrollContainer.removeEventListener("scroll", syncFromEditor);+ }, [follow, scrollContainer, syncFromEditor]);++ useEffect(() => {+ const preview = previewRef.current;+ if (!follow || !preview) return;+ preview.addEventListener("scroll", syncFromPreview, { passive: true });+ return () => preview.removeEventListener("scroll", syncFromPreview);+ }, [follow, markup.html, syncFromPreview]);++ useEffect(() => {+ if (!follow || !editor || editor.isDestroyed) return;+ editor.on("selectionUpdate", syncFromEditor);+ return () => {+ editor.off("selectionUpdate", syncFromEditor);+ };+ }, [editor, follow, syncFromEditor]);return (<asideclassName={cn("edgeever-phone-stage sticky top-0 hidden xl:flex", className)}aria-label={t("editor.phonePreview")}>+ <label className="mb-3 flex w-full items-center justify-end gap-2 px-5 text-xs text-slate-500">+ <span>{t("editor.phonePreviewFollow")}</span>+ <Switch+ checked={follow}+ aria-label={t("editor.phonePreviewFollow")}+ onCheckedChange={handleFollowChange}+ />+ </label><div className="edgeever-phone-device"><span className="edgeever-phone-device__silent" aria-hidden="true" /><span className="edgeever-phone-device__vol-up" aria-hidden="true" />@@ -86,6 +233,7 @@ export const EditorPhonePreview = ({ editor, title, className }: EditorPhonePrev<divclassName={cn("edgeever-phone-preview", markup.paper ? "edgeever-phone-preview--article" : "edgeever-phone-preview--editor")}ref={(node) => {+ previewRef.current = node;if (node) node.setAttribute("style", markup.style);}}>diff --git a/apps/web/src/lib/app-helpers.test.mjs b/apps/web/src/lib/app-helpers.test.mjsindex c63d4019..f31619f0 100644--- a/apps/web/src/lib/app-helpers.test.mjs+++ b/apps/web/src/lib/app-helpers.test.mjs@@ -8,6 +8,7 @@ import {EDITOR_CONTENT_ALIGNMENT_STORAGE_KEY,EDITOR_TOOLBAR_EXPANDED_STORAGE_KEY,EDITOR_PHONE_PREVIEW_STORAGE_KEY,+ EDITOR_PHONE_PREVIEW_FOLLOW_STORAGE_KEY,NOTEBOOK_SORT_STORAGE_KEY,SHORTCUT_SETTINGS_STORAGE_KEY,getSearchShortcutScope,@@ -21,6 +22,7 @@ import {readEditorOutlineCollapsedPreference,readEditorToolbarExpandedPreference,readEditorPhonePreviewPreference,+ readEditorPhonePreviewFollowPreference,readShortcutSettingsPreference,writeEditorContentAlignmentPreference,writeNotebookSortPreference,@@ -30,6 +32,7 @@ import {writeEditorOutlineCollapsedPreference,writeEditorToolbarExpandedPreference,writeEditorPhonePreviewPreference,+ writeEditorPhonePreviewFollowPreference,resolveSelectionMoveTargetNotebookId,getMemoIdsNeedingMove,} from "./app-helpers.ts";@@ -189,6 +192,27 @@ describe("editor phone preview preference", () => {writeEditorPhonePreviewPreference(false);expect(values.get(EDITOR_PHONE_PREVIEW_STORAGE_KEY)).toBe("false");});++ test("defaults phone preview scroll following to on", () => {+ const values = installLocalStorage();+ expect(readEditorPhonePreviewFollowPreference()).toBe(true);++ values.set(EDITOR_PHONE_PREVIEW_FOLLOW_STORAGE_KEY, "false");+ expect(readEditorPhonePreviewFollowPreference()).toBe(false);++ values.set(EDITOR_PHONE_PREVIEW_FOLLOW_STORAGE_KEY, "true");+ expect(readEditorPhonePreviewFollowPreference()).toBe(true);+ });++ test("persists phone preview scroll following", () => {+ const values = installLocalStorage();++ writeEditorPhonePreviewFollowPreference(false);+ expect(values.get(EDITOR_PHONE_PREVIEW_FOLLOW_STORAGE_KEY)).toBe("false");++ writeEditorPhonePreviewFollowPreference(true);+ expect(values.get(EDITOR_PHONE_PREVIEW_FOLLOW_STORAGE_KEY)).toBe("true");+ });});describe("desktop reading protection preference", () => {diff --git a/apps/web/src/lib/app-helpers.ts b/apps/web/src/lib/app-helpers.tsindex 4b80b6ad..94adb689 100644--- a/apps/web/src/lib/app-helpers.ts+++ b/apps/web/src/lib/app-helpers.ts@@ -136,6 +136,7 @@ export const EDITOR_OUTLINE_COLLAPSED_STORAGE_KEY = "edgeever.editorOutlineCollaexport const EDITOR_CONTENT_ALIGNMENT_STORAGE_KEY = "edgeever.editorContentAlignment";export const EDITOR_TOOLBAR_EXPANDED_STORAGE_KEY = "edgeever.editorToolbarExpanded";export const EDITOR_PHONE_PREVIEW_STORAGE_KEY = "edgeever.editor.phonePreviewOpen";+export const EDITOR_PHONE_PREVIEW_FOLLOW_STORAGE_KEY = "edgeever.editor.phonePreviewFollow";export const MEMO_LIST_DENSITY_STORAGE_KEY = "edgeever.memoListDensity";export const MEMO_LIST_WIDTH_STORAGE_KEY = "edgeever.memoListWidth";export const NOTEBOOK_SORT_STORAGE_KEY = "edgeever.notebookSort";@@ -439,6 +440,22 @@ export const writeEditorPhonePreviewPreference = (enabled: boolean) => {}};+export const readEditorPhonePreviewFollowPreference = () => {+ try {+ return window.localStorage.getItem(EDITOR_PHONE_PREVIEW_FOLLOW_STORAGE_KEY) !== "false";+ } catch {+ return true;+ }+};++export const writeEditorPhonePreviewFollowPreference = (enabled: boolean) => {+ try {+ window.localStorage.setItem(EDITOR_PHONE_PREVIEW_FOLLOW_STORAGE_KEY, enabled ? "true" : "false");+ } catch {+ // Local storage can be unavailable in private or restricted browser contexts.+ }+};+export const readMemoListDensityPreference = (): MemoListDensity => {try {const density = window.localStorage.getItem(MEMO_LIST_DENSITY_STORAGE_KEY);diff --git a/apps/web/src/lib/markdown-theme.test.mjs b/apps/web/src/lib/markdown-theme.test.mjsindex e3599926..3833f5be 100644--- a/apps/web/src/lib/markdown-theme.test.mjs+++ b/apps/web/src/lib/markdown-theme.test.mjs@@ -86,6 +86,10 @@ describe("markdown theme contracts", () => {expect(preview).toContain("edgeever-phone-device__lens");expect(preview).toContain("edgeever-phone-device__home");expect(preview).toContain("buildPhonePreviewHtml");+ expect(preview).toContain("embedMermaidForPreview");+ expect(preview).toContain("phonePreviewFollow");+ expect(preview).toContain("scrollContainer");expect(preview).not.toContain("edgeever-phone-device__wifi");+ expect(editorPane).toContain("scrollContainer={editorScrollContainer}");});});diff --git a/apps/web/src/lib/phone-preview-mermaid.test.mjs b/apps/web/src/lib/phone-preview-mermaid.test.mjsnew file mode 100644index 00000000..6eadda30--- /dev/null+++ b/apps/web/src/lib/phone-preview-mermaid.test.mjs@@ -0,0 +1,11 @@+import { describe, expect, test } from "bun:test";+import { readFileSync } from "node:fs";++describe("phone preview mermaid", () => {+ test("replaces mermaid source blocks with rendered diagrams", () => {+ const source = readFileSync(new URL("./phone-preview-mermaid.ts", import.meta.url), "utf8");+ expect(source).toContain("pre > code.language-mermaid");+ expect(source).toContain("edgeever-phone-mermaid");+ expect(source).toContain(".edgeever-mermaid-code-block .edgeever-mermaid-svg svg");+ });+});diff --git a/apps/web/src/lib/phone-preview-mermaid.ts b/apps/web/src/lib/phone-preview-mermaid.tsnew file mode 100644index 00000000..739e9dde--- /dev/null+++ b/apps/web/src/lib/phone-preview-mermaid.ts@@ -0,0 +1,80 @@+import type { Editor } from "@tiptap/react";+import { MERMAID_THEME_PALETTES, type MermaidThemeName } from "@/components/ThemeProvider";++const remapSvgIds = (svg: SVGElement, prefix: string) => {+ const renamed = new Map<string, string>();+ svg.querySelectorAll("[id]").forEach((element) => {+ const id = element.getAttribute("id");+ if (!id) return;+ const next = `${prefix}-${id}`;+ renamed.set(id, next);+ element.setAttribute("id", next);+ });++ svg.querySelectorAll("*").forEach((element) => {+ for (const attribute of Array.from(element.attributes)) {+ let value = attribute.value;+ let changed = false;+ for (const [from, to] of renamed) {+ const next = value+ .replaceAll(`url(#${from})`, `url(#${to})`)+ .replaceAll(`#${from}`, `#${to}`);+ if (next !== value) {+ value = next;+ changed = true;+ }+ }+ if (changed) element.setAttribute(attribute.name, value);+ }+ });+};++const renderMermaidSvg = async (source: string, theme: MermaidThemeName) => {+ const { renderMermaidSVG, THEMES } = await import("beautiful-mermaid");+ const palette = MERMAID_THEME_PALETTES[theme] ?? MERMAID_THEME_PALETTES["zinc-light"];+ return renderMermaidSVG(source, {+ ...THEMES[theme] ?? THEMES["zinc-light"],+ ...palette,+ transparent: true,+ font: "Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, sans-serif",+ padding: 16,+ });+};++export const embedMermaidForPreview = async (+ root: HTMLElement,+ editor?: Editor | null,+ mermaidTheme: MermaidThemeName = "zinc-light",+) => {+ const codeBlocks = Array.from(root.querySelectorAll<HTMLElement>("pre > code.language-mermaid"));+ if (codeBlocks.length === 0) return;++ const liveSvgs = editor+ ? Array.from(editor.view.dom.querySelectorAll<SVGElement>(".edgeever-mermaid-code-block .edgeever-mermaid-svg svg"))+ : [];++ await Promise.all(codeBlocks.map(async (codeBlock, index) => {+ const source = codeBlock.textContent?.trim();+ const pre = codeBlock.closest("pre");+ if (!source || !pre) return;++ try {+ const live = liveSvgs[index];+ let svgHtml = "";+ if (live) {+ const clone = live.cloneNode(true) as SVGElement;+ remapSvgIds(clone, `phone-mermaid-${index}`);+ svgHtml = clone.outerHTML;+ } else {+ svgHtml = await renderMermaidSvg(source, mermaidTheme);+ }++ const figure = document.createElement("figure");+ figure.className = "edgeever-phone-mermaid";+ figure.innerHTML = svgHtml;+ pre.replaceWith(figure);+ } catch {+ // Keep the Mermaid source readable when rendering fails.+ }+ }));+};diff --git a/apps/web/src/styles/globals.css b/apps/web/src/styles/globals.cssindex 4565ae2d..164c0734 100644--- a/apps/web/src/styles/globals.css+++ b/apps/web/src/styles/globals.css@@ -684,22 +684,24 @@ textarea {}.edgeever-phone-stage {- width: 430px;- min-height: 760px;+ width: 380px;+ min-height: 740px;flex-shrink: 0;flex-direction: column;align-items: center;- justify-content: center;+ justify-content: flex-start;margin: 12px 12px 12px 0;+ padding-top: 16px;+ padding-bottom: 24px;border-radius: 24px;background: color-mix(in srgb, var(--workspace-surface, #eef3f0) 76%, white);}.edgeever-phone-device {position: relative;- width: 390px;- height: 720px;- border-radius: 48px;+ width: 331px;+ height: 686px;+ border-radius: 52px;background:linear-gradient(165deg, #6a6a6e 0%, #3e3e42 12%, #1f1f22 38%, #2c2c30 72%, #121214 100%);box-shadow:@@ -724,7 +726,7 @@ textarea {.edgeever-phone-device__silent {left: -3px;- top: 96px;+ top: 88px;width: 3px;height: 18px;border-radius: 1px 0 0 1px;@@ -734,24 +736,24 @@ textarea {.edgeever-phone-device__vol-down {left: -3px;width: 3px;- height: 32px;+ height: 28px;border-radius: 1px 0 0 1px;}-.edgeever-phone-device__vol-up { top: 132px; }-.edgeever-phone-device__vol-down { top: 172px; }+.edgeever-phone-device__vol-up { top: 120px; }+.edgeever-phone-device__vol-down { top: 156px; }.edgeever-phone-device__power {right: -3px;- top: 156px;+ top: 140px;width: 3px;- height: 62px;+ height: 56px;border-radius: 0 1px 1px 0;}.edgeever-phone-device__screen {position: absolute;- inset: 8px;+ inset: 6.8% 3.7% 3.1%;overflow: hidden;border-radius: 38px;background: #fff;@@ -764,12 +766,12 @@ textarea {.edgeever-phone-device__island {position: absolute;- top: 9px;+ top: 8px;left: 50%;z-index: 4;display: flex;- width: 102px;- height: 30px;+ width: 88px;+ height: 26px;align-items: center;justify-content: center;gap: 8px;@@ -860,6 +862,18 @@ textarea {margin: 0 0 12px !important;}+.edgeever-phone-preview .edgeever-phone-mermaid {+ margin: 12px 0;+ overflow: hidden;+}++.edgeever-phone-preview .edgeever-phone-mermaid svg {+ display: block;+ width: 100%;+ height: auto;+ max-width: 100%;+}+.edgeever-phone-preview .edgeever-theme-block__toolbar,.edgeever-phone-preview .edgeever-theme-block__delete {display: none;diff --git a/packages/shared/src/i18n/en-US.ts b/packages/shared/src/i18n/en-US.tsindex 2b169106..c0e668eb 100644--- a/packages/shared/src/i18n/en-US.ts+++ b/packages/shared/src/i18n/en-US.ts@@ -1793,6 +1793,7 @@ export const enUS = {showPhonePreview: "Show phone preview",hidePhonePreview: "Hide phone preview",phonePreviewEmpty: "Start writing to see how this note reads on a phone.",+ phonePreviewFollow: "Follow scroll",copyingToWeChat: "Preparing rich text",copiedToWeChat: "Copied",copyToWeChatFailed: "Copy failed",diff --git a/packages/shared/src/i18n/zh-CN.ts b/packages/shared/src/i18n/zh-CN.tsindex 21127a3d..5bb0ca1e 100644--- a/packages/shared/src/i18n/zh-CN.ts+++ b/packages/shared/src/i18n/zh-CN.ts@@ -1791,6 +1791,7 @@ export const zhCN = {showPhonePreview: "显示手机预览",hidePhonePreview: "隐藏手机预览",phonePreviewEmpty: "开始写作后,这里会显示手机阅读效果。",+ phonePreviewFollow: "滚动跟随",copyingToWeChat: "正在准备富文本内容",copiedToWeChat: "已复制",copyToWeChatFailed: "复制失败",