Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

Fix Semantic Radar collision handling and dragging (#100)

sunsunsun-java4293061d81bb
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 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 legends
run: node --test test/viewer-chrome-layout.test.mjs
working-directory: archify
diff --git a/archify.zip b/archify.zip
index 400b619c..bcd083a0 100644
Binary files a/archify.zip and b/archify.zip differ
diff --git a/archify/assets/template.html b/archify/assets/template.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.mjs
index 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 focus
assert.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.mjs
index 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.mjs
index 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.gif
index 608f691c..a9c95d06 100644
Binary files a/docs/assets/archify-live-proof.gif and b/docs/assets/archify-live-proof.gif differ
diff --git a/docs/assets/archify-live-proof.json b/docs/assets/archify-live-proof.json
index 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.html
index 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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.json
index 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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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.html
index 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">&#215;</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; }
};
})();