@diagrammo/dgmo 0.52.0 → 0.53.0

package/dist/{chunk-QJMKPUYK.js → chunk-22OQWBWD.js}

@@ -8,11 +8,11 @@ import {
   stripDefaultModifier,
   validateTagGroupNames,
   validateTagValues
-} from "./chunk-HHKO6SKY.js";
+} from "./chunk-CMVZWP32.js";
 import {
   parseArrow,
   parseInArrowLabel
-} from "./chunk-FFUN5D66.js";
+} from "./chunk-WF64MW5G.js";
 import {
   displayName,
   normalizeName
@@ -24,10 +24,11 @@ import {
   extractColor,
   measureIndent,
   parseFirstLine,
+  peelTrailingCollapsedFlag,
   splitNameAndMeta,
   warnUnknownMetaKeys,
   withTagAliases
-} from "./chunk-BRENJ2BQ.js";
+} from "./chunk-YJVA3QUU.js";
 import {
   NAME_DIAGNOSTIC_CODES,
   formatDgmoError,
@@ -35,7 +36,7 @@ import {
   makeFail,
   nameMergedMessage,
   suggest
-} from "./chunk-CXK4DZH3.js";
+} from "./chunk-4W2PE66Q.js";
 
 // src/sequence/parser.ts
 var KNOWN_SEQ_OPTIONS = /* @__PURE__ */ new Set(["active-tag"]);
@@ -43,7 +44,8 @@ var KNOWN_SEQ_BOOLEANS = /* @__PURE__ */ new Set([
   "fill-tint",
   "fill-solid",
   "fill-outline",
-  "no-title"
+  "no-title",
+  "no-legend"
 ]);
 var NO_PREFIX_ONLY_BOOLEANS = /* @__PURE__ */ new Set(["activations"]);
 var VALID_PARTICIPANT_TYPES = /* @__PURE__ */ new Set([
@@ -358,8 +360,13 @@ function parseSequenceDgmo(content, palette) {
       const groupName = groupMatch[1].trim();
       const groupColor = groupMatch[2]?.trim();
       let groupMeta;
-      const afterBracket = groupMatch[3]?.trim() || "";
+      let afterBracket = groupMatch[3]?.trim() || "";
       let isCollapsed = false;
+      const barePeel = peelTrailingCollapsedFlag(afterBracket);
+      if (barePeel.collapsed) {
+        isCollapsed = true;
+        afterBracket = barePeel.rest;
+      }
       if (afterBracket) {
         const groupRegistry = withTagAliases(
           SEQUENCE_REGISTRY,
@@ -1032,4 +1039,4 @@ export {
   parseSequenceDgmo,
   looksLikeSequence
 };
-//# sourceMappingURL=chunk-QJMKPUYK.js.map
+//# sourceMappingURL=chunk-22OQWBWD.js.map

package/dist/{chunk-5NGAO4QK.js → chunk-27STWBOK.js}

@@ -1,6 +1,6 @@
 import {
   MAP_DIRECTIVE_KEY_SET
-} from "./chunk-FQ7HTV52.js";
+} from "./chunk-6DCOIN4W.js";
 import {
   AUTO_TAG_COLOR_SENTINEL,
   finalizeAutoTagColors,
@@ -8,10 +8,10 @@ import {
   stripDefaultModifier,
   tagAttrKey,
   validateTagGroupNames
-} from "./chunk-HHKO6SKY.js";
+} from "./chunk-CMVZWP32.js";
 import {
   parseInArrowLabel
-} from "./chunk-FFUN5D66.js";
+} from "./chunk-WF64MW5G.js";
 import {
   MAP_REGISTRY,
   extractColor,
@@ -19,11 +19,11 @@ import {
   peelRampColors,
   splitNameAndMeta,
   withTagAliases
-} from "./chunk-BRENJ2BQ.js";
+} from "./chunk-YJVA3QUU.js";
 import {
   formatDgmoError,
   makeDgmoError
-} from "./chunk-CXK4DZH3.js";
+} from "./chunk-4W2PE66Q.js";
 
 // src/map/parser.ts
 var COORD_RE = /^[+-]?\d+(?:\.\d+)?\s+[+-]?\d+(?:\.\d+)?$/;
@@ -300,12 +300,14 @@ function parseMap(content, palette) {
         d.noClusterPois = true;
         break;
       // ── Clock channel (BL-122). Activation is the per-POI `clock` flag (see
-      //    handlePoi); `hours`/`days` are the global availability window, stored
-      //    raw and parsed at resolve. ──
+      //    handlePoi); `hours`/`workweek` are the global availability window,
+      //    stored raw and parsed at resolve. `days` is the legacy alias for
+      //    `workweek` (decision #48). ──
       case "hours":
         dup(d.clockHours);
         d.clockHours = value;
         break;
+      case "workweek":
       case "days":
         dup(d.clockDays);
         d.clockDays = value;
@@ -633,4 +635,4 @@ export {
   looksLikeMap,
   parseMap
 };
-//# sourceMappingURL=chunk-5NGAO4QK.js.map
+//# sourceMappingURL=chunk-27STWBOK.js.map

package/dist/{chunk-QGATPIPX.js → chunk-2QC4HXCY.js}

@@ -1,25 +1,25 @@
 import {
   GANTT_BOOLEAN_SET,
   GANTT_OPTION_SET
-} from "./chunk-FQ7HTV52.js";
+} from "./chunk-6DCOIN4W.js";
 import {
   parseDuration,
   parseOffset,
   parseOffsetPrefix
-} from "./chunk-USZW2HHU.js";
+} from "./chunk-EQW6HOP4.js";
 import {
   parseDateToken,
   toInternal
 } from "./chunk-DAOFNU6J.js";
 import {
   getSeriesColors
-} from "./chunk-WBM7ZNDI.js";
+} from "./chunk-JYDMBWRP.js";
 import {
   matchTagBlockHeading,
   stripDefaultModifier,
   tagAttrKey,
   validateTagGroupNames
-} from "./chunk-HHKO6SKY.js";
+} from "./chunk-CMVZWP32.js";
 import {
   normalizeName
 } from "./chunk-NOTA6TEI.js";
