@citeark/agent 0.3.20

package/ui/arkgraph/graph-gestures.mjs

@@ -0,0 +1,62 @@
+// Camera and node dragging share one pointer owner and the same bounded follow model.
+export function createGraphGestures({element,graph,findNode,reduced,onStart,onActivity,onRelease,onTap,onNodeStart,onNodeEnd}){
+ let gesture=null,frame=0,lastTime=0,target=null,node=null,nodeStarted=false,disposed=false;
+ const state=(name,lag=0)=>{const prefix=node?'nodeDrag':'pan';element.dataset[prefix]=name;element.dataset[prefix+'Lag']=lag.toFixed(2);};
+ const active=()=>!!gesture||!!frame;
+ const finish=()=>{
+  state('idle');target=null;lastTime=0;
+  if(nodeStarted){const released=node;nodeStarted=false;delete released.fx;delete released.fy;onNodeEnd(released);}
+  node=null;
+ };
+ const render=now=>{
+  frame=0;if(disposed||!target)return;
+  const position=node||graph.centerAt(),k=graph.zoom(),dx=target.x-position.x,dy=target.y-position.y,lag=Math.hypot(dx,dy)*k;
+  const dt=lastTime?Math.min(40,now-lastTime):16;lastTime=now;
+  const amount=reduced()?1:1-Math.exp(-dt/(node?85:65));
+  const remaining=Math.min(node?26:24,lag*(1-amount)),ratio=lag?remaining/lag:0;
+  const x=target.x-dx*ratio,y=target.y-dy*ratio;
+  if(node){node.x=node.fx=x;node.y=node.fy=y;}else graph.centerAt(x,y);
+  onActivity();state(gesture?'dragging':'settling',remaining);
+  const peak=node?'nodeDragPeakLag':'panPeakLag';element.dataset[peak]=Math.max(Number(element.dataset[peak]||0),remaining).toFixed(2);
+  if(remaining>.12)frame=requestAnimationFrame(render);
+  else if(!gesture)finish();
+ };
+ const schedule=()=>{if(!frame)frame=requestAnimationFrame(render);};
+ const cancel=()=>{
+  cancelAnimationFrame(frame);frame=0;
+  if(gesture){try{element.releasePointerCapture(gesture.id);}catch{}gesture=null;onRelease();}
+  finish();
+ };
+ const down=event=>{
+  if(event.button!==0||event.isPrimary===false||event.target.tagName!=='CANVAS')return;
+  cancel();const rect=element.getBoundingClientRect();node=findNode(event.clientX-rect.left,event.clientY-rect.top)||null;
+  const center=node?{x:node.x,y:node.y}:graph.centerAt();
+  gesture={id:event.pointerId,x:event.clientX,y:event.clientY,center,zoom:graph.zoom(),moved:false};
+  target={...center};element.dataset[node?'nodeDragPeakLag':'panPeakLag']='0';onStart(node);
+  element.setPointerCapture(event.pointerId);event.preventDefault();event.stopImmediatePropagation();state('dragging');
+ };
+ const move=event=>{
+  if(!gesture||event.pointerId!==gesture.id)return;
+  const dx=event.clientX-gesture.x,dy=event.clientY-gesture.y;
+  gesture.moved ||= Math.hypot(dx,dy)>3;
+  if(gesture.moved){
+   if(node&&!nodeStarted){nodeStarted=true;node.fx=node.x;node.fy=node.y;onNodeStart(node);}
+   const sign=node?1:-1;target={x:gesture.center.x+sign*dx/gesture.zoom,y:gesture.center.y+sign*dy/gesture.zoom};schedule();
+  }
+  event.preventDefault();event.stopImmediatePropagation();
+ };
+ const up=event=>{
+  if(!gesture||event.pointerId!==gesture.id)return;
+  const moved=gesture.moved,tapped=node;gesture=null;
+  try{element.releasePointerCapture(event.pointerId);}catch{}
+  event.preventDefault();event.stopImmediatePropagation();onRelease();
+  if(moved)schedule();else{cancel();onTap(tapped,{x:event.clientX,y:event.clientY});}
+ };
+ const mouseDown=event=>{if(gesture){event.preventDefault();event.stopImmediatePropagation();}};
+ const aborted=event=>{if(gesture&&event.pointerId===gesture.id)cancel();};
+ const wheel=()=>{if(active())cancel();};
+ element.addEventListener('pointerdown',down,true);element.addEventListener('mousedown',mouseDown,true);element.addEventListener('wheel',wheel,{capture:true,passive:true});
+ window.addEventListener('pointermove',move,{capture:true,passive:false});window.addEventListener('pointerup',up,true);window.addEventListener('pointercancel',aborted,true);
+ element.dataset.pan='idle';element.dataset.nodeDrag='idle';
+ return {get active(){return active();},cancel,dispose(){disposed=true;cancel();element.removeEventListener('pointerdown',down,true);element.removeEventListener('mousedown',mouseDown,true);element.removeEventListener('wheel',wheel,true);window.removeEventListener('pointermove',move,true);window.removeEventListener('pointerup',up,true);window.removeEventListener('pointercancel',aborted,true);}};
+}

