@opendata-ai/openchart-vanilla 8.0.0 → 8.1.0

package/dist/index.js

@@ -6,7 +6,7 @@ import {
 } from "./chunk-DCODCLWI.js";
 import {
   renderTileMapSVG
-} from "./chunk-2NAQRP66.js";
+} from "./chunk-BGJT3GTB.js";
 import {
   AnimationScheduler,
   CANVAS_DEFAULT_UPDATE_MAX_MARKS,
@@ -32,7 +32,7 @@ import {
   setupAnimationCleanup,
   setupTableAnimationCleanup,
   zoom_default
-} from "./chunk-6BUCYCLD.js";
+} from "./chunk-RQNAZZJM.js";
 import {
   embedFonts,
   ensureSVGDimensions,
@@ -50,7 +50,7 @@ import {
   registerMarkRenderer,
   renderChartSVG,
   stampAnimationVars
-} from "./chunk-EKAUQAAX.js";
+} from "./chunk-XOZ6AM7C.js";
 import {
   injectThemeStyleBlock
 } from "./chunk-RM5XS6NR.js";
@@ -903,8 +903,9 @@ function edgeTier(edge, focus) {
   if (!focus.hasActive) return "default";
   return focus.connected.has(edge.source) && focus.connected.has(edge.target) ? "connected" : "dimmed";
 }