@@ -29,27 +29,28 @@ import {
   isReservedKey,
   measureIndent,
   parseFirstLine,
+  peelTrailingCollapsedFlag,
   splitNameAndMeta,
   warnUnknownMetaKeys,
   withTagAliases
-} from "./chunk-BRENJ2BQ.js";
+} from "./chunk-YJVA3QUU.js";
 import {
   formatDgmoError,
   makeDgmoError
-} from "./chunk-CXK4DZH3.js";
+} from "./chunk-4W2PE66Q.js";
 
 // src/gantt/parser.ts
 var GROUP_RE = /^\[(.+?)\]\s*(.*)$/;
 var DEPENDENCY_RE = /^(?:-(.+?))?->\s*(.+)$/;
 var COMMENT_RE = /^\/\//;
 var WORKWEEK_RE = /^workweek\s+(.+)$/i;
-var OFFSET_PREFIX_RE = /^\+(\d+(?:\.\d+)?(?:min|bd|d|w|m|q|y|h|s))\s+(.*)/;
-var DURATION_TOKEN_RE = /^(\d+(?:\.\d+)?)(min|bd|d|w|m|q|y|h|s)(\?)?$/;
-var LAG_ARROW_RE = /^-(\d+(?:\.\d+)?(?:min|bd|d|w|m|q|y|h|s))->\s*(.*)/;
-var LEAD_ARROW_RE = /^--(\d+(?:\.\d+)?(?:min|bd|d|w|m|q|y|h|s))->\s*(.*)/;
+var OFFSET_PREFIX_RE = /^\+(\d+(?:\.\d+)?(?:min|bd|sp|d|w|m|q|y|h|s))\s+(.*)/;
+var DURATION_TOKEN_RE = /^(\d+(?:\.\d+)?)(min|bd|sp|d|w|m|q|y|h|s)(\?)?$/;
+var LAG_ARROW_RE = /^-(\d+(?:\.\d+)?(?:min|bd|sp|d|w|m|q|y|h|s))->\s*(.*)/;
+var LEAD_ARROW_RE = /^--(\d+(?:\.\d+)?(?:min|bd|sp|d|w|m|q|y|h|s))->\s*(.*)/;
 var BASIC_ARROW_RE = /^->\s*(.*)/;