package/ui/arkgraph/label-layout.mjs

@@ -0,0 +1,57 @@
+// Fixed graph geometry only: camera position, zoom and viewport never enter the solver.
+const overlap=(a,b,pad=4)=>a.x<b.x+b.w+pad&&a.x+a.w+pad>b.x&&a.y<b.y+b.h+pad&&a.y+a.h+pad>b.y;
+const swept=(box,n)=>{const {x=0,y=0}=n?.motion||{};return {...box,x:box.x-x,y:box.y-y,w:box.w+2*x,h:box.h+2*y};};
+const near=(n,b)=>({x:Math.max(b.x,Math.min(b.x+b.w,n.x)),y:Math.max(b.y,Math.min(b.y+b.h,n.y))});
+const cross=(a,b,c)=>(b.x-a.x)*(c.y-a.y)-(b.y-a.y)*(c.x-a.x);
+const intersects=(a,b,c,d)=>cross(a,b,c)*cross(a,b,d)<-1e-6&&cross(c,d,a)*cross(c,d,b)<-1e-6;
+function lineHits(a,b,box){
+ const p={x:box.x,y:box.y},q={x:box.x+box.w,y:box.y},r={x:q.x,y:box.y+box.h},s={x:p.x,y:r.y};
+ return intersects(a,b,p,q)||intersects(a,b,q,r)||intersects(a,b,r,s)||intersects(a,b,s,p);
+}
+export function layoutLabels(items,previous=new Map(),reserved=[]){
+ const boxes=new Map(),result=new Map(),byId=new Map(items.map(n=>[n.id,n]));
+ const obstacles=[...items.map(n=>({id:n.id,x:n.x-n.r,y:n.y-n.r,w:2*n.r,h:2*n.r})),...reserved];
+ const ordered=[...items].sort((a,b)=>Number(b.main)-Number(a.main)||(a.main?a.step-b.step:a.y-b.y)||a.id.localeCompare(b.id));
+ function choose(n,retain=true){
+  const others=[...boxes.entries()].filter(([id])=>id!==n.id),old=previous.get(n.id);
+  const free=b=>{
+   const envelope=swept(b,n);
+   // A label shares its owner's motion. Other nodes/labels can move independently.
+   return !obstacles.some(o=>o.id===n.id?overlap(b,o,4):overlap(envelope,swept(o,byId.get(o.id)),4))
+    &&!others.some(([id,o])=>overlap(envelope,swept(o,byId.get(id)),5));
+  };
+  const score=b=>{
+   const p=near(n,b),length=Math.hypot(p.x-n.x,p.y-n.y),gap=Math.max(0,length-n.r),vx=b.x+b.w/2-n.x,vy=b.y+b.h/2-n.y;
+   let cost=gap*2+Math.abs(vy)*(n.main?.65:.12);
+   // Place branch labels outward from their parent, preserving the local fan order.
+   if(n.outward){const v=Math.hypot(vx,vy)||1;cost+=(1-(vx*n.outward.x+vy*n.outward.y)/v)*16;}
+   else if(b.side!==n.side)cost+=n.main?7:3;
+   for(const [id,o] of others){const owner=byId.get(id),end=near(owner,o);if(intersects(n,p,owner,end))cost+=160;if(lineHits(n,p,o)||lineHits(owner,end,b))cost+=100;}
+   for(const other of items)if(other.id!==n.id){const q=near(other,b);if(Math.hypot(q.x-other.x,q.y-other.y)<length-2)cost+=45;}
+   for(const o of obstacles)if(o.id!==n.id&&lineHits(n,p,o))cost+=160;
+   return cost;
+  };
+  const retained=old&&{x:n.x+old.dx,y:n.y+old.dy,w:n.w,h:n.h,side:old.side};
+  const preferred=n.preferred&&{x:n.x+n.preferred.dx,y:n.y+n.preferred.dy,w:n.w,h:n.h,side:n.preferred.side};
+  // The physical layout already reserves this nearby attachment. Camera movement
+  // never participates in this choice or in the collision geometry.
+  if(preferred&&free(preferred))return preferred;
+  // At rest a good attachment stays put, including through pan/zoom and gentle drift.
+  if(retain&&retained&&free(retained)&&score(retained)<48)return retained;
+  let best=null,bestScore=Infinity;
+  for(let ring=0;ring<5||!best;ring++){
+   const r=n.r+8+ring*10,candidates=[];
+   for(const side of ['left','right'])for(const shift of [0,-.5,.5,-1,1])candidates.push({x:side==='left'?n.x-r-n.w:n.x+r,y:n.y-n.h/2+shift*n.h,w:n.w,h:n.h,side});
+   for(const side of ['above','below'])for(const shift of [0,-.25,.25,-.5,.5])candidates.push({x:n.x-n.w/2+shift*n.w,y:side==='above'?n.y-r-n.h:n.y+r,w:n.w,h:n.h,side});
+   for(const b of candidates)if(free(b)){const value=score(b)+(retained?Math.hypot(b.x-retained.x,b.y-retained.y)*.06:0);if(value<bestScore){best=b;bestScore=value;}}
+   if(best&&ring>1&&(ring*10+8)*2>bestScore+20)break;
+  }
+  if(retain&&retained&&free(retained)&&score(retained)<=bestScore+14)return retained;
+  return best;
+ }
+ for(const n of ordered)boxes.set(n.id,choose(n));
+ // A final local pass can shorten leaders after all neighboring labels are known.
+ if(!previous.size)for(const n of ordered)boxes.set(n.id,choose(n,false));
+ for(const n of items){const b=boxes.get(n.id);result.set(n.id,{dx:b.x-n.x,dy:b.y-n.y,side:b.side});}
+ return result;
+}

