Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
Fix Semantic Radar collision handling and dragging (#100)
sunsunsun-java4293061d81bb
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.ymlindex add292bf..b7676eee 100644--- a/.github/workflows/ci.yml+++ b/.github/workflows/ci.yml@@ -51,6 +51,12 @@ jobs:env:ARCHIFY_CHROME: ${{ steps.setup-chrome.outputs.chrome-path }}ARCHIFY_CHROME_NO_SANDBOX: '1'+ - name: Verify Semantic Radar collision and drag behavior+ run: node --test test/semantic-radar.test.mjs+ working-directory: archify+ env:+ ARCHIFY_CHROME: ${{ steps.setup-chrome.outputs.chrome-path }}+ ARCHIFY_CHROME_NO_SANDBOX: '1'- name: Verify Viewer chrome stays clear of SVG legendsrun: node --test test/viewer-chrome-layout.test.mjsworking-directory: archifydiff --git a/archify.zip b/archify.zipindex 400b619c..bcd083a0 100644Binary files a/archify.zip and b/archify.zip differdiff --git a/archify/assets/template.html b/archify/assets/template.htmlindex 80915779..6f7fdca4 100644--- a/archify/assets/template.html+++ b/archify/assets/template.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5233,11 +5305,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8270,6 +8344,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8541,7 +8654,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11391,18 +11504,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11447,62 +11574,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11523,6 +11882,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11533,25 +11896,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11596,31 +11965,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11653,8 +12082,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11663,7 +12116,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/archify/examples/dataflow-product-analytics.html b/archify/examples/dataflow-product-analytics.htmlindex 2ba52bf5..00961186 100644--- a/archify/examples/dataflow-product-analytics.html+++ b/archify/examples/dataflow-product-analytics.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5348,11 +5420,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8381,6 +8455,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8652,7 +8765,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11502,18 +11615,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11558,62 +11685,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11634,6 +11993,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11644,25 +12007,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11707,31 +12076,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11764,8 +12193,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11774,7 +12227,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/archify/examples/lifecycle-agent-run.html b/archify/examples/lifecycle-agent-run.htmlindex 70742acd..d7172705 100644--- a/archify/examples/lifecycle-agent-run.html+++ b/archify/examples/lifecycle-agent-run.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5297,11 +5369,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8330,6 +8404,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8601,7 +8714,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11451,18 +11564,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11507,62 +11634,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11583,6 +11942,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11593,25 +11956,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11656,31 +12025,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11713,8 +12142,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11723,7 +12176,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/archify/examples/sequence-cache-miss-request.html b/archify/examples/sequence-cache-miss-request.htmlindex 802dccfd..e93eef5f 100644--- a/archify/examples/sequence-cache-miss-request.html+++ b/archify/examples/sequence-cache-miss-request.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5363,11 +5435,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8396,6 +8470,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8667,7 +8780,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11517,18 +11630,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11573,62 +11700,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11649,6 +12008,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11659,25 +12022,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11722,31 +12091,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11779,8 +12208,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11789,7 +12242,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/archify/examples/web-app-rendered.html b/archify/examples/web-app-rendered.htmlindex a1588db3..259a150d 100644--- a/archify/examples/web-app-rendered.html+++ b/archify/examples/web-app-rendered.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5314,11 +5386,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8345,6 +8419,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8616,7 +8729,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11466,18 +11579,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11522,62 +11649,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11598,6 +11957,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11608,25 +11971,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11671,31 +12040,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11728,8 +12157,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11738,7 +12191,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/archify/examples/workflow-agent-tool-call-rendered.html b/archify/examples/workflow-agent-tool-call-rendered.htmlindex 41c328fb..f5373ec9 100644--- a/archify/examples/workflow-agent-tool-call-rendered.html+++ b/archify/examples/workflow-agent-tool-call-rendered.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5342,11 +5414,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8378,6 +8452,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8649,7 +8762,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11499,18 +11612,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11555,62 +11682,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11631,6 +11990,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11641,25 +12004,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11704,31 +12073,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11761,8 +12190,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11771,7 +12224,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/archify/test/semantic-passport.test.mjs b/archify/test/semantic-passport.test.mjsindex 213c8fee..614db22e 100644--- a/archify/test/semantic-passport.test.mjs+++ b/archify/test/semantic-passport.test.mjs@@ -80,7 +80,7 @@ test('Relationship Lens renders one Semantic Passport and copyable stable focusassert.match(html, /focus-chip:not\(\[data-relations-expanded="true"\]\) \.relationship-lens-list \{ display: none; \}/);assert.match(html, /clearBtn\.addEventListener\('click', function \(\) \{ clear\(\{ restoreFocus: true \}\); \}\)/);assert.match(html, /chip\.hidden \|\| !target \|\| typeof target\.closest !== 'function' \|\| chip\.contains\(target\)/);- assert.match(html, /target\.closest\('\[data-node-id\], \[data-relationship-hit-key\]'\)/);+ assert.match(html, /target\.closest\('\[data-node-id\], \[data-relationship-hit-key\], \.overview-map'\)/);assert.match(html, /document\.addEventListener\('click',[\s\S]+?clear\(\);\s+\}, true\);/);assert.match(html, /Archify\.focus\.clear\(\{ restoreFocus: true \}\)/);});diff --git a/archify/test/semantic-radar.test.mjs b/archify/test/semantic-radar.test.mjsindex e2347e74..fb689ecd 100644--- a/archify/test/semantic-radar.test.mjs+++ b/archify/test/semantic-radar.test.mjs@@ -4,11 +4,14 @@ import { execFileSync } from 'node:child_process';import fs from 'node:fs';import os from 'node:os';import path from 'node:path';-import { fileURLToPath } from 'node:url';+import { fileURLToPath, pathToFileURL } from 'node:url';++import { ChromeVisualBrowser, findChrome } from '../bin/visual-check.mjs';const __dirname = path.dirname(fileURLToPath(import.meta.url));const skillRoot = path.resolve(__dirname, '..');const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-semantic-radar-'));+const chromePath = process.env.ARCHIFY_CHROME ? findChrome() : null;const CASES = {architecture: 'web-app.architecture.json',@@ -32,11 +35,117 @@ function canonicalSvg(html) {return html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';}+async function evaluate(browser, sessionId, expression, awaitPromise = false) {+ const response = await browser.cdp.send('Runtime.evaluate', {+ expression,+ awaitPromise,+ returnByValue: true,+ }, sessionId);+ if (response.exceptionDetails) {+ throw new Error(response.exceptionDetails.exception?.description+ || response.exceptionDetails.text+ || 'Runtime.evaluate failed');+ }+ return response.result?.value;+}++async function loadArtifact(browser, artifactPath, { width = 1440, height = 900 } = {}) {+ const sessionId = await browser.sessionPromise;+ await browser.cdp.send('Emulation.setDeviceMetricsOverride', {+ width,+ height,+ deviceScaleFactor: 1,+ mobile: false,+ }, sessionId);+ const loaded = browser.cdp.waitFor('Page.loadEventFired', sessionId);+ const navigation = await browser.cdp.send('Page.navigate', {+ url: pathToFileURL(artifactPath).href,+ }, sessionId);+ if (navigation.errorText) throw new Error(`Chrome navigation failed: ${navigation.errorText}`);+ await loaded;+ await evaluate(browser, sessionId, `(function () {+ document.documentElement.setAttribute('data-motion', 'still');+ var fontsReady = document.fonts && document.fonts.ready+ ? document.fonts.ready.catch(function () {})+ : Promise.resolve();+ return fontsReady.then(function () {+ return new Promise(function (resolve) {+ requestAnimationFrame(function () { requestAnimationFrame(resolve); });+ });+ });+ })()`, true);+ return sessionId;+}++async function radarRects(browser, sessionId, setup) {+ return evaluate(browser, sessionId, `(function () {+ ${setup}+ return new Promise(function (resolve) {+ requestAnimationFrame(function () {+ requestAnimationFrame(function () {+ var radar = document.getElementById('overview-map').getBoundingClientRect();+ var controls = document.querySelector('.diagram-nav').getBoundingClientRect();+ var passport = document.getElementById('focus-chip');+ var passportRect = passport && !passport.hidden ? passport.getBoundingClientRect() : null;+ resolve({+ radar: { left: radar.left, top: radar.top, right: radar.right, bottom: radar.bottom },+ controls: { left: controls.left, top: controls.top, right: controls.right, bottom: controls.bottom },+ passport: passportRect ? {+ left: passportRect.left,+ top: passportRect.top,+ right: passportRect.right,+ bottom: passportRect.bottom+ } : null+ });+ });+ });+ });+ })()`, true);+}++async function dragMouse(browser, sessionId, from, to) {+ await browser.cdp.send('Input.dispatchMouseEvent', {+ type: 'mousePressed',+ x: from.x,+ y: from.y,+ button: 'left',+ buttons: 1,+ clickCount: 1,+ }, sessionId);+ await browser.cdp.send('Input.dispatchMouseEvent', {+ type: 'mouseMoved',+ x: to.x,+ y: to.y,+ button: 'left',+ buttons: 1,+ }, sessionId);+ await browser.cdp.send('Input.dispatchMouseEvent', {+ type: 'mouseReleased',+ x: to.x,+ y: to.y,+ button: 'left',+ buttons: 0,+ clickCount: 1,+ }, sessionId);+ await evaluate(browser, sessionId, `new Promise(function (resolve) {+ requestAnimationFrame(function () { requestAnimationFrame(resolve); });+ })`, true);+}++function overlaps(a, b, gap = 0) {+ return a.left < b.right + gap+ && a.right > b.left - gap+ && a.top < b.bottom + gap+ && a.bottom > b.top - gap;+}+test('all typed renderers inherit one viewer-only Semantic Radar', () => {for (const [mode, example] of Object.entries(CASES)) {const html = render(mode, example);assert.match(html, /id="overview-map" hidden role="region" aria-labelledby="overview-map-title"/, mode);assert.match(html, /id="overview-map-surface" tabindex="0" role="group"/, mode);+ assert.match(html, /id="overview-map-expand"[^>]+aria-label="Open full semantic radar"/, mode);+ assert.match(html, /id="overview-map-feedback" role="status" aria-live="polite" hidden/, mode);assert.match(html, /id="btn-overview-map"[^>]+aria-label="Open semantic radar"[^>]+aria-expanded="false"[^>]+aria-controls="overview-map"/, mode);assert.match(html, /Archify\.radar = \(function \(\)/, mode);assert.match(html, /document\.createElementNS\(namespace, 'svg'\)/, mode);@@ -73,10 +182,17 @@ test('Semantic Radar tracks desktop camera and mobile contained scroll', () => {assert.match(html, /data-wide-diagram="true"\] \.overview-map/);assert.match(html, /function updateDocking\(\)/);assert.match(html, /chip\.style\.top = Math\.round\(top\) \+ 'px';[\s\S]+Archify\.radar\.sync\(\)/);- assert.match(html, /activeRect\.left \+ activeRect\.width \/ 2 > window\.innerWidth \/ 2/);- assert.match(html, /var blockers = \[activeRect, lensRect, legendRect, navRect\]\.filter/);- assert.match(html, /candidates\.push\(rect\.top - 10 - panel\.offsetHeight, rect\.bottom \+ 10\)/);- assert.match(html, /return candidate \+ panel\.offsetHeight <= rect\.top - 10 \|\| candidate >= rect\.bottom \+ 10/);+ assert.match(html, /var navigation = container\.querySelector\('\.diagram-nav'\)/);+ assert.match(html, /if \(controlRect\) bottom = Math\.min\(bottom, controlRect\.top - placementGap\)/);+ assert.match(html, /hardBlockers: \[lensRect, controlRect, legendRect\]\.filter\(Boolean\)/);+ assert.match(html, /function cornerCandidates\(context\)/);+ assert.match(html, /function nearbyCandidates\(context, reference\)/);+ assert.match(html, /nearbyCandidates\(context, reference\)\.concat\(cornerCandidates\(context\)\)/);+ assert.match(html, /var placementOptions = \{ softWeight: manualPosition \? 0 : 100 \}/);+ assert.match(html, /manualPosition && positionIsValid\(manualPosition, context\)/);+ assert.match(html, /panelHead\.addEventListener\('pointerdown', beginPanelDrag\)/);+ assert.match(html, /surface\.addEventListener\('pointerdown',[\s\S]+viewportDrag = \{ pointerId: event\.pointerId \}/);+ assert.match(html, /target\.closest\('\[data-node-id\], \[data-relationship-hit-key\], \.overview-map'\)/);assert.match(html, /--archify-radar-top/);assert.match(html, /\.overview-map\[data-docked="true"\]/);});@@ -95,4 +211,365 @@ test('Semantic Radar keeps redundant accessible navigation and clean exports', (assert.doesNotMatch(canonicalSvg(html), /overview-map-node|overview-map-viewport/);});+test('Semantic Radar stays above the measured MAP control strip', {+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',+}, async () => {+ const artifact = path.join(tmp, 'radar-control-clearance.html');+ execFileSync(process.execPath, [+ path.join(skillRoot, 'renderers/architecture/render-architecture.mjs'),+ path.join(skillRoot, 'examples', CASES.architecture),+ artifact,+ ]);+ const browser = new ChromeVisualBrowser(chromePath);+ try {+ const sessionId = await loadArtifact(browser, artifact, { width: 1440, height: 900 });+ const rects = await radarRects(browser, sessionId, `+ var container = document.querySelector('.diagram-container');+ window.scrollTo(0, Math.max(0, container.offsetTop + container.offsetHeight - window.innerHeight + 8));+ Archify.radar.open();+ `);+ const controlGap = rects.controls.top - rects.radar.bottom;+ assert.ok(controlGap >= 15, JSON.stringify({ ...rects, controlGap }, null, 2));+ assert.ok(+ rects.radar.left < rects.controls.left,+ `automatic placement should prefer the lower-left corner: ${JSON.stringify(rects, null, 2)}`,+ );+ } finally {+ await browser.close();+ }+});++test('Semantic Radar avoids an expanded mobile Passport without hiding a collision', {+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',+}, async () => {+ const artifact = path.join(tmp, 'radar-mobile-passport.html');+ execFileSync(process.execPath, [+ path.join(skillRoot, 'renderers/architecture/render-architecture.mjs'),+ path.join(skillRoot, 'examples', CASES.architecture),+ artifact,+ ]);+ const browser = new ChromeVisualBrowser(chromePath);+ try {+ const sessionId = await loadArtifact(browser, artifact, { width: 390, height: 600 });+ const state = await evaluate(browser, sessionId, `(function () {+ var container = document.querySelector('.diagram-container');+ window.scrollTo(0, Math.max(0, container.offsetTop));+ Archify.focus.set('lb', { toggle: false });+ document.getElementById('btn-focus-relations').click();+ Archify.radar.open();+ return new Promise(function (resolve) {+ setTimeout(function () {+ var radar = document.getElementById('overview-map');+ var radarRect = radar.getBoundingClientRect();+ var passportRect = document.getElementById('focus-chip').getBoundingClientRect();+ var containerRect = document.querySelector('.diagram-container').getBoundingClientRect();+ var controlsRect = document.querySelector('.diagram-nav').getBoundingClientRect();+ var legendRect = document.querySelector('[data-legend]').getBoundingClientRect();+ resolve({+ radar: { left: radarRect.left, top: radarRect.top, right: radarRect.right, bottom: radarRect.bottom },+ passport: { left: passportRect.left, top: passportRect.top, right: passportRect.right, bottom: passportRect.bottom },+ container: { left: containerRect.left, top: containerRect.top, right: containerRect.right, bottom: containerRect.bottom },+ controls: { left: controlsRect.left, top: controlsRect.top, right: controlsRect.right, bottom: controlsRect.bottom },+ legend: { left: legendRect.left, top: legendRect.top, right: legendRect.right, bottom: legendRect.bottom },+ viewport: { width: window.innerWidth, height: window.innerHeight },+ invalid: radar.getAttribute('data-placement-invalid'),+ compact: radar.getAttribute('data-compact'),+ unavailable: radar.getAttribute('data-placement-unavailable')+ });+ }, 180);+ });+ })()`, true);+ assert.equal(overlaps(state.radar, state.passport, 10), false, JSON.stringify(state, null, 2));+ assert.notEqual(state.invalid, 'true', JSON.stringify(state, null, 2));+ assert.equal(state.compact, 'true', JSON.stringify(state, null, 2));++ const expanded = await evaluate(browser, sessionId, `(function () {+ document.getElementById('overview-map-expand').click();+ return new Promise(function (resolve) {+ setTimeout(function () {+ var radar = document.getElementById('overview-map');+ var rect = radar.getBoundingClientRect();+ var passport = document.getElementById('focus-chip');+ resolve({+ compact: radar.getAttribute('data-compact'),+ height: rect.height,+ surfaceVisible: getComputedStyle(document.getElementById('overview-map-surface')).display !== 'none',+ passportYielded: passport.getAttribute('data-radar-yielded'),+ passportVisible: getComputedStyle(passport).display !== 'none'+ });+ }, 120);+ });+ })()`, true);+ assert.equal(expanded.compact, null, JSON.stringify(expanded, null, 2));+ assert.equal(expanded.surfaceVisible, true, JSON.stringify(expanded, null, 2));+ assert.equal(expanded.passportYielded, 'true', JSON.stringify(expanded, null, 2));+ assert.equal(expanded.passportVisible, false, JSON.stringify(expanded, null, 2));+ assert.ok(expanded.height > state.radar.bottom - state.radar.top, JSON.stringify({ state, expanded }, null, 2));++ const closed = await evaluate(browser, sessionId, `(function () {+ document.getElementById('overview-map-close').click();+ var passport = document.getElementById('focus-chip');+ return {+ radarHidden: document.getElementById('overview-map').hidden,+ passportYielded: passport.getAttribute('data-radar-yielded'),+ passportVisible: getComputedStyle(passport).display !== 'none'+ };+ })()`);+ assert.equal(closed.radarHidden, true, JSON.stringify(closed, null, 2));+ assert.equal(closed.passportYielded, null, JSON.stringify(closed, null, 2));+ assert.equal(closed.passportVisible, true, JSON.stringify(closed, null, 2));+ } finally {+ await browser.close();+ }+});++test('Semantic Radar reports a consistent unavailable state and recovers when space returns', {+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',+}, async () => {+ const artifact = path.join(tmp, 'radar-unavailable.html');+ execFileSync(process.execPath, [+ path.join(skillRoot, 'renderers/architecture/render-architecture.mjs'),+ path.join(skillRoot, 'examples', CASES.architecture),+ artifact,+ ]);+ const browser = new ChromeVisualBrowser(chromePath);+ try {+ const sessionId = await loadArtifact(browser, artifact, { width: 390, height: 300 });+ const unavailable = await evaluate(browser, sessionId, `(function () {+ var container = document.querySelector('.diagram-container');+ window.scrollTo(0, Math.max(0, container.offsetTop));+ Archify.focus.set('lb', { toggle: false });+ document.getElementById('btn-focus-relations').click();+ Archify.radar.open();+ return new Promise(function (resolve) {+ setTimeout(function () {+ var panel = document.getElementById('overview-map');+ var trigger = document.getElementById('btn-overview-map');+ var feedback = document.getElementById('overview-map-feedback');+ resolve({+ panelHidden: panel.hidden,+ expanded: trigger.getAttribute('aria-expanded'),+ limited: trigger.getAttribute('data-radar-space-limited'),+ feedbackHidden: feedback.hidden,+ feedback: feedback.textContent.trim()+ });+ }, 260);+ });+ })()`, true);+ assert.equal(unavailable.panelHidden, true, JSON.stringify(unavailable, null, 2));+ assert.equal(unavailable.expanded, 'false', JSON.stringify(unavailable, null, 2));+ assert.equal(unavailable.limited, 'true', JSON.stringify(unavailable, null, 2));+ assert.equal(unavailable.feedbackHidden, false, JSON.stringify(unavailable, null, 2));+ assert.match(unavailable.feedback, /space/i);++ await browser.cdp.send('Emulation.setDeviceMetricsOverride', {+ width: 390,+ height: 600,+ deviceScaleFactor: 1,+ mobile: false,+ }, sessionId);+ const recovered = await evaluate(browser, sessionId, `new Promise(function (resolve) {+ setTimeout(function () {+ var panel = document.getElementById('overview-map');+ var trigger = document.getElementById('btn-overview-map');+ var feedback = document.getElementById('overview-map-feedback');+ resolve({+ panelHidden: panel.hidden,+ expanded: trigger.getAttribute('aria-expanded'),+ feedbackHidden: feedback.hidden+ });+ }, 260);+ })`, true);+ assert.equal(recovered.panelHidden, false, JSON.stringify(recovered, null, 2));+ assert.equal(recovered.expanded, 'true', JSON.stringify(recovered, null, 2));+ assert.equal(recovered.feedbackHidden, true, JSON.stringify(recovered, null, 2));+ } finally {+ await browser.close();+ }+});++test('Semantic Radar automatically avoids a tall Semantic Passport', {+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',+}, async () => {+ const input = path.join(tmp, 'tall-passport.architecture.json');+ const artifact = path.join(tmp, 'tall-passport.html');+ const peers = Array.from({ length: 12 }, (_, index) => ({+ id: `peer-${index + 1}`,+ type: index % 2 ? 'backend' : 'database',+ label: `Peer ${index + 1}`,+ sublabel: 'Connected system',+ pos: [80, 40 + index * 90],+ size: [130, 60],+ }));+ fs.writeFileSync(input, JSON.stringify({+ schema_version: 1,+ diagram_type: 'architecture',+ meta: { title: 'Tall Passport Radar Regression', output: artifact },+ components: [+ ...peers,+ { id: 'hub', type: 'security', label: 'Relationship Hub', sublabel: 'Many authored links', pos: [900, 500], size: [150, 70] },+ ],+ boundaries: [],+ connections: peers.map((peer, index) => ({+ id: `hub-to-${peer.id}`,+ from: 'hub',+ to: peer.id,+ fromSide: 'left',+ toSide: 'right',+ via: [[840, 535], [840, peer.pos[1] + 30]],+ })),+ cards: [],+ }, null, 2));+ execFileSync(process.execPath, [+ path.join(skillRoot, 'renderers/architecture/render-architecture.mjs'),+ input,+ artifact,+ ]);+ const browser = new ChromeVisualBrowser(chromePath);+ try {+ const sessionId = await loadArtifact(browser, artifact, { width: 1200, height: 700 });+ const rects = await radarRects(browser, sessionId, `+ var container = document.querySelector('.diagram-container');+ window.scrollTo(0, Math.max(0, container.offsetTop));+ Archify.focus.set('hub', { toggle: false });+ Archify.radar.open();+ `);+ assert.ok(rects.passport, JSON.stringify(rects, null, 2));+ assert.equal(overlaps(rects.radar, rects.passport, 10), false, JSON.stringify(rects, null, 2));++ const dragGeometry = await evaluate(browser, sessionId, `(function () {+ var radar = document.getElementById('overview-map').getBoundingClientRect();+ var head = document.querySelector('.overview-map-head').getBoundingClientRect();+ var passport = document.getElementById('focus-chip').getBoundingClientRect();+ var active = document.querySelector('[data-focus-selected]');+ var nearestLeft = passport.right + 16;+ active.getBoundingClientRect = function () {+ return {+ left: nearestLeft,+ top: radar.top,+ right: nearestLeft + radar.width,+ bottom: radar.top + radar.height,+ width: radar.width,+ height: radar.height+ };+ };+ return {+ radar: { left: radar.left, top: radar.top },+ head: { left: head.left, top: head.top, height: head.height },+ requested: { left: passport.right + 8, top: radar.top },+ nearest: { left: nearestLeft, top: radar.top }+ };+ })()`);+ await dragMouse(browser, sessionId, {+ x: dragGeometry.head.left + 48,+ y: dragGeometry.head.top + dragGeometry.head.height / 2,+ }, {+ x: dragGeometry.head.left + 48 + dragGeometry.requested.left - dragGeometry.radar.left,+ y: dragGeometry.head.top + dragGeometry.head.height / 2 + dragGeometry.requested.top - dragGeometry.radar.top,+ });+ const snappedRects = await radarRects(browser, sessionId, '');+ assert.equal(overlaps(snappedRects.radar, snappedRects.passport, 10), false, JSON.stringify(snappedRects, null, 2));+ assert.ok(Math.abs(snappedRects.radar.left - dragGeometry.nearest.left) <= 2, JSON.stringify({ dragGeometry, snappedRects }, null, 2));+ assert.ok(Math.abs(snappedRects.radar.top - dragGeometry.nearest.top) <= 2, JSON.stringify({ dragGeometry, snappedRects }, null, 2));+ } finally {+ await browser.close();+ }+});++test('Semantic Radar titlebar drag persists while surface drag still pans the diagram', {+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',+}, async () => {+ const artifact = path.join(tmp, 'radar-dragging.html');+ execFileSync(process.execPath, [+ path.join(skillRoot, 'renderers/architecture/render-architecture.mjs'),+ path.join(skillRoot, 'examples', CASES.architecture),+ artifact,+ ]);+ const browser = new ChromeVisualBrowser(chromePath);+ try {+ const sessionId = await loadArtifact(browser, artifact, { width: 1440, height: 900 });+ const geometry = await evaluate(browser, sessionId, `(function () {+ var container = document.querySelector('.diagram-container');+ window.scrollTo(0, Math.max(0, container.offsetTop + container.offsetHeight - window.innerHeight + 8));+ Archify.radar.open();+ var radar = document.getElementById('overview-map').getBoundingClientRect();+ var head = document.querySelector('.overview-map-head').getBoundingClientRect();+ var containerRect = container.getBoundingClientRect();+ return {+ radar: { left: radar.left, top: radar.top, width: radar.width, height: radar.height },+ head: { left: head.left, top: head.top, width: head.width, height: head.height },+ state: Archify.view.state(),+ target: {+ left: Math.max(24, containerRect.left + 360),+ top: Math.max(24, containerRect.top + 20)+ }+ };+ })()`);+ const titleStart = {+ x: geometry.head.left + 48,+ y: geometry.head.top + geometry.head.height / 2,+ };+ const titleTarget = {+ x: titleStart.x + geometry.target.left - geometry.radar.left,+ y: titleStart.y + geometry.target.top - geometry.radar.top,+ };+ await dragMouse(browser, sessionId, titleStart, titleTarget);++ const manuallyPlaced = await evaluate(browser, sessionId, `(function () {+ Archify.radar.sync();+ var radar = document.getElementById('overview-map').getBoundingClientRect();+ return { left: radar.left, top: radar.top, state: Archify.view.state() };+ })()`);+ assert.ok(Math.abs(manuallyPlaced.left - geometry.target.left) <= 2, JSON.stringify({ geometry, manuallyPlaced }, null, 2));+ assert.ok(Math.abs(manuallyPlaced.top - geometry.target.top) <= 2, JSON.stringify({ geometry, manuallyPlaced }, null, 2));+ assert.deepEqual(manuallyPlaced.state, geometry.state);++ const surfaceState = await evaluate(browser, sessionId, `(function () {+ var radar = document.getElementById('overview-map').getBoundingClientRect();+ var surface = document.getElementById('overview-map-surface').getBoundingClientRect();+ return {+ radar: { left: radar.left, top: radar.top },+ state: Archify.view.state(),+ start: { x: surface.left + 8, y: surface.top + 8 },+ end: { x: surface.right - 8, y: surface.bottom - 8 }+ };+ })()`);+ await dragMouse(browser, sessionId, surfaceState.start, surfaceState.end);+ const afterSurfaceDrag = await evaluate(browser, sessionId, `(function () {+ var radar = document.getElementById('overview-map').getBoundingClientRect();+ return {+ radar: { left: radar.left, top: radar.top },+ state: Archify.view.state()+ };+ })()`);+ assert.deepEqual(afterSurfaceDrag.radar, surfaceState.radar);+ assert.notDeepEqual(afterSurfaceDrag.state, surfaceState.state);++ await browser.cdp.send('Emulation.setDeviceMetricsOverride', {+ width: 640,+ height: 700,+ deviceScaleFactor: 1,+ mobile: false,+ }, sessionId);+ const afterResize = await evaluate(browser, sessionId, `new Promise(function (resolve) {+ setTimeout(function () {+ var radar = document.getElementById('overview-map').getBoundingClientRect();+ var controls = document.querySelector('.diagram-nav').getBoundingClientRect();+ var container = document.querySelector('.diagram-container').getBoundingClientRect();+ resolve({+ radar: { left: radar.left, top: radar.top, right: radar.right, bottom: radar.bottom },+ controls: { left: controls.left, top: controls.top, right: controls.right, bottom: controls.bottom },+ container: { left: container.left, top: container.top, right: container.right, bottom: container.bottom },+ viewport: { width: window.innerWidth, height: window.innerHeight }+ });+ }, 120);+ })`, true);+ assert.ok(afterResize.radar.left >= Math.max(0, afterResize.container.left), JSON.stringify(afterResize, null, 2));+ assert.ok(afterResize.radar.right <= Math.min(afterResize.viewport.width, afterResize.container.right), JSON.stringify(afterResize, null, 2));+ assert.equal(overlaps(afterResize.radar, afterResize.controls, 10), false, JSON.stringify(afterResize, null, 2));+ } finally {+ await browser.close();+ }+});+process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));diff --git a/archify/test/viewer-chrome-layout.test.mjs b/archify/test/viewer-chrome-layout.test.mjsindex cc35ff4b..3ee20dc5 100644--- a/archify/test/viewer-chrome-layout.test.mjs+++ b/archify/test/viewer-chrome-layout.test.mjs@@ -117,11 +117,13 @@ async function finalGeometry(browser, sessionId) {var svg = container && container.querySelector(':scope > svg');var lens = document.getElementById('semantic-lens');var radar = document.getElementById('overview-map');+ var passport = document.getElementById('focus-chip');var legendRect = legend && getComputedStyle(legend).display !== 'none' ? legend.getBoundingClientRect() : null;var navRect = nav && getComputedStyle(nav).display !== 'none' ? nav.getBoundingClientRect() : null;var svgRect = svg ? svg.getBoundingClientRect() : null;var lensRect = lens && !lens.hidden && getComputedStyle(lens).display !== 'none' ? lens.getBoundingClientRect() : null;var radarRect = radar && !radar.hidden && getComputedStyle(radar).display !== 'none' ? radar.getBoundingClientRect() : null;+ var passportRect = passport && !passport.hidden && getComputedStyle(passport).display !== 'none' ? passport.getBoundingClientRect() : null;return {reserve: parseFloat(getComputedStyle(container).getPropertyValue('--archify-nav-reserve')) || 0,stageGap: navRect && svgRect ? navRect.top - svgRect.bottom : null,@@ -130,8 +132,13 @@ async function finalGeometry(browser, sessionId) {navLensIntersectionArea: area(navRect, lensRect),legendRadarIntersectionArea: area(legendRect, radarRect),navRadarIntersectionArea: area(navRect, radarRect),+ legendPassportIntersectionArea: area(legendRect, passportRect),+ navPassportIntersectionArea: area(navRect, passportRect),+ radarPassportIntersectionArea: area(radarRect, passportRect),legendRect: legendRect ? { left: legendRect.left, right: legendRect.right, top: legendRect.top, bottom: legendRect.bottom } : null,navRect: navRect ? { left: navRect.left, right: navRect.right, top: navRect.top, bottom: navRect.bottom } : null,+ passportRect: passportRect ? { left: passportRect.left, right: passportRect.right, top: passportRect.top, bottom: passportRect.bottom } : null,+ radarRect: radarRect ? { left: radarRect.left, right: radarRect.right, top: radarRect.top, bottom: radarRect.bottom } : null,hasLegend: Boolean(legendRect && legendRect.width && legendRect.height)};})()`);@@ -421,6 +428,40 @@ test('Semantic Lens and Radar protect the final Legend and Dock rectangles', {}});+test('Radar, Passport, Legend, and Dock remain mutually clear on desktop and narrow viewports', {+ skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',+}, async () => {+ const browser = new ChromeVisualBrowser(chromePath);+ try {+ const artifact = render('architecture', CASES.architecture);+ for (const viewport of [+ { width: 1440, height: 900, label: 'desktop' },+ { width: 390, height: 600, label: 'narrow' },+ ]) {+ const sessionId = await load(browser, artifact, viewport);+ await evaluate(browser, sessionId, `(function () {+ var container = document.querySelector('.diagram-container');+ window.scrollTo(0, Math.max(0, container.offsetTop));+ Archify.focus.set('lb', { toggle: false });+ Archify.radar.open();+ window.dispatchEvent(new Event('resize'));+ })()`);+ await waitForLayout(browser, sessionId);+ const receipt = await finalGeometry(browser, sessionId);+ const message = viewport.label + ': ' + JSON.stringify(receipt);++ assert.equal(receipt.legendDockIntersectionArea, 0, message);+ assert.equal(receipt.legendPassportIntersectionArea, 0, message);+ assert.equal(receipt.navPassportIntersectionArea, 0, message);+ assert.equal(receipt.legendRadarIntersectionArea, 0, message);+ assert.equal(receipt.navRadarIntersectionArea, 0, message);+ assert.equal(receipt.radarPassportIntersectionArea, 0, message);+ }+ } finally {+ await browser.close();+ }+});+test('mobile, embed, hidden Legend, and print keep reserve at zero', {skip: chromePath ? false : 'Set ARCHIFY_CHROME to run the real browser regression.',}, async () => {diff --git a/docs/assets/archify-live-proof.gif b/docs/assets/archify-live-proof.gifindex 608f691c..a9c95d06 100644Binary files a/docs/assets/archify-live-proof.gif and b/docs/assets/archify-live-proof.gif differdiff --git a/docs/assets/archify-live-proof.json b/docs/assets/archify-live-proof.jsonindex 40bb3287..26ff6c0c 100644--- a/docs/assets/archify-live-proof.json+++ b/docs/assets/archify-live-proof.json@@ -7,13 +7,13 @@"fps": 10,"frameCount": 54,"durationSeconds": 5.4,- "bytes": 1587643,- "sha256": "39b0435a28b48d262d7cade9fc07f2a95fe5b88927a436667d047ed5c9b80b85",+ "bytes": 1701629,+ "sha256": "7a63605c59e8edecd1c03292275b8d0dd73f07ade8703eeee42b8780eef63a73","scenes": [{"id": "signal-flow","artifact": "docs/gallery/artifacts/agent-tool-call.workflow.html",- "artifactSha256": "1bd86d288342e5d8ccbc92e5671171195f581e7aa2b0e477d557a5b6924f2647",+ "artifactSha256": "8dc60c7af65f6ab7f54df9a7bbc1ff81048ccd4074833b4a0cf48973b314ec57","view": "happy-path","eyebrow": "WORKFLOW · SIGNAL FLOW","title": "Agent Tool Call",@@ -22,7 +22,7 @@{"id": "blueprint","artifact": "docs/gallery/artifacts/production-deployment.architecture.html",- "artifactSha256": "ad4901d2f507cef6a8692e199a06334780cf1ef13176f4656bb2a2a08faf2808",+ "artifactSha256": "c36f566c66cc66c5ca5cc2c4d3545f19725d1655f3dd841497920a984f43d1bc","view": "request-boundary","eyebrow": "ARCHITECTURE · BLUEPRINT","title": "Production Deployment",@@ -31,7 +31,7 @@{"id": "classic","artifact": "docs/gallery/artifacts/cache-miss.sequence.html",- "artifactSha256": "2056359a30ffae1948874761fcbcbdc2401062584008681c18565d56310c028d",+ "artifactSha256": "e2968c2ae39ca95a7b69029bbda161f97a28bd21c3c14fca76e8e6ddf7a406fd","view": "cache-fallback","eyebrow": "SEQUENCE · CLASSIC","title": "Cache Miss Request",diff --git a/docs/gallery.html b/docs/gallery.htmlindex 7a65f3d1..46a930cd 100644--- a/docs/gallery.html+++ b/docs/gallery.html@@ -339,7 +339,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">12N · 11E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="1bd86d288342e5d8ccbc92e5671171195f581e7aa2b0e477d557a5b6924f2647">1bd86d288342</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="8dc60c7af65f6ab7f54df9a7bbc1ff81048ccd4074833b4a0cf48973b314ec57">8dc60c7af65f</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/agent-tool-call.workflow.html?present=1&play=1#view=happy-path" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -369,7 +369,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">12N · 12E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="ad4901d2f507cef6a8692e199a06334780cf1ef13176f4656bb2a2a08faf2808">ad4901d2f507</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="c36f566c66cc66c5ca5cc2c4d3545f19725d1655f3dd841497920a984f43d1bc">c36f566c66cc</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/production-deployment.architecture.html?present=1&play=1#view=request-boundary" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -398,7 +398,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">7N · 12E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="2056359a30ffae1948874761fcbcbdc2401062584008681c18565d56310c028d">2056359a30ff</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="e2968c2ae39ca95a7b69029bbda161f97a28bd21c3c14fca76e8e6ddf7a406fd">e2968c2ae39c</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/cache-miss.sequence.html?present=1&play=1#view=cache-fallback" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -427,7 +427,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 10E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="e57652c5d56168774c3133ad7864adda2bd9a1195b6672ad49e2c55da12497c2">e57652c5d561</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="3011dcbd9e6277d95d9d0d78aa02f384647f63476f7ff697ef9b3dd98342f51b">3011dcbd9e62</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/release-delivery.workflow.html?present=1&play=1#view=approval-to-production" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -456,7 +456,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">11N · 10E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="b4050780e9e2e9fe567ea34fb8b10412f667da0d66b4fc31730e222964ba1a03">b4050780e9e2</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="2fe192787f61c817fb3facb47822e2e2941e6787dd601f9ce99b653e3c5ecfbd">2fe192787f61</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/incident-response.workflow.html?present=1&play=1#view=mitigate-and-verify" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -485,7 +485,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 10E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="26aaa3815bffa920a5f28a7ca034880ef49e7a099fc190aa52ab771356c91db2">26aaa3815bff</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="f079c0d9762d85f562fe56566d3571da0592e21c62f73e1337fb22f4bf29a804">f079c0d9762d</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/product-analytics.dataflow.html?present=1&play=1#view=consent-boundary" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -514,7 +514,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">7N · 14E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="9f7c01124c11ceee6eeb28b66cafea2595da9d491a28aca92897bf057baf74d9">9f7c01124c11</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="fd8715ba977c0b63278b49310a757850dc3a72167bc51115977c06c728d7e26b">fd8715ba977c</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/async-job-roundtrip.sequence.html?present=1&play=1#view=work-and-retry" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -543,7 +543,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">12N · 12E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="45475994137e2ec4791067d7a78d38441e4a968e7957ecadcd0f2071e3be90af">45475994137e</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="349d22dc2ec7ddf7b81af61a34860ee0232d0911a9094ab87076bdc9b056bbb3">349d22dc2ec7</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/event-stream.dataflow.html?present=1&play=1#view=order-transit" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -572,7 +572,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 6E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="f5ecaa6f9852be1324ae68352ca6f637590c0a0d1681afa4fcbae95d66f4db7a">f5ecaa6f9852</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="76f6151e43cac58593e756a40ef16b3bc01447a71489444c51c6b4e536f34814">76f6151e43ca</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/agent-run.lifecycle.html?present=1&play=1#view=main-lifecycle" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -601,7 +601,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">11N · 6E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="ead5d13c9c75003785bd1cd499d748d405887fc74a54e3d6d952063595f2c6f0">ead5d13c9c75</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="56e29cc80624778f56b34ceae7df64feb369c5c8cdb39cadf6b843c9124e347c">56e29cc80624</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/deployment-release.lifecycle.html?present=1&play=1#view=rollback-outcomes" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -630,7 +630,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 9E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="7b91e4febd662a633f0754930dc34e91db692225d3cd7504ff6c5c01ed9bb86b">7b91e4febd66</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="3d949a8b9546616143e2adeb626aa27f9420e96061fbf1e512570caedb9297b3">3d949a8b9546</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/web-app.architecture.html?present=1&play=1#view=request-path" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -716,8 +716,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 12,"edgeCount": 11,- "artifactBytes": 658874,- "artifactSha256": "1bd86d288342e5d8ccbc92e5671171195f581e7aa2b0e477d557a5b6924f2647",+ "artifactBytes": 678767,+ "artifactSha256": "8dc60c7af65f6ab7f54df9a7bbc1ff81048ccd4074833b4a0cf48973b314ec57","sourceBytes": 6367,"sourceSha256": "9c94c8c0b2104478b77befb4cc5e343d381acba6e66645ab17616fde20b60e05","checks": [@@ -816,8 +816,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": "deployment-ownership","nodeCount": 12,"edgeCount": 12,- "artifactBytes": 663275,- "artifactSha256": "ad4901d2f507cef6a8692e199a06334780cf1ef13176f4656bb2a2a08faf2808",+ "artifactBytes": 683168,+ "artifactSha256": "c36f566c66cc66c5ca5cc2c4d3545f19725d1655f3dd841497920a984f43d1bc","sourceBytes": 5476,"sourceSha256": "ec484aa8576664fdb207b543fa49486b23273faccb7a5071e1a0becfb48c22eb","checks": [@@ -916,8 +916,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 7,"edgeCount": 12,- "artifactBytes": 655291,- "artifactSha256": "2056359a30ffae1948874761fcbcbdc2401062584008681c18565d56310c028d",+ "artifactBytes": 675184,+ "artifactSha256": "e2968c2ae39ca95a7b69029bbda161f97a28bd21c3c14fca76e8e6ddf7a406fd","sourceBytes": 4345,"sourceSha256": "4bbaa6ca3cd4036002fd5d0f3a332eb922cec69d09bac3d7925f95beb4308389","checks": [@@ -1016,8 +1016,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 10,"edgeCount": 10,- "artifactBytes": 657666,- "artifactSha256": "e57652c5d56168774c3133ad7864adda2bd9a1195b6672ad49e2c55da12497c2",+ "artifactBytes": 677559,+ "artifactSha256": "3011dcbd9e6277d95d9d0d78aa02f384647f63476f7ff697ef9b3dd98342f51b","sourceBytes": 5164,"sourceSha256": "e5c880417eac1623923c3dd5461e0c78acd762e1621a28bd53fc14a84cad6a91","checks": [@@ -1116,8 +1116,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 11,"edgeCount": 10,- "artifactBytes": 654995,- "artifactSha256": "b4050780e9e2e9fe567ea34fb8b10412f667da0d66b4fc31730e222964ba1a03",+ "artifactBytes": 674888,+ "artifactSha256": "2fe192787f61c817fb3facb47822e2e2941e6787dd601f9ce99b653e3c5ecfbd","sourceBytes": 5375,"sourceSha256": "5c760c82eee545dfb7da38a4e628059d7891af4cfbfc13c8a7009ea64f69aa1b","checks": [@@ -1216,8 +1216,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 10,"edgeCount": 10,- "artifactBytes": 658924,- "artifactSha256": "26aaa3815bffa920a5f28a7ca034880ef49e7a099fc190aa52ab771356c91db2",+ "artifactBytes": 678817,+ "artifactSha256": "f079c0d9762d85f562fe56566d3571da0592e21c62f73e1337fb22f4bf29a804","sourceBytes": 5627,"sourceSha256": "6fa38a7ccedf96da592d60b392783b846188eaa3ec9136c6dc06ca020e43a110","checks": [@@ -1316,8 +1316,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 7,"edgeCount": 14,- "artifactBytes": 655701,- "artifactSha256": "9f7c01124c11ceee6eeb28b66cafea2595da9d491a28aca92897bf057baf74d9",+ "artifactBytes": 675594,+ "artifactSha256": "fd8715ba977c0b63278b49310a757850dc3a72167bc51115977c06c728d7e26b","sourceBytes": 4370,"sourceSha256": "545f20920c89b69c2bb1f15508d5543fddbeb15cffba61e102206e04bd5a5cd9","checks": [@@ -1416,8 +1416,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 12,"edgeCount": 12,- "artifactBytes": 662875,- "artifactSha256": "45475994137e2ec4791067d7a78d38441e4a968e7957ecadcd0f2071e3be90af",+ "artifactBytes": 682768,+ "artifactSha256": "349d22dc2ec7ddf7b81af61a34860ee0232d0911a9094ab87076bdc9b056bbb3","sourceBytes": 5433,"sourceSha256": "a92d6597ddbe164f395da32a7d4b33cfae08edd7d9600a6fb45a2058e5bbb43e","checks": [@@ -1516,8 +1516,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 10,"edgeCount": 6,- "artifactBytes": 652559,- "artifactSha256": "f5ecaa6f9852be1324ae68352ca6f637590c0a0d1681afa4fcbae95d66f4db7a",+ "artifactBytes": 672452,+ "artifactSha256": "76f6151e43cac58593e756a40ef16b3bc01447a71489444c51c6b4e536f34814","sourceBytes": 4417,"sourceSha256": "af939579dcafc8b4c49f09594591577994398aee57a57369d4c791dfc0d85a42","checks": [@@ -1616,8 +1616,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 11,"edgeCount": 6,- "artifactBytes": 653545,- "artifactSha256": "ead5d13c9c75003785bd1cd499d748d405887fc74a54e3d6d952063595f2c6f0",+ "artifactBytes": 673438,+ "artifactSha256": "56e29cc80624778f56b34ceae7df64feb369c5c8cdb39cadf6b843c9124e347c","sourceBytes": 4274,"sourceSha256": "735c2c5819266e6ea2a71775b6eefce98b53030ce90cb721dc8e1d022ce5be71","checks": [@@ -1716,8 +1716,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 10,"edgeCount": 9,- "artifactBytes": 653637,- "artifactSha256": "7b91e4febd662a633f0754930dc34e91db692225d3cd7504ff6c5c01ed9bb86b",+ "artifactBytes": 673530,+ "artifactSha256": "3d949a8b9546616143e2adeb626aa27f9420e96061fbf1e512570caedb9297b3","sourceBytes": 3793,"sourceSha256": "483350f5297df682aba4e4a0fa491307ce3d3abd725ae4df07fab177490752cf","checks": [diff --git a/docs/gallery/artifacts/agent-run.lifecycle.html b/docs/gallery/artifacts/agent-run.lifecycle.htmlindex 70742acd..d7172705 100644--- a/docs/gallery/artifacts/agent-run.lifecycle.html+++ b/docs/gallery/artifacts/agent-run.lifecycle.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5297,11 +5369,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8330,6 +8404,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8601,7 +8714,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11451,18 +11564,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11507,62 +11634,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11583,6 +11942,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11593,25 +11956,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11656,31 +12025,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11713,8 +12142,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11723,7 +12176,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/docs/gallery/artifacts/agent-tool-call.workflow.html b/docs/gallery/artifacts/agent-tool-call.workflow.htmlindex 41c328fb..f5373ec9 100644--- a/docs/gallery/artifacts/agent-tool-call.workflow.html+++ b/docs/gallery/artifacts/agent-tool-call.workflow.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5342,11 +5414,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8378,6 +8452,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8649,7 +8762,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11499,18 +11612,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11555,62 +11682,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11631,6 +11990,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11641,25 +12004,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11704,31 +12073,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11761,8 +12190,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11771,7 +12224,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/docs/gallery/artifacts/async-job-roundtrip.sequence.html b/docs/gallery/artifacts/async-job-roundtrip.sequence.htmlindex fd0ce931..793e0ab5 100644--- a/docs/gallery/artifacts/async-job-roundtrip.sequence.html+++ b/docs/gallery/artifacts/async-job-roundtrip.sequence.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5375,11 +5447,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8408,6 +8482,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8679,7 +8792,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11529,18 +11642,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11585,62 +11712,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11661,6 +12020,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11671,25 +12034,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11734,31 +12103,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11791,8 +12220,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11801,7 +12254,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/docs/gallery/artifacts/cache-miss.sequence.html b/docs/gallery/artifacts/cache-miss.sequence.htmlindex 802dccfd..e93eef5f 100644--- a/docs/gallery/artifacts/cache-miss.sequence.html+++ b/docs/gallery/artifacts/cache-miss.sequence.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5363,11 +5435,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8396,6 +8470,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8667,7 +8780,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11517,18 +11630,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11573,62 +11700,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11649,6 +12008,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11659,25 +12022,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11722,31 +12091,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11779,8 +12208,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11789,7 +12242,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/docs/gallery/artifacts/deployment-release.lifecycle.html b/docs/gallery/artifacts/deployment-release.lifecycle.htmlindex 0dc90dbb..abcc22d4 100644--- a/docs/gallery/artifacts/deployment-release.lifecycle.html+++ b/docs/gallery/artifacts/deployment-release.lifecycle.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5309,11 +5381,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8342,6 +8416,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8613,7 +8726,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11463,18 +11576,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11519,62 +11646,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11595,6 +11954,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11605,25 +11968,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11668,31 +12037,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11725,8 +12154,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11735,7 +12188,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/docs/gallery/artifacts/event-stream.dataflow.html b/docs/gallery/artifacts/event-stream.dataflow.htmlindex 28ef8d49..4cfc840f 100644--- a/docs/gallery/artifacts/event-stream.dataflow.html+++ b/docs/gallery/artifacts/event-stream.dataflow.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5387,11 +5459,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8420,6 +8494,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8691,7 +8804,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11541,18 +11654,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11597,62 +11724,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11673,6 +12032,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11683,25 +12046,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11746,31 +12115,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11803,8 +12232,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11813,7 +12266,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/docs/gallery/artifacts/incident-response.workflow.html b/docs/gallery/artifacts/incident-response.workflow.htmlindex fc84515a..67f5289a 100644--- a/docs/gallery/artifacts/incident-response.workflow.html+++ b/docs/gallery/artifacts/incident-response.workflow.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5314,11 +5386,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8347,6 +8421,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8618,7 +8731,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11468,18 +11581,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11524,62 +11651,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11600,6 +11959,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11610,25 +11973,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11673,31 +12042,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11730,8 +12159,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11740,7 +12193,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/docs/gallery/artifacts/product-analytics.dataflow.html b/docs/gallery/artifacts/product-analytics.dataflow.htmlindex 2ba52bf5..00961186 100644--- a/docs/gallery/artifacts/product-analytics.dataflow.html+++ b/docs/gallery/artifacts/product-analytics.dataflow.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5348,11 +5420,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8381,6 +8455,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8652,7 +8765,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11502,18 +11615,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11558,62 +11685,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11634,6 +11993,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11644,25 +12007,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11707,31 +12076,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11764,8 +12193,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11774,7 +12227,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/docs/gallery/artifacts/production-deployment.architecture.html b/docs/gallery/artifacts/production-deployment.architecture.htmlindex bd49167b..42788a8b 100644--- a/docs/gallery/artifacts/production-deployment.architecture.html+++ b/docs/gallery/artifacts/production-deployment.architecture.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5379,11 +5451,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8412,6 +8486,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8683,7 +8796,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11533,18 +11646,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11589,62 +11716,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11665,6 +12024,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11675,25 +12038,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11738,31 +12107,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11795,8 +12224,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11805,7 +12258,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/docs/gallery/artifacts/release-delivery.workflow.html b/docs/gallery/artifacts/release-delivery.workflow.htmlindex e5174245..e126df33 100644--- a/docs/gallery/artifacts/release-delivery.workflow.html+++ b/docs/gallery/artifacts/release-delivery.workflow.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5340,11 +5412,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8373,6 +8447,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8644,7 +8757,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11494,18 +11607,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11550,62 +11677,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11626,6 +11985,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11636,25 +11999,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11699,31 +12068,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11756,8 +12185,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11766,7 +12219,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/docs/gallery/artifacts/web-app.architecture.html b/docs/gallery/artifacts/web-app.architecture.htmlindex a1588db3..259a150d 100644--- a/docs/gallery/artifacts/web-app.architecture.html+++ b/docs/gallery/artifacts/web-app.architecture.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5314,11 +5386,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8345,6 +8419,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8616,7 +8729,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11466,18 +11579,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11522,62 +11649,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11598,6 +11957,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11608,25 +11971,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11671,31 +12040,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11728,8 +12157,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11738,7 +12191,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/docs/gallery/manifest.json b/docs/gallery/manifest.jsonindex 66f3ba85..84255f03 100644--- a/docs/gallery/manifest.json+++ b/docs/gallery/manifest.json@@ -27,8 +27,8 @@"engineeringProfile": null,"nodeCount": 12,"edgeCount": 11,- "artifactBytes": 658874,- "artifactSha256": "1bd86d288342e5d8ccbc92e5671171195f581e7aa2b0e477d557a5b6924f2647",+ "artifactBytes": 678767,+ "artifactSha256": "8dc60c7af65f6ab7f54df9a7bbc1ff81048ccd4074833b4a0cf48973b314ec57","sourceBytes": 6367,"sourceSha256": "9c94c8c0b2104478b77befb4cc5e343d381acba6e66645ab17616fde20b60e05","checks": [@@ -127,8 +127,8 @@"engineeringProfile": "deployment-ownership","nodeCount": 12,"edgeCount": 12,- "artifactBytes": 663275,- "artifactSha256": "ad4901d2f507cef6a8692e199a06334780cf1ef13176f4656bb2a2a08faf2808",+ "artifactBytes": 683168,+ "artifactSha256": "c36f566c66cc66c5ca5cc2c4d3545f19725d1655f3dd841497920a984f43d1bc","sourceBytes": 5476,"sourceSha256": "ec484aa8576664fdb207b543fa49486b23273faccb7a5071e1a0becfb48c22eb","checks": [@@ -227,8 +227,8 @@"engineeringProfile": null,"nodeCount": 7,"edgeCount": 12,- "artifactBytes": 655291,- "artifactSha256": "2056359a30ffae1948874761fcbcbdc2401062584008681c18565d56310c028d",+ "artifactBytes": 675184,+ "artifactSha256": "e2968c2ae39ca95a7b69029bbda161f97a28bd21c3c14fca76e8e6ddf7a406fd","sourceBytes": 4345,"sourceSha256": "4bbaa6ca3cd4036002fd5d0f3a332eb922cec69d09bac3d7925f95beb4308389","checks": [@@ -327,8 +327,8 @@"engineeringProfile": null,"nodeCount": 10,"edgeCount": 10,- "artifactBytes": 657666,- "artifactSha256": "e57652c5d56168774c3133ad7864adda2bd9a1195b6672ad49e2c55da12497c2",+ "artifactBytes": 677559,+ "artifactSha256": "3011dcbd9e6277d95d9d0d78aa02f384647f63476f7ff697ef9b3dd98342f51b","sourceBytes": 5164,"sourceSha256": "e5c880417eac1623923c3dd5461e0c78acd762e1621a28bd53fc14a84cad6a91","checks": [@@ -427,8 +427,8 @@"engineeringProfile": null,"nodeCount": 11,"edgeCount": 10,- "artifactBytes": 654995,- "artifactSha256": "b4050780e9e2e9fe567ea34fb8b10412f667da0d66b4fc31730e222964ba1a03",+ "artifactBytes": 674888,+ "artifactSha256": "2fe192787f61c817fb3facb47822e2e2941e6787dd601f9ce99b653e3c5ecfbd","sourceBytes": 5375,"sourceSha256": "5c760c82eee545dfb7da38a4e628059d7891af4cfbfc13c8a7009ea64f69aa1b","checks": [@@ -527,8 +527,8 @@"engineeringProfile": null,"nodeCount": 10,"edgeCount": 10,- "artifactBytes": 658924,- "artifactSha256": "26aaa3815bffa920a5f28a7ca034880ef49e7a099fc190aa52ab771356c91db2",+ "artifactBytes": 678817,+ "artifactSha256": "f079c0d9762d85f562fe56566d3571da0592e21c62f73e1337fb22f4bf29a804","sourceBytes": 5627,"sourceSha256": "6fa38a7ccedf96da592d60b392783b846188eaa3ec9136c6dc06ca020e43a110","checks": [@@ -627,8 +627,8 @@"engineeringProfile": null,"nodeCount": 7,"edgeCount": 14,- "artifactBytes": 655701,- "artifactSha256": "9f7c01124c11ceee6eeb28b66cafea2595da9d491a28aca92897bf057baf74d9",+ "artifactBytes": 675594,+ "artifactSha256": "fd8715ba977c0b63278b49310a757850dc3a72167bc51115977c06c728d7e26b","sourceBytes": 4370,"sourceSha256": "545f20920c89b69c2bb1f15508d5543fddbeb15cffba61e102206e04bd5a5cd9","checks": [@@ -727,8 +727,8 @@"engineeringProfile": null,"nodeCount": 12,"edgeCount": 12,- "artifactBytes": 662875,- "artifactSha256": "45475994137e2ec4791067d7a78d38441e4a968e7957ecadcd0f2071e3be90af",+ "artifactBytes": 682768,+ "artifactSha256": "349d22dc2ec7ddf7b81af61a34860ee0232d0911a9094ab87076bdc9b056bbb3","sourceBytes": 5433,"sourceSha256": "a92d6597ddbe164f395da32a7d4b33cfae08edd7d9600a6fb45a2058e5bbb43e","checks": [@@ -827,8 +827,8 @@"engineeringProfile": null,"nodeCount": 10,"edgeCount": 6,- "artifactBytes": 652559,- "artifactSha256": "f5ecaa6f9852be1324ae68352ca6f637590c0a0d1681afa4fcbae95d66f4db7a",+ "artifactBytes": 672452,+ "artifactSha256": "76f6151e43cac58593e756a40ef16b3bc01447a71489444c51c6b4e536f34814","sourceBytes": 4417,"sourceSha256": "af939579dcafc8b4c49f09594591577994398aee57a57369d4c791dfc0d85a42","checks": [@@ -927,8 +927,8 @@"engineeringProfile": null,"nodeCount": 11,"edgeCount": 6,- "artifactBytes": 653545,- "artifactSha256": "ead5d13c9c75003785bd1cd499d748d405887fc74a54e3d6d952063595f2c6f0",+ "artifactBytes": 673438,+ "artifactSha256": "56e29cc80624778f56b34ceae7df64feb369c5c8cdb39cadf6b843c9124e347c","sourceBytes": 4274,"sourceSha256": "735c2c5819266e6ea2a71775b6eefce98b53030ce90cb721dc8e1d022ce5be71","checks": [@@ -1027,8 +1027,8 @@"engineeringProfile": null,"nodeCount": 10,"edgeCount": 9,- "artifactBytes": 653637,- "artifactSha256": "7b91e4febd662a633f0754930dc34e91db692225d3cd7504ff6c5c01ed9bb86b",+ "artifactBytes": 673530,+ "artifactSha256": "3d949a8b9546616143e2adeb626aa27f9420e96061fbf1e512570caedb9297b3","sourceBytes": 3793,"sourceSha256": "483350f5297df682aba4e4a0fa491307ce3d3abd725ae4df07fab177490752cf","checks": [diff --git a/examples/dataflow-product-analytics.html b/examples/dataflow-product-analytics.htmlindex 2ba52bf5..00961186 100644--- a/examples/dataflow-product-analytics.html+++ b/examples/dataflow-product-analytics.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5348,11 +5420,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8381,6 +8455,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8652,7 +8765,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11502,18 +11615,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11558,62 +11685,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11634,6 +11993,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11644,25 +12007,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11707,31 +12076,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11764,8 +12193,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11774,7 +12227,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/examples/lifecycle-agent-run.html b/examples/lifecycle-agent-run.htmlindex 70742acd..d7172705 100644--- a/examples/lifecycle-agent-run.html+++ b/examples/lifecycle-agent-run.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5297,11 +5369,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8330,6 +8404,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8601,7 +8714,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11451,18 +11564,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11507,62 +11634,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11583,6 +11942,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11593,25 +11956,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11656,31 +12025,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11713,8 +12142,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11723,7 +12176,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/examples/sequence-cache-miss-request.html b/examples/sequence-cache-miss-request.htmlindex 802dccfd..e93eef5f 100644--- a/examples/sequence-cache-miss-request.html+++ b/examples/sequence-cache-miss-request.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5363,11 +5435,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8396,6 +8470,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8667,7 +8780,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11517,18 +11630,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11573,62 +11700,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11649,6 +12008,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11659,25 +12022,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11722,31 +12091,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11779,8 +12208,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11789,7 +12242,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/examples/web-app-rendered.html b/examples/web-app-rendered.htmlindex a1588db3..259a150d 100644--- a/examples/web-app-rendered.html+++ b/examples/web-app-rendered.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5314,11 +5386,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8345,6 +8419,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8616,7 +8729,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11466,18 +11579,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11522,62 +11649,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11598,6 +11957,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11608,25 +11971,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11671,31 +12040,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11728,8 +12157,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11738,7 +12191,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/examples/web-app.html b/examples/web-app.htmlindex a1588db3..259a150d 100644--- a/examples/web-app.html+++ b/examples/web-app.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5314,11 +5386,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8345,6 +8419,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8616,7 +8729,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11466,18 +11579,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11522,62 +11649,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11598,6 +11957,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11608,25 +11971,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11671,31 +12040,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11728,8 +12157,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11738,7 +12191,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();diff --git a/examples/workflow-agent-tool-call-rendered.html b/examples/workflow-agent-tool-call-rendered.htmlindex 41c328fb..f5373ec9 100644--- a/examples/workflow-agent-tool-call-rendered.html+++ b/examples/workflow-agent-tool-call-rendered.html@@ -1088,6 +1088,36 @@padding: 0.42rem 0.48rem 0.38rem 0.55rem;border-bottom: 1px solid var(--toolbar-border);background: linear-gradient(110deg, color-mix(in srgb, var(--frontend-fill) 45%, transparent), transparent 68%);+ cursor: grab;+ touch-action: none;+ user-select: none;+ }+ .overview-map[data-panel-dragging="true"] .overview-map-head { cursor: grabbing; }+ .overview-map[data-placement-invalid="true"] {+ border-color: var(--security-stroke);+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--security-stroke) 34%, transparent), 0 16px 42px rgba(0, 0, 0, 0.3);+ }+ .overview-map[data-compact="true"] {+ width: 7.4rem;+ }+ .overview-map[data-compact="true"] .overview-map-head {+ grid-template-columns: minmax(0, 1fr) auto;+ gap: 0.24rem;+ min-height: 1.5rem;+ padding: 0.05rem 0.16rem 0.05rem 0.32rem;+ border-bottom: 0;+ }+ .overview-map[data-compact="true"] .overview-map-live,+ .overview-map[data-compact="true"] .overview-map-copy,+ .overview-map[data-compact="true"] .overview-map-surface,+ .overview-map[data-compact="true"] .overview-map-hint {+ display: none;+ }+ .overview-map[data-compact="true"] .overview-map-expand { display: inline-flex; }+ .overview-map[data-compact="true"] .overview-map-close {+ width: 1.15rem;+ height: 1.15rem;+ font-size: 0.72rem;}.overview-map-live {width: 0.42rem;@@ -1118,6 +1148,26 @@white-space: nowrap;text-overflow: ellipsis;}+ .overview-map-expand {+ display: none;+ align-items: center;+ justify-content: center;+ min-width: 0;+ height: 1.2rem;+ padding: 0 0.34rem;+ overflow: hidden;+ border: 0;+ border-radius: 0.3rem;+ background: transparent;+ color: var(--frontend-stroke);+ font: inherit;+ font-size: 0.49rem;+ font-weight: 700;+ letter-spacing: 0.06em;+ text-transform: uppercase;+ white-space: nowrap;+ cursor: pointer;+ }.overview-map-close {width: 1.55rem;height: 1.55rem;@@ -1130,8 +1180,11 @@font-size: 0.9rem;cursor: pointer;}+ .overview-map-expand:hover,+ .overview-map-expand:focus-visible,.overview-map-close:hover,.overview-map-close:focus-visible { background: var(--toolbar-hover); }+ .overview-map-expand:focus-visible,.overview-map-close:focus-visible,.overview-map-surface:focus-visible,.overview-map-node:focus-visible {@@ -1213,6 +1266,24 @@color: var(--frontend-stroke);background: var(--toolbar-hover);}+ .overview-map-feedback {+ position: absolute;+ right: 1rem;+ bottom: 4.15rem;+ z-index: 13;+ max-width: min(16rem, calc(100% - 2rem));+ padding: 0.38rem 0.55rem;+ border: 1px solid color-mix(in srgb, var(--frontend-stroke) 52%, var(--toolbar-border));+ border-radius: 0.5rem;+ background: var(--toolbar-menu-bg);+ color: var(--toolbar-text);+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);+ font-size: 0.52rem;+ line-height: 1.35;+ pointer-events: none;+ }+ .overview-map-feedback[hidden] { display: none; }+ .focus-chip[data-radar-yielded="true"] { display: none !important; }.diagram-nav #btn-route-probe[aria-pressed="true"] {color: var(--backend-stroke);background: var(--toolbar-hover);@@ -3580,16 +3651,17 @@width: min(10.25rem, calc(100% - 1rem));}.overview-map[data-docked="true"] {- right: 0.5rem;+ right: var(--archify-radar-right, 0.5rem);top: var(--archify-radar-top, 0.5rem);bottom: auto;transform: none !important;}.overview-map[data-docked="true"][data-dock-side="left"] {right: auto;- left: 0.5rem;+ left: var(--archify-radar-left, 0.5rem);}.overview-map-surface { height: 4rem; }+ .overview-map-feedback { right: 0.5rem; bottom: 3.7rem; }.semantic-lens {right: 0.5rem;bottom: 3.7rem;@@ -5342,11 +5414,13 @@<strong id="overview-map-title">Semantic radar</strong><small id="overview-map-status" aria-live="polite">Building overview</small></span>+ <button class="overview-map-expand" id="overview-map-expand" type="button" aria-label="Open full semantic radar">Open radar</button><button class="overview-map-close" id="overview-map-close" type="button" aria-label="Close semantic radar">×</button></div><div class="overview-map-surface" id="overview-map-surface" tabindex="0" role="group" aria-label="Diagram overview. Click a node to focus it, or use arrow keys to pan."></div><div class="overview-map-hint" aria-hidden="true"><span>Click node</span><span>Drag to pan</span></div></div>+ <p class="overview-map-feedback no-print" id="overview-map-feedback" role="status" aria-live="polite" hidden>Semantic radar needs more MAP space.</p><div class="diagram-nav no-print" role="toolbar" aria-label="Diagram view controls"><button id="btn-route-probe" type="button" aria-label="Trace a directed route" aria-pressed="false" aria-controls="route-probe" title="Trace route (R)">PATH</button><button id="btn-overview-map" type="button" aria-label="Open semantic radar" aria-expanded="false" aria-controls="overview-map" title="Semantic radar (M)">MAP</button>@@ -8378,6 +8452,45 @@preferred = nodeCenter - chip.offsetHeight / 2;}var top = Math.max(minTop, Math.min(maxTop, preferred));+ var chipRect = chip.getBoundingClientRect();+ var safeGap = 10;+ var protectViewerChrome = !mobile || compactOnMobile || previewingOnMobile;+ var protectedRects = (protectViewerChrome+ ? [svg.querySelector('[data-legend]'), container.querySelector('.diagram-nav')]+ : [])+ .filter(function (element) {+ if (!element || element.hidden) return false;+ var style = window.getComputedStyle(element);+ return style.display !== 'none' && style.visibility !== 'hidden';+ })+ .map(function (element) { return element.getBoundingClientRect(); })+ .filter(function (rect) {+ return rect.width > 0 && rect.height > 0 &&+ chipRect.left < rect.right + safeGap && chipRect.right > rect.left - safeGap;+ });+ if (protectedRects.length) {+ var candidates = [top, minTop, maxTop];+ protectedRects.forEach(function (rect) {+ candidates.push(+ rect.top - containerRect.top - chip.offsetHeight - safeGap,+ rect.bottom - containerRect.top + safeGap+ );+ });+ var valid = candidates.map(function (candidate) {+ return Math.max(minTop, Math.min(maxTop, candidate));+ }).filter(function (candidate, index, all) {+ if (all.indexOf(candidate) !== index) return false;+ var candidateTop = containerRect.top + candidate;+ var candidateBottom = candidateTop + chip.offsetHeight;+ return protectedRects.every(function (rect) {+ return candidateBottom <= rect.top - safeGap || candidateTop >= rect.bottom + safeGap;+ });+ });+ valid.sort(function (first, second) {+ return Math.abs(first - preferred) - Math.abs(second - preferred);+ });+ if (valid.length) top = valid[0];+ }chip.style.top = Math.round(top) + 'px';if (Archify.radar && typeof Archify.radar.sync === 'function') Archify.radar.sync();}@@ -8649,7 +8762,7 @@var target = event.target;if (chip.hidden || !target || typeof target.closest !== 'function' || chip.contains(target)) return;if (container.getAttribute('data-just-panned') === 'true') return;- if (target.closest('[data-node-id], [data-relationship-hit-key]')) return;+ if (target.closest('[data-node-id], [data-relationship-hit-key], .overview-map')) return;clear();}, true);window.addEventListener('scroll', requestLensPlacement, { passive: true });@@ -11499,18 +11612,32 @@var container = document.querySelector('.diagram-container');var diagram = container.querySelector(':scope > svg');var panel = document.getElementById('overview-map');+ var panelHead = panel.querySelector('.overview-map-head');var surface = document.getElementById('overview-map-surface');var status = document.getElementById('overview-map-status');var trigger = document.getElementById('btn-overview-map');var closeBtn = document.getElementById('overview-map-close');+ var expandBtn = document.getElementById('overview-map-expand');+ var feedback = document.getElementById('overview-map-feedback');+ var navigation = container.querySelector('.diagram-nav');+ var passport = document.getElementById('focus-chip');var namespace = 'http://www.w3.org/2000/svg';var viewBox = diagram.viewBox && diagram.viewBox.baseVal;var mapSvg = document.createElementNS(namespace, 'svg');var nodeLayer = document.createElementNS(namespace, 'g');var viewport = document.createElementNS(namespace, 'rect');var nodes = [];- var drag = null;+ var viewportDrag = null;+ var panelDrag = null;+ var manualPosition = null;+ var lastPlacement = null;+ var requestedOpen = false;+ var passportYielded = false;+ var passportPreviousAriaHidden = null;var syncFrame = 0;+ var spaceRetryTimer = 0;+ var spaceRetryCount = 0;+ var placementGap = 16;mapSvg.setAttribute('role', 'group');mapSvg.setAttribute('aria-label', 'Semantic diagram radar nodes');@@ -11555,62 +11682,294 @@status.textContent = nodes.length + ' nodes · full map';return true;}- function updateDocking() {- if (panel.hidden) return;- var containerRect = container.getBoundingClientRect();- var intersectsWindow = containerRect.bottom > 12 && containerRect.top < window.innerHeight - 12;- if (!intersectsWindow) {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');- return;- }- var active = diagram.querySelector('[data-focus-selected]');- var activeRect = active ? active.getBoundingClientRect() : null;- var dockLeft = !!(activeRect && activeRect.left + activeRect.width / 2 > window.innerWidth / 2);- var right = Math.max(16, window.innerWidth - Math.min(containerRect.right - 16, window.innerWidth - 16));- var left = Math.max(16, Math.min(containerRect.left + 16, window.innerWidth - panel.offsetWidth - 16));- var topLimit = Math.max(16, containerRect.top + 16);- var bottomLimit = Math.min(window.innerHeight - 16, containerRect.bottom - 16);- var panelLeft = dockLeft ? left : window.innerWidth - right - panel.offsetWidth;- var panelRight = panelLeft + panel.offsetWidth;+ function visibleRect(element) {+ if (!element || element.hidden) return null;+ var rect = element.getBoundingClientRect();+ if (rect.width <= 0 || rect.height <= 0 || rect.right <= 0 || rect.bottom <= 0 || rect.left >= window.innerWidth || rect.top >= window.innerHeight) return null;+ return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height };+ }+ function panelRectAt(position) {+ return {+ left: position.left,+ top: position.top,+ right: position.left + panel.offsetWidth,+ bottom: position.top + panel.offsetHeight,+ width: panel.offsetWidth,+ height: panel.offsetHeight+ };+ }+ function rectsIntersect(first, second, gap) {+ gap = Number(gap) || 0;+ return first.left < second.right + gap &&+ first.right > second.left - gap &&+ first.top < second.bottom + gap &&+ first.bottom > second.top - gap;+ }+ function intersectionArea(first, second) {+ var width = Math.max(0, Math.min(first.right, second.right) - Math.max(first.left, second.left));+ var height = Math.max(0, Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top));+ return width * height;+ }+ function clamp(value, minimum, maximum) {+ if (maximum < minimum) return minimum;+ return Math.max(minimum, Math.min(maximum, value));+ }+ function placementContext() {+ var containerRect = visibleRect(container);+ if (!containerRect) return null;+ var controlRect = visibleRect(navigation);+ var left = Math.max(placementGap, containerRect.left + placementGap);+ var top = Math.max(placementGap, containerRect.top + placementGap);+ var right = Math.min(window.innerWidth - placementGap, containerRect.right - placementGap);+ var bottom = Math.min(window.innerHeight - placementGap, containerRect.bottom - placementGap);+ if (controlRect) bottom = Math.min(bottom, controlRect.top - placementGap);var lens = document.getElementById('focus-chip');- var lensRect = lens && !lens.hidden ? lens.getBoundingClientRect() : null;- var legend = diagram.querySelector('[data-legend]');- var legendRect = legend && !legend.hidden && window.getComputedStyle(legend).display !== 'none'- ? legend.getBoundingClientRect() : null;- var nav = container.querySelector('.diagram-nav');- var navRect = nav && !nav.hidden && window.getComputedStyle(nav).display !== 'none'- ? nav.getBoundingClientRect() : null;- var blockers = [activeRect, lensRect, legendRect, navRect].filter(function (rect) {- return rect && rect.right > panelLeft && rect.left < panelRight;- });- var desiredTop = bottomLimit - panel.offsetHeight;- var candidates = [desiredTop, topLimit];- blockers.forEach(function (rect) {- candidates.push(rect.top - 10 - panel.offsetHeight, rect.bottom + 10);- });- var valid = candidates.filter(function (candidate) {- if (candidate < topLimit || candidate + panel.offsetHeight > bottomLimit) return false;- return blockers.every(function (rect) {- return candidate + panel.offsetHeight <= rect.top - 10 || candidate >= rect.bottom + 10;- });+ var lensRect = visibleRect(lens);+ var legendRect = visibleRect(diagram.querySelector('[data-legend]'));+ var active = diagram.querySelector('[data-focus-selected]');+ var activeRect = visibleRect(active);+ return {+ bounds: { left: left, top: top, right: right, bottom: bottom },+ hardBlockers: [lensRect, controlRect, legendRect].filter(Boolean),+ softBlockers: [activeRect].filter(Boolean),+ preferredSide: !activeRect || activeRect.left + activeRect.width / 2 > window.innerWidth / 2 ? 'left' : 'right'+ };+ }+ function positionIsValid(position, context) {+ if (!position || !context) return false;+ var rect = panelRectAt(position);+ var bounds = context.bounds;+ if (rect.left < bounds.left || rect.top < bounds.top || rect.right > bounds.right || rect.bottom > bounds.bottom) return false;+ return context.hardBlockers.every(function (blocker) { return !rectsIntersect(rect, blocker, placementGap); });+ }+ function cornerCandidates(context) {+ var bounds = context.bounds;+ var left = bounds.left;+ var right = Math.max(left, bounds.right - panel.offsetWidth);+ var top = bounds.top;+ var bottom = Math.max(top, bounds.bottom - panel.offsetHeight);+ var preferredLeft = context.preferredSide === 'left' ? left : right;+ var alternateLeft = context.preferredSide === 'left' ? right : left;+ return [+ { left: preferredLeft, top: bottom },+ { left: alternateLeft, top: bottom },+ { left: preferredLeft, top: top },+ { left: alternateLeft, top: top }+ ].filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function nearbyCandidates(context, reference) {+ var bounds = context.bounds;+ var maximumLeft = bounds.right - panel.offsetWidth;+ var maximumTop = bounds.bottom - panel.offsetHeight;+ var requested = reference ? {+ left: clamp(reference.left, bounds.left, maximumLeft),+ top: clamp(reference.top, bounds.top, maximumTop)+ } : null;+ var horizontal = [bounds.left, maximumLeft];+ var vertical = [bounds.top, maximumTop];+ if (requested) {+ horizontal.push(requested.left);+ vertical.push(requested.top);+ }+ context.hardBlockers.forEach(function (blocker) {+ horizontal.push(+ blocker.left - placementGap - panel.offsetWidth,+ blocker.right + placementGap+ );+ vertical.push(+ blocker.top - placementGap - panel.offsetHeight,+ blocker.bottom + placementGap+ );+ });+ horizontal = horizontal.map(function (left) { return clamp(left, bounds.left, maximumLeft); });+ vertical = vertical.map(function (top) { return clamp(top, bounds.top, maximumTop); });+ var candidates = [];+ horizontal.forEach(function (left) {+ vertical.forEach(function (top) { candidates.push({ left: left, top: top }); });});- valid.sort(function (a, b) { return Math.abs(a - desiredTop) - Math.abs(b - desiredTop); });- var top = valid.length ? valid[0] : Math.max(topLimit, desiredTop);- top = Math.min(window.innerHeight - panel.offsetHeight - 16, top);+ return candidates.filter(function (candidate, index, all) {+ return all.findIndex(function (other) { return other.left === candidate.left && other.top === candidate.top; }) === index;+ });+ }+ function placementScore(position, context, reference, softWeight) {+ var rect = panelRectAt(position);+ var referenceLeft = reference ? reference.left : (context.preferredSide === 'left' ? context.bounds.left : context.bounds.right - panel.offsetWidth);+ var referenceTop = reference ? reference.top : context.bounds.bottom - panel.offsetHeight;+ var distance = Math.pow(position.left - referenceLeft, 2) + Math.pow(position.top - referenceTop, 2);+ var softOverlap = context.softBlockers.reduce(function (total, blocker) { return total + intersectionArea(rect, blocker); }, 0);+ return distance + softOverlap * softWeight;+ }+ function chooseRadarPlacement(context, reference, options) {+ options = options || {};+ var softWeight = Number.isFinite(options.softWeight) ? options.softWeight : 100;+ var candidates = nearbyCandidates(context, reference).concat(cornerCandidates(context));+ var valid = candidates.filter(function (candidate) { return positionIsValid(candidate, context); });+ valid.sort(function (first, second) {+ return placementScore(first, context, reference, softWeight) - placementScore(second, context, reference, softWeight);+ });+ return valid.length ? valid[0] : null;+ }+ function applyPlacement(position, remember) {+ var useLeft = position.left + panel.offsetWidth / 2 <= window.innerWidth / 2;panel.setAttribute('data-docked', 'true');- panel.setAttribute('data-dock-side', dockLeft ? 'left' : 'right');- panel.style.setProperty('--archify-radar-right', Math.round(right) + 'px');- panel.style.setProperty('--archify-radar-left', Math.round(left) + 'px');- panel.style.setProperty('--archify-radar-top', Math.round(Math.max(16, top)) + 'px');+ panel.setAttribute('data-dock-side', useLeft ? 'left' : 'right');+ if (useLeft) {+ panel.style.setProperty('--archify-radar-left', Math.round(position.left) + 'px');+ panel.style.removeProperty('--archify-radar-right');+ } else {+ panel.style.setProperty('--archify-radar-right', Math.round(window.innerWidth - position.left - panel.offsetWidth) + 'px');+ panel.style.removeProperty('--archify-radar-left');+ }+ panel.style.setProperty('--archify-radar-top', Math.round(position.top) + 'px');+ if (remember !== false) lastPlacement = { left: position.left, top: position.top };+ }+ function resetDockingStyles() {+ panel.removeAttribute('data-docked');+ panel.removeAttribute('data-dock-side');+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('data-compact');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ panel.style.removeProperty('--archify-radar-right');+ panel.style.removeProperty('--archify-radar-left');+ panel.style.removeProperty('--archify-radar-top');+ }+ function updateDocking() {+ var options = arguments[0] || {};+ if (panel.hidden) return false;+ if (panelDrag) return true;+ panel.removeAttribute('data-compact');+ panel.removeAttribute('data-placement-degraded');+ panel.removeAttribute('data-placement-invalid');+ panel.removeAttribute('data-placement-unavailable');+ panel.removeAttribute('title');+ panel.style.removeProperty('visibility');+ var context = placementContext();+ if (!context) {+ resetDockingStyles();+ return false;+ }+ var reference = manualPosition || lastPlacement;+ var placementOptions = { softWeight: manualPosition ? 0 : 100 };+ var placement = manualPosition && positionIsValid(manualPosition, context)+ ? manualPosition+ : chooseRadarPlacement(context, reference, placementOptions);+ var compact = false;+ if (!placement && options.allowCompact !== false) {+ compact = true;+ panel.setAttribute('data-compact', 'true');+ panel.setAttribute('data-placement-degraded', 'true');+ panel.setAttribute('title', 'Radar compacted to avoid covering the Semantic Passport or MAP controls.');+ context = placementContext();+ placement = chooseRadarPlacement(context, reference, placementOptions);+ }+ if (!placement) {+ resetDockingStyles();+ panel.setAttribute('data-placement-unavailable', 'true');+ return false;+ }+ if (manualPosition && !compact) manualPosition = { left: placement.left, top: placement.top };+ applyPlacement(placement, true);+ return true;+ }+ function clearSpaceRetry() {+ if (spaceRetryTimer) window.clearTimeout(spaceRetryTimer);+ spaceRetryTimer = 0;+ }+ function yieldPassport() {+ if (!passport || passport.hidden || passportYielded) return passportYielded;+ passportPreviousAriaHidden = passport.getAttribute('aria-hidden');+ passportYielded = true;+ passport.setAttribute('data-radar-yielded', 'true');+ passport.setAttribute('aria-hidden', 'true');+ return true;+ }+ function restorePassport() {+ if (!passport || !passportYielded) return;+ passportYielded = false;+ passport.removeAttribute('data-radar-yielded');+ if (passportPreviousAriaHidden === null) passport.removeAttribute('aria-hidden');+ else passport.setAttribute('aria-hidden', passportPreviousAriaHidden);+ passportPreviousAriaHidden = null;+ }+ function reflectVisible() {+ panel.hidden = false;+ panel.removeAttribute('data-placement-unavailable');+ trigger.setAttribute('aria-expanded', 'true');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Close semantic radar');+ trigger.title = 'Semantic radar (M)';+ feedback.hidden = true;+ }+ function scheduleSpaceRetry() {+ if (!requestedOpen || spaceRetryTimer || spaceRetryCount >= 4) return;+ spaceRetryCount += 1;+ spaceRetryTimer = window.setTimeout(function () {+ spaceRetryTimer = 0;+ attemptRequestedOpen();+ }, 60);+ }+ function reflectUnavailable() {+ restorePassport();+ panel.hidden = true;+ panel.setAttribute('data-placement-unavailable', 'true');+ trigger.setAttribute('aria-expanded', 'false');+ trigger.setAttribute('aria-label', 'Cancel semantic radar waiting for more MAP space');+ trigger.setAttribute('data-radar-space-limited', 'true');+ trigger.title = 'Semantic radar needs more visible MAP space';+ feedback.hidden = false;+ scheduleSpaceRetry();+ }+ function attemptRequestedOpen(options) {+ options = options || {};+ if (!requestedOpen) return false;+ panel.hidden = false;+ if (!updateDocking(options)) {+ reflectUnavailable();+ return false;+ }+ clearSpaceRetry();+ spaceRetryCount = 0;+ reflectVisible();+ sync();+ if (options.focus === true && !panel.hasAttribute('data-compact')) surface.focus();+ return true;+ }+ function expandCompactRadar() {+ if (!requestedOpen || panel.hidden || !panel.hasAttribute('data-compact')) return false;+ yieldPassport();+ if (!updateDocking({ allowCompact: false })) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return false;+ }+ }+ reflectVisible();+ sync();+ if (!panel.hasAttribute('data-compact')) surface.focus();+ return !panel.hasAttribute('data-compact');}function syncNow() {syncFrame = 0;if (panel.hidden || !Archify.view || typeof Archify.view.logicalViewport !== 'function') return;- updateDocking();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ if (passportYielded && panel.hasAttribute('data-compact')) {+ restorePassport();+ if (!updateDocking()) {+ reflectUnavailable();+ return;+ }+ }+ reflectVisible();var visible = Archify.view.logicalViewport();if (!visible) return;viewport.setAttribute('x', String(visible.x));@@ -11631,6 +11990,10 @@});}function sync() {+ if (requestedOpen && panel.hidden) {+ attemptRequestedOpen();+ return;+ }if (syncFrame) return;syncFrame = requestAnimationFrame(syncNow);}@@ -11641,25 +12004,31 @@if (next && Archify.semanticLens && Archify.semanticLens.isOpen()) {Archify.semanticLens.close({ restoreFocus: false });}- panel.hidden = !next;- trigger.setAttribute('aria-expanded', next ? 'true' : 'false');- trigger.setAttribute('aria-label', next ? 'Close semantic radar' : 'Open semantic radar');+ requestedOpen = next;if (next) {+ clearSpaceRetry();+ spaceRetryCount = 0;build();- updateDocking();- sync();- if (options.focus === true) surface.focus();+ attemptRequestedOpen(options);} else {- panel.removeAttribute('data-docked');- panel.removeAttribute('data-dock-side');- panel.style.removeProperty('--archify-radar-right');- panel.style.removeProperty('--archify-radar-left');- panel.style.removeProperty('--archify-radar-top');+ clearSpaceRetry();+ spaceRetryCount = 0;+ viewportDrag = null;+ panelDrag = null;+ container.classList.remove('is-panning');+ panel.hidden = true;+ resetDockingStyles();+ restorePassport();+ feedback.hidden = true;+ trigger.setAttribute('aria-expanded', 'false');+ trigger.removeAttribute('data-radar-space-limited');+ trigger.setAttribute('aria-label', 'Open semantic radar');+ trigger.title = 'Semantic radar (M)';if (options.restoreFocus === true) trigger.focus();}return next;}- function toggle() { return setOpen(panel.hidden, { focus: false }); }+ function toggle() { return setOpen(!requestedOpen, { focus: false }); }function close(options) { return setOpen(false, options); }function bringNodeIntoWindow(node) {var delay = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 0 : 540;@@ -11704,31 +12073,91 @@Archify.view.centerAt(point.x, point.y, { minimumScale: 1.5, instant: true });sync();}- function endDrag(event) {- if (!drag) return;- drag = null;+ function endViewportDrag(event) {+ if (!viewportDrag) return;+ viewportDrag = null;panel.removeAttribute('data-dragging');container.classList.remove('is-panning');try { surface.releasePointerCapture(event.pointerId); } catch (_) {}}+ function beginPanelDrag(event) {+ if (event.button !== 0 || event.target.closest('button, a, input, [role="button"]')) return;+ var context = placementContext();+ if (!context) return;+ var rect = panel.getBoundingClientRect();+ event.preventDefault();+ event.stopPropagation();+ panelDrag = {+ pointerId: event.pointerId,+ originX: event.clientX,+ originY: event.clientY,+ start: { left: rect.left, top: rect.top },+ current: { left: rect.left, top: rect.top },+ previousManual: manualPosition ? { left: manualPosition.left, top: manualPosition.top } : null+ };+ panel.setAttribute('data-panel-dragging', 'true');+ try { panelHead.setPointerCapture(event.pointerId); } catch (_) {}+ }+ function movePanelDrag(event) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ var context = placementContext();+ if (!context) return;+ event.preventDefault();+ event.stopPropagation();+ var bounds = context.bounds;+ var position = {+ left: clamp(panelDrag.start.left + event.clientX - panelDrag.originX, bounds.left, bounds.right - panel.offsetWidth),+ top: clamp(panelDrag.start.top + event.clientY - panelDrag.originY, bounds.top, bounds.bottom - panel.offsetHeight)+ };+ panelDrag.current = position;+ if (positionIsValid(position, context)) panel.removeAttribute('data-placement-invalid');+ else panel.setAttribute('data-placement-invalid', 'true');+ applyPlacement(position, false);+ }+ function finishPanelDrag(event, cancel) {+ if (!panelDrag || panelDrag.pointerId !== event.pointerId) return;+ event.preventDefault();+ event.stopPropagation();+ var activeDrag = panelDrag;+ panelDrag = null;+ panel.removeAttribute('data-panel-dragging');+ panel.removeAttribute('data-placement-invalid');+ try { panelHead.releasePointerCapture(event.pointerId); } catch (_) {}+ var context = placementContext();+ if (!context) return;+ if (cancel) {+ manualPosition = activeDrag.previousManual;+ lastPlacement = { left: activeDrag.start.left, top: activeDrag.start.top };+ updateDocking();+ return;+ }+ var requested = activeDrag.current;+ manualPosition = { left: requested.left, top: requested.top };+ updateDocking();+ }trigger.addEventListener('click', toggle);closeBtn.addEventListener('click', function () { close({ restoreFocus: true }); });+ expandBtn.addEventListener('click', expandCompactRadar);+ panelHead.addEventListener('pointerdown', beginPanelDrag);+ panelHead.addEventListener('pointermove', movePanelDrag);+ panelHead.addEventListener('pointerup', function (event) { finishPanelDrag(event, false); });+ panelHead.addEventListener('pointercancel', function (event) { finishPanelDrag(event, true); });surface.addEventListener('pointerdown', function (event) {if (event.button !== 0 || event.target.closest('[data-radar-node-id]')) return;event.preventDefault();- drag = { pointerId: event.pointerId };+ viewportDrag = { pointerId: event.pointerId };panel.setAttribute('data-dragging', 'true');container.classList.add('is-panning');try { surface.setPointerCapture(event.pointerId); } catch (_) {}navigate(event);});surface.addEventListener('pointermove', function (event) {- if (!drag || drag.pointerId !== event.pointerId) return;+ if (!viewportDrag || viewportDrag.pointerId !== event.pointerId) return;navigate(event);});- surface.addEventListener('pointerup', endDrag);- surface.addEventListener('pointercancel', endDrag);+ surface.addEventListener('pointerup', endViewportDrag);+ surface.addEventListener('pointercancel', endViewportDrag);surface.addEventListener('click', function (event) {var node = event.target.closest('[data-radar-node-id]');if (node) focusNode(node.getAttribute('data-radar-node-id'));@@ -11761,8 +12190,32 @@Archify.view.centerAt(x, y, { minimumScale: 1.5, instant: true });sync();});- window.addEventListener('resize', sync);- window.addEventListener('scroll', function () { updateDocking(); sync(); }, { passive: true });+ document.addEventListener('keydown', function (event) {+ if (!panelDrag || event.key !== 'Escape') return;+ finishPanelDrag({+ pointerId: panelDrag.pointerId,+ preventDefault: function () { event.preventDefault(); },+ stopPropagation: function () { event.stopPropagation(); }+ }, true);+ }, true);+ function reflow() {+ if (!requestedOpen) return;+ clearSpaceRetry();+ spaceRetryCount = 0;+ sync();+ }+ window.addEventListener('resize', reflow);+ window.addEventListener('scroll', reflow, { passive: true });+ if (typeof ResizeObserver === 'function') {+ var radarResizeObserver = new ResizeObserver(function (entries) {+ if (!requestedOpen) return;+ if (panel.hidden && entries.every(function (entry) { return entry.target === panel; })) return;+ reflow();+ });+ [container, navigation, document.getElementById('focus-chip'), panel].filter(Boolean).forEach(function (element) {+ radarResizeObserver.observe(element);+ });+ }requestAnimationFrame(build);return {@@ -11771,7 +12224,7 @@toggle: toggle,sync: sync,focus: focusNode,- isOpen: function () { return !panel.hidden; },+ isOpen: function () { return requestedOpen; },count: function () { return nodes.length; }};})();