-var ERA_OFFSET_RE = /^era\s+\+(\d+(?:\.\d+)?(?:min|bd|d|w|m|q|y|h|s))\s*(?:->|–>)\s*\+(\d+(?:\.\d+)?(?:min|bd|d|w|m|q|y|h|s))\s+(.+)$/i;
-var MARKER_OFFSET_RE = /^marker\s+\+(\d+(?:\.\d+)?(?:min|bd|d|w|m|q|y|h|s))\s+(.+)$/i;
+var ERA_OFFSET_RE = /^era\s+\+(\d+(?:\.\d+)?(?:min|bd|sp|d|w|m|q|y|h|s))\s*(?:->|–>)\s*\+(\d+(?:\.\d+)?(?:min|bd|sp|d|w|m|q|y|h|s))\s+(.+)$/i;
+var MARKER_OFFSET_RE = /^marker\s+\+(\d+(?:\.\d+)?(?:min|bd|sp|d|w|m|q|y|h|s))\s+(.+)$/i;
 var WEEKDAY_MAP = {
   mon: "mon",
   tue: "tue",
@@ -153,7 +154,8 @@ function parseGantt(content, palette) {
       sprintStart: null,
       sprintMode: null,
       fillMode: void 0,
-      noTitle: false
+      noTitle: false,
+      noLegend: false
     },
     diagnostics,
     error: null,
@@ -807,6 +809,9 @@ function parseGantt(content, palette) {
         case "no-title":
           result.options.noTitle = true;
           break;
+        case "no-legend":
+          result.options.noLegend = true;
+          break;
       }
       continue;
     }