package/ui/arkgraph/locales/en.json

@@ -0,0 +1,229 @@
+{
+  " · 全文 ": " · Total ",
+  " · 正在检索完整记录…": " · Searching complete records…",
+  " 个": " objects",
+  " 个主节点": " main nodes",
+  " 个假说": " hypotheses",
+  " 个对象 ": " objects ",
+  " 个对象 · 全文 ": " visible · Total ",
+  " 个必要步骤": " required steps",
+  " 个科研步骤。": " research steps.",
+  " 个补充对象": " additional objects",
+  " 条": " relations",
+  " 条 ": " relations ",
+  " 条关系": " relations",
+  " 项": " items",
+  " 项 · 点击弱化或恢复": " items · Click to dim or restore",
+  " 项主张 ": " claims ",
+  " 项匹配": " matches",
+  " 项实验": " experiments",
+  " 项实验共用": " experiments share this step",
+  " 项实验已选 ": " experiments selected ",
+  " 项实验，共用 ": " experiments sharing ",
+  " 项数值": " values",
+  "上一个主线节点": "Previous mainline node",
+  "下一个主线节点": "Next mainline node",
+  "主体": "Agent",
+  "主张": "Claim",
+  "主张、假说与评估": "Claims, hypotheses and assessments",
+  "主线以外的概念、前提、观点和解释": "Additional concepts, premises, claims and explanations",
+  "主线导航": "Mainline navigation",
+  "人、组织、智能体与运行节点": "People, organizations, agents and execution nodes",
+  "从主线开始": "Start with the mainline",
+  "代码": "Code",
+  "作者提出的发现、解释、定理或结论": "Findings, explanations, theorems or conclusions proposed by the authors",
+  "使用": "Uses",
+  "使用方法": "Uses method",
+  "依据": "Based on",
+  "保存实验范围": "Save experiment scope",
+  "保存选择后，正式执行前仍需确认资源与费用。": "Confirm resources and costs before starting the selected experiments.",
+  "修订": "Revises",
+  "候选实验": "Candidate experiment",
+  "假说": "Hypothesis",
+  "假说与前提": "Hypotheses and premises",
+  "先看问题，再选择实验": "Read the question, then select experiments",
+  "全部 ": "All ",
+  "全部关联 · ": "All connections · ",
+  "全部数据 ↓": "Complete data ↓",
+  "全部研究对象": "All research objects",
+  "关系": "Relations",
+  "关联实验计划": "Related experiment plans",
+  "关闭大纲": "Close outline",
+  "关闭放大图表": "Close enlarged figure",
+  "关闭详情": "Close details",
+  "具体研究的安排或尚未执行的后续研究意向": "Research arrangements and proposed future work",
+  "内容": "Content",
+  "内容分类": "Content categories",
+  "再显示 ": "Show more ",
+  "包含 ": "Includes ",
+  "包含步骤": "Has step",
+  "包含的必要步骤": "Required steps",
+  "原文": "Source",
+  "原文依据与目标": "Source evidence and targets",
+  "原文图表": "Source figures and tables",
+  "原文图表与评述": "Source evidence and commentary",
+  "原文报告": "Reported in the paper",
+  "参与": "Associated with",
+  "参与者": "Participant",
+  "发表于": "Asserted in",
+  "取消选择": "Deselect",
+  "可复用的操作方法、算法、分析或测量方法": "Reusable procedures, algorithms, analysis and measurement methods",
+  "后续研究与实验计划": "Future research and experiment plans",
+  "后续研究意向、待执行方案及预期材料与产出": "Proposed research, pending plans and expected inputs and outputs",
+  "回到研究概览": "Return to the overview",
+  "图上实验关系": "Experiment connections",
+  "图中 ": "Visible: ",
+  "大纲": "Outline",
+  "大纲视图": "Outline view",
+  "完成选择": "Finish selection",
+  "完整整理关系": "Complete relation record",
+  "实体": "Entity",
+  "实际发生的执行、采集、测量与分析": "Recorded execution, collection, measurement and analysis",
+  "实际发生的采集、实验、训练、访谈或分析": "Recorded collection, experiments, training, interviews and analysis",
+  "实际获得或计算得到的数据、图像及分析结果": "Observed or computed data, images and analysis results",
+  "实验依赖不可用": "Experiment dependency unavailable",
+  "实验依赖存在循环": "Cyclic experiment dependencies",
+  "实验材料 ": "Experiment materials ",
+  "实验范围": "Experiment scope",
+  "实验计划": "Experiment plan",
+  "对象与资源": "Objects and resources",
+  "对象之间的关联 ": "Connections between objects ",
+  "对象分类": "Object categories",
+  "对象类型筛选": "Filter object types",
+  "展开论文说明": "Expand paper description",
+  "展开详情": "Expand details",
+  "属于": "Part of",
+  "已保存到此浏览器": "Saved in this browser",
+  "已选 ": "Selected: ",
+  "已选择 · 移出范围": "Selected · Remove from scope",
+  "归属于": "Attributed to",
+  "待明确的输入": "Unresolved inputs",
+  "待核对条件": "Conditions to verify",
+  "待检验假说与条件前提；通过子类型区分": "Hypotheses to test and conditional premises, distinguished by subtype",
+  "报告数值 ": "Reported values ",
+  "拟检验": "Planned for",
+  "指标": "Metric",
+  "按需查阅 ": "Reference sections ",
+  "描述": "Describes",
+  "提出、执行、提供或评估研究内容的人、组织或软件代理": "People, organizations or software agents proposing, executing, providing or assessing research",
+  "搜索内容、数值或来源": "Search content, values or sources",
+  "搜索大纲": "Search outline",
+  "收起数值": "Show fewer values",
+  "收起论文说明": "Collapse paper description",
+  "放大": "Enlarge ",
+  "数值": "Value",
+  "数值的完整条件与来源": "Complete measurement conditions and sources",
+  "数据与提示": "Data and prompts",
+  "数据集": "Dataset",
+  "整理关系": "Research relation",
+  "断言": "Assertion",
+  "方案": "Plan",
+  "方法": "Method",
+  "方法、计划、数据、模型、材料、观测": "Methods, plans, data, models, materials and observations",
+  "方法与活动细节": "Method and activity details",
+  "方法与过程": "Methods and processes",
+  "方法图示": "Method illustrations",
+  "暂未识别基础对象类型": "Unrecognized object type",
+  "替代": "Supersedes",
+  "有归属与依据的验证、评价或局限性分析": "Attributed, evidence-based verification, evaluation and limitation analysis",
+  "未分类": "Unclassified",
+  "未解析的外部引用": "Unresolved external reference",
+  "本次选择的实验": "Selected experiments",
+  "本篇尚未建立此类独立对象。": "This paper has no independent objects in this category.",
+  "材料": "Material",
+  "材料与工具": "Materials and tools",
+  "材料与来源": "Materials and sources",
+  "条件": "Condition",
+  "来源理解": "Source interpretation",
+  "来源论文以及内容提供者、作者或整理者": "Source papers, content providers, authors and compilers",
+  "来源资料": "Source material",
+  "查看": "View ",
+  "查看全图": "Fit graph",
+  "查看全部 ": "Show all ",
+  "查看原论文 ↗": "View source paper ↗",
+  "查看实验：": "View experiment: ",
+  "查看范围 →": "Review scope →",
+  "样本": "Sample",
+  "检查点": "Checkpoint",
+  "概念": "Concept",
+  "概念、定义、理论框架，以及变量和指标的定义": "Concepts, definitions, theoretical frameworks, variables and metrics",
+  "概念与定义": "Concepts and definitions",
+  "模型": "Model",
+  "模型、数据与材料": "Models, data and materials",
+  "模型与检查点": "Models and checkpoints",
+  "正在加载完整记录…": "Loading complete records…",
+  "此浏览器无法保存草案。": "This browser cannot save the draft.",
+  "没有匹配内容，试试其他关键词。": "No matches. Try another search term.",
+  "没有匹配的关系": "No matching relations",
+  "活动": "Activity",
+  "派生自": "Derived from",
+  "涉及": "About",
+  "清空": "Clear",
+  "清空搜索": "Clear search",
+  "点问题看比较方式 · ＋ 加入范围": "Click a question to inspect its comparison · ＋ Add to scope",
+  "生成": "Generated",
+  "生成自": "Generated by",
+  "相关方法 ": "Related methods ",
+  "相关证据": "Related evidence",
+  "研究使用的模型、数据、提示、材料和工具": "Models, data, prompts, materials and tools used in the research",
+  "研究对象、材料、数据集、模型、仪器、代码和来源文献": "Research objects, materials, datasets, models, instruments, code and source literature",
+  "研究方案": "Research plan",
+  "研究概览": "Research overview",
+  "研究活动": "Research activity",
+  "研究脉络 ": "Research mainline ",
+  "研究计划 · 尚未执行": "Research plan · Not executed",
+  "研究评估": "Research assessment",
+  "研究试图回答的问题或目标": "The question or objective addressed by the research",
+  "研究问题": "Research question",
+  "终点": "Target",
+  "结果": "Result",
+  "结果与评价": "Results and assessments",
+  "缩小详情，显示图谱": "Shrink details to show graph",
+  "缺少输入：": "Missing input: ",
+  "节点图未能打开：": "Unable to open graph: ",
+  "范围与限制": "Scope and limitations",
+  "补充概念与解释": "Additional concepts and explanations",
+  "观察与判断": "Observations and criteria",
+  "观测": "Observation",
+  "观测与结果": "Observations and results",
+  "观点与解释": "Claims and explanations",
+  "视图控制": "View controls",
+  "解释假说": "Explains hypothesis",
+  "计划步骤": "Planned step",
+  "论文使用的方法及报告的研究活动": "Methods and research activities reported in the paper",
+  "论文原文": "Source paper",
+  "论文大纲": "Paper outline",
+  "论文报告的图表、观测和补充评价": "Figures, tables, observations and supplementary assessments reported in the paper",
+  "论文来源": "Source paper",
+  "论文来源与参与者": "Source papers and participants",
+  "论文节点图": "Paper graph",
+  "论文阅读地图": "Paper reading map",
+  "论证": "Argument",
+  "论证与证明": "Arguments and proofs",
+  "证据关联": "Evidence for",
+  "证据关联来自原文阅读，不表示已完成独立验证。": "This evidence connection comes from reading the source and does not indicate independent verification.",
+  "评估": "Assessment",
+  "详情 ": " details ",
+  "责任主体": "Responsible agent",
+  "资源": "Resource",
+  "起点": "Source",
+  "运行观测": "Execution observation",
+  "返回实验详情": "Return to experiment details",
+  "连接依据与主张的推导、证明或解释性论证": "Derivations, proofs or explanatory arguments connecting evidence and claims",
+  "适用条件与方法": "Applicable conditions and methods",
+  "选择": "Select",
+  "选择实验": "Select experiments",
+  "选择这项实验": "Select this experiment",
+  "遵循": "Follows",
+  "重新加载": "Reload",
+  "重试": "Retry",
+  "问题": "Question",
+  "问题与概念": "Questions and concepts",
+  "阅读分析": "Reading analysis",
+  "阅读核对": "Reading assessment",
+  "阅读脉络": "Reading mainline",
+  "需要": "Requires",
+  "预期产出": "Expected output",
+  "预期材料与产出": "Expected materials and outputs",
+  "Agent 生成 · 来源声明": "Agent-generated · Source declarations"
+}

