@diagrammo/dgmo 0.95.0 → 0.97.0

package/dist/{chunk-ZECJ7Q6C.js → chunk-KMB754DO.js}

@@ -13,7 +13,7 @@ import {
   tagAttrKey,
   validateTagGroupNames,
   validateTagValues
-} from "./chunk-4SACN2C5.js";
+} from "./chunk-KW3CC7SB.js";
 import {
   ALL_CHART_TYPES,
   AliasRegistry,
@@ -23,11 +23,12 @@ import {
   measureIndent,
   parseFirstLine,
   peelQuotedName,
+  peelTrailingCollapsedFlag,
   splitNameAndMeta,
   tryParseSharedOption,
   warnUnknownMetaKeys,
   withTagAliases
-} from "./chunk-TIIZIAGS.js";
+} from "./chunk-RFGQDIOI.js";
 import {
   formatDgmoError,
   makeDgmoError,
@@ -202,7 +203,8 @@ function parseSitemap(content, palette) {
       }
       currentTagGroup = null;
     }
-    if (!contentStarted && !currentTagGroup && measureIndent(line) === 0 && !trimmed.includes("|") && !trimmed.includes("->") && !trimmed.includes(":")) {
+    if (!contentStarted && !currentTagGroup && measureIndent(line) === 0 && !trimmed.includes("|") && !trimmed.includes("->") && !trimmed.includes(":") && // `Home collapsed` is a page carrying the bare fold flag, not an option.
+    !/[ \t]collapsed$/.test(trimmed)) {
       const dirBool = trimmed.match(/^direction-(lr|tb)$/i);
       if (dirBool) {
         result.direction = dirBool[1].toUpperCase();
@@ -260,7 +262,10 @@ function parseSitemap(content, palette) {
         /^(.*?)\s+as\s+([A-Za-z][A-Za-z0-9_]{0,11})\s*$/
       );
       const label = peelQuotedName(asMatch ? asMatch[1].trim() : rawLabel);
-      const tail = (containerMatch[2] ?? "").trim();
+      const barePeel = peelTrailingCollapsedFlag(
+        (containerMatch[2] ?? "").trim()
+      );
+      const tail = barePeel.rest.trim();
       const containerMetadata = {};
       if (tail.length > 0) {
         Object.assign(
@@ -268,6 +273,10 @@ function parseSitemap(content, palette) {
           parseSitemapMetaTail(tail, metaAliasMap)
         );
       }
+      const containerCollapsed = liftCollapsed(
+        containerMetadata,
+        barePeel.collapsed
+      );
       containerCounter++;
       const containerId = `container-${containerCounter}`;
       if (asMatch) nameAliasMap.declare(asMatch[2], containerId, lineNumber);
@@ -279,7 +288,10 @@ function parseSitemap(content, palette) {
         children: [],
         parentId: null,
         isContainer: true,
-        lineNumber
+        lineNumber,
+        ...containerCollapsed !== void 0 && {
+          collapsed: containerCollapsed
+        }
       };
       attachNode(node, indent, indentStack, result);
       const key = normalizeName(label);
@@ -294,6 +306,8 @@ function parseSitemap(content, palette) {
           lineNumber,
           "Metadata 'key: value' must be indented under a page \u2014 no page precedes it."
         );
+      } else if (key === "collapsed") {
+        parent.collapsed = value.toLowerCase() === "true";
       } else {
         parent.metadata = { ...parent.metadata, [key]: value };
       }
@@ -426,8 +440,10 @@ function parseNodeLabel(trimmed, lineNumber, _palette, counter, metaAliasMap = /
     new Set(metaAliasMap.keys())
   );
   const id = `node-${counter}`;
+  const barePeel = peelTrailingCollapsedFlag(trimmed);
+  const bareCollapsed = barePeel.collapsed && barePeel.rest.trim() !== "";
   const split = splitNameAndMeta(
-    trimmed,
+    bareCollapsed ? barePeel.rest : trimmed,
     registry,
     metaAliasMap,
     void 0,
@@ -456,10 +472,12 @@ function parseNodeLabel(trimmed, lineNumber, _palette, counter, metaAliasMap = /
     }
     delete metadata["description"];
   }
+  const collapsed = liftCollapsed(metadata, bareCollapsed);
   return {
     id,
     label,
     metadata,
+    ...collapsed !== void 0 && { collapsed },
     ...description !== void 0 && { description },
     children: [],
     parentId: null,
@@ -467,6 +485,15 @@ function parseNodeLabel(trimmed, lineNumber, _palette, counter, metaAliasMap = /
     lineNumber
   };
 }
+function liftCollapsed(metadata, bare) {
+  let collapsed = bare ? true : void 0;
+  const raw = metadata["collapsed"];
+  if (raw !== void 0) {
+    collapsed ??= raw.toLowerCase() === "true";
+    delete metadata["collapsed"];
+  }
+  return collapsed;
+}
 function parseSitemapMetaTail(tail, metaAliasMap) {
   const trimmed = tail.trim();
   if (!trimmed?.includes(":")) return {};

package/dist/chunk-KNKZGRRB.js

@@ -0,0 +1,439 @@
+import {
+  normalizeName
+} from "./chunk-NOTA6TEI.js";
+import {
+  AUTO_TAG_COLOR_SENTINEL,
+  activeTagNoMatchMessage,
+  finalizeAutoTagColors,
+  matchTagBlockHeading,
+  stripDefaultModifier,
+  tagAttrKey,
+  validateTagGroupNames
+} from "./chunk-KW3CC7SB.js";
+import {
+  SWOT_REGISTRY,
+  extractColor,
+  measureIndent,
+  parseFirstLine,
+  peelQuotedName,
+  splitNameAndMeta,
+  warnUnknownMetaKeys,
+  withTagAliases
+} from "./chunk-RFGQDIOI.js";
+import {
+  resolveColorWithDiagnostic
+} from "./chunk-3J7O3CU6.js";
+import {
+  emit,
+  formatDgmoError,
+  makeDgmoError,
+  makeFail,
+  suggest
+} from "./chunk-BYU54C3S.js";
+
+// src/swot/diagnostics.ts
+var SWOT_DX = {
+  UNKNOWN_SECTION: {
+    code: "E_SWOT_UNKNOWN_SECTION",
+    severity: "error",
+    chartType: "swot",
+    title: "Unknown section",
+    message: (p) => `Unknown section '${p.word ?? "word"}'. Did you mean '${p.nearest ?? "strengths"}'?`,
+    hint: "A line at indent 0 opens one of: strengths, weaknesses, opportunities, threats. There are no brackets.",
+    example: `swot
+
+[Strengths]
+  Loyal crew`
+  },
+  DUPLICATE_SECTION: {
+    code: "E_SWOT_DUPLICATE_SECTION",
+    severity: "error",
+    chartType: "swot",
+    title: "Duplicate section",
+    message: (p) => `Section '${p.section ?? "strengths"}' appears more than once.`,
+    hint: "Merge the items under one section line.",
+    example: `swot
+
+strengths
+  Loyal crew
+strengths
+  Fast ship`
+  },
+  EMPTY_SECTION: {
+    code: "W_SWOT_EMPTY_SECTION",
+    severity: "warning",
+    chartType: "swot",
+    title: "Empty section",
+    message: (p) => `Section '${p.section ?? "threats"}' has no items, so its panel says "None listed".`,
+    hint: "Indent at least one item under the section line.",
+    example: `swot
+
+strengths
+  Loyal crew
+weaknesses
+  Old sails
+opportunities
+  New trade route`
+  },
+  ORPHAN_ITEM: {
+    code: "E_SWOT_ORPHAN_ITEM",
+    severity: "error",
+    chartType: "swot",
+    title: "Item before a section",
+    message: (p) => `Item '${p.item ?? "item"}' comes before any section.`,
+    hint: "Put a section line above it: strengths, weaknesses, opportunities or threats.",
+    example: `swot
+
+  Loyal crew
+strengths
+  Fast ship`
+  },
+  TOO_DEEP: {
+    code: "E_SWOT_TOO_DEEP",
+    severity: "error",
+    chartType: "swot",
+    title: "Nested too deep",
+    message: (p) => `'${p.item ?? "line"}' is nested too deep. An item takes one detail level.`,
+    hint: "Move the line up to the detail level, or make it an item of its own.",
+    example: `swot
+
+strengths
+  Loyal crew
+    Sworn in
+      At Tortuga`
+  }
+};
+var SWOT_DIAGNOSTICS = Object.values(SWOT_DX);
+
+// src/swot/parser.ts
+var SECTION_DEFAULTS = [
+  { key: "strengths", label: "Strengths", color: "green" },
+  { key: "weaknesses", label: "Weaknesses", color: "yellow" },
+  { key: "opportunities", label: "Opportunities", color: "blue" },
+  { key: "threats", label: "Threats", color: "red" }
+];
+var SECTION_KEYS = SECTION_DEFAULTS.map((s) => s.key);
+var VALUE_OPTIONS = /* @__PURE__ */ new Set(["active-tag", "palette"]);
+var BOOLEAN_OPTIONS = /* @__PURE__ */ new Set([
+  "no-axes",
+  "no-tint-items",
+  "no-title",
+  "no-legend",
+  "legend-inline"
+]);
+var DEFAULT_X_LABELS = ["Helpful", "Harmful"];
+var DEFAULT_Y_LABELS = ["Internal", "External"];
+function editDistance(a, b) {
+  let row = Array.from({ length: b.length + 1 }, (_, j) => j);
+  for (let i = 1; i <= a.length; i++) {
+    const next = [i];
+    for (let j = 1; j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      next.push(Math.min(row[j] + 1, next[j - 1] + 1, row[j - 1] + cost));
+    }
+    row = next;
+  }
+  return row[b.length];
+}
+function nearestSection(word) {
+  const clean = word.toLowerCase().replace(/[^a-z]/g, "");
+  let best = SECTION_KEYS[0];
+  let bestDistance = Number.POSITIVE_INFINITY;
+  for (const key of SECTION_KEYS) {
+    const distance = editDistance(clean, key);
+    if (distance < bestDistance) {
+      best = key;
+      bestDistance = distance;
+    }
+  }
+  return best;
+}
+function parseItemLine(trimmed, lineNumber, counter, metaAliasMap, diagnostics) {
+  const text = trimmed.startsWith("- ") ? trimmed.slice(2).trim() : trimmed;
+  const registry = withTagAliases(SWOT_REGISTRY, new Set(metaAliasMap.keys()));
+  const split = splitNameAndMeta(
+    text,
+    registry,
+    metaAliasMap,
+    void 0,
+    diagnostics,
+    lineNumber,
+    { peelAlias: false }
+  );
+  warnUnknownMetaKeys(
+    split.meta,
+    registry,
+    (msg) => diagnostics.push(makeDgmoError(lineNumber, msg, "warning")),
+    split.name
+  );
+  const name = peelQuotedName(split.name);
+  const title = split.color !== void 0 ? `${name} ${split.color}` : name;
+  return {
+    id: `item-${counter}`,
+    title,
+    tags: { ...split.meta },
+    details: [],
+    lineNumber,
+    endLineNumber: lineNumber
+  };
+}
+function parseSwot(content, palette) {
+  const options = {};
+  const sectionsByKey = /* @__PURE__ */ new Map();
+  const result = {
+    type: "swot",
+    sections: [],
+    tagGroups: [],
+    options,
+    xLabels: DEFAULT_X_LABELS,
+    yLabels: DEFAULT_Y_LABELS,
+    diagnostics: [],
+    error: null
+  };
+  const diagnostics = result.diagnostics;
+  const fail = makeFail(result);
+  const report = (spec, line, params) => {
+    const diag = emit(spec, line, params);
+    diagnostics.push(diag);
+    if (diag.severity === "error") result.error ??= formatDgmoError(diag);
+  };
+  const warn = (line, message, code) => {
+    diagnostics.push(makeDgmoError(line, message, "warning", code));
+  };
+  const defaultColor = (word, line) => resolveColorWithDiagnostic(word, line, diagnostics, palette) ?? word;
+  if (!content?.trim()) {
+    return fail(0, "No content provided");
+  }
+  const lines = content.split("\n");
+  const metaAliasMap = /* @__PURE__ */ new Map();
+  const tagGroups = result.tagGroups;
+  let firstLineSeen = false;
+  let contentStarted = false;
+  let activeTagLine = 0;
+  let currentTagGroup = null;
+  let currentSection = null;
+  let currentItem = null;
+  let itemIndent = 0;
+  let detailIndent = null;
+  let itemCounter = 0;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineNumber = i + 1;
+    const trimmed = line.trim();
+    if (!trimmed) {
+      currentTagGroup = null;
+      continue;
+    }
+    if (trimmed.startsWith("//")) continue;
+    if (!firstLineSeen) {
+      firstLineSeen = true;
+      const firstLine = parseFirstLine(trimmed);
+      if (firstLine) {
+        if (firstLine.chartType !== "swot") {
+          let msg = `Expected chart type "swot", got "${firstLine.chartType}"`;
+          const hint = suggest(firstLine.chartType, ["swot"]);
+          if (hint) msg += `. ${hint}`;
+          return fail(lineNumber, msg);
+        }
+        if (firstLine.title) {
+          result.title = firstLine.title;
+          result.titleLineNumber = lineNumber;
+        }
+        continue;
+      }
+    }
+    const indent = measureIndent(line);
+    if (currentTagGroup && !contentStarted) {
+      if (indent > 0) {
+        const { text, isDefault } = stripDefaultModifier(trimmed);
+        const { label, color } = extractColor(
+          text,
+          palette,
+          diagnostics,
+          lineNumber
+        );
+        if (isDefault || currentTagGroup.entries.length === 0) {
+          currentTagGroup.defaultValue = label;
+        }
+        currentTagGroup.entries.push({
+          value: label,
+          color: color ?? AUTO_TAG_COLOR_SENTINEL,
+          lineNumber
+        });
+        continue;
+      }
+      currentTagGroup = null;
+    }
+    if (indent === 0) {
+      if (!contentStarted) {
+        const heading = matchTagBlockHeading(trimmed);
+        if (heading) {
+          currentTagGroup = {
+            name: heading.name,
+            ...heading.alias !== void 0 && { alias: heading.alias },
+            entries: [],
+            lineNumber
+          };
+          if (heading.alias) {
+            metaAliasMap.set(
+              normalizeName(heading.alias),
+              tagAttrKey(heading.name)
+            );
+          }
+          metaAliasMap.set(
+            normalizeName(heading.name),
+            tagAttrKey(heading.name)
+          );
+          tagGroups.push(currentTagGroup);
+          continue;
+        }
+      }
+      const space = trimmed.search(/\s/);
+      const word = space < 0 ? trimmed : trimmed.slice(0, space);
+      const rest = space < 0 ? "" : trimmed.slice(space + 1).trim();
+      const keyword = word.toLowerCase();
+      if (SECTION_KEYS.includes(keyword)) {
+        contentStarted = true;
+        currentItem = null;
+        const key = keyword;
+        const existing = sectionsByKey.get(key);
+        if (existing) {
+          report(SWOT_DX.DUPLICATE_SECTION, lineNumber, { section: keyword });
+          currentSection = existing;
+          continue;
+        }
+        const { label, color } = extractColor(
+          `${keyword} ${rest}`.trim(),
+          palette,
+          diagnostics,
+          lineNumber
+        );
+        const defaults = SECTION_DEFAULTS.find((s) => s.key === key);
+        const written = peelQuotedName(label.slice(keyword.length).trim());
+        currentSection = {
+          key,
+          label: written || defaults.label,
+          color: color ?? defaultColor(defaults.color, lineNumber),
+          items: [],
+          lineNumber
+        };
+        sectionsByKey.set(key, currentSection);
+        continue;
+      }
+      if (BOOLEAN_OPTIONS.has(keyword) && !rest) {
+        options[keyword] = "on";
+        continue;
+      }
+      if (VALUE_OPTIONS.has(keyword) && rest) {
+        options[keyword] = rest;
+        if (keyword === "active-tag") activeTagLine = lineNumber;
+        continue;
+      }
+      if (keyword === "x-label" || keyword === "y-label") {
+        const parts = rest.split(",").map((s) => s.trim()).filter(Boolean);
+        if (parts.length === 2) {
+          const pair = [parts[0], parts[1]];
+          if (keyword === "x-label") result.xLabels = pair;
+          else result.yLabels = pair;
+        } else {
+          warn(
+            lineNumber,
+            `'${keyword}' takes two labels, like '${keyword} A, B'. Using the defaults.`
+          );
+        }
+        continue;
+      }
+      report(SWOT_DX.UNKNOWN_SECTION, lineNumber, {
+        word,
+        nearest: nearestSection(word)
+      });
+      currentSection = null;
+      currentItem = null;
+      contentStarted = true;
+      continue;
+    }
+    if (!currentSection) {
+      if (result.error === null) {
+        report(SWOT_DX.ORPHAN_ITEM, lineNumber, { item: trimmed });
+      }
+      continue;
+    }
+    if (currentItem && indent > itemIndent) {
+      if (detailIndent === null || indent <= detailIndent) {
+        currentItem.details.push(trimmed);
+        currentItem.endLineNumber = lineNumber;
+        detailIndent = indent;
+      } else {
+        report(SWOT_DX.TOO_DEEP, lineNumber, { item: trimmed });
+      }
+      continue;
+    }
+    itemCounter++;
+    currentItem = parseItemLine(
+      trimmed,
+      lineNumber,
+      itemCounter,
+      metaAliasMap,
+      diagnostics
+    );
+    itemIndent = indent;
+    detailIndent = null;
+    currentSection.items.push(currentItem);
+  }
+  const tagValueSets = new Map(
+    tagGroups.map((group) => [
+      tagAttrKey(group.name),
+      new Set(group.entries.map((e) => e.value.toLowerCase()))
+    ])
+  );
+  result.sections = SECTION_DEFAULTS.map((defaults) => {
+    const section = sectionsByKey.get(defaults.key);
+    if (section) return section;
+    return {
+      key: defaults.key,
+      label: defaults.label,
+      color: defaultColor(defaults.color, 1),
+      items: [],
+      lineNumber: 0
+    };
+  });
+  for (const section of result.sections) {
+    if (section.items.length === 0) {
+      report(SWOT_DX.EMPTY_SECTION, section.lineNumber || 1, {
+        section: section.key
+      });
+    }
+    for (const item of section.items) {
+      for (const [tagKey, tagValue] of Object.entries(item.tags)) {
+        const groupKey = metaAliasMap.get(tagKey.toLowerCase()) ?? tagKey;
+        const valid = tagValueSets.get(groupKey);
+        if (valid && !valid.has(tagValue.toLowerCase())) {
+          const entries = tagGroups.find((g) => tagAttrKey(g.name) === groupKey)?.entries.map((e) => e.value);
+          let msg = `Unknown tag value "${tagValue}" for group "${groupKey}"`;
+          const hint = entries ? suggest(tagValue, entries) : null;
+          if (hint) msg += `. ${hint}`;
+          warn(item.lineNumber, msg);
+        }
+      }
+    }
+  }
+  finalizeAutoTagColors(tagGroups, palette);
+  validateTagGroupNames(tagGroups, warn, (line, msg) => {
+    const diag = makeDgmoError(line, msg);
+    diagnostics.push(diag);
+    result.error ??= formatDgmoError(diag);
+  });
+  const activeTagWarning = activeTagNoMatchMessage(
+    options["active-tag"],
+    tagGroups
+  );
+  if (activeTagWarning) {
+    warn(activeTagLine || 1, activeTagWarning, "W_ACTIVE_TAG_NO_MATCH");
+  }
+  return result;
+}
+
+export {
+  SWOT_DIAGNOSTICS,
+  parseSwot
+};

package/dist/{chunk-XIUGSUE4.js → chunk-KTGJQJB3.js}

@@ -1,3 +1,6 @@
+import {
+  markTitleRoot
+} from "./chunk-35A3J4Z5.js";
 import {
   tryStripDescriptionKeyword
 } from "./chunk-IYULMRBE.js";
@@ -11,7 +14,7 @@ import {
   tagAttrKey,
   validateTagGroupNames,
   validateTagValues
-} from "./chunk-4SACN2C5.js";
+} from "./chunk-KW3CC7SB.js";
 import {
   MINDMAP_REGISTRY,
   OPTION_NOCOLON_RE,
@@ -23,7 +26,7 @@ import {
   tryParseSharedOption,
   warnUnknownMetaKeys,
   withTagAliases
-} from "./chunk-TIIZIAGS.js";
+} from "./chunk-RFGQDIOI.js";
 import {
   formatDgmoError,
   makeDgmoError,
@@ -99,6 +102,7 @@ function parseMindmap(content, palette) {
             parentId: null,
             lineNumber
           };
+          markTitleRoot(titleRoot);
           result.roots.push(titleRoot);
           indentStack.push({ node: titleRoot, indent: -1 });
         }

package/dist/{chunk-4SACN2C5.js → chunk-KW3CC7SB.js}

@@ -2,7 +2,7 @@ import {
   peelQuotedName,
   stripQuotes,
   tokenizeQuoteAware
-} from "./chunk-TIIZIAGS.js";
+} from "./chunk-RFGQDIOI.js";
 import {
   CATEGORICAL_COLOR_ORDER,
   RECOGNIZED_COLOR_NAMES,

package/dist/{chunk-3GUEYQGL.js → chunk-L3K5O3Z5.js}

@@ -1,7 +1,7 @@
 import {
   extractDatePrefix,
   parseTimelineDate
-} from "./chunk-BQO24BDM.js";
+} from "./chunk-O3HRF25Z.js";
 import {
   makeYearContext,
   parseDateToken,
@@ -16,7 +16,7 @@ import {
   tagAttrKey,
   validateTagGroupNames,
   validateTagValues
-} from "./chunk-4SACN2C5.js";
+} from "./chunk-KW3CC7SB.js";
 import {
   EVENT_LINE_REGISTRY,
   extractColor,
@@ -27,7 +27,7 @@ import {
   tryParseSharedOption,
   warnUnknownMetaKeys,
   withTagAliases
-} from "./chunk-TIIZIAGS.js";
+} from "./chunk-RFGQDIOI.js";
 import {
   emit,
   formatDgmoError,