@@ -833,6 +838,9 @@ function parseGantt(content, palette) {
       const value = optNoColonMatch[2].trim();
       result.options.optionLineNumbers[key] = lineNumber;
       switch (key) {
+        // `start-date` is canonical (decision #48, pert parity); bare `start`
+        // stays as an undocumented legacy alias.
+        case "start-date":
         case "start":
           result.options.start = wholeDate(value)?.iso ?? value;
           break;
@@ -952,7 +960,13 @@ function parseGantt(content, palette) {
           );
           continue;
         }
-        const afterBrackets = gm[2].trim();
+        let afterBrackets = gm[2].trim();
+        let collapsed = false;
+        const barePeel = peelTrailingCollapsedFlag(afterBrackets);
+        if (barePeel.collapsed) {
+          collapsed = true;
+          afterBrackets = barePeel.rest;
+        }
         let metadata = {};
         if (afterBrackets) {
           const groupRegistry = withTagAliases(
@@ -975,7 +989,6 @@ function parseGantt(content, palette) {
           );
           metadata = split.meta;
         }
-        let collapsed = false;
         if (metadata["collapsed"]?.toLowerCase() === "true") {
           collapsed = true;
           delete metadata["collapsed"];
@@ -1152,7 +1165,8 @@ function parseGantt(content, palette) {
       for (let j = tokens.length - 1; j >= 0; j--) {
         const m = tokens[j].match(DURATION_TOKEN_RE);
         if (m) {
-          duration = { amount: parseFloat(m[1]), unit: m[2] };
+          const unit = m[2] === "sp" ? "s" : m[2];
+          duration = { amount: parseFloat(m[1]), unit };
           uncertain = !!m[3];
           name = tokens.slice(0, j).join(" ");
           break;
@@ -1332,4 +1346,4 @@ export {
   GANTT_KNOWN_OPTIONS,
   GANTT_KNOWN_BOOLEANS
 };
-//# sourceMappingURL=chunk-QGATPIPX.js.map
+//# sourceMappingURL=chunk-2QC4HXCY.js.map

package/dist/{chunk-HFMYN6N2.js → chunk-3B2GXZCX.js}

@@ -4,10 +4,10 @@ import {
 } from "./chunk-6EK55ART.js";
 import {
   noteBoxSize
-} from "./chunk-TYS6CSS5.js";
+} from "./chunk-UU6LUYUH.js";
 import {
   resolveNotes
-} from "./chunk-FMDSF3OV.js";
+} from "./chunk-QZAW5SFH.js";
 
 // src/graph/layout.ts
 import dagre from "@dagrejs/dagre";
@@ -146,6 +146,7 @@ function layoutGraph(graph, options) {
       shape: node.shape,
       ...node.color !== void 0 && { color: node.color },
       ...node.group !== void 0 && { group: node.group },
+      ...node.metadata !== void 0 && { metadata: node.metadata },
       lineNumber: node.lineNumber,
       x: p.x,
       y: p.y,
@@ -310,4 +311,4 @@ function layoutGraph(graph, options) {
 export {
   layoutGraph
 };
-//# sourceMappingURL=chunk-HFMYN6N2.js.map
+//# sourceMappingURL=chunk-3B2GXZCX.js.map

package/dist/{chunk-6HQH6JZE.js → chunk-3BEKKRH5.js}

@@ -1,35 +1,35 @@
 import {
   renderCollapseBar,
   renderNodeCard
-} from "./chunk-OTOHI4JO.js";
+} from "./chunk-H3HFC3SQ.js";
 import {
   CARD_RADIUS,
   CONTAINER_RADIUS
 } from "./chunk-3CIOJ5YJ.js";
 import {
   renderIntegratedLegend
-} from "./chunk-AUIM2NVH.js";
+} from "./chunk-W5KMNC5U.js";
 import {
   getMaxLegendReservedHeight
-} from "./chunk-YAA6IID3.js";
+} from "./chunk-774C2FF3.js";
 import {
   FONT_FAMILY
 } from "./chunk-6KFWC4CO.js";
-import {
-  measureText,
-  wrapTextToWidth
-} from "./chunk-WCT3NYCV.js";
 import {
   contrastText,
   mix,
   shapeFill,
   themeBaseBg
-} from "./chunk-WBM7ZNDI.js";
+} from "./chunk-JYDMBWRP.js";
+import {
+  measureText,
+  wrapTextToWidth
+} from "./chunk-4ASYQ347.js";
 import {
   resolveActiveTagGroup,
   resolveTagColor,
   tagAttrKey
-} from "./chunk-HHKO6SKY.js";
+} from "./chunk-CMVZWP32.js";
 
 // src/sketch/renderer.ts
 import * as d3 from "d3-selection";
@@ -1059,4 +1059,4 @@ export {
   sketchEdgeGeometry,
   renderSketchForExport
 };
-//# sourceMappingURL=chunk-6HQH6JZE.js.map
+//# sourceMappingURL=chunk-3BEKKRH5.js.map

package/dist/{chunk-AL672HNE.js → chunk-3CZLWOCI.js}

@@ -10,24 +10,25 @@ import {
   tagAttrKey,
   validateTagGroupNames,
   validateTagValues
-} from "./chunk-HHKO6SKY.js";
+} from "./chunk-CMVZWP32.js";
 import {
   MINDMAP_REGISTRY,
   OPTION_NOCOLON_RE,
   extractColor,
   measureIndent,
   parseFirstLine,
+  peelTrailingCollapsedFlag,
   splitNameAndMeta,
   tryParseSharedOption,
   warnUnknownMetaKeys,
   withTagAliases
-} from "./chunk-BRENJ2BQ.js";
+} from "./chunk-YJVA3QUU.js";
 import {
   formatDgmoError,
   makeDgmoError,
   makeFail,
   suggest
-} from "./chunk-CXK4DZH3.js";
+} from "./chunk-4W2PE66Q.js";
 
 // src/mindmap/parser.ts
 var KNOWN_OPTIONS = /* @__PURE__ */ new Set(["active-tag"]);