package/ui/arkgraph/locales/source-types.json

@@ -0,0 +1,15 @@
+{
+  "question": "研究问题",
+  "concept": "概念与定义",
+  "hypothesis": "假说与前提",
+  "claim": "主张",
+  "method": "方法",
+  "plan": "研究方案",
+  "activity": "研究活动",
+  "result": "观测与结果",
+  "argument": "论证与证明",
+  "assessment": "评估",
+  "resource": "对象与资源",
+  "agent": "责任主体",
+  "provenance": "Agent 生成 · 来源声明"
+}

package/ui/arkgraph/localization-build.mjs

@@ -0,0 +1,27 @@
+import fs from 'node:fs/promises';
+import ts from './node_modules/typescript/lib/typescript.js';
+const english=JSON.parse(await fs.readFile(new URL('./locales/en.json',import.meta.url),'utf8'));
+const translate=text=>{
+ if(!/[\u4e00-\u9fff]/.test(text))return text;
+ if(!(text in english))throw Error(`Missing ArkGraph UI translation: ${JSON.stringify(text)}`);
+ return english[text];
+};
+// Translate only UI source literals, after JSX lowering. Scientific records stay unchanged.
+export const localizationPlugin={name:'arkgraph-english',setup(build){
+ build.onLoad({filter:/ui\/arkgraph\/[^/]+\.(jsx|mjs)$/},async({path})=>{
+  const source=await fs.readFile(path,'utf8');
+  const result=ts.transpileModule(source,{fileName:path,compilerOptions:{target:ts.ScriptTarget.ESNext,module:ts.ModuleKind.ESNext,jsx:ts.JsxEmit.React},transformers:{after:[context=>root=>{
+   const f=context.factory;
+   function visit(node){
+    if(ts.isStringLiteral(node))return f.createStringLiteral(translate(node.text));
+    if(ts.isNoSubstitutionTemplateLiteral(node))return f.createNoSubstitutionTemplateLiteral(translate(node.text));
+    if(ts.isTemplateHead(node))return f.createTemplateHead(translate(node.text));
+    if(ts.isTemplateMiddle(node))return f.createTemplateMiddle(translate(node.text));
+    if(ts.isTemplateTail(node))return f.createTemplateTail(translate(node.text));
+    return ts.visitEachChild(node,visit,context);
+   }
+   return ts.visitNode(root,visit);
+  }]}});
+  return {contents:result.outputText,loader:'js'};
+ });
+}};

