@liquidcars/atlas 0.1.52 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liquidcars/atlas",
-  "version": "0.1.52",
+  "version": "0.2.0",
   "description": "Reusable 3D conceptual atlas Web Component for LiquidCars-style models",
   "type": "module",
   "scripts": {

package/src/diagram-scene.js

@@ -0,0 +1,125 @@
+// Draws the already calculated diagram. No layout or SVG work occurs in a camera frame.
+const isContainer=node=>['container','shell'].includes(node.type);
+export class DiagramScene {
+ constructor(atlas,G){this.atlas=atlas;this.G=G;this.visuals=new Map();this.links=[];this.index=new Map();this.positions=new Map();this.batch=null;this.basic=new Map();}
+ material(source){
+  if(source.isLineBasicMaterial)return source;
+  if(this.basic.has(source))return this.basic.get(source);
+  const material=new this.G.MeshBasicMaterial({color:source.color||'#fff',map:source.map,side:source.side,alphaTest:source.alphaTest||0,transparent:true,opacity:source.userData?.atlasBaseOpacity??source.opacity??1,depthWrite:source.depthWrite,toneMapped:false});
+  material.userData.atlasBaseOpacity=material.opacity;this.basic.set(source,material);return material;
+ }
+ flattenMaterials(){
+  const originals=new Set();
+  for(const node of this.atlas.nodes.values()){
+   if(isContainer(node))continue;
+   node.mesh.traverse(mesh=>{if(!mesh.isMesh||mesh===node.pickMesh)return;const original=Array.isArray(mesh.material)?mesh.material:[mesh.material];const materials=original.map(source=>{originals.add(source);return this.material(source);});mesh.material=Array.isArray(mesh.material)?materials:materials[0];});
+   if(node.material)node.material=this.material(node.material);
+   if(node.appearanceMaterials)node.appearanceMaterials=node.appearanceMaterials.map(m=>this.material(m));
+   if(node.pickMesh)node.pickMesh.visible=false;
+  }
+  for(const material of originals)material.dispose();
+ }
+ caption(node,lines,fontSize,lineHeight,color,align){
+  const key=JSON.stringify([lines,fontSize,lineHeight,color,align]),visual=this.visuals.get(node.id);
+  if(visual?.captionKey===key)return visual.caption;
+  if(visual?.caption){node.group.remove(visual.caption);visual.caption.geometry.dispose();visual.caption.material.map.dispose();visual.caption.material.dispose();}
+  const canvas=this.atlas.ownerDocument.createElement('canvas'),ctx=canvas.getContext('2d');
+  ctx.font=`${fontSize}px system-ui`;
+  const width=Math.max(1,...lines.map(line=>ctx.measureText(line).width))+4,height=Math.max(lineHeight,lines.length*lineHeight);
+  const density=Math.min(4,4096/width,4096/height);
+  canvas.width=Math.ceil(width*density);canvas.height=Math.ceil(height*density);ctx.scale(density,density);ctx.font=`${fontSize}px system-ui`;ctx.fillStyle=color;ctx.textAlign=align;ctx.textBaseline='top';
+  lines.forEach((line,i)=>ctx.fillText(line,align==='left'?2:width/2,i*lineHeight));
+  const texture=new this.G.CanvasTexture(canvas);texture.colorSpace='srgb';
+  const mesh=new this.G.Mesh(new this.G.PlaneGeometry(width/this.scale,height/this.scale),new this.G.MeshBasicMaterial({map:texture,transparent:true,depthTest:false,depthWrite:false,toneMapped:false}));
+  mesh.renderOrder=100;mesh.userData.node=node;mesh.userData.size=[width/this.scale,height/this.scale];node.group.add(mesh);visual.captionKey=key;visual.caption=mesh;return mesh;
+ }
+ container(node,visual,width,height,color,depth){
+  if(!visual.fill){
+   visual.fill=new this.G.Mesh(new this.G.BufferGeometry(),new this.G.MeshBasicMaterial({color,depthTest:false,depthWrite:false,toneMapped:false}));
+   visual.border=new this.G.LineSegments(new this.G.BufferGeometry(),new this.G.LineBasicMaterial({color,transparent:true,opacity:.72,depthTest:false,depthWrite:false,toneMapped:false}));
+   node.group.add(visual.fill,visual.border);
+  }
+  const key=width+':'+height;
+  if(visual.rectangleKey!==key){
+   visual.rectangleKey=key;const radius=Math.min(12/this.scale,width/4,height/4),points=[],fill=[],border=[];
+   for(const [x,y,start] of [[width/2-radius,height/2-radius,0],[-width/2+radius,height/2-radius,90],[-width/2+radius,-height/2+radius,180],[width/2-radius,-height/2+radius,270]])
+    for(let i=0;i<=5;i++){const angle=(start+i*18)*Math.PI/180;points.push([x+Math.cos(angle)*radius,y+Math.sin(angle)*radius]);}
+   for(let i=0;i<points.length;i++){const a=points[i],b=points[(i+1)%points.length];fill.push(0,0,0,...a,0,...b,0);border.push(...a,0,...b,0);}
+   visual.fill.geometry.dispose();visual.border.geometry.dispose();visual.fill.geometry=new this.G.BufferGeometry().setAttribute('position',new this.G.Float32BufferAttribute(fill,3));visual.border.geometry=new this.G.BufferGeometry().setAttribute('position',new this.G.Float32BufferAttribute(border,3));
+  }
+  visual.fill.renderOrder=-200+depth;visual.border.renderOrder=-100+depth;visual.baseBackground=this.backgroundFor(node.parent);visual.fillTint=visual.baseBackground.clone().lerp(new this.G.Color(color),.14);
+  visual.fill.material.color.copy(visual.fillTint);visual.border.material.color.set(color).lerp(new this.G.Color(this.dark?'#e9f0f5':'#254253'),this.dark ? .65 : .48);
+ }
+ backgroundFor(id,seen=new Set()){
+  if(!id||!this.index.has(id)||seen.has(id))return new this.G.Color(this.config.background||(this.dark?'#2d2f31':'#f5f5f5'));
+  if(this.backgrounds.has(id))return this.backgrounds.get(id).clone();seen.add(id);
+  const node=this.atlas.nodes.get(id),color=this.atlas.modelData.palette[node.c]||node.c||'#5eaa9d',base=this.backgroundFor(node.parent,seen).lerp(new this.G.Color(color),.14);
+  this.backgrounds.set(id,base);return base.clone();
+ }
+
+ update(layout,config){
+  this.layout=layout;this.scale=layout.scale;this.config=config;this.dark=config.theme==='dark';this.index=new Map();this.positions=new Map();this.backgrounds=new Map();
+  for(const entry of layout.items){const node=this.atlas.nodes.get(entry.id);if(!node)continue;this.index.set(entry.id,{...entry,kind:'item'});this.positions.set(entry.id,new this.G.Vector3(entry.x/this.scale,-entry.y/this.scale,10));}
+  for(const entry of layout.containers){this.index.set(entry.id,{...entry,kind:'container'});this.positions.set(entry.id,new this.G.Vector3((entry.minX+entry.maxX)/(2*this.scale),-(entry.minY+entry.maxY)/(2*this.scale),0));}
+  for(const [id,entry] of this.index){
+   const node=this.atlas.nodes.get(id);if(!node)continue;
+   if(!this.visuals.has(id))this.visuals.set(id,{});const visual=this.visuals.get(id);node.group.position.copy(this.positions.get(id));
+   const open=entry.kind==='container',box=entry.bounds;
+   const color=this.atlas.modelData.palette[node.c]||node.c||'#5eaa9d';
+   if(isContainer(node)){
+    const width=open?(entry.maxX-entry.minX)/this.scale:box.maxX-box.minX,height=open?(entry.maxY-entry.minY)/this.scale:box.maxY-box.minY;
+    this.container(node,visual,width,height,color,entry.depth||0);
+   }
+   const lines=open?[node.name||node.id]:entry.labelLines;
+   const font=open?layout.containerFontSize:entry.labelFontSize,lineHeight=open?font*1.3:entry.labelLineHeight;
+   const caption=this.caption(node,lines,font,lineHeight,this.dark?'#e9f0f5':'#172c3a',open?'left':'center'),[width,height]=caption.userData.size;
+   if(open)caption.position.set(-(entry.maxX-entry.minX)/(2*this.scale)+8/this.scale+width/2,(entry.maxY-entry.minY)/(2*this.scale)-6/this.scale-height/2,30);
+   else caption.position.set(0,box.minY-(entry.labelGap/this.scale)-height/2,30);
+  }
+  this.buildLinks(layout.relations);this.apply();
+ }
+ buildLinks(links){
+  this.links=links;this.atlas._clearRelationGroup();
+  const positions=[],colors=[],arrows=[],arrowColors=[],base=new this.G.Color(this.dark?'#b1c7d3':'#58788d'),background=new this.G.Color(this.dark?'#2d2f31':'#f5f5f5');
+  const segment=(a,b,color)=>{positions.push(a.x/this.scale,-a.y/this.scale,2,b.x/this.scale,-b.y/this.scale,2);colors.push(color.r,color.g,color.b,color.r,color.g,color.b);};
+  const arrow=(from,to,color)=>{
+   const dx=to.x-from.x,dy=to.y-from.y,length=Math.hypot(dx,dy)||1,s=Math.min(9,length*.25),x=to.x-dx/length*s,y=to.y-dy/length*s;
+   for(const point of [to,{x:x-dy/length*s*.42,y:y+dx/length*s*.42},{x:x+dy/length*s*.42,y:y-dx/length*s*.42}]){arrows.push(point.x/this.scale,-point.y/this.scale,2);arrowColors.push(color.r,color.g,color.b);}
+  };
+  for(const link of links){
+   const selected=link.index===this.atlas.selectedRelationIndex,color=link.mode==='broken'?new this.G.Color('#c43748'):selected?new this.G.Color('#008fcb'):base.clone();color.lerp(background,1-link.opacity);
+   if(link.mode==='broken'){for(let i=0;i<12;i+=2){const at=t=>({x:link.start.x+(link.end.x-link.start.x)*t,y:link.start.y+(link.end.y-link.start.y)*t});segment(at(i/12),at((i+1)/12),color);}}
+   else {segment(link.start,link.end,color);arrow(link.start,link.end,color);if(link.mode==='bidirectional')arrow(link.end,link.start,color);}
+  }
+  if(positions.length){const geometry=new this.G.BufferGeometry().setAttribute('position',new this.G.Float32BufferAttribute(positions,3)).setAttribute('color',new this.G.Float32BufferAttribute(colors,3));const mesh=new this.G.LineSegments(geometry,new this.G.LineBasicMaterial({vertexColors:true,transparent:true,depthTest:false,depthWrite:false,toneMapped:false}));mesh.renderOrder=-50;this.atlas.relationGroup.add(mesh);}
+  if(arrows.length){const geometry=new this.G.BufferGeometry().setAttribute('position',new this.G.Float32BufferAttribute(arrows,3)).setAttribute('color',new this.G.Float32BufferAttribute(arrowColors,3));const mesh=new this.G.Mesh(geometry,new this.G.MeshBasicMaterial({vertexColors:true,side:2,transparent:true,depthTest:false,depthWrite:false,toneMapped:false}));mesh.renderOrder=-49;this.atlas.relationGroup.add(mesh);}
+ }
+ apply(){
+  for(const node of this.atlas.nodes.values()){
+   const entry=this.index.get(node.id),visible=!!entry&&entry.visible;
+   node.group.visible=visible;node.label.visible=false;
+   if(!entry)continue;node.group.position.copy(this.positions.get(node.id));
+   if(isContainer(node)){node.mesh.visible=false;if(node.edge)node.edge.visible=false;const visual=this.visuals.get(node.id);visual.fill.visible=visible;visual.fill.material.color.copy(visual.fillTint).lerp(visual.baseBackground,1-entry.opacity);visual.border.visible=visible;visual.border.material.opacity=.72*entry.opacity;}
+   else{node.mesh.visible=visible;if(node.edge?.material)node.edge.material.opacity=(node===this.atlas.selected?1:.65)*entry.opacity;for(const material of node.appearanceMaterials||[node.material])if(material)material.opacity=(material.userData.atlasBaseOpacity??1)*entry.opacity;}
+   const visual=this.visuals.get(node.id);
+   if(node===this.atlas.selected&&!visual.selection){
+    const geometry=new this.G.BufferGeometry().setAttribute('position',new this.G.Float32BufferAttribute([-.5,-.5,0,.5,-.5,0,.5,-.5,0,.5,.5,0,.5,.5,0,-.5,.5,0,-.5,.5,0,-.5,-.5,0],3));
+    visual.selection=new this.G.LineSegments(geometry,new this.G.LineBasicMaterial({color:'#008fcb',depthTest:false,depthWrite:false,toneMapped:false}));visual.selection.renderOrder=90;node.group.add(visual.selection);
+   }
+   if(visual.selection){visual.selection.visible=visible&&node===this.atlas.selected;const box=entry.kind==='container'?{minX:-(entry.maxX-entry.minX)/(2*this.scale),maxX:(entry.maxX-entry.minX)/(2*this.scale),minY:-(entry.maxY-entry.minY)/(2*this.scale),maxY:(entry.maxY-entry.minY)/(2*this.scale)}:entry.bounds;visual.selection.scale.set(box.maxX-box.minX+.15,box.maxY-box.minY+.15,1);visual.selection.position.set((box.minX+box.maxX)/2,(box.minY+box.maxY)/2,20);}
+   if(visual?.caption){visual.caption.visible=visible&&(entry.kind==='container'||this.config.labels);visual.caption.material.opacity=entry.opacity;}
+  }
+ }
+ pick(event,fallback){
+  const rect=this.atlas.canvas.getBoundingClientRect(),units=28/(Math.max(.001,this.atlas.zoom)*rect.height),point={x:this.atlas.focus.x+(event.clientX-rect.left-rect.width/2)*units,y:this.atlas.focus.y-(event.clientY-rect.top-rect.height/2)*units};
+  const captions=[...this.visuals.entries()].filter(([id])=>this.index.get(id)?.visible&&this.visuals.get(id).caption?.visible).map(([,v])=>v.caption);
+  const text=this.atlas.raycaster.intersectObjects(captions,false)[0];if(text)return {kind:'entity',node:text.object.userData.node};
+  if(fallback?.kind==='entity'&&!isContainer(fallback.node))return fallback;
+  const x=point.x*this.scale,y=-point.y*this.scale;let nearest=null,distance=5*units*this.scale;
+  for(const link of this.links){const a=link.start,b=link.end,dx=b.x-a.x,dy=b.y-a.y,t=Math.max(0,Math.min(1,((x-a.x)*dx+(y-a.y)*dy)/(dx*dx+dy*dy||1))),d=Math.hypot(x-a.x-t*dx,y-a.y-t*dy);if(d<distance){distance=d;nearest=link;}}
+  if(nearest)return {kind:'relation',index:nearest.index};
+  let chosen=null,area=Infinity;
+  for(const [id,entry] of this.index){if(!entry.visible||!isContainer(this.atlas.nodes.get(id)))continue;const box=entry.kind==='container'?entry:{minX:entry.x+entry.bounds.minX*this.scale,maxX:entry.x+entry.bounds.maxX*this.scale,minY:entry.y-entry.bounds.maxY*this.scale,maxY:entry.y-entry.bounds.minY*this.scale};const size=(box.maxX-box.minX)*(box.maxY-box.minY);if(x>=box.minX&&x<=box.maxX&&y>=box.minY&&y<=box.maxY&&size<area){chosen=id;area=size;}}
+  return chosen?{kind:'entity',node:this.atlas.nodes.get(chosen)}:null;
+ }
+}

package/src/diagram-svg.js

@@ -185,31 +185,27 @@ function rayBoundary(item, towards) {
 }
 
 function separateOverlaps(items, gap) {
-  for (let iteration = 0; iteration < 96; iteration += 1) {
-    let moved = false;
-    for (let i = 0; i < items.length; i += 1) for (let j = i + 1; j < items.length; j += 1) {
-      const a = items[i];
-      const b = items[j];
-      const boundsA = itemBounds(a, a.labelLines.length > 0);
-      const boundsB = itemBounds(b, b.labelLines.length > 0);
-      const x = Math.min(boundsA.maxX, boundsB.maxX) - Math.max(boundsA.minX, boundsB.minX) + gap;
-      const y = Math.min(boundsA.maxY, boundsB.maxY) - Math.max(boundsA.minY, boundsB.minY) + gap;
-      if (x <= 0 || y <= 0) continue;
-      moved = true;
-      if (x < y) {
-        const push = x / 2 + .01;
-        const sign = a.x <= b.x ? 1 : -1;
-        a.x -= sign * push;
-        b.x += sign * push;
-      } else {
-        const push = y / 2 + .01;
-        const sign = a.y <= b.y ? 1 : -1;
-        a.y -= sign * push;
-        b.y += sign * push;
-      }
-    }
-    if (!moved) break;
+ const ordered = items.map(item => ({ item, box: itemBounds(item, item.labelLines.length > 0) }))
+  .sort((a,b) => a.box.minY-b.box.minY || a.box.minX-b.box.minX);
+ const cell = Math.max(1, ...ordered.map(({box}) => Math.max(box.maxX-box.minX,box.maxY-box.minY)+gap));
+ const cells = new Map();
+ const keys = box => {
+  const out=[];
+  for(let x=Math.floor(box.minX/cell);x<=Math.floor((box.maxX+gap)/cell);x++)
+   for(let y=Math.floor(box.minY/cell);y<=Math.floor((box.maxY+gap)/cell);y++)out.push(x+','+y);
+  return out;
+ };
+ for(const {item,box} of ordered){
+  for(;;){
+   const nearby=new Set(keys(box).flatMap(key=>cells.get(key)||[]));
+   let shift=0;
+   for(const other of nearby)if(box.minX<other.maxX+gap && box.maxX+gap>other.minX && box.minY<other.maxY+gap && box.maxY+gap>other.minY)
+    shift=Math.max(shift,other.maxY+gap-box.minY+.01);
+   if(!shift)break;
+   item.y+=shift;box.minY+=shift;box.maxY+=shift;
   }
+  for(const key of keys(box)){if(!cells.has(key))cells.set(key,[]);cells.get(key).push(box);}
+ }
 }
 
 function labelLines(name) {
@@ -340,6 +336,7 @@ export function renderDiagramSvg(atlas, options = {}) {
   const depth = Array.isArray(options.depth) ? options.depth : [-Infinity, Infinity];
   let items = [];
   const warnings = [];
+  const sharedFaces = new Map();
   for (const node of atlas.nodes.values()) {
     if (include && !include.has(node.id)) continue;
     if (!isVisible(node) || (isContainer(node) && !isClosed(node))) continue;
@@ -348,7 +345,9 @@ export function renderDiagramSvg(atlas, options = {}) {
     const distance = origin.dot(forward);
     if (distance < depth[0] || distance > depth[1]) continue;
     const faceCache = options.faceCache;
-    let face = faceCache?.has(node) ? faceCache.get(node) : frontFaces(node, independent);
+    const faceKey = JSON.stringify([node.geometry || "box", node.type, node.c, node.s, node.radius, node.segments, node.geometryOptions, node.geometryPaletteOverrides, node.geometry ? null : node.mesh?.geometry?.uuid, node.c ? null : node.mesh?.material?.color?.getHexString(), independent ? null : node.material?.opacity, independent ? null : node.appearanceMaterials?.map(material => material.opacity)]);
+    let face = faceCache?.has(node) ? faceCache.get(node) : sharedFaces.get(faceKey);
+    if (!face) { face = frontFaces(node, independent); sharedFaces.set(faceKey, face); }
     if (faceCache && !faceCache.has(node)) faceCache.set(node, face);
     if (!face) { warnings.push(`${node.id}: no vector front face`); continue; }
     // The 3D renderer can leave an opened shell's material translucent when
@@ -364,7 +363,7 @@ export function renderDiagramSvg(atlas, options = {}) {
     const geometryHeight = (face.bounds.maxY - face.bounds.minY) * scale;
     items.push({ id: node.id, name: node.name || "", x: origin.dot(right) * scale,
       y: -origin.dot(up) * scale, scale, depth: distance, ...face, labelLines: lines,
-      labelFontSize, labelLineHeight, labelGap,
+      faceKey, labelFontSize, labelLineHeight, labelGap,
       width: geometryWidth, height: geometryHeight });
   }
   if (options.cameraFrame && items.length) {
@@ -440,67 +439,33 @@ export function renderDiagramSvg(atlas, options = {}) {
     return boxes;
   };
   let boxes = buildBoxes();
-  const rootGroups = containers.filter(node => boxes.has(node.id) && !boxes.has(node.parent));
-  const rootMembers = new Map(rootGroups.map(root => [root.id, items.filter(item => {
-    let parent = atlas.nodes.get(item.id)?.parent, guard = 0;
-    while (parent && guard++ < atlas.nodes.size) {
-      if (parent === root.id) return true;
-      parent = atlas.nodes.get(parent)?.parent;
-    }
-    return false;
-  })]));
-  const groupGap = labelScale ? 8 / labelScale : gap;
-  for (let iteration = 0; iteration < 24; iteration += 1) {
-    let moved = false;
-    for (let i = 0; i < rootGroups.length; i += 1) for (let j = i + 1; j < rootGroups.length; j += 1) {
-      const a = boxes.get(rootGroups[i].id), b = boxes.get(rootGroups[j].id);
-      const overlapX = Math.min(a.maxX, b.maxX) - Math.max(a.minX, b.minX) + groupGap;
-      const overlapY = Math.min(a.maxY, b.maxY) - Math.max(a.minY, b.minY) + groupGap;
-      if (overlapX <= 0 || overlapY <= 0) continue;
-      const axis = overlapX < overlapY ? "x" : "y";
-      const centerA = (a[axis === "x" ? "minX" : "minY"] + a[axis === "x" ? "maxX" : "maxY"]) / 2;
-      const centerB = (b[axis === "x" ? "minX" : "minY"] + b[axis === "x" ? "maxX" : "maxY"]) / 2;
-      const push = (axis === "x" ? overlapX : overlapY) / 2 + .01;
-      const sign = centerA <= centerB ? 1 : -1;
-      for (const item of rootMembers.get(rootGroups[i].id)) item[axis] -= sign * push;
-      for (const item of rootMembers.get(rootGroups[j].id)) item[axis] += sign * push;
-      boxes = buildBoxes();
-      moved = true;
-    }
-    if (!moved) break;
-  }
-  const grouped = new Set([...rootMembers.values()].flat());
-  const blocks = rootGroups.map(root => ({ box: boxes.get(root.id), members: rootMembers.get(root.id) }));
-  for (const item of items) if (!grouped.has(item)) {
-    blocks.push({ box: itemBounds(item, options.labels !== false), members: [item] });
-  }
-  // Keep the canonical front's authored grouping. A turned camera can spread
-  // those same root groups across a very large page, so arrange the already
-  // resolved group rectangles into a compact reading surface.
-  const placement = forward.z < .97 ? compactRootBlocks(blocks, groupGap,
-    Math.max(.5, Math.min(3, Number(options.cameraFrame?.aspect) || 1.7))) : null;
-  if (placement) {
-    for (const block of blocks) {
-      const position = placement.get(block);
-      for (const item of block.members) {
-        item.x += position.x - block.box.minX;
-        item.y += position.y - block.box.minY;
-      }
-    }
-    boxes = buildBoxes();
-  }
-  // Captured diagrams keep the user's chosen 2D arrangement independently of
-  // later changes to the packing heuristic or viewport aspect.
-  if (options.placements && typeof options.placements === "object") {
-    for (const item of items) {
-      const position = options.placements[item.id];
-      if (Array.isArray(position) && position.length === 2 && position.every(Number.isFinite)) {
-        item.x = position[0];
-        item.y = position[1];
-      }
-    }
-    boxes = buildBoxes();
-  }
+  const groupGap = labelScale ? 8 / labelScale : Math.max(8, gap);
+ // Resolve from the deepest siblings outwards. Each child container moves as a
+ // rigid subtree; parents are then measured again around their final children.
+ if (options.placements && typeof options.placements === "object") for(const item of items){
+  const at=options.placements[item.id];if(Array.isArray(at)&&at.length===2&&at.every(Number.isFinite)){item.x=at[0];item.y=at[1];}
+ }
+ boxes=buildBoxes();
+ const descendants=new Map(), parentOf=id=>{
+  let parent=atlas.nodes.get(id)?.parent,seen=new Set();
+  while(parent&&!seen.has(parent)){if(boxes.has(parent))return parent;seen.add(parent);parent=atlas.nodes.get(parent)?.parent;}
+  return null;
+ };
+ for(const item of items){let parent=parentOf(item.id),seen=new Set();while(parent&&!seen.has(parent)){seen.add(parent);if(!descendants.has(parent))descendants.set(parent,[]);descendants.get(parent).push(item);parent=parentOf(parent);}}
+ const parents=[...containers.filter(node=>boxes.has(node.id)).sort((a,b)=>containerDepth(b)-containerDepth(a)).map(node=>node.id),null];
+ for(const parent of parents){
+  const units=[...containers.filter(node=>boxes.has(node.id)&&parentOf(node.id)===parent).map(node=>({box:boxes.get(node.id),members:descendants.get(node.id)||[]})),...items.filter(item=>parentOf(item.id)===parent).map(item=>({box:itemBounds(item,options.labels!==!1),members:[item]}))];
+  let collision=false;
+  for(let i=0;i<units.length&&!collision;i++)for(let j=i+1;j<units.length;j++){const a=units[i].box,b=units[j].box;if(a.minX<b.maxX+groupGap&&a.maxX+groupGap>b.minX&&a.minY<b.maxY+groupGap&&a.maxY+groupGap>b.minY){collision=true;break;}}
+  if(!collision)continue;
+  const originX=Math.min(...units.map(u=>u.box.minX)),originY=Math.min(...units.map(u=>u.box.minY)),aspect=Math.max(.5,Math.min(3,Number(options.cameraFrame?.aspect)||1.7));
+  const area=units.reduce((sum,u)=>sum+(u.box.maxX-u.box.minX+groupGap)*(u.box.maxY-u.box.minY+groupGap),0),rowWidth=Math.max(Math.sqrt(area*aspect),...units.map(u=>u.box.maxX-u.box.minX));
+  units.sort((a,b)=>a.box.minY-b.box.minY||a.box.minX-b.box.minX);
+  let x=0,y=0,height=0;
+  for(const unit of units){const width=unit.box.maxX-unit.box.minX,h=unit.box.maxY-unit.box.minY;if(x&&x+width>rowWidth){x=0;y+=height+groupGap;height=0;}const dx=originX+x-unit.box.minX,dy=originY+y-unit.box.minY;for(const item of unit.members){item.x+=dx;item.y+=dy;}x+=width+groupGap;height=Math.max(height,h);}
+  boxes=buildBoxes();
+ }
+
   const extent = [...items.map(item => itemBounds(item, options.labels !== false)), ...boxes.values()];
   const left = (extent.length ? Math.min(...extent.map(box => box.minX)) : 0) - padding;
   const top = (extent.length ? Math.min(...extent.map(box => box.minY)) : 0) - padding;
@@ -508,6 +473,12 @@ export function renderDiagramSvg(atlas, options = {}) {
   const bottom = (extent.length ? Math.max(...extent.map(box => box.maxY)) : 0) + padding;
   const width = Math.max(1, Math.ceil(rightEdge - left));
   const height = Math.max(1, Math.ceil(bottom - top));
+  if (options.layoutOnly) return {
+    width, height, scale, left, top, labelFontSize, labelLineHeight, labelGap, containerFontSize,
+    items: items.map(item => ({ id:item.id, x:item.x-left, y:item.y-top, width:item.width, height:item.height, bounds:item.bounds, labelLines:item.labelLines, labelFontSize:item.labelFontSize, labelLineHeight:item.labelLineHeight, labelGap:item.labelGap, visible:!hiddenByFocus(item.id), opacity:dimmed(item.id) })),
+    containers: [...boxes.values()].map(box => ({ id:box.node.id, minX:box.minX-left, maxX:box.maxX-left, minY:box.minY-top, maxY:box.maxY-top, depth:containerDepth(box.node), visible:!hiddenByFocus(box.node.id), opacity:dimmed(box.node.id) })),
+    relations: visible.map(relation => { const from=byId.get(relation.from),to=byId.get(relation.to); return { id:relation.id, index:atlas.relations.indexOf(relation), from:relation.from, to:relation.to, start:rayBoundary(from,to), end:rayBoundary(to,from), mode:relationMode(relation), opacity:Math.min(dimmed(relation.from),dimmed(relation.to)) }; }).map(link => ({...link,start:{x:link.start.x-left,y:link.start.y-top},end:{x:link.end.x-left,y:link.end.y-top}})), warnings
+  };
   if (options.measureOnly) return { width, height, warnings };
   const fmt = p => `${round(p.x - left)} ${round(p.y - top)}`;
   const relations = visible.map(relation => {
@@ -554,13 +525,22 @@ export function renderDiagramSvg(atlas, options = {}) {
       ? `<rect x="${x}" y="${y}" width="${round(box.maxX - box.minX)}" height="${round(box.maxY - box.minY)}" rx="12" fill="${parentBackdrop}"/>` : "";
     return `${underlay}<g data-container="${escapeXml(box.node.id)}"${dimmed(box.node.id) < 1 ? ` opacity="${dimmed(box.node.id)}"` : ""}><title>${escapeXml(box.node.name || box.node.id)}</title><rect x="${x}" y="${y}" width="${round(box.maxX - box.minX)}" height="${round(box.maxY - box.minY)}" rx="12" ${fill} stroke="${ink}" stroke-opacity="0.72" stroke-width="2"/><g data-diagram-label="container" transform="translate(${x} ${y})"><text x="${labelX}" y="${labelY}" font-family="system-ui,sans-serif" font-size="${round(containerFontSize)}" font-weight="600" fill="${ink}">${escapeXml(box.node.name || box.node.id)}</text></g></g>`;
   }).join("");
+  const svgSymbols = new Map(), svgDefs = [];
+  const svgGlyph = (item, make) => {
+    if (!svgSymbols.has(item.faceKey)) {
+      const id = 'atlas-geometry-' + svgSymbols.size;
+      svgDefs.push(`<symbol id="${id}" overflow="visible">${make()}</symbol>`);
+      svgSymbols.set(item.faceKey, `<use href="#${id}"/>`);
+    }
+    return svgSymbols.get(item.faceKey);
+  };
   const entities = items.sort((a, b) => a.depth - b.depth).map(item => {
     if (hiddenByFocus(item.id)) return "";
     let parent = atlas.nodes.get(item.id)?.parent, guard = 0;
     while (parent && !boxBackdrops.has(parent) && guard++ < atlas.nodes.size) parent = atlas.nodes.get(parent)?.parent;
     const mask = options.maskGrid && !boxBackdrops.has(parent) && item.hull.length > 2
       ? `<polygon points="${item.hull.map(point => `${round(point.x * scale)},${round(-point.y * scale)}`).join(" ")}" fill="${escapeXml(canvasColor)}"/>` : "";
-    const paths = [...item.triangles, ...item.textured].sort((a, b) => a.depth - b.depth).map((triangle, index) => {
+    const paths = svgGlyph(item, () => [...item.triangles, ...item.textured].sort((a, b) => a.depth - b.depth).map((triangle, index) => {
       if (triangle.image) {
         const clipId = `atlas-clip-${escapeXml(item.id).replace(/[^a-zA-Z0-9_-]/g, "-")}-${index}`;
         const hull = convexHull(triangle.points.map(point => ({ x: point.x, y: point.y })));
@@ -571,14 +551,14 @@ export function renderDiagramSvg(atlas, options = {}) {
       const p = triangle.vertices.map(point => `${round(point.x * scale)},${round(-point.y * scale)}`).join(" ");
       const stroke = triangle.opacity < 1 ? "" : ` stroke="${triangle.color}" stroke-width="0.8" stroke-linejoin="round"`;
       return `<polygon points="${p}" fill="${triangle.color}"${stroke}${triangle.opacity < 1 ? ` opacity="${round(triangle.opacity)}"` : ""}/>`;
-    }).join("");
+    }).join(""));
     const labelBottom = round(-item.bounds.minY * scale);
     const label = options.labels === false || !item.labelLines.length ? "" : `<g data-diagram-label="entity" transform="translate(0 ${labelBottom})">${item.labelLines.map((line, i) => `<text x="0" y="${round(item.labelGap + item.labelFontSize + i * item.labelLineHeight)}" text-anchor="middle" font-family="system-ui,sans-serif" font-size="${round(item.labelFontSize)}" fill="${escapeXml(options.labelColor || "#172c3a")}">${escapeXml(line)}</text>`).join("")}</g>`;
     const transform = `translate(${round(item.x - left)} ${round(item.y - top)})`;
     return `${mask ? `<g transform="${transform}" pointer-events="none">${mask}</g>` : ""}<g data-entity="${escapeXml(item.id)}" transform="${transform}"${dimmed(item.id) < 1 ? ` opacity="${dimmed(item.id)}"` : ""}><title>${escapeXml(item.name || item.id)}</title>${paths}${label}</g>`;
   }).join("");
   const background = options.background ? `<rect width="100%" height="100%" fill="${escapeXml(options.background)}"/>` : "";
-  const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${width} ${height}" width="${width}" height="${height}"><defs><marker id="atlas-diagram-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path d="M0 0 L10 5 L0 10Z" fill="${escapeXml(options.connectionColor || "#58788d")}"/></marker></defs>${background}<g class="containers">${containersSvg}</g><g class="relations">${relations}</g><g class="entities">${entities}</g></svg>`;
+  const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${width} ${height}" width="${width}" height="${height}"><defs>${svgDefs.join('')}<marker id="atlas-diagram-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path d="M0 0 L10 5 L0 10Z" fill="${escapeXml(options.connectionColor || "#58788d")}"/></marker></defs>${background}<g class="containers">${containersSvg}</g><g class="relations">${relations}</g><g class="entities">${entities}</g></svg>`;
   return { svg, width, height, warnings, items: items.map(({ id, x, y, width: w, height: h }) => ({ id, x: round(x - left), y: round(y - top), width: round(w), height: round(h) })) };
 }
 
@@ -601,3 +581,6 @@ export async function diagramSvgToPng(svg, ownerDocument = globalThis.document)
     URL.revokeObjectURL(url);
   }
 }
+
+/** Calculate the shared diagram without generating SVG or touching the DOM. */
+export function computeDiagramLayout(atlas, options = {}) { return renderDiagramSvg(atlas, {...options, layoutOnly:true}); }

package/src/diagram-view.js

@@ -94,6 +94,7 @@ function diagramNodeVisible(atlas, node) {
 }
 
 function modelCenter(atlas) {
+  if (atlas._canonicalDiagramCenter) return atlas._canonicalDiagramCenter();
   const points = [...atlas.nodes.values()].filter(node => diagramNodeVisible(atlas, node) && diagramItemNode(atlas, node)).map(node => node.group.position);
   if (!points.length) return [0, 0, 0];
   return ["x", "y", "z"].map(axis => (Math.min(...points.map(point => point[axis])) + Math.max(...points.map(point => point[axis]))) / 2);
@@ -322,6 +323,9 @@ export class DiagramView {
     this.cube.hidden = !this.config.showOrientationCube;
     this.cube.innerHTML = orientationCubeSvg(cameraAngles(this.config.cameraView));
     toolbar.querySelector("[data-diagram-cube-visible]").checked = this.config.showOrientationCube;
+    const controlsKey = JSON.stringify([this.atlas._diagramRevision, [...this.atlas.open], this.config.includeIds, this.config.orbitId]);
+    if (this._itemsControlsKey !== controlsKey) {
+      this._itemsControlsKey = controlsKey;
     const orbit = toolbar.querySelector("[data-diagram-orbit]");
     const orbitIds = [...this.atlas.nodes.values()].filter(node => diagramNodeVisible(this.atlas, node) && diagramItemNode(this.atlas, node));
     orbit.innerHTML = '<option value="">Model center</option>' + orbitIds.map(node =>
@@ -332,6 +336,7 @@ export class DiagramView {
     const visible = new Set(this.config.includeIds || [...this.atlas.nodes.keys()]);
     const nodes = [...this.atlas.nodes.values()].filter(node => diagramNodeVisible(this.atlas, node) && diagramItemNode(this.atlas, node));
     items.innerHTML = nodes.map(node => `<button type="button" class="toolbar-option checkbox" data-diagram-item="${escapeHtml(node.id)}"><input type="checkbox" ${visible.has(node.id) ? "checked" : ""}><span>${escapeHtml(node.name || node.id)}</span></button>`).join("");
+    }
     const groupIds = [...new Set(this.atlas.relations.map(relation => relation.group || "default"))];
     const selectedGroups = new Set(this.config.relationGroups || groupIds);
     for (const button of toolbar.querySelectorAll('[data-action="relation-group-toggle"]')) {
@@ -439,7 +444,7 @@ export class DiagramView {
     this.atlas.toolbar.addEventListener("change", event => {
       if (!event.target.matches("[data-diagram-orbit]")) return;
       const orbitId = event.target.value;
-      const target = orbitId ? this.atlas.nodes.get(orbitId)?.group.position.toArray() : modelCenter(this.atlas);
+      const target = orbitId ? (this.atlas._diagramOrbitTarget?.(orbitId) || this.atlas.nodes.get(orbitId)?.group.position.toArray()) : modelCenter(this.atlas);
       const angles = cameraAngles(this.config.cameraView);
       this.setConfig({ orbitId, cameraView: cameraView(target || modelCenter(this.atlas), angles.yaw, angles.pitch) }, { layout: true });
     });

package/src/diagram-webgl.js

@@ -0,0 +1,166 @@
+import {DiagramScene} from './diagram-scene.js';
+// Orthographic viewport over an independently calculated diagram; the domain/3D coordinates stay canonical.
+const container=node=>['container','shell'].includes(node.type);
+export function orthographicFit(bounds,aspect,halfHeight=14){
+ const width=Math.max(1,bounds.maxX-bounds.minX),height=Math.max(1,bounds.maxY-bounds.minY);
+ return Math.max(.001,Math.min(6,Math.min(halfHeight*2/height,halfHeight*2*aspect/width)/1.15));
+}
+export function diagramViewForModel(value,center,orbit){
+ const next={theme:'light',...value},valid=v=>Array.isArray(v)&&v.length===3&&v.every(Number.isFinite),view=next.cameraView;
+ if(!view||view.projection==='orthographic'||!valid(view.position)||!valid(view.target))next.cameraView={target:[...center],position:[center[0],center[1],center[2]+30]};
+ else if(orbit||valid(next.cameraModelCenter)){
+  const target=orbit||view.target.map((n,i)=>n+center[i]-next.cameraModelCenter[i]),delta=target.map((n,i)=>n-view.target[i]);
+  next.cameraView={target:[...target],position:view.position.map((n,i)=>n+delta[i])};
+ }
+ next.cameraModelCenter=[...center];return next;
+}
+export function installPlanarAtlas(Atlas,OrthographicCamera,computeLayout,G){
+ const proto=Atlas.prototype;if(proto._planarInstalled)return;proto._planarInstalled=true;
+ const original=Object.fromEntries(['_build','_worldPosition','getCameraView','setCameraView','_panByPixels','fit','frontView','resize','_positionJumpButton','_renderFrame','exportDiagramSvg','_rebuildRelations','_geometryContentUpdated','_pick','captureFrame','zoomIn','zoomOut','focusSelection'].map(key=>[key,proto[key]]));
+ proto._setupPlanar=function(){
+  if(this._planarSetup)return;this._planarSetup=true;
+  const style=this.ownerDocument.createElement('style');
+  style.textContent=`:host([data-planar="true"]) .viewport>canvas{visibility:visible!important;pointer-events:auto!important}
+   :host([data-planar="true"]) .diagram-view{display:none!important}
+   :host([data-planar="true"]) [data-toolbar-group="camera"]{display:none!important}
+   :host([data-planar="true"]) [data-toolbar-group="copy"]{display:flex!important}
+   .diagram-toolbar .toolbar-popover{max-height:min(420px,calc(100dvh - 160px),var(--lc-menu-height,420px));overflow-y:auto}
+   .diagram-appearance{padding:6px 9px;display:grid;gap:8px;color:#dbe7ec;font-size:12px}.diagram-appearance label{display:flex;gap:8px;align-items:center}`;
+  this.shadowRoot.append(style);
+  const diagram=this.diagramView,setState=diagram.setState.bind(diagram),action=diagram.action.bind(diagram);
+  diagram.setState=(value={})=>setState(diagramViewForModel(value,this._canonicalDiagramCenter(),value.orbitId?this._diagramOrbitTarget(value.orbitId):null));
+  diagram.refresh=()=>{if(!this._webglPlanar)return false;this._scheduleDiagram();return true;};
+  diagram.scheduleRefresh=()=>{if(this._webglPlanar)this._scheduleDiagram();};
+  diagram.focusSelection=()=>this.focusSelection();
+  diagram.action=(name,control)=>{
+   if(name==='diagram-plus'){this.zoomIn();return true;}if(name==='diagram-minus'){this.zoomOut();return true;}if(name==='diagram-fit'){this.fit();return true;}
+   return action(name,control);
+  };
+  const options=this.toolbar.querySelector('[data-toolbar-menu="diagram-options"] .toolbar-popover');
+  options?.insertAdjacentHTML('beforeend','<div class="diagram-appearance"><label><input type="checkbox" data-diagram-light checked>Fondo claro</label><label><input type="checkbox" data-diagram-grid checked>Cuadrícula de puntos</label></div>');
+  this.toolbar.addEventListener('change',event=>{
+   if(event.target.matches('[data-diagram-light]'))diagram.setConfig({theme:event.target.checked?'light':'dark'});
+   if(event.target.matches('[data-diagram-grid]'))diagram.setConfig({grid:event.target.checked});
+  });
+  this.addEventListener('lc-disconnect',()=>{cancelAnimationFrame(this._planarChangeFrame);cancelAnimationFrame(this._diagramFrame);});
+ };
+ proto._canonicalDiagramCenter=function(){
+  const points=[...this.nodes.values()].filter(n=>this._isVisible(n)&&(!container(n)||!this.open.has(n.id))).map(n=>this._canonicalPositions?.get(n.id)||original._worldPosition.call(this,n));
+  if(!points.length)return [0,0,0];return ['x','y','z'].map(axis=>(Math.min(...points.map(p=>p[axis]))+Math.max(...points.map(p=>p[axis])))/2);
+ };
+ proto._diagramOrbitTarget=function(id){return this._canonicalPositions?.get(id)?.toArray();};
+ proto._withCanonicalDiagram=function(run){
+  this._computingDiagram=true;
+  const visibility=new Map();for(const node of this.nodes.values()){node.group.position.copy(this._canonicalPositions.get(node.id));visibility.set(node.id,node.mesh.visible);node.mesh.visible=true;}
+  try{return run();}finally{for(const node of this.nodes.values())node.mesh.visible=visibility.get(node.id);this._computingDiagram=false;if(this._diagramScene)for(const [id,position] of this._diagramScene.positions)this.nodes.get(id)?.group.position.copy(position);}
+ };
+ proto._worldPosition=function(node,trail){
+  const position=this._webglPlanar&&!this._computingDiagram?this._diagramScene?.positions.get(node?.id):null;
+  return position?position.clone():original._worldPosition.call(this,node,trail);
+ };
+ proto._configurePlanarCamera=function(planar){
+  this._webglPlanar=planar;this.dataset.planar=String(planar);this.dataset.renderer=planar?'webgl-orthographic':'webgl-perspective';
+  if(planar){if(!this.camera.isOrthographicCamera){this._perspectiveCamera=this.camera;this.camera=new OrthographicCamera(-14,14,14,-14,.1,20000);this.camera.aspect=1;}this.yaw=0;this.pitch=0;}
+  else {if(this._perspectiveCamera){this.camera=this._perspectiveCamera;this._perspectiveCamera=null;}const viewport=this.shadowRoot.querySelector('.viewport');viewport.style.backgroundColor='';viewport.style.backgroundImage='';viewport.style.backgroundSize='';viewport.style.backgroundPosition='';this.shadowRoot.querySelector('.hint').style.color='';}
+ };
+ proto._build=function(options={}){
+  // Detached/headless callers may build geometry for vector export without a DOM renderer.
+  if(!this.ownerDocument)return original._build.call(this,options);
+  if(!this._ensureRenderer())return;
+  this._setupPlanar();this._configurePlanarCamera(this.viewMode==='2d');
+  cancelAnimationFrame(this._diagramFrame);this._diagramFrame=0;this._diagramScene=null;this._diagramLayout=null;this._diagramKey=null;this._diagramFaces=new Map();this._canonicalPositions=new Map();this._buildingDiagram=true;
+  try{original._build.call(this,options);}finally{this._buildingDiagram=false;}
+  for(const node of this.nodes.values())this._canonicalPositions.set(node.id,original._worldPosition.call(this,node));
+  this._diagramRevision=(this._diagramRevision||0)+1;
+  if(this._webglPlanar){this.diagramView.setState(this._diagramRevision===1?(this.modelData.render?.views?.['2d']||{}):this.diagramView.config);this._diagramScene=new DiagramScene(this,G);this._diagramScene.flattenMaterials();this._diagramFitted=true;this._runDiagram();}
+ };
+ proto._scheduleDiagram=function(){
+  if(this._buildingDiagram||this._diagramFrame||!this._webglPlanar)return;
+  this._diagramFrame=requestAnimationFrame(()=>{this._diagramFrame=0;if(this.isConnected&&this.ready&&this._webglPlanar)this._runDiagram();});
+ };
+ proto._diagramOptions=function(){
+  const config=this.diagramView.config,rect=this.canvas.getBoundingClientRect();
+  return {...this.diagramView.renderOptions(),cameraView:config.cameraView,cameraFrame:{zoom:config.cameraZoom,aspect:rect.width/Math.max(1,rect.height)},observerScale:1,faceCache:this._diagramFaces,background:null,maskGrid:true};
+ };
+ proto._runDiagram=function(){
+  if(!this._diagramScene||!this.nodes.size)return;
+  const start=performance.now(),options=this._diagramOptions(),key=JSON.stringify([this._diagramRevision,[...this.open],options,this.selectedRelationIndex]);
+  const cubeChanged=this._lastDiagramCube!==this.diagramView.config.showOrientationCube;this._lastDiagramCube=this.diagramView.config.showOrientationCube;
+  this.diagramView.cube.hidden=!this.diagramView.config.showOrientationCube;
+  if(key!==this._diagramKey){
+   const layout=this._withCanonicalDiagram(()=>computeLayout(this,options));
+   this._diagramScene.update(layout,this.diagramView.config);this._diagramLayout=layout;this._diagramKey=key;
+   this.dataset.layoutVersion=String((Number(this.dataset.layoutVersion)||0)+1);this.dataset.layoutMs=(performance.now()-start).toFixed(2);this.dataset.diagramItems=String(layout.items.filter(i=>i.visible).length);
+   if(this._diagramFitted)this.fit({animate:false});
+  }
+  if(this._diagramToolbarRevision!==this._diagramRevision){this._syncRelationToolbar();this._diagramToolbarRevision=this._diagramRevision;}
+  this.diagramView._syncControls();
+  this.toolbar.querySelector('[data-diagram-camera-zoom]').value=String(Math.round(this.diagramView.config.cameraZoom*100));
+  const light=this.toolbar.querySelector('[data-diagram-light]'),grid=this.toolbar.querySelector('[data-diagram-grid]');if(light)light.checked=this.diagramView.config.theme!=='dark';if(grid)grid.checked=this.diagramView.config.grid;
+  if(cubeChanged&&this._diagramFitted)this.fit({animate:false});
+  this._applyDiagramTheme();this.invalidate();
+ };
+ proto._applyDiagramTheme=function(){
+  const config=this.diagramView.config,dark=config.theme==='dark',viewport=this.shadowRoot.querySelector('.viewport');
+  viewport.style.backgroundColor=config.background||(dark?'#2d2f31':'#f5f5f5');viewport.style.backgroundImage=config.grid?`radial-gradient(circle,${dark?'#73777c':'#b3b3b3'} .8px,transparent 1px)`:'none';viewport.style.backgroundSize='16px 16px';
+  this.shadowRoot.querySelector('.hint').style.color=dark?'#b1c7d3':'#527286';
+ };
+ proto._applyDiagramPresentation=function(){this._diagramScene?.apply();};
+ proto.setViewMode=function(mode,options={}){
+  this._setupPlanar();if(!['2d','3d'].includes(mode))throw new TypeError('Atlas view mode must be 2d or 3d.');if(!this._ensureRenderer())return this;
+  const changed=this.viewMode!==mode;
+  if(changed&&this.ready){this._modeCameras??={};this._modeCameras[this.viewMode]=this.getCameraView();}
+  this.viewMode=mode;this._configurePlanarCamera(mode==='2d');this.dataset.viewMode=mode;this.diagramView.root.hidden=true;
+  this.canvas.setAttribute('aria-label',mode==='2d'?'Diagrama 2D de arquitectura':'Modelo 3D de arquitectura');
+  const button=this.toolbar.querySelector('[data-action="view-mode"]');button.textContent=mode==='2d'?'3D':'2D';button.setAttribute('aria-label',mode==='2d'?'Switch to 3D model':'Switch to 2D diagram');button.title=button.getAttribute('aria-label');
+  const facing=this.toolbar.querySelector('[data-action="item-facing"]');if(facing)facing.disabled=mode==='2d';
+  this.shadowRoot.querySelector('.hint').textContent=mode==='2d'?'Desplazar: arrastrar · Zoom: rueda o + / − · Orientación y filtros: barra y cubo':'Rotate: drag · Pan: ⇧+drag · Zoom: wheel · Select: click';
+  const complete=()=>{
+   if(!this.isConnected||!this.ready||this.viewMode!==mode)return;
+   if(this._projectedPlanar!==(mode==='2d'))this._build({preserveSelection:this.selectedId,preserveRelation:this.selectedRelationIndex});
+   this.resize();if(changed||options.force){const saved=this._modeCameras?.[mode];if(saved)this.setCameraView(saved,{animate:false});else this.fit({animate:false});}
+   if(mode==='2d')this._runDiagram();else {this._syncRelationToolbar();this._syncFocusToolbar();this._syncLabelsToolbar();}
+   this.invalidate();
+  };
+  this._projectedPlanar??=mode==='2d';
+  if(changed){cancelAnimationFrame(this._planarChangeFrame);this._planarChangeFrame=requestAnimationFrame(complete);}else complete();
+  if(changed&&options.emit!==false)this._emit('lc-view-mode-change',{mode,source:options.source||'api'});return this;
+ };
+ // Remember which representation is built (not just which mode the toolbar requested).
+ const build=proto._build;proto._build=function(options){build.call(this,options);this._projectedPlanar=this._webglPlanar;};
+ proto._rebuildRelations=function(){if(this._webglPlanar){if(!this._buildingDiagram)this._scheduleDiagram();return;}return original._rebuildRelations.call(this);};
+ proto._geometryContentUpdated=function(){if(this._webglPlanar){this._diagramFaces?.clear();this._diagramKey=null;this._scheduleDiagram();}else original._geometryContentUpdated.call(this);};
+ proto._updatePlanarCamera=function(){const camera=this.camera;camera.zoom=Math.max(.001,this.zoom);camera.position.set(this.focus.x,this.focus.y,1000);camera.lookAt(this.focus.x,this.focus.y,0);camera.updateProjectionMatrix();};
+ proto.resize=function(){
+  if(this._webglPlanar){const rect=this.canvas.getBoundingClientRect();this.camera.aspect=rect.width/Math.max(1,rect.height);this.camera.left=-14*this.camera.aspect;this.camera.right=14*this.camera.aspect;this.camera.top=14;this.camera.bottom=-14;}
+  return original.resize.call(this);
+ };
+ proto.getCameraView=function(){return this._webglPlanar?{position:[this.focus.x,this.focus.y,1000],target:[this.focus.x,this.focus.y,0],zoom:this.zoom,projection:'orthographic'}:original.getCameraView.call(this);};
+ proto.setCameraView=function(view={},options={}){
+  if(!this._webglPlanar)return original.setCameraView.call(this,view,options);
+  this._diagramFitted=false;
+  if(view.target?.length===3&&view.target.every(Number.isFinite))this.targetFocus.set(view.target[0],view.target[1],0);if(Number.isFinite(view.zoom)&&view.zoom>0)this.targetZoom=Math.max(.001,Math.min(6,view.zoom));
+  if(options.animate===false){this.focus.copy(this.targetFocus);this.zoom=this.targetZoom;}
+  this.invalidate();return this;
+ };
+ proto._panByPixels=function(dx,dy){if(!this._webglPlanar)return original._panByPixels.call(this,dx,dy);this._diagramFitted=false;const units=28/(Math.max(.001,this.zoom)*Math.max(1,this.canvas.getBoundingClientRect().height));this.targetFocus.x-=dx*units;this.targetFocus.y+=dy*units;this.invalidate();return this;};
+ proto.focusSelection=function(options={}){if(this._webglPlanar)this._diagramFitted=false;return original.focusSelection.call(this,options);};
+ proto.zoomIn=function(){if(this._webglPlanar)this._diagramFitted=false;return original.zoomIn.call(this);};
+ proto.zoomOut=function(){if(!this._webglPlanar)return original.zoomOut.call(this);this._diagramFitted=false;this.targetZoom=Math.max(.001,this.targetZoom/1.18);this.invalidate();return this;};
+ proto.fit=function(options={}){
+  if(!this._webglPlanar)return original.fit.call(this,options);if(!this._diagramLayout)return this;
+  this._diagramFitted=true;const layout=this._diagramLayout,scale=layout.scale,rect=this.canvas.getBoundingClientRect(),left=this.diagramView.config.showOrientationCube?132:16,right=16,top=34,bottom=this.toolbarVisible?this.toolbar.offsetHeight+44:16;
+  this.targetZoom=orthographicFit({minX:0,maxX:layout.width/scale,minY:0,maxY:layout.height/scale},this.camera.aspect||1)*Math.max(.1,Math.min((rect.width-left-right)/rect.width,(rect.height-top-bottom)/rect.height));
+  const units=28/(this.targetZoom*Math.max(1,rect.height));this.targetFocus.set(layout.width/(2*scale)-(left-right)*units/2,-layout.height/(2*scale)+(top-bottom)*units/2,0);
+  if(options.animate===false){this.focus.copy(this.targetFocus);this.zoom=this.targetZoom;}this.invalidate();return this;
+ };
+ proto.frontView=function(){if(!this._webglPlanar)return original.frontView.call(this);this.diagramView.action('diagram-front');return this;};
+ proto._pick=function(event){if(!this._webglPlanar)return original._pick.call(this,event);const mode=this.relationMode;let hit;this.relationMode='none';try{hit=original._pick.call(this,event);}finally{this.relationMode=mode;}return this._diagramScene?.pick(event,hit)||hit;};
+ proto._positionJumpButton=function(){if(!this._webglPlanar)return original._positionJumpButton.call(this);const mode=this.viewMode;this.viewMode='3d';try{return original._positionJumpButton.call(this);}finally{this.viewMode=mode;}};
+ proto.getDiagramView=function(){const state=this.diagramView.captureState();return {...state,cameraModelCenter:this._canonicalDiagramCenter(),viewport:this._webglPlanar?{...this.getCameraView(),fitted:this._diagramFitted}:state.viewport};};
+ proto.captureDiagramView=function(){return this.getDiagramView();};
+ proto.setDiagramView=function(state={}){this.diagramView.setState(state);if(this._webglPlanar&&state.viewport?.projection==='orthographic'){this._diagramFitted=false;this.setCameraView(state.viewport,{animate:false});this._diagramFitted=state.viewport.fitted===true;}return this;};
+ proto._renderFrame=function(time){const start=performance.now(),result=original._renderFrame.call(this,time);if(this._webglPlanar){this.dataset.frameMs=(performance.now()-start).toFixed(2);this.dataset.frames=String((Number(this.dataset.frames)||0)+1);this.dataset.drawCalls=String(this.renderer?.info.render.calls||0);}return result;};
+ proto.captureFrame=function(options={}){return original.captureFrame.call(this,this._webglPlanar&&options.background==='theme'?{...options,background:this.diagramView.config.background||(this.diagramView.config.theme==='dark'?'#2d2f31':'#f5f5f5')}:options);};
+ proto.exportDiagramSvg=function(options={}){this.dataset.svgExports=String((Number(this.dataset.svgExports)||0)+1);if(this._webglPlanar)return this._withCanonicalDiagram(()=>original.exportDiagramSvg.call(this,{...this._diagramOptions(),...options}));return original.exportDiagramSvg.call(this,options);};
+}