minecodex 2.0.52 → 2.0.54

package/features/mermaid-diagrams/codex-feature.json

@@ -3,12 +3,12 @@
   "id": "mermaid-diagrams",
   "version": "0.1.0",
   "label": {
-    "en": "Mermaid Diagrams (Experimental)",
-    "zh-CN": "Mermaid 图表增强（实验性）"
+    "en": "Mermaid Diagrams",
+    "zh-CN": "Mermaid 图表增强"
   },
   "description": {
-    "en": "Opt in to enhanced Markdown diagrams with zoom and PNG download. Off by default.",
-    "zh-CN": "在 Markdown 预览中增强图表，支持缩放与 PNG 下载。实验性功能，默认关闭。"
+    "en": "Enhance Markdown diagrams with readable layouts, zoom and PNG download. Enabled by default.",
+    "zh-CN": "在 Markdown 预览中增强图表排版，支持缩放与 PNG 下载。默认启用。"
   },
   "entry": {
     "kind": "page-script",

package/features/mermaid-diagrams/src/adapters/codex/native.mjs

@@ -1,8 +1,9 @@
 import { findCodexModule } from '../../../../../packages/codex-adapter/src/renderer/modules.mjs';
 import { saveQvDiagram } from '../../mermaid/export.mjs';
 
-// 图表下载协议只由实验性功能加载，阅读增强不依赖此能力。
+// 图表下载协议只由图表功能加载，阅读增强不依赖此能力。
 export async function loadNativeMermaidActions(native, {read = async url => { const response = await fetch(url); if (!response.ok) throw new Error('native-diagram-source-unavailable'); return response.text(); }, load = url => import(url)} = {}) {
+  if (native.rspack) return loadRspackMermaidActions(native);
   const url = await findCodexModule('app-initial',{read});
   if (!url) throw new Error('native-diagram-module-unavailable');
   const source = await read(url);
@@ -41,3 +42,26 @@ export async function loadNativeMermaidActions(native, {read = async url => { co
     return saveQvDiagram(downloadSrc,saveFile,markdownDownloadsDirectory,suggestedFilename);
   } };
 }
+
+
+export function loadRspackMermaidActions(native) {
+  const registry=native.rspack;
+  const preview=registry.module(source=>source.includes('imagePreviewDialog.label')&&source.includes('suggestedFilename:')&&source.includes('downloadSrc:'),'diagram preview download');
+  const call=preview.source.match(/\(0,([\w$]+\.[\w$]+)\)\(\{downloadSrc:[^}]*suggestedFilename:/);
+  const icon=call&&preview.source.slice(call.index).match(/children:\(0,[\w$]+\.jsx\)\(([\w$]+\.[\w$]+),\{className:"icon-xs"\}/)?.[1];
+  // 新版原生图标通过组件 + asset 绘制，沿真实下载按钮读取两者。
+  const assetIcon=call&&preview.source.slice(call.index).match(/children:\(0,[\w$]+\.jsx\)\(([\w$]+\.[\w$]+),\{"aria-hidden":!1,asset:([\w$]+\.[\w$]+)\}/);
+  if (!call || (!icon && !assetIcon)) throw new Error('native-diagram-download-unavailable');
+  const downloadImage=registry.binding(preview,call[1]);
+  let DownloadIcon;
+  if(icon) DownloadIcon=registry.binding(preview,icon);
+  else {
+    const Icon=registry.binding(preview,assetIcon[1]),asset=registry.binding(preview,assetIcon[2]);
+    if(typeof Icon!=='function'||!asset||!native.React?.createElement) throw new Error('native-diagram-download-unavailable');
+    DownloadIcon=props=>native.React.createElement(Icon,{...props,asset});
+  }
+  if (typeof DownloadIcon!=='function' || typeof downloadImage!=='function'
+    || !String(downloadImage).includes('workspaceFiles.saveStream')
+    || !String(downloadImage).includes('Failed to download image')) throw new Error('native-diagram-download-unavailable');
+  return {...native,DownloadIcon,downloadImage};
+}

package/features/mermaid-diagrams/src/injection-source.mjs

@@ -14,14 +14,14 @@ import { exportQvDiagram, saveQvDiagram } from './mermaid/export.mjs';
 import { createQvLoading } from './mermaid/loading.mjs';
 import { createMarkdownMermaidControls } from './adapters/codex/mermaid-viewer.mjs';
 import { installMarkdownMermaid } from './adapters/codex/mermaid.mjs';
-import { loadNativeMermaidActions } from './adapters/codex/native.mjs';
+import { loadNativeMermaidActions, loadRspackMermaidActions } from './adapters/codex/native.mjs';
 import { createMermaidRuntime } from './adapters/codex/runtime.mjs';
 
 export async function createPageScriptSource() {
   const bindings = [findCodexModule, codexModuleStyles,codexModuleRegistry,loadRspackMarkdownListAPI,loadRspackMarkdownToc,loadRspackMarkdownTableActions,loadRspackMarkdownRenderer, createMarkdownPreviewAdapter, loadMarkdownListAPI, captureMarkdownProviders,
     loadNativeMarkdownToc, loadNativeMarkdownRenderer, markdownExportAlias, loadNativeMarkdownTableActions,
     createQvResources, createQvFrame, readQvTheme, exportQvDiagram, saveQvDiagram, createQvLoading,
-    createMarkdownMermaidControls, installMarkdownMermaid, loadNativeMermaidActions, createMermaidRuntime];
+    createMarkdownMermaidControls, installMarkdownMermaid, loadNativeMermaidActions, loadRspackMermaidActions, createMermaidRuntime];
   const declarations = bindings.map(binding => `const ${binding.name} = ${binding.toString()};`).join('\n');
   const entry = await readFile(new URL('./mermaid-diagrams.mjs',import.meta.url),'utf8');
   return `const markdownDownloadsDirectory=${JSON.stringify(join(homedir(),'Downloads'))};\n${declarations}\n${entry}`;

package/features/mermaid-diagrams/src/mermaid/detail-position.mjs

@@ -0,0 +1,7 @@
+// 先限定与触发对象的距离，再在局部候选中避让；避免宽画布的空角吸走气泡。
+export function nearbyRadarDetails(candidates) {
+  const unobscured = candidates.filter(candidate => !(candidate.pointer ?? candidate.coversPointer));
+  const available = unobscured.length ? unobscured : candidates;
+  const nearest = Math.min(...available.map(candidate => candidate.distance));
+  return available.filter(candidate => candidate.distance <= Math.max(32, nearest + 16));
+}

package/features/mermaid-diagrams/src/mermaid/frame.mjs

@@ -51,7 +51,7 @@ export function createQvFrame(source, assets, theme, onHeight, onReady, onEscape
   frame.style.height = '240px';
   let disposed = false, height = 240, input = null;
   const timeout = setTimeout(() => { if (!disposed) onReady('error'); }, 30000);
-  const config = { source, title: '', descriptions: {}, icons: 'auto', navigation: 'expanded', readingWidth: theme.readingWidth };
+  const config = { source, title: '', descriptions: {}, icons: 'auto', readingWidth: theme.readingWidth };
   const encode = (value) => JSON.stringify(value).replace(/</g, '\\u003c');
   const bootstrap = `const token=${encode(token)};window.__mcxDiagramConfig=${encode(config)};window.openai={displayMode:'inline',maxHeight:innerHeight};
 const send=()=>{const root=document.querySelector('.qv-mermaid');parent.postMessage({type:'mcx-qv',token,state:root.dataset.state,height:Math.ceil(root.offsetHeight)},'*');};

package/features/mermaid-diagrams/src/mermaid/qv-git.js

@@ -0,0 +1,95 @@
+// QV 风格的 Git 分支图：模型读取与绘制。由构建器组装进 QV 模板，不修改 vendor 快照。
+// 视觉沿用 QV：分支色取 --viz-series-*（与背景混合降饱和）、12px 文字、按钮承载交互、共享视口与入场动效。
+function readMermaidGitModel(db,descriptions={}){
+ if(!db.getCommits||!db.getBranchesAsObjArray)return {reason:'gitGraph 数据接口不兼容'};
+ const branches=db.getBranchesAsObjArray().map(b=>b.name);
+ // 未写 id 的提交由 Mermaid 生成「序号-7 位哈希」，只展示哈希。
+ const commits=[...db.getCommits().values()].sort((a,b)=>a.seq-b.seq).map(c=>({id:String(c.id),message:String(c.message||''),type:c.type,tags:[...(c.tags||[])].map(String),parents:[...(c.parents||[])].map(String),branch:c.branch,auto:/^\d+-[0-9a-f]{7}$/.test(String(c.id)),description:descriptions[c.id]||''}));
+ if(!commits.length)return {reason:'gitGraph 没有提交'};
+ if(commits.some(c=>[c.id,c.message,...c.tags].some(hasRichMermaidLabel)))return {reason:'gitGraph 包含富文本，保留原生语义'};
+ const unknown=Object.keys(descriptions).filter(id=>!commits.some(c=>c.id===id));if(unknown.length)throw new Error('说明引用了未知提交：'+unknown.join('、'));
+ return {data:{kind:'git',branches,commits,direction:db.getDirection?.()||'LR',title:db.getDiagramTitle?.()||''}};
+}
+
+function renderMermaidGit(root,data){
+ const scene=root.querySelector('.scene'),viewport=root.querySelector('.diagram-scroll'),svg=scene.querySelector('svg'),NS='http://www.w3.org/2000/svg';
+ root.classList.add('qv-git');root.dataset.state='enhanced';root.dataset.renderer='qv-git';root.querySelector('.edge-key').hidden=true;
+ if(data.title&&root.querySelector('h3').hidden){root.querySelector('h3').textContent=data.title;root.querySelector('h3').hidden=false;}
+ const style=document.createElement('style');style.textContent=`
+ #${root.id} .git-branch{position:absolute;display:block;box-sizing:border-box;height:24px;padding:0 10px;border:0;border-radius:999px;font:inherit;font-size:12px;line-height:24px;color:color-mix(in srgb,var(--git-tone) 60%,var(--foreground));background:color-mix(in srgb,var(--git-tone) 14%,var(--background));white-space:nowrap;overflow:hidden;text-overflow:ellipsis;cursor:var(--cursor-interaction,pointer)}
+ #${root.id} .git-commit{position:absolute;display:flex;align-items:center;gap:8px;box-sizing:border-box;height:24px;padding:0;border:0;background:transparent;font:inherit;font-size:12px;line-height:18px;color:var(--foreground);white-space:nowrap;overflow:hidden;cursor:var(--cursor-interaction,pointer)}
+ #${root.id} .git-commit.lr{justify-content:center}
+ #${root.id} .git-commit>span{overflow:hidden;text-overflow:ellipsis;min-width:0}
+ #${root.id} .git-commit .git-text{flex:0 1 auto}
+ #${root.id} .git-commit .git-hash{color:var(--muted-foreground);font-variant-numeric:tabular-nums}
+ #${root.id} .git-commit .git-ref{flex:none;max-width:160px;height:20px;padding:0 8px;border-radius:999px;line-height:20px;color:color-mix(in srgb,var(--git-tone) 60%,var(--foreground));background:color-mix(in srgb,var(--git-tone) 14%,var(--background))}
+ #${root.id} .git-tag{flex:none;max-width:200px;height:20px;padding:0 8px;box-sizing:border-box;border:1px solid var(--border);border-radius:6px;line-height:18px;color:var(--muted-foreground);background:var(--background);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+ #${root.id} .git-tag.lr{position:absolute}
+ #${root.id} .git-edge{fill:none;stroke:color-mix(in srgb,var(--git-tone) 70%,var(--background));stroke-width:2;stroke-linecap:round}
+ #${root.id} .git-dot{fill:var(--git-tone);stroke:var(--background);stroke-width:2}
+ #${root.id} .git-dot.merge{fill:var(--background);stroke:var(--git-tone);stroke-width:2.5}
+ #${root.id} .git-dot.cherry{fill:var(--background);stroke:var(--git-tone);stroke-width:2;stroke-dasharray:3 2}
+ #${root.id} .git-mark{fill:none;stroke:var(--git-tone);stroke-width:2;stroke-linecap:round}
+ #${root.id} [data-branch]{transition:opacity 140ms}
+ #${root.id} [data-dim]{opacity:.22}
+ #${root.id} .git-commit:focus-visible,#${root.id} .git-branch:focus-visible{outline:1px solid var(--viz-series-1);outline-offset:2px}
+ @media(prefers-reduced-motion:reduce){#${root.id} [data-branch]{transition:none}}
+ `;root.append(style);
+ const el=(tag,attrs)=>{const n=document.createElementNS(NS,tag);for(const [k,v] of Object.entries(attrs))n.setAttribute(k,v);svg.append(n);return n;};
+ const html=(tag,cls,text)=>{const n=document.createElement(tag);n.className=cls;if(text!==undefined)n.textContent=text;return n;};
+ const lane=new Map(data.branches.map((b,i)=>[b,i])),tone=b=>`var(--viz-series-${(lane.get(b)??0)%6+1})`;
+ const index=new Map(data.commits.map((c,i)=>[c.id,i])),firstOf=new Map();data.commits.forEach(c=>{if(!firstOf.has(c.branch))firstOf.set(c.branch,c.id);});
+ const context=document.createElement('canvas').getContext('2d');context.font='12px '+getComputedStyle(root).fontFamily;const measure=t=>Math.ceil(context.measureText(t).width);
+ const label=c=>c.auto?c.id.split('-')[1]:c.id;
+ // 横排放得下正文宽度就沿用 Mermaid 默认方向；放不下改为 git log 式纵排（与流程图主轴规则一致）。
+ const limit=cfg.readingWidth||root.clientWidth,n=data.commits.length,lanes=data.branches.length;
+ const branchCol=Math.min(160,Math.max(...data.branches.map(measure))+20),step=Math.min(140,Math.max(56,...data.commits.map(c=>measure(label(c))+16)));
+ const lrStart=24+branchCol+24,lrWidth=lrStart+(n-1)*step+step/2+24;
+ const vertical=data.direction!=='LR'||lrWidth>limit;root.dataset.gitLayout=vertical?'rows':'lanes';root.dataset.mcxLayout=vertical?'git-rows':'git-lanes';
+ const commits=[],edges=[],refs=[];let width,height,point;
+ if(!vertical){
+  const tagged=new Set(data.commits.filter(c=>c.tags.length).map(c=>lane.get(c.branch)));let y=36;const laneY=data.branches.map((b,i)=>{if(tagged.has(i))y+=26;const v=y;y+=56;return v;});
+  width=lrWidth;height=laneY.at(-1)+48;point=c=>({x:lrStart+index.get(c.id)*step,y:laneY[lane.get(c.branch)]});
+  data.branches.forEach((b,i)=>{const r=html('button','git-branch',b);r.type='button';r.title=b;r.dataset.branch=b;r.style.setProperty('--git-tone',tone(b));r.style.left='24px';r.style.top=(laneY[i]-12)+'px';r.style.maxWidth=branchCol+'px';scene.append(r);refs.push(r);});
+ }else{
+  const rowH=32,top=12,textX=24+lanes*24+12,order=data.direction==='BT'?[...data.commits].reverse():data.commits,row=new Map(order.map((c,i)=>[c.id,i]));
+  width=Math.max(textX+240,limit);height=top+n*rowH+12;point=c=>({x:24+12+lane.get(c.branch)*24,y:top+row.get(c.id)*rowH+rowH/2});
+ }
+ scene.style.width=scene.style.minWidth=width+'px';scene.style.height=height+'px';svg.setAttribute('width',width);svg.setAttribute('height',height);svg.setAttribute('viewBox',`0 0 ${width} ${height}`);svg.style.width=width+'px';svg.style.height=height+'px';
+ // 分支分出时在父提交附近转入新泳道；合并时沿来源泳道前进，在合并提交前转入。
+ const toXY=(m,c)=>vertical?[c,m]:[m,c],unit=vertical?32:step;
+ for(const c of data.commits){const b=point(c),bm=vertical?b.y:b.x,bc=vertical?b.x:b.y;
+  for(const [k,pid] of c.parents.entries()){const parent=data.commits[index.get(pid)];if(!parent)continue;const a=point(parent),am=vertical?a.y:a.x,ac=vertical?a.x:a.y,s=Math.sign(bm-am)||1,r=Math.min(Math.abs(bm-am),unit);
+   let d,owner;const curve=(m0,c0,m1,c1)=>{const mid=(m0+m1)/2;return `C${toXY(mid,c0)} ${toXY(mid,c1)} ${toXY(m1,c1)}`;};
+   if(ac===bc){d=`M${toXY(am,ac)} L${toXY(bm,bc)}`;owner=c.branch;}
+   else if(firstOf.get(c.branch)===c.id&&k===0){d=`M${toXY(am,ac)} ${curve(am,ac,am+s*r,bc)} L${toXY(bm,bc)}`;owner=c.branch;}
+   else{d=`M${toXY(am,ac)} L${toXY(bm-s*r,ac)} ${curve(bm-s*r,ac,bm,bc)}`;owner=parent.branch;}
+   const path=el('path',{d,class:'git-edge','data-branch':owner});path.style.setProperty('--git-tone',tone(owner));edges.push({path,index:index.get(c.id)});}}
+ for(const c of data.commits){const p=point(c),i=index.get(c.id),t=tone(c.branch),kind=['normal','reverse','highlight','merge','cherry'][c.type]||'normal';let mark;
+  if(kind==='highlight')mark=el('rect',{x:p.x-6,y:p.y-6,width:12,height:12,rx:2,class:'git-dot','data-branch':c.branch});
+  else{mark=el('circle',{cx:p.x,cy:p.y,r:kind==='merge'?6:kind==='cherry'?6:5.5,class:'git-dot '+kind,'data-branch':c.branch});}
+  mark.style.setProperty('--git-tone',t);const marks=[mark];
+  if(kind==='reverse'){const x=el('path',{d:`M${p.x-3} ${p.y-3}l6 6m0 -6l-6 6`,class:'git-mark','data-branch':c.branch});x.style.setProperty('--git-tone','var(--background)');marks.push(x);}
+  const b=html('button','git-commit'+(vertical?'':' lr'));b.type='button';b.dataset.branch=c.branch;b.style.setProperty('--git-tone',t);
+  b.title=[c.branch,c.auto?c.id.split('-')[1]:c.id,c.message,...c.tags,c.description].filter(Boolean).join(' · ');b.setAttribute('aria-label',b.title);
+  const text=html('span','git-text'+(c.auto?' git-hash':''),label(c));const tags=[];
+  if(vertical){const textX=24+lanes*24+12;if(firstOf.get(c.branch)===c.id){const ref=html('span','git-ref',c.branch);b.append(ref);}b.append(text);if(c.message&&!c.auto)b.append(html('span','git-hash',c.message));c.tags.forEach(v=>{const g=html('span','git-tag',v);b.append(g);});b.style.left=textX+'px';b.style.top=(p.y-12)+'px';b.style.maxWidth=(width-textX-16)+'px';}
+  else{b.append(text);b.style.left=(p.x-(step-8)/2)+'px';b.style.width=(step-8)+'px';b.style.top=(p.y+10)+'px';c.tags.forEach((v,j)=>{const g=html('span','git-tag lr',v);g.title=v;g.dataset.branch=c.branch;g.style.maxWidth=Math.max(step-8,96)+'px';scene.append(g);g.style.left=(p.x-g.offsetWidth/2)+'px';g.style.top=(p.y-34-j*24)+'px';tags.push(g);});}
+  scene.append(b);commits.push({c,i,b,marks,tags});}
+ const view=createMermaidViewport(root);
+ // 悬停或聚焦某提交时只保留其所在分支，其余分支降为背景。
+ const all=()=>root.querySelectorAll('[data-branch]');function clear(){all().forEach(n=>n.removeAttribute('data-dim'));}
+ function focus(branch){all().forEach(n=>n.toggleAttribute('data-dim',n.dataset.branch!==branch));}
+ for(const o of commits){o.b.addEventListener('pointerenter',()=>focus(o.c.branch));o.b.addEventListener('pointerleave',clear);o.b.addEventListener('focus',()=>{focus(o.c.branch);const r=o.b.getBoundingClientRect(),v=viewport.getBoundingClientRect();if(r.left<v.left+12)viewport.scrollLeft-=v.left+12-r.left;else if(r.right>v.right-12)viewport.scrollLeft+=r.right-v.right+12;});o.b.addEventListener('blur',clear);}
+ for(const r of refs){r.addEventListener('pointerenter',()=>focus(r.dataset.branch));r.addEventListener('pointerleave',clear);r.addEventListener('focus',()=>focus(r.dataset.branch));r.addEventListener('blur',clear);}
+ viewport.addEventListener('scroll',clear,{passive:true});root.addEventListener('keydown',e=>{if(e.key==='Escape')clear();});
+ // 入场：按提交顺序画出连线并点亮提交，总时长约 1.2 秒；减少动态效果时不播放。
+ const reduced=matchMedia('(prefers-reduced-motion:reduce)');let running=[],armed=true;const gap=Math.min(120,1200/Math.max(1,n-1));
+ function replay(){running.forEach(a=>a.cancel());running=[];if(reduced.matches||view.expanded)return;
+  for(const {path,index:i} of edges){const length=path.getTotalLength();path.style.strokeDasharray=`${length} ${length}`;const a=path.animate([{strokeDashoffset:length},{strokeDashoffset:0}],{duration:360,delay:Math.max(0,i-1)*gap,easing:'cubic-bezier(.2,.7,.3,1)',fill:'backwards'});a.onfinish=()=>{path.style.strokeDasharray='';};running.push(a);}
+  for(const o of commits){const delay=o.i*gap;o.marks.forEach(m=>running.push(m.animate([{opacity:0},{opacity:1}],{duration:200,delay,fill:'backwards'})));[o.b,...o.tags].forEach(n=>running.push(n.animate([{opacity:0},{opacity:1}],{duration:200,delay:delay+60,fill:'backwards'})));}
+  root.dataset.replays=String(+(root.dataset.replays||0)+1);}
+ new IntersectionObserver(es=>{if(!es[0].isIntersecting)armed=true;else if(es[0].intersectionRatio>=.2&&armed){armed=false;replay();}},{threshold:[0,.2]}).observe(root);
+ document.addEventListener('visibilitychange',()=>{if(document.hidden)armed=true;else if(armed){armed=false;replay();}});
+ root.addEventListener('qv:display-mode',()=>{running.forEach(a=>a.cancel());clear();if(!view.expanded)viewport.scrollLeft=view.savedInlinePosition?.left||0;});reduced.addEventListener('change',()=>running.forEach(a=>a.cancel()));view.refresh();
+}

package/features/mermaid-diagrams/src/mermaid/qv-motion.js

@@ -0,0 +1,25 @@
+// 规则 32–33：渲染器显式接入，不修改宿主或 iframe 的全局原型。
+const mermaidEntryEase='cubic-bezier(.23,1,.32,1)',mermaidEntryBudget=1200;
+let mermaidEntryBatch=null;
+function animateMermaidEntry(element,frames,options){
+ const timing=typeof options==='number'?{duration:options}:{...options};
+ timing.easing=mermaidEntryEase;
+ if(Array.isArray(frames))frames=frames.map(frame=>{
+  const match=typeof frame.transform==='string'&&frame.transform.match(/^scale\((0|0?\.\d+)\)$/);
+  if(!match||+match[1]>=.9)return frame;
+  return {...frame,transform:`scale(${+match[1]<.5?.92:.97})`,opacity:frame.opacity??(+match[1]<.5?0:1)};
+ });
+ const animation=element.animate(frames,timing);
+ if(!mermaidEntryBatch){mermaidEntryBatch=[];queueMicrotask(()=>{
+  const batch=mermaidEntryBatch;mermaidEntryBatch=null;
+  const end=Math.max(0,...batch.map(a=>{const t=a.effect.getTiming();return Number(t.delay)+Number(t.duration);}));
+  if(end>mermaidEntryBudget){const ratio=mermaidEntryBudget/end;for(const a of batch){const t=a.effect.getTiming();a.effect.updateTiming({delay:Number(t.delay)*ratio,duration:Number(t.duration)*ratio});}}
+ });}
+ mermaidEntryBatch.push(animation);return animation;
+}
+// rAF 与 D3 几何动画采用同一条曲线，二分求解 Bézier 的时间参数。
+function mermaidEntryProgress(time){
+ const t=Math.max(0,Math.min(1,time));let low=0,high=1;
+ for(let i=0;i<16;i++){const u=(low+high)/2,x=3*(1-u)*(1-u)*u*.23+3*(1-u)*u*u*.32+u*u*u;if(x<t)low=u;else high=u;}
+ const u=(low+high)/2;return 1-(1-u)**3;
+}

package/features/mermaid-diagrams/src/mermaid/qv-polish.css

@@ -0,0 +1,20 @@
+#mcx-qv-root.qv-mermaid{--mcx-ease-out:cubic-bezier(.23,1,.32,1);--mcx-tip-shadow:0 4px 16px light-dark(color-mix(in srgb,var(--foreground) 9%,transparent),rgb(0 0 0/.5));--mcx-tip-surface:light-dark(var(--popover),color-mix(in srgb,var(--popover-foreground) 6%,var(--popover)))}
+#mcx-qv-root.qv-mermaid :is(.node-tip,.seq-tip,.er-tip,.class-tip,.state-tip,.state-peers,.xy-tip,.sankey-detail,.radar-detail,.quadrant-detail,.architecture-detail,.bubble,.quick-radar-tooltip){background:var(--mcx-tip-surface);color:var(--popover-foreground);border:1px solid var(--border);border-radius:12px;padding:12px 14px;font-size:12px;line-height:18px;box-shadow:var(--mcx-tip-shadow);transition:opacity 140ms var(--mcx-ease-out),scale 140ms var(--mcx-ease-out)}
+@starting-style{#mcx-qv-root.qv-mermaid :is(.node-tip,.seq-tip,.er-tip,.class-tip,.state-tip,.state-peers,.xy-tip,.sankey-detail,.radar-detail,.quadrant-detail,.architecture-detail,.bubble,.quick-radar-tooltip){opacity:0;scale:.97}}
+#mcx-qv-root.qv-mermaid :is(.xy-tip-title,.sankey-detail-title,.radar-detail-title,.c4-tip-title,.state-tip-name,.bubble-title,.quick-radar-tooltip-dimension){font-size:14px;line-height:20px;font-weight:500}
+#mcx-qv-root.qv-mermaid :is(.xy-tip-name,.radar-detail-name,.quick-radar-tooltip-name){color:var(--muted-foreground);font-weight:400}
+#mcx-qv-root.qv-mermaid :is(.xy-tip-value,.radar-detail-value,.quick-radar-tooltip-value,.bubble-value){color:var(--popover-foreground);font-weight:500;font-variant-numeric:tabular-nums}
+#mcx-qv-root.qv-mermaid :is(.state-tip-caption,.architecture-detail-label){font-size:12px;line-height:18px}
+@media (prefers-reduced-motion:reduce){#mcx-qv-root.qv-mermaid :is(.node-tip,.seq-tip,.er-tip,.class-tip,.state-tip,.state-peers,.xy-tip,.sankey-detail,.radar-detail,.quadrant-detail,.architecture-detail,.bubble,.quick-radar-tooltip){transition:none}}
+
+/* 规则 37：标题、正文与辅助信息保持稳定层级。 */
+#mcx-qv-root.qv-mermaid h3{font-size:16px;line-height:24px}
+#mcx-qv-root.qv-mermaid .state-node{font-size:14px;line-height:20px}
+#mcx-qv-root.qv-mermaid .timeline-period{font-size:14px}
+#mcx-qv-root.qv-mermaid .er-type{color:var(--muted-foreground)}
+
+/* 内容画布在宽容器内居中，超宽时保留左侧可达的滚动起点。 */
+#mcx-qv-root.qv-mermaid:is([data-renderer="qv-quadrant"],[data-renderer="qv-er"],[data-renderer="qv-class"]) .scene{margin-inline:auto}
+/* Journey 的固定参考轴与步骤画布一起居中，溢出时只滚动步骤。 */
+#mcx-qv-root.qv-mermaid[data-renderer="qv-journey"] .journey-frame{max-width:100%;margin-inline:auto}
+#mcx-qv-root.qv-mermaid:is([data-renderer="qv-radar"],[data-renderer="qv-sankey"]) h3{margin-inline:0;text-align:center}

package/features/mermaid-diagrams/src/mermaid/qv-title.mjs

@@ -0,0 +1,11 @@
+import { load, JSON_SCHEMA } from 'js-yaml';
+
+// Mermaid 11.12 的 getDiagramFromText 只转交显式 metadata，未转交预处理得到的标题。
+// 使用相同的 YAML schema 与边界，避免另写只能识别单行标题的解析器。
+export function readMermaidTitle(source) {
+  const match = source.replace(/\r\n?/g, '\n').match(/^-{3}\s*[\n\r](.*?)[\n\r]-{3}\s*[\n\r]+/s);
+  if (!match) return '';
+  const metadata = load(match[1], { schema: JSON_SCHEMA });
+  return metadata && typeof metadata === 'object' && !Array.isArray(metadata) && metadata.title
+    ? String(metadata.title) : '';
+}

package/features/mermaid-diagrams/vendor/qv/THIRD_PARTY_NOTICES.txt

@@ -2563,6 +2563,33 @@ TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
 THIS SOFTWARE.
 
 
+========================================================================
+js-yaml@4.1.1 — MIT
+
+LICENSE
+(The MIT License)
+
+Copyright (C) 2011-2015 by Vitaly Puzrin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
 ========================================================================
 katex@0.16.47 — MIT
 

package/features/quick-chat/src/adapters/codex/rspack.mjs

@@ -0,0 +1,50 @@
+// 从已注册的原生模块与导出表解析角色，不执行模块工厂或依赖压缩名称。
+export function loadRspackQuickChatBindings(registry, commandCatalog) {
+  const catalog=registry.module(source=>/\{id:[`"']temporaryChat[`"'],titleIntlId:/.test(source),'Quick Chat command catalog');
+  const native=commandCatalog(catalog.source);
+  if (native) return {native};
+  const entry=registry.module(source=>/has-opened-quick-chat-v1/.test(source)&&/chatgpt\.quick-chat/.test(source),'Quick Chat lifecycle');
+  const exported=local=>{
+    if (!local) throw new Error('quick-chat-lifecycle-contract-unavailable');
+    const escaped=local.replace(/[.*+?^${}()|[\]\\]/g,'\\$&');
+    const key=entry.source.match(new RegExp(`([\\w$]+):\\(\\)=>${escaped}(?=[,}])`))?.[1];
+    const value=key && registry.exports(entry)[key];
+    if (value==null) throw new Error('quick-chat-lifecycle-export-unavailable');
+    return value;
+  };
+  const open=registry.value(entry,(value,source)=>typeof value==='function'&&/chatgpt\.quick-chat/.test(source)&&/\.get\(([\w$]+)\)\|\|/.test(source),'Quick Chat open');
+  const source=String(open);
+  const create=exported(source.match(/null==[\w$]+\?([\w$]+)\([\w$]+,[\w$]+\):/)?.[1]);
+  const state=exported(source.match(/\.get\(([\w$]+)\)\|\|/)?.[1]);
+  const bindings={native,open,create,isOpen:scope=>scope.get(state)};
+  if (typeof create!=='function') throw new Error('quick-chat-lifecycle-contract-unavailable');
+  try {
+    const discard=registry.value(entry,(value,source)=>typeof value==='function'&&/draftKey:/.test(source)&&/content:null/.test(source)&&/conversationId,""/.test(source),'Quick Chat discard');
+    const actions=String(discard).match(/let ([\w$]+)=([\w$]+)\.get\(([\w$]+)\);([\w$]+)\(\2\),\2\.set\(\3,null\),null!=\1&&\(\(0,([\w$]+\.[\w$]+)\)\(\2,\{draftKey:\1\.conversationId,content:null\}\),\(0,([\w$]+\.[\w$]+)\)\(\2,\1\.conversationId,""\),\2\.set\(([\w$]+\.[\w$]+),\1\.conversationId,\[\]\)/);
+    if (!actions) throw new Error('quick-chat-close-contract-unavailable');
+    const session=exported(actions[3]),close=exported(actions[4]);
+    const draft=registry.binding(entry,actions[5]),text=registry.binding(entry,actions[6]),attachments=registry.binding(entry,actions[7]);
+    if ([close,draft,text].some(value=>typeof value!=='function')) throw new Error('quick-chat-close-contract-unavailable');
+    bindings.close=(scope,id)=>{
+      if (scope.get(session)?.conversationId!==id) return false;
+      draft(scope,{draftKey:id,content:null});text(scope,id,'');scope.set(attachments,id,[]);close(scope);return true;
+    };
+  } catch { /* 关闭协议独立失效时仍保留打开能力。 */ }
+  try {
+    const modeEntry=registry.module(source=>/conversationDetailMode/.test(source)&&/"work":"codex"/.test(source),'Quick Chat product mode');
+    const modes=Object.values(registry.exports(modeEntry));
+    if (modes.length===1) bindings.mode=scope=>scope.get(modes[0]);
+  } catch { /* 无模式 selector 时只使用可见模式选择器。 */ }
+  return bindings;
+}
+
+export function loadRspackQuickChatIcon(registry) {
+  const entry=registry.module(source=>/"data-floating-chat-surface":/.test(source)&&/minimizedIcon:/.test(source),'Quick Chat floating surface');
+  const local=entry.source.match(/minimizedIcon:([\w$]+)/)?.[1];
+  const escaped=local?.replace(/[.*+?^${}()|[\]\\]/g,'\\$&');
+  const reference=escaped&&entry.source.match(new RegExp(`children:${escaped}\\?\\?\\(0,[\\w$]+\\.jsx\\)\\(([\\w$]+\\.[\\w$]+),\\{\\}\\)`))?.[1];
+  if (!reference) throw new Error('quick-chat-icon-contract-unavailable');
+  const icon=registry.binding(entry,reference);
+  if (typeof icon?.createElement!=='function') throw new Error('quick-chat-icon-contract-unavailable');
+  return icon;
+}

package/features/quick-chat/src/adapters/codex/shortcut.mjs

@@ -1,4 +1,5 @@
-import { findCodexModule } from '../../../../../packages/codex-adapter/src/renderer/modules.mjs';
+import {loadRspackQuickChatBindings} from "./rspack.mjs";
+import { findCodexModule, codexModuleRegistry } from '../../../../../packages/codex-adapter/src/renderer/modules.mjs';
 import {quickChatLifecycleActions, quickChatScope} from "./lifecycle.mjs";
 // 通过原生能力检查与已有会话分支定位打开动作，不依赖构建哈希或压缩名称。
 export function quickChatOpenExport(source) {
@@ -99,6 +100,12 @@ export function installQuickChatShortcut(signal, codex, discover = null) {
   }
   async function load() {
     codex.report('quick-chat-shortcut', false, 'quick-chat-module-pending');
+    const registry=await codexModuleRegistry({signal:loading.signal,waitForEntry:true,read:async url=>(await fetch(url,{signal:loading.signal})).text()});
+    if (registry) {
+      const bindings=loadRspackQuickChatBindings(registry,quickChatNativeCommand);
+      if (!bindings.native && !bindings.close) codex.report('quick-chat-close',false,'quick-chat-close-contract-unavailable');
+      return bindings;
+    }
     const url=await findCodexModule('app-initial',{signal:loading.signal,waitForEntry:true});
     if (!url) throw new Error('quick-chat-module-unavailable');
     const source = await (await fetch(url, {signal:loading.signal})).text();

package/features/quick-chat/src/adapters/codex/sidebar.mjs

@@ -1,5 +1,9 @@
-import { findCodexModule } from '../../../../../packages/codex-adapter/src/renderer/modules.mjs';
+import {loadRspackQuickChatIcon} from "./rspack.mjs";
+import { findCodexModule, codexModuleRegistry } from '../../../../../packages/codex-adapter/src/renderer/modules.mjs';
 export async function loadQuickChatSidebarIcon(signal) {
+  signal.throwIfAborted();
+  const registry=await codexModuleRegistry({signal,waitForEntry:true,read:async url=>(await fetch(url,{signal})).text()});
+  if (registry) return loadRspackQuickChatIcon(registry);
   const initialUrl = await findCodexModule('app-initial',{signal});
   if (!initialUrl) throw new Error('quick-chat-icon-module-unavailable');
   const initial = await (await fetch(initialUrl,{signal})).text();

package/features/quick-chat/src/injection-source.mjs

@@ -1,4 +1,5 @@
-import { findCodexModule } from '../../../packages/codex-adapter/src/renderer/modules.mjs';
+import {loadRspackQuickChatBindings,loadRspackQuickChatIcon} from "./adapters/codex/rspack.mjs";
+import { findCodexModule, codexModuleRegistry } from '../../../packages/codex-adapter/src/renderer/modules.mjs';
 import {quickChatLifecycleActions, quickChatScope} from "./adapters/codex/lifecycle.mjs";
 import {quickChatHistoryVisible} from "./adapters/codex/history.mjs";
 import { readFile } from "node:fs/promises";
@@ -10,7 +11,7 @@ import { installQuickChatSidebar } from "./frontend/sidebar.mjs";
 import { createHistoryTracker } from "./domain/history.mjs";
 export async function createPageScriptSource() {
   const source = await readFile(new URL("./frontend/entry.mjs", import.meta.url), "utf8");
-  const functions = [findCodexModule, quickChatHistoryVisible, loadQuickChatSidebarIcon, createQuickChatSidebarAdapter, installQuickChatSidebar,
+  const functions = [findCodexModule, codexModuleRegistry, loadRspackQuickChatBindings, loadRspackQuickChatIcon, quickChatHistoryVisible, loadQuickChatSidebarIcon, createQuickChatSidebarAdapter, installQuickChatSidebar,
     quickChatLifecycleActions, quickChatScope, quickChatOpenExport, quickChatLifecycleExports, quickChatNativeCommand, installQuickChatShortcut, createQuickChatAdapter,
     createSubmissionTracker, createHistoryTracker];
   return functions.map(fn => `const ${fn.name}=${fn.toString()};`).join('\n') + '\n' + source;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "2.0.52",
+  "version": "2.0.54",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",
@@ -142,6 +142,7 @@
     "elkjs": "0.10.0",
     "esbuild": "^0.28.2",
     "html-to-image": "1.11.13",
+    "js-yaml": "4.1.1",
     "lucide": "0.468.0",
     "mermaid": "11.12.0"
   }

package/packages/cli/src/config.mjs

@@ -14,7 +14,7 @@ export const DEFAULT_CONFIG = Object.freeze({
     "sidebar-focus": true,
     sites: true,
     "markdown-reading": true,
-    "mermaid-diagrams": false,
+    "mermaid-diagrams": true,
     "file-navigation": true,
     "files-auto-refresh": true,
     "quick-chat": true,

package/packages/codex-adapter/src/markdown/rspack.mjs

@@ -1,9 +1,8 @@
 // Markdown 共用原生角色；只沿已注册模块与原生 lazy 声明绑定依赖。
 export async function loadRspackMarkdownToc(registry) {
-  if (!registry.entries.some(entry=>entry.source.includes('data-heading-preview'))) {
-    const page=registry.module(source=>source.includes(').PageEditorContent'),'Pages content loader');
-    await registry.lazy(page,'PageEditorContent');
-  }
+  // 工厂已注册不等于依赖已初始化；并行加载的阅读与图表增强共用原生 import 完成点。
+  const page=registry.module(source=>source.includes(').PageEditorContent'),'Pages content loader');
+  await registry.lazy(page,'PageEditorContent');
   const owner=registry.module(source=>source.includes('data-heading-preview')&&source.includes('page-table-of-contents'),'Pages table of contents');
   const body=marker=>{
     const at=owner.source.indexOf(marker),start=owner.source.lastIndexOf('function ',at);

package/packages/codex-adapter/src/renderer/modules.mjs

@@ -66,62 +66,80 @@ export function codexModuleStyles(source, ownerUrl, moduleUrl) {
 }
 
 // rspack 的入口公开原生 require；只读取已注册模块，不重新执行模块工厂。
-export async function codexModuleRegistry({read = async url => (await fetch(url)).text(), load = url => import(url)} = {}) {
-  for (const script of document.querySelectorAll('script[src]')) {
-    const url = script.src;
-    if (!url) continue;
-    const source = await read(url);
-    if (!/export\s*\{[^}]*\bas\s+__webpack_require__\b/.test(source)) continue;
-    const runtime = (await load(url)).__webpack_require__;
-    if (typeof runtime !== 'function' || !runtime.m || !runtime.c) throw new Error('native-module-registry-unavailable');
-    const sourceOf = value => {
-      try { return Function.prototype.toString.call(value); } catch { return ''; }
-    };
-    const entries = Object.entries(runtime.m).map(([id, factory]) => ({id, source:sourceOf(factory)}));
-    const unique = (values, role) => {
-      if (values.length !== 1) throw new Error(`Native module contract changed: ${role}`);
-      return values[0];
-    };
-    const resolvedExports = new Map();
-    const exportsOf = entry => {
-      if (resolvedExports.has(entry.id)) return resolvedExports.get(entry.id);
-      const cached = runtime.c[entry.id];
-      if (!cached || cached.error) throw new Error('native-module-not-loaded');
-      return cached.exports;
-    };
-    const module = (predicate, role) => unique(entries.filter(entry => predicate(entry.source, entry)), role);
-    const value = (entry, predicate, role) => unique(Object.values(exportsOf(entry)).filter(item => predicate(item, sourceOf(item))), role);
-    const binding = (entry, reference) => {
-      const [owner, ...properties] = reference.split('.');
-      const escaped = owner.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-      const id = entry.source.match(new RegExp(`(?:^|[^\\w$])${escaped}=[\\w$]+\\("([^"\\n]+)"\\)`))?.[1];
-      if (!id) throw new Error('native-module-binding-unavailable');
-      let result = exportsOf({id});
-      for (const property of properties) result = result?.[property];
-      if (result == null) throw new Error('native-module-export-unavailable');
-      return result;
-    };
-    const lazy = async (entry, name) => {
-      const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-      const match = entry.source.match(new RegExp(`[\\w$]+\\.e\\((\\d+)\\)\\.then\\([\\w$]+\\.bind\\([\\w$]+,"([^"\\n]+)"\\)\\)\\.then\\([\\w$]+=>\\(\\{default:[\\w$]+\\.${escaped}\\}\\)\\)`));
-      let id;
-      if (match) {
-        await runtime.e(Number(match[1]));
-        id=match[2];
-      } else {
-        // Pages 与 KaTeX 使用具名异步导入；依赖列表仍完全来自原生声明。
-        const group=entry.source.match(new RegExp(`Promise\\.all\\(\\[([^\\]]+)\\]\\)\\.then\\([\\w$]+\\.bind\\([\\w$]+,"([^"\\n]+)"\\)\\)(?:\\)\\.${escaped}\\b|\\.then\\(\\(\\{${escaped}(?=[:,}]))`));
-        if(!group || !/^(?:[\w$]+\.e\(\d+\),?)+$/.test(group[1])) throw new Error('native-module-lazy-contract-unavailable');
-        await Promise.all([...group[1].matchAll(/\.e\((\d+)\)/g)].map(item=>runtime.e(Number(item[1]))));
-        id=group[2];
-      }
-      const exports = await runtime(id);
-      if (exports[name] == null) throw new Error('native-module-lazy-export-unavailable');
-      resolvedExports.set(id,exports);
-      entries.splice(0,entries.length,...Object.entries(runtime.m).map(([id,factory])=>({id,source:sourceOf(factory)})));
-      return {id, source:sourceOf(runtime.m[id])};
-    };
-    return {entries, module, value, binding, lazy, exports:exportsOf, sourceOf};
+export async function codexModuleRegistry({read = async url => (await fetch(url)).text(), load = url => import(url), signal, waitForEntry = false} = {}) {
+  const scripts=()=>[...document.querySelectorAll('script[src]')];
+  const visited=new Set();
+  while (true) {
+    signal?.throwIfAborted();
+    for (const script of scripts()) {
+      signal?.throwIfAborted();
+      if (visited.has(script.src)) continue;
+      visited.add(script.src);
+      const url = script.src;
+      if (!url) continue;
+      const source = await read(url);
+      if (!/export\s*\{[^}]*\bas\s+__webpack_require__\b/.test(source)) continue;
+      const runtime = (await load(url)).__webpack_require__;
+      if (typeof runtime !== 'function' || !runtime.m || !runtime.c) throw new Error('native-module-registry-unavailable');
+      const sourceOf = value => {
+        try { return Function.prototype.toString.call(value); } catch { return ''; }
+      };
+      const entries = Object.entries(runtime.m).map(([id, factory]) => ({id, source:sourceOf(factory)}));
+      const unique = (values, role) => {
+        if (values.length !== 1) throw new Error(`Native module contract changed: ${role}`);
+        return values[0];
+      };
+      const resolvedExports = new Map();
+      const exportsOf = entry => {
+        if (resolvedExports.has(entry.id)) return resolvedExports.get(entry.id);
+        const cached = runtime.c[entry.id];
+        if (!cached || cached.error) throw new Error('native-module-not-loaded');
+        return cached.exports;
+      };
+      const module = (predicate, role) => unique(entries.filter(entry => predicate(entry.source, entry)), role);
+      const value = (entry, predicate, role) => unique(Object.values(exportsOf(entry)).filter(item => predicate(item, sourceOf(item))), role);
+      const binding = (entry, reference) => {
+        const [owner, ...properties] = reference.split('.');
+        const escaped = owner.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const id = entry.source.match(new RegExp(`(?:^|[^\\w$])${escaped}=[\\w$]+\\("([^"\\n]+)"\\)`))?.[1];
+        if (!id) throw new Error('native-module-binding-unavailable');
+        let result = exportsOf({id});
+        for (const property of properties) result = result?.[property];
+        if (result == null) throw new Error('native-module-export-unavailable');
+        return result;
+      };
+      const lazy = async (entry, name) => {
+        const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const match = entry.source.match(new RegExp(`[\\w$]+\\.e\\((\\d+)\\)\\.then\\([\\w$]+\\.bind\\([\\w$]+,"([^"\\n]+)"\\)\\)\\.then\\([\\w$]+=>\\(\\{default:[\\w$]+\\.${escaped}\\}\\)\\)`));
+        let id;
+        if (match) {
+          await runtime.e(Number(match[1]));
+          id=match[2];
+        } else {
+          // Pages 与 KaTeX 使用具名异步导入；依赖列表仍完全来自原生声明。
+          const group=entry.source.match(new RegExp(`Promise\\.all\\(\\[([^\\]]+)\\]\\)\\.then\\([\\w$]+\\.bind\\([\\w$]+,"([^"\\n]+)"\\)\\)(?:\\)\\.${escaped}\\b|\\.then\\(\\(\\{${escaped}(?=[:,}]))`));
+          if(!group || !/^(?:[\w$]+\.e\(\d+\),?)+$/.test(group[1])) throw new Error('native-module-lazy-contract-unavailable');
+          await Promise.all([...group[1].matchAll(/\.e\((\d+)\)/g)].map(item=>runtime.e(Number(item[1]))));
+          id=group[2];
+        }
+        const exports = await runtime(id);
+        if (exports[name] == null) throw new Error('native-module-lazy-export-unavailable');
+        resolvedExports.set(id,exports);
+        entries.splice(0,entries.length,...Object.entries(runtime.m).map(([id,factory])=>({id,source:sourceOf(factory)})));
+        return {id, source:sourceOf(runtime.m[id])};
+      };
+      return {entries, module, value, binding, lazy, exports:exportsOf, sourceOf};
+    }
+    if (!waitForEntry || scripts().some(script=>/\/(?:index|app-(?:main|initial))-[^/]+\.js(?:$|\?)/.test(script.src))) return null;
+    // HTML 仍在逐个挂载入口脚本时，首个 chunk 不一定拥有注册表。
+    await new Promise((resolve,reject)=>{
+      const cleanup=()=>{observer.disconnect();signal?.removeEventListener('abort',abort);};
+      const abort=()=>{cleanup();reject(signal.reason);};
+      const check=()=>{if(scripts().some(script=>!visited.has(script.src))){cleanup();resolve();}};
+      const observer=new MutationObserver(check);
+      observer.observe(document.documentElement,{childList:true,subtree:true,attributes:true,attributeFilter:['src']});
+      signal?.addEventListener('abort',abort,{once:true});
+      if(signal?.aborted)abort();else check();
+    });
   }
-  return null;
 }