package/ui/arkgraph/material-build.mjs

@@ -0,0 +1,23 @@
+import fs from 'node:fs/promises';
+import {MD} from './material-colors.mjs';
+const swatches=Object.values(MD),neutrals=new Set(Object.entries(MD).filter(([k])=>k.startsWith('grey')).map(([,v])=>v));
+const rgb=hex=>[1,3,5].map(i=>parseInt(hex.slice(i,i+2),16));
+function closestColor(hex){
+ const values=rgb(hex);return swatches.reduce((best,next)=>{
+  const distance=c=>rgb(c).reduce((sum,v,i)=>sum+(v-values[i])**2,0);
+  return distance(next)<distance(best)?next:best;
+ },swatches[0]);
+}
+export function materialCss(source){
+ let css=source.replace(/#([\da-f]{8}|[\da-f]{6}|[\da-f]{4}|[\da-f]{3})\b/gi,(_,value)=>{
+  const expanded=value.length<=4?[...value].map(c=>c+c).join(''):value;
+  return closestColor('#'+expanded.slice(0,6))+(expanded.length===8?expanded.slice(6).toUpperCase():'');
+ });
+ // Keep small secondary text readable on the light surfaces.
+ css=css.replace(/(?<![-\w])color:\s*(#[\dA-F]{6})([\dA-F]{2})?\b/g,(_,value,opacity)=>{
+  if(neutrals.has(value)&&parseInt(value.slice(1,3),16)>parseInt(MD.grey700.slice(1,3),16))return 'color: '+MD.grey700;
+  return 'color: '+value+(opacity||'');
+ });
+ return css;
+}
+export const materialCssPlugin={name:'material-palette',setup(build){build.onLoad({filter:/\.css$/},async args=>({contents:materialCss(await fs.readFile(args.path,'utf8')),loader:'css'}));}};