@@ -241,9 +242,18 @@ function parseMindmap(content, palette) {
   return result;
 }
 function parseNodeLine(trimmed, lineNumber, _palette, counter, aliasMap, diagnostics) {
+  let bareCollapsed = false;
+  let nodeText = trimmed;
+  {
+    const barePeel = peelTrailingCollapsedFlag(nodeText);
+    if (barePeel.collapsed && barePeel.rest) {
+      bareCollapsed = true;
+      nodeText = barePeel.rest;
+    }
+  }
   const registry = withTagAliases(MINDMAP_REGISTRY, new Set(aliasMap.keys()));
   const split = splitNameAndMeta(
-    trimmed,
+    nodeText,
     registry,
     aliasMap,
     void 0,
@@ -265,9 +275,9 @@ function parseNodeLine(trimmed, lineNumber, _palette, counter, aliasMap, diagnos
     if (descVal) description = [descVal];
     delete metadata["description"];
   }
-  let collapsed;
+  let collapsed = bareCollapsed ? true : void 0;
   if ("collapsed" in metadata) {
-    collapsed = metadata["collapsed"].toLowerCase() === "true";
+    collapsed = collapsed || metadata["collapsed"].toLowerCase() === "true";
     delete metadata["collapsed"];
   }
   return {
@@ -313,4 +323,4 @@ function findMetadataParent(indent, indentStack) {
 export {
   parseMindmap
 };
-//# sourceMappingURL=chunk-AL672HNE.js.map
+//# sourceMappingURL=chunk-3CZLWOCI.js.map

package/dist/{chunk-J7TLCB2Q.js → chunk-3IUHKMJI.js}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-3HDBAXF5.js";
 import {
   mix
-} from "./chunk-WBM7ZNDI.js";
+} from "./chunk-JYDMBWRP.js";
 
 // src/utils/note-box/svg.ts
 var NOTE_STROKE_WIDTH = 0.6;
@@ -133,4 +133,4 @@ export {
   NOTE_BADGE_RADIUS,
   renderNoteBadge
 };
-//# sourceMappingURL=chunk-J7TLCB2Q.js.map
+//# sourceMappingURL=chunk-3IUHKMJI.js.map

package/dist/{chunk-7L4UJOY6.js → chunk-3TYUXC7D.js}

@@ -1,7 +1,7 @@
 import {
   formatDateKey,
   parseGanttDate
-} from "./chunk-USZW2HHU.js";
+} from "./chunk-EQW6HOP4.js";
 
 // src/pert/internal.ts
 var CONFIDENCE_TABLE = {
@@ -97,4 +97,4 @@ export {
   formatSprintCell,
   formatSlackValue
 };
-//# sourceMappingURL=chunk-7L4UJOY6.js.map
+//# sourceMappingURL=chunk-3TYUXC7D.js.map

package/dist/{chunk-Y2ZE3MSG.js → chunk-43E26CDA.js}

@@ -2,7 +2,7 @@ import {
   CHAR_WIDTH_RATIO,
   measureText,
   truncateText
-} from "./chunk-WCT3NYCV.js";
+} from "./chunk-4ASYQ347.js";
 
 // src/infra/layout.ts
 import dagre from "@dagrejs/dagre";
@@ -587,4 +587,4 @@ export {
   fixEdgeWaypoints,
   layoutInfra
 };
-//# sourceMappingURL=chunk-Y2ZE3MSG.js.map
+//# sourceMappingURL=chunk-43E26CDA.js.map

package/dist/{chunk-YTMTPUH4.js → chunk-4ASVFYB2.js}

@@ -8,17 +8,17 @@ import {
 import {
   FONT_FAMILY
 } from "./chunk-6KFWC4CO.js";
-import {
-  measureText
-} from "./chunk-WCT3NYCV.js";
 import {
   contrastText,
   mix,
   shapeFill
-} from "./chunk-WBM7ZNDI.js";
+} from "./chunk-JYDMBWRP.js";
+import {
+  measureText
+} from "./chunk-4ASYQ347.js";
 import {
   fillModeFromOptions
-} from "./chunk-BRENJ2BQ.js";
+} from "./chunk-YJVA3QUU.js";
 
 // src/wireframe/renderer.ts
 import * as d3Selection from "d3-selection";
@@ -554,4 +554,4 @@ function renderModal(parent, node, ctx) {
 export {
   renderWireframe
 };
-//# sourceMappingURL=chunk-YTMTPUH4.js.map
+//# sourceMappingURL=chunk-4ASVFYB2.js.map

package/dist/{chunk-WCT3NYCV.js → chunk-4ASYQ347.js}

@@ -88,23 +88,38 @@ var CHAR_W = {
 };
 var DEFAULT_W = 0.56;
 var CHAR_WIDTH_RATIO = DEFAULT_W;
-function measureText(text, fontSize) {
-  let w = 0;
+var MEASURE_CACHE = /* @__PURE__ */ new Map();
+var MEASURE_CACHE_MAX = 1e4;
+function extendWidth(acc, text, fontSize) {
+  let w = acc;
   for (let i = 0; i < text.length; i++) {
     w += (CHAR_W[text.charAt(i)] ?? DEFAULT_W) * fontSize;
   }
   return w;
 }
+function measureText(text, fontSize) {
+  const key = `${fontSize}|${text}`;
+  const cached = MEASURE_CACHE.get(key);
+  if (cached !== void 0) return cached;
+  const w = extendWidth(0, text, fontSize);
+  if (MEASURE_CACHE.size >= MEASURE_CACHE_MAX) MEASURE_CACHE.clear();
+  MEASURE_CACHE.set(key, w);
+  return w;
+}
 function truncateText(text, fontSize, maxWidth) {
   if (measureText(text, fontSize) <= maxWidth) return text;
   const ellipsis = "\u2026";
   const ellipsisW = measureText(ellipsis, fontSize);
   if (ellipsisW > maxWidth) return "";
+  const prefix = [0];
+  for (let i = 0; i < text.length; i++) {
+    prefix.push(extendWidth(prefix[i], text.charAt(i), fontSize));
+  }
   let lo = 0;
   let hi = text.length;
   while (lo < hi) {
     const mid = Math.ceil((lo + hi) / 2);
-    if (measureText(text.slice(0, mid), fontSize) + ellipsisW <= maxWidth) {
+    if (prefix[mid] + ellipsisW <= maxWidth) {
       lo = mid;
     } else {
       hi = mid - 1;
@@ -116,15 +131,19 @@ function wrapTextToWidth(text, fontSize, maxWidth, opts) {
   const words = text.split(/\s+/).filter((w) => w.length > 0);
   if (words.length === 0) return [""];
   const hardBreak = opts?.hardBreak ?? false;
+  const spaceW = (CHAR_W[" "] ?? DEFAULT_W) * fontSize;
   const lines = [];
   let current = "";
+  let currentW = 0;
   const pushWord = (word) => {
-    const test = current ? `${current} ${word}` : word;
-    if (measureText(test, fontSize) <= maxWidth || !current) {
-      current = test;
+    const testW = extendWidth(current ? currentW + spaceW : 0, word, fontSize);
+    if (testW <= maxWidth || !current) {
+      current = current ? `${current} ${word}` : word;
+      currentW = testW;
     } else {
       lines.push(current);
       current = word;
+      currentW = extendWidth(0, word, fontSize);
     }
   };
   for (const word of words) {
@@ -132,17 +151,23 @@ function wrapTextToWidth(text, fontSize, maxWidth, opts) {
       if (current) {
         lines.push(current);
         current = "";
+        currentW = 0;
       }
       let chunk = "";
+      let chunkW = 0;
       for (const ch of word) {
-        if (chunk && measureText(chunk + ch, fontSize) > maxWidth) {
+        const candW = extendWidth(chunkW, ch, fontSize);
+        if (chunk && candW > maxWidth) {
           lines.push(chunk);
           chunk = ch;
+          chunkW = extendWidth(0, ch, fontSize);
         } else {
           chunk += ch;
+          chunkW = candW;
         }
       }
       current = chunk;
+      currentW = chunkW;
       continue;
     }
     pushWord(word);
@@ -157,4 +182,4 @@ export {
   truncateText,
   wrapTextToWidth
 };
-//# sourceMappingURL=chunk-WCT3NYCV.js.map
+//# sourceMappingURL=chunk-4ASYQ347.js.map

package/dist/{chunk-ZNWAYU6N.js → chunk-4K42RUGC.js}

@@ -7,7 +7,7 @@ import {
   tagAttrKey,
   validateTagGroupNames,
   validateTagValues
-} from "./chunk-HHKO6SKY.js";
+} from "./chunk-CMVZWP32.js";
 import {
   TREEMAP_REGISTRY,
   extractColor,
@@ -19,14 +19,14 @@ import {
   stripQuotes,
   warnUnknownMetaKeys,
   withTagAliases
-} from "./chunk-BRENJ2BQ.js";
+} from "./chunk-YJVA3QUU.js";
 import {
   emit,
   formatDgmoError,
   makeDgmoError,
   makeFail,
   suggest
-} from "./chunk-CXK4DZH3.js";
+} from "./chunk-4W2PE66Q.js";
 
 // src/treemap/diagnostics.ts
 var TREEMAP_DX = {
@@ -246,7 +246,7 @@ function parseTreemap(content, palette) {
     validateTagGroupNames(result.tagGroups, pushWarning);
     cascadeTagMetadata(result.roots, result.tagGroups);
   }
-  result.defaultColorMode = resolveDefaultColorMode(result);
+  result.defaultColorMode = resolveDefaultColorMode(result, pushWarning);
   if (result.roots.length === 0 && !result.error) {
     const diag = makeDgmoError(1, "No nodes found in treemap");
     result.diagnostics.push(diag);
@@ -280,10 +280,16 @@ function handleDirective(trimmed, options, result, pushWarning, lineNumber) {
     result.hasHeat = true;
     return true;
   }
-  const noMatch = trimmed.match(/^no-(values|percent|headers|legend)\s*$/i);
+  const activeTagMatch = trimmed.match(/^active-tag\s+(.+)$/i);
+  if (activeTagMatch) {
+    result.activeTag = activeTagMatch[1].trim();
+    result.activeTagLineNumber = lineNumber;
+    return true;
+  }
+  const noMatch = trimmed.match(/^no-(values?|percent|headers|legend)\s*$/i);
   if (noMatch) {
     const key = noMatch[1].toLowerCase();
-    if (key === "values") options.noValues = true;
+    if (key === "value" || key === "values") options.noValues = true;
     else if (key === "percent") options.noPercent = true;
     else if (key === "headers") options.noHeaders = true;
     else if (key === "legend") options.noLegend = true;
@@ -302,9 +308,27 @@ function handleDirective(trimmed, options, result, pushWarning, lineNumber) {
   }
   return false;
 }
-function resolveDefaultColorMode(result) {
-  if (result.tagGroups.length > 0) return "tag";
+function resolveDefaultColorMode(result, pushWarning) {
+  const at = result.activeTag?.trim();
+  if (at) {
+    const lv = at.toLowerCase();
+    if (lv === "none") return "branch";
+    const heatName = result.options.heatLabel;
+    const heatHit = heatName !== void 0 ? lv === heatName.toLowerCase() : lv === "value" || lv === "heat";
+    if (result.hasHeat && heatHit) return "heat";
+    if (result.tagGroups.some((g) => g.name.toLowerCase() === lv)) return "tag";
+    const dims = [
+      ...result.tagGroups.map((g) => g.name),
+      ...result.hasHeat ? [heatName ?? "Value"] : []
+    ];
+    const hint = dims.length ? ` Available: ${dims.join(", ")}, none.` : " No tag groups or heat are declared.";
+    pushWarning(
+      result.activeTagLineNumber ?? 0,
+      `active-tag "${at}" does not match a declared tag group or the heat label.${hint}`
+    );
+  }
   if (result.hasHeat) return "heat";
+  if (result.tagGroups.length > 0) return "tag";
   return "branch";
 }
 function parseNodeLine(trimmed, lineNumber, counter, aliasMap, diagnostics) {
@@ -381,4 +405,4 @@ export {
   TREEMAP_DIAGNOSTICS,
   parseTreemap
 };
-//# sourceMappingURL=chunk-ZNWAYU6N.js.map
+//# sourceMappingURL=chunk-4K42RUGC.js.map