-function nodeTier(node, focus) {
+function nodeTier(node, focus, exemptIds) {
   if (!focus.hasActive) return "default";
+  if (exemptIds?.has(node.id)) return "connected";
   return focus.connected.has(node.id) ? "connected" : "dimmed";
 }
 function edgeTierAlpha(tier, dimOpacity) {
@@ -1092,6 +1093,7 @@ var GraphCanvasRenderer = class {
       minRadius,
       nextFocus,
       dimOpacity,
+      state.exemptIds,
       crossfade,
       state.hoverRadiusScale,
       entrance,
@@ -1294,16 +1296,16 @@ var GraphCanvasRenderer = class {
   // -------------------------------------------------------------------------
   // Batched node drawing
   // -------------------------------------------------------------------------
-  drawNodesBatched(ctx, nodes, hoveredNodeId, selectedNodeIds, searchMatches, showGlow, theme, minRadius, nextFocus, dimOpacity, crossfade, hoverRadiusScale, entrance, enterAlphaFor) {
+  drawNodesBatched(ctx, nodes, hoveredNodeId, selectedNodeIds, searchMatches, showGlow, theme, minRadius, nextFocus, dimOpacity, exemptIds, crossfade, hoverRadiusScale, entrance, enterAlphaFor) {
     const focusAlpha = (node) => {
       if (crossfade) {
         return lerp(
-          nodeTierAlpha(nodeTier(node, crossfade.prev), dimOpacity),
-          nodeTierAlpha(nodeTier(node, crossfade.next), dimOpacity),
+          nodeTierAlpha(nodeTier(node, crossfade.prev, exemptIds), dimOpacity),
+          nodeTierAlpha(nodeTier(node, crossfade.next, exemptIds), dimOpacity),
           crossfade.t
         );
       }
-      return nodeTierAlpha(nodeTier(node, nextFocus), dimOpacity);
+      return nodeTierAlpha(nodeTier(node, nextFocus, exemptIds), dimOpacity);
     };
     const searchAlpha = (node) => searchMatches !== null && !searchMatches.has(node.id) ? SEARCH_NON_MATCH_ALPHA : 1;
     const entranceAlpha = (node) => entrance ? entrance.nodeAlpha(node) : 1;
@@ -3417,7 +3419,11 @@ function createGraph(container, spec, options) {
   let cameraChangePending = false;
   let highlightSet = null;
   let highlightDimOpacity = null;
+  let seedIds = /* @__PURE__ */ new Set();
   let activeCategories = /* @__PURE__ */ new Set();
+  let transientHighlight = null;
+  let transientTarget = null;
+  const seenWarnings = /* @__PURE__ */ new Set();
   let nodeCategory = /* @__PURE__ */ new Map();
   let focusTransition = null;
   let focusAnim = null;
@@ -3449,6 +3455,12 @@ function createGraph(container, spec, options) {
       height: Math.max(rect.height || 400, 100)
     };
   }
+  function warnOnce(message) {
+    if (seenWarnings.has(message)) return;
+    seenWarnings.add(message);
+    if (options?.onWarn) options.onWarn(message);
+    else console.warn(message);
+  }
   function compile() {
     const { width, height } = getContainerDimensions();
     const darkMode = resolveDarkMode(options?.darkMode);
@@ -3457,7 +3469,8 @@ function createGraph(container, spec, options) {
       height,
       theme: options?.theme,
       darkMode,
-      watermark: options?.watermark
+      watermark: options?.watermark,
+      onWarn: warnOnce
     };
     return compileGraph(currentSpec, compileOpts);
   }
@@ -3559,7 +3572,7 @@ function createGraph(container, spec, options) {
       canvas.setAttribute("aria-label", compilation.a11y.altText);
     }
     wrapper.appendChild(canvas);
-    if (options?.legend !== false) {
+    if (legendSetting() !== false) {
       legendEl = document.createElement("div");
       legendEl.className = "oc-graph-legend";
       renderLegend2();
@@ -3587,8 +3600,11 @@ function createGraph(container, spec, options) {
       chromeEl.style.display = "";
     }
   }
+  function legendSetting() {
+    return options?.legend ?? currentSpec.legend;
+  }
   function legendConfig() {
-    const l = options?.legend;
+    const l = legendSetting();
     if (l && typeof l === "object") {
       return { interactive: l.interactive ?? true, counts: l.counts ?? true };
     }
@@ -3863,6 +3879,32 @@ function createGraph(container, spec, options) {
     for (const [id, cat] of nodeCategory) if (activeCategories.has(cat)) set2.add(id);
     return set2;
   }
+  function recomputeHighlight() {
+    const filter = categoryHighlightSet();
+    const transient = transientHighlight !== null && transientHighlight.size > 0 ? transientHighlight : null;
+    if (filter !== null && transient !== null) {
+      const inter = /* @__PURE__ */ new Set();
+      for (const id of transient) if (filter.has(id)) inter.add(id);
+      highlightSet = inter.size > 0 ? inter : transient;
+      return;
+    }
+    highlightSet = filter ?? transient;
+  }
+  function refreshTransientHighlight() {
+    if (transientTarget === null) {
+      transientHighlight = null;
+      return;
+    }
+    const nextIds = new Set(compilation.nodes.map((n) => n.id));
+    const resolved = new Set(
+      [...resolveHighlightTarget(transientTarget)].filter((id) => nextIds.has(id))
+    );
+    transientHighlight = resolved.size > 0 ? resolved : null;
+  }
+  function effectiveDimOpacity() {
+    const custom = transientHighlight !== null ? highlightDimOpacity : null;
+    return custom ?? compilation.interaction.dimOpacity;
+  }
   function emitHighlightChange() {
     options?.onHighlightChange?.(highlightSet ? [...highlightSet] : null);
   }
@@ -3870,8 +3912,7 @@ function createGraph(container, spec, options) {
     const init = compilation.initialHighlight;
     if (!init) return;
     activeCategories = new Set(init.values);
-    highlightSet = categoryHighlightSet();
-    highlightDimOpacity = null;
+    recomputeHighlight();
   }
   function startHoverRadiusTween(nodeId) {
     const hoverCfg = compilation.animation?.hover ?? null;
@@ -3955,11 +3996,12 @@ function createGraph(container, spec, options) {
       adjacencyMap,
       theme: compilation.theme,
       searchMatches: searchManager.getMatches(),
+      exemptIds: seedIds,
       isGesturing,
       watermark: compilation.watermark,
       focus: focus ?? { t: 1, prev: settledNext, next: settledNext },
       hoverRadiusScale,
-      dimOpacity: highlightDimOpacity ?? compilation.interaction.dimOpacity,
+      dimOpacity: effectiveDimOpacity(),
       entrance: entranceActive && entranceProgress < 1 ? {
         t: entranceProgress,
         stagger: entranceStagger,
@@ -4252,18 +4294,20 @@ function createGraph(container, spec, options) {
     return [...searchManager.getMatches() ?? []];
   }
   function highlight(target, opts) {
-    activeCategories = /* @__PURE__ */ new Set();
-    highlightSet = resolveHighlightTarget(target);
+    if (destroyed) return;
+    transientTarget = target;
+    refreshTransientHighlight();
     highlightDimOpacity = opts?.dimOpacity ?? null;
-    syncLegendActiveState();
+    recomputeHighlight();
     refreshFocus();
     emitHighlightChange();
   }
   function clearHighlight() {
-    activeCategories = /* @__PURE__ */ new Set();
-    highlightSet = null;
+    if (destroyed) return;
+    transientTarget = null;
+    transientHighlight = null;
     highlightDimOpacity = null;
-    syncLegendActiveState();
+    recomputeHighlight();
     refreshFocus();
     emitHighlightChange();
   }
@@ -4290,8 +4334,7 @@ function createGraph(container, spec, options) {
   function setActiveCategories(values) {
     if (destroyed) return;
     activeCategories = new Set(values);
-    highlightSet = categoryHighlightSet();
-    highlightDimOpacity = null;
+    recomputeHighlight();
     syncLegendActiveState();
     refreshFocus();
     emitHighlightChange();
@@ -4302,8 +4345,7 @@ function createGraph(container, spec, options) {
   function toggleLegendCategory(value) {
     if (activeCategories.has(value)) activeCategories.delete(value);
     else activeCategories.add(value);
-    highlightSet = categoryHighlightSet();
-    highlightDimOpacity = null;
+    recomputeHighlight();
     syncLegendActiveState();
     refreshFocus();
     options?.onLegendToggle?.([...activeCategories]);
@@ -4338,6 +4380,7 @@ function createGraph(container, spec, options) {
     const prevEdges = positionedEdges;
     const prevConfig = compilation.simulationConfig;
     compilation = compile();
+    seedIds = new Set(compilation.seedNodeIds);
     const diff = diffGraphUpdate(
       prevNodes,
       prevEdges,
@@ -4368,9 +4411,8 @@ function createGraph(container, spec, options) {
       return { ...edge, sourceX: src.x, sourceY: src.y, targetX: tgt.x, targetY: tgt.y };
     });
     spatialIndex.rebuild(positionedNodes);
-    if (activeCategories.size > 0) {
-      highlightSet = categoryHighlightSet();
-    }
+    refreshTransientHighlight();
+    recomputeHighlight();
     reRunSearch();
     renderChrome3();
     renderLegend2();
@@ -4436,12 +4478,8 @@ function createGraph(container, spec, options) {
     const survivingSelection = [...selectedNodeIds].filter((id) => nextIds.has(id));
     selectedNodeIds = new Set(survivingSelection);
     interactionManager?.setSelection(survivingSelection);
-    if (activeCategories.size > 0) {
-      highlightSet = categoryHighlightSet();
-    } else if (highlightSet) {
-      highlightSet = new Set([...highlightSet].filter((id) => nextIds.has(id)));
-      if (highlightSet.size === 0) highlightSet = null;
-    }
+    refreshTransientHighlight();
+    recomputeHighlight();
     syncLegendActiveState();
     reRunSearch();
     focusTransition = null;
@@ -4550,6 +4588,7 @@ function createGraph(container, spec, options) {
   }
   try {
     compilation = compile();
+    seedIds = new Set(compilation.seedNodeIds);
     adjacencyMap = buildAdjacencyMap(compilation.edges);
     buildDataMaps();
     applyInitialHighlight();