package/ui/arkgraph/material-colors.mjs

@@ -0,0 +1,39 @@
+// Material Design 2014 palette, verified against Google MDC Web v14.0.0.
+// https://github.com/material-components/material-components-web/blob/v14.0.0/packages/mdc-theme/_color-palette.scss
+export const MATERIAL_SOURCE='https://github.com/material-components/material-components-web/blob/v14.0.0/packages/mdc-theme/_color-palette.scss';
+export const MD=Object.freeze({
+ white:'#FFFFFF',black:'#000000',
+ grey50:'#FAFAFA',grey100:'#F5F5F5',grey200:'#EEEEEE',grey300:'#E0E0E0',grey400:'#BDBDBD',
+ grey500:'#9E9E9E',grey600:'#757575',grey700:'#616161',grey800:'#424242',grey900:'#212121',
+ blue50:'#E3F2FD',blue600:'#1E88E5',blue700:'#1976D2',
+ indigo50:'#E8EAF6',indigo500:'#3F51B5',
+ deepOrange50:'#FBE9E7',deepOrange700:'#E64A19',
+ teal50:'#E0F2F1',teal600:'#00897B',red50:'#FFEBEE',red700:'#D32F2F',
+ amber700:'#FFA000',lightGreen700:'#689F38',green600:'#43A047',purple500:'#9C27B0'
+});
+export const typeColors=Object.freeze({entity:MD.blue600,activity:MD.deepOrange700,assertion:MD.indigo500,agent:MD.teal600,unknown:MD.grey600});
+export const coreLabels=Object.freeze({entity:'实体',activity:'活动',assertion:'断言',agent:'参与者',unknown:'未分类'});
+export const coreHints=Object.freeze({entity:'方法、计划、数据、模型、材料、观测',activity:'实际发生的执行、采集、测量与分析',assertion:'主张、假说与评估',agent:'人、组织、智能体与运行节点',unknown:'暂未识别基础对象类型'});
+const assertionRoles=new Set(['claim','hypothesis','assessment','evaluation','assertion']);
+const activityRoles=new Set(['activity','execution','run','measurement-activity','analysis-activity']);
+const agentRoles=new Set(['agent','participant','person','organization']);
+const entityRoles=new Set(['entity','method','procedure','procedure-step','plan','model','checkpoint','dataset','sample','observation','material','code','source-work','file','instrument']);
+export function coreTypeOf(record){
+ const explicit=record.recordType||record.type||record.raw?.type;
+ if(explicit){const value=String(explicit).toLowerCase(),type=value.match(/record-types\/(entity|activity|assertion|agent)\//)?.[1]||value;if(type in typeColors)return type;}
+ if(assertionRoles.has(record.role))return 'assertion';
+ if(activityRoles.has(record.role))return 'activity';
+ if(agentRoles.has(record.role))return 'agent';
+ if(entityRoles.has(record.role))return 'entity';
+ return 'unknown';
+}
+export const colorOf=record=>typeColors[coreTypeOf(record)];
+export const alpha=(hex,opacity)=>hex+Math.round(Math.max(0,Math.min(1,opacity))*255).toString(16).padStart(2,'0');
+export function shapeOf(record){
+ if(record.role==='hypothesis')return 'hypothesis';
+ if(['assessment','evaluation'].includes(record.role))return 'assessment';
+ if(['procedure','procedure-step','plan'].includes(record.role)||record.prospective)return 'plan';
+ if(record.role==='method')return 'method';
+ if(record.role==='observation')return 'observation';
+ return coreTypeOf(record)==='activity'?'activity':'circle';
+}

package/ui/arkgraph/material-style.css

@@ -0,0 +1,15 @@
+/* All authored colors come from the Material Design palette. */
+:root { --paper:#FAFAFA; --ink:#212121; --muted:#757575; --border:#E0E0E0; --accent:#1976D2; --soft-accent:#E3F2FD; }
+.graph-region { background-image:none; }
+.graph-region:before { background:none; }
+.brand-mark { color:#1976D2; background:#E3F2FD; }
+.legend { align-items:center; }
+.legend-title { font-size:10px; color:#616161; margin:0 7px; }
+.legend i { width:9px; height:9px; }
+.legend button { color:#424242; }
+.legend small { color:#616161; }
+.detail-eyebrow:before { background:var(--record-color,#757575); width:7px; height:7px; }
+.expanded-controls button { color:#616161; }
+.expanded-controls i { background:#9E9E9E !important; }
+.graph-error { color:#D32F2F; background:#FFEBEE; border-color:#D32F2F; }
+@media (max-width:530px) { .legend-title { font-size:9px; margin:0 4px; } }