xfy f6b7ab4333 fix(post): scrollToHash 增加 ResizeObserver 布局稳定期，修正 mermaid 异步渲染导致的锚点落点偏移 ...

直接访问 /post/slug#heading 或刷新该 URL 时，目标标题停在屏幕中间偏下，但点击目录
或标题跳转却正常。根因是时序竞争：

post_content 的 use_effect 同步依次调用 __initMermaid（注册 IntersectionObserver，
异步）→ __scrollToHash。scrollToHash 的"立即 + 两帧"校正只覆盖浏览器原生
fragment-scroll；而 mermaid 懒加载（加载 ~1MB bundle → render → pre.innerHTML=svg）
是数百毫秒的异步链，发生在两帧之后。mermaid 块从源码文本膨胀成 SVG 图时撑高内容，
把目标标题推离已校准的落点。mermaid.ts 渲染完成后无任何落点修正。点击目录正常是
因为那时 mermaid 已渲染、布局稳定。

解法：scrollToHash 末尾新增 stabilizeScrollOnResize——在 STABILIZE_WINDOW_MS(2s) 内
用 ResizeObserver 观察 .post-content 容器，检测到布局变化即用 rAF 合并重新校正一次
落点。与 mermaid 解耦，同时覆盖图片/字体等所有异步位移源。用户主动滚动（wheel/
touchmove/keydown）或超时后自动停止，不与交互打架。重入安全：主题切换重跑 use_effect
时先 dispose 上一次稳定器，避免泄漏/叠加。

测试（hash-scroll.test.ts）新增 3 例：resize 后再校正、用户 wheel 后停止、重入清理旧 RO。

2026-07-16 16:05:11 +08:00

..

src

fix(post): scrollToHash 增加 ResizeObserver 布局稳定期，修正 mermaid 异步渲染导致的锚点落点偏移

2026-07-16 16:05:11 +08:00

package.json

refactor(libs): 抽取 @yggdrasil/shared 消除跨 IIFE 库的类型/常量重复

2026-07-14 15:39:41 +08:00

tsconfig.json

chore(workspace): 建立 pnpm workspace 与共享 tsconfig

2026-07-02 17:50:52 +08:00

vite.config.ts

chore(biome): 引入 Biome v2.5 monorepo 配置并格式化全量源码

2026-07-02 17:54:46 +08:00

vitest.config.ts

chore(core): 搭建 yggdrasil-core 子工程骨架

2026-06-26 13:51:39 +08:00