@miragon/design-iq-validator 5.10.0 → 5.11.0

package/README.md

@@ -7,7 +7,8 @@ the generic cross-model reference rule (every required reference — `callActivi
 notations, and a per-mediaKind parse baseline for every other registered notation (a file that
 is no JSON or XML is an ERROR; DSL notations are lenient by design; a `mermaid` fence in a
 Markdown document that does not start with a diagram type such as `flowchart` or
-`sequenceDiagram` is a WARN, `mermaid/diagram-type`, naming the document's line). Every finding
+`sequenceDiagram` is a WARN, `mermaid/diagram-type`, naming the document's line; another casing
+passes only where mermaid draws it, so `Ishikawa` passes and `Flowchart` warns). Every finding
 carries a stable `ruleId` (e.g. `bpmn/flow`, `dmn/di`, `refs/dangling`). It treats the target
 repo as pure data — it never executes content-repo code. Exit code 0 = no errors (warnings
 allowed), 1 = errors.

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { o as runCli } from "./validate-BWa99fy6.js";
+import { o as runCli } from "./validate-HHrcxggb.js";
 //#region src/cli.ts
 /**
 * CLI entry for the platform validator. A dedicated entry file (instead of an

package/dist/{content-BjTdVfz8.js → content-2Udu_aBL.js}

@@ -545,6 +545,8 @@ const TT_EDGE_INTERACTIONS_VERSION = 1;
 function extractTeamTopology(raw) {
 	const data = JSON.parse(raw);
 	const list = (v) => Array.isArray(v) ? v : [];
+	const objects = (v) => list(v).filter((i) => i !== null && typeof i === "object");
+	const text = (v) => typeof v === "string" && v !== "" ? v : void 0;
 	const teams = list(data.nodes).map((n) => ({
 		id: n.id,
 		type: n.type ?? "team",
@@ -552,16 +554,38 @@ function extractTeamTopology(raw) {
 		extra: n.description ? { description: n.description } : void 0
 	}));
 	const placed = (i) => "position" in i && "size" in i;
-	const interactions = list(data.interactions).filter((i) => i !== null && typeof i === "object").filter((i) => data.version !== TT_EDGE_INTERACTIONS_VERSION || placed(i)).map((i) => ({
+	const interactions = objects(data.interactions).filter((i) => data.version !== TT_EDGE_INTERACTIONS_VERSION || placed(i)).map((i) => ({
 		id: i.id,
 		type: "interaction",
 		name: i.label,
 		extra: { mode: i.mode }
 	}));
+	const flows = objects(data.flows).map((f) => ({
+		id: f.id,
+		type: "flow",
+		name: text(f.label)
+	}));
+	const attachable = new Set([
+		...teams,
+		...interactions,
+		...flows
+	].map((n) => n.id));
+	const annotations = objects(data.annotations).map((a) => ({
+		id: a.id,
+		type: "annotation",
+		name: text(a.text),
+		extra: typeof a.attachedTo === "string" && attachable.has(a.attachedTo) ? { attachedTo: a.attachedTo } : void 0
+	}));
 	return {
 		notation: "team-topology",
-		nodes: [...teams, ...interactions],
-		edges: []
+		nodes: [
+			...teams,
+			...interactions,
+			...flows,
+			...annotations
+		],
+		edges: [],
+		meta: { title: text(data.title) ?? null }
 	};
 }
 const STORM_ID_PREFIX = {

package/dist/{content-CAFoHROH.js → content-aBn6QjJK.js}

@@ -1 +1 @@
-export { t as CONTENT_CONFIG_FILE, i as contentConfigConflict, a as discoverModels, o as legacyContentConfigFile, s as loadContentConfig } from "./content-BjTdVfz8.js";
+export { t as CONTENT_CONFIG_FILE, i as contentConfigConflict, a as discoverModels, o as legacyContentConfigFile, s as loadContentConfig } from "./content-2Udu_aBL.js";

package/dist/{validate-BWa99fy6.js → validate-HHrcxggb.js}

@@ -1,4 +1,4 @@
-import { _ as byId, c as resolveContentConfigFile, d as extractModelGraph, f as parseXml, g as byExtension, h as kindOf, l as XMLValidator, m as requirementHref, p as readBpmn, r as CONTENT_CONFIG_NAMES, u as asArray } from "./content-BjTdVfz8.js";
+import { _ as byId, c as resolveContentConfigFile, d as extractModelGraph, f as parseXml, g as byExtension, h as kindOf, l as XMLValidator, m as requirementHref, p as readBpmn, r as CONTENT_CONFIG_NAMES, u as asArray } from "./content-2Udu_aBL.js";
 import { readFileSync } from "node:fs";
 import { relative, resolve } from "node:path";
 import { parseDocumentText, serializeDocumentText, validateDocument } from "@miragon/context-maps-schema-model";
@@ -98,9 +98,14 @@ const SETEXT_UNDERLINE = /^(?:=+|-+)[ \t]*$/;
 const BULLET = /^[-+*](?=[ \t]|$)/;
 const ORDERED = /^(\d{1,9})[.)](?=[ \t]|$)/;
 const BLANK = /^[ \t]*$/;
+/** a footnote definition's marker: a label without blanks */
+const FOOTNOTE_DEFINITION = /^\[\^[^\] ]+\]:/;
+/** the columns a footnote definition's content is indented by past the definition */
+const FOOTNOTE_INDENT = 4;
 /** a link reference definition on one line: [label]: destination "title" (a
-*  "[^" label is a footnote, which render.ts keeps as paragraph text; a bare
-*  destination ends at a space or a control character, as in markdown-it) */
+*  "[^" label is a footnote definition, or with a blank in it paragraph text
+*  to render.ts; a bare destination ends at a space or a control character,
+*  as in markdown-it) */
 const LINK_DEFINITION = /^\[(?!\^)((?:[^[\]\\]|\\.)*)\]:[ \t]*(<(?:[^<>\\]|\\.)*>|[^ <\x00-\x1f\x7f][^ \x00-\x1f\x7f]*)(?:[ \t]+(?:"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|\((?:[^()\\]|\\.)*\)))?[ \t]*$/;
 /** the destinations markdown-it's validateLink refuses: no definition then */
 const BAD_LINK = /^(?:vbscript|javascript|file|data):/i;
@@ -216,6 +221,11 @@ function continues(container, rest, lead) {
 		const at = dropIndent(rest, lead.indent);
 		return at.text.startsWith(">") ? afterQuoteMarker(at) : void 0;
 	}
+	if (container.kind === "footnote") {
+		if (!lead.blank && lead.indent < FOOTNOTE_INDENT) return void 0;
+		lead.indent = Math.max(0, lead.indent - FOOTNOTE_INDENT);
+		return dropIndent(rest, FOOTNOTE_INDENT);
+	}
 	const fresh = container.fresh;
 	container.fresh = false;
 	if (lead.blank ? fresh : lead.indent < container.indent) return void 0;
@@ -250,9 +260,25 @@ function listItem(at, indent, level, interruptsParagraph) {
 function htmlBlock(text) {
 	return text.startsWith("<") ? HTML_BLOCKS.find(([start]) => start.test(text)) : void 0;
 }
+/**
+* The content of a footnote definition's first line, `at` the line after its
+* indent: the text after the colon. markdown-it-footnote indents it by the
+* blanks after the colon, less `indent` (the columns the definition's content
+* is indented by in the innermost quote) once there are that many.
+*/
+function footnoteContent(at, marker, indent) {
+	const after = {
+		text: at.text.slice(marker.length),
+		col: at.col + marker.length
+	};
+	return indentOf(after) < indent ? after : dropIndent(after, indent);
+}
 /** whether a line that does not continue a paragraph's containers starts a
-*  block of its own (else it is a lazy continuation line of the paragraph) */
-function startsBlock(rest) {
+*  block of its own (else it is a lazy continuation line of the paragraph).
+*  A footnote definition does, whatever its indent, but not in a quote it
+*  does not continue: a quote reads it as a lazy line */
+function startsBlock(rest, quoted) {
+	if (!quoted && FOOTNOTE_DEFINITION.test(dropIndent(rest, indentOf(rest)).text)) return true;
 	const at = blockStart(rest);
 	if (!at) return false;
 	const text = at.text;
@@ -308,6 +334,16 @@ function markdownFences(source) {
 	const fences = [];
 	const stack = [];
 	const level = () => stack.length > 0 ? stack[stack.length - 1].level : 0;
+	/** the columns the innermost container's content is indented by, counted
+	*  from the innermost quote (inside a quote markdown-it counts from its ">") */
+	const contentIndent = () => {
+		let indent = 0;
+		for (let i = stack.length - 1; i >= 0 && stack[i].kind !== "quote"; i--) {
+			const container = stack[i];
+			indent += container.kind === "item" ? container.indent : FOOTNOTE_INDENT;
+		}
+		return indent;
+	};
 	let leaf = NONE;
 	let dropping;
 	const finish = (fence, closed) => {
@@ -341,7 +377,7 @@ function markdownFences(source) {
 				dropping.lastBlank = BLANK.test(rest.text);
 				continue;
 			}
-			if (!dropping.lastBlank && !BLANK.test(rest.text) && !startsBlock(rest)) continue;
+			if (!dropping.lastBlank && !BLANK.test(rest.text) && !startsBlock(rest, true)) continue;
 			dropping = void 0;
 		}
 		if (leaf.kind === "fence" && all) {
@@ -356,7 +392,8 @@ function markdownFences(source) {
 			continue;
 		}
 		if (!all) {
-			if (leaf.kind === "paragraph" && !BLANK.test(rest.text) && !startsBlock(rest)) continue;
+			const quoted = stack.slice(matched).some((container) => container.kind === "quote");
+			if (leaf.kind === "paragraph" && !BLANK.test(rest.text) && !startsBlock(rest, quoted)) continue;
 			if (leaf.kind === "fence") finish(leaf, false);
 			stack.length = matched;
 			leaf = NONE;
@@ -364,12 +401,19 @@ function markdownFences(source) {
 		while (level() < MAX_NESTING && !BLANK.test(rest.text)) {
 			const at = blockStart(rest);
 			if (!at) break;
+			const footnote = FOOTNOTE_DEFINITION.exec(at.text)?.[0];
 			if (at.text.startsWith(">")) {
 				stack.push({
 					kind: "quote",
 					level: level() + 1
 				});
 				rest = afterQuoteMarker(at);
+			} else if (footnote !== void 0) {
+				stack.push({
+					kind: "footnote",
+					level: level() + 1
+				});
+				rest = footnoteContent(at, footnote, contentIndent());
 			} else {
 				if (THEMATIC_BREAK.test(at.text)) break;
 				const opening = listItem(at, indentOf(rest), level(), leaf.kind === "paragraph");
@@ -496,8 +540,44 @@ const KEEPS_COMMENTS = /^(?:eventmodeling|agentflow-beta\b)/;
 /** mermaid's default maxTextSize, which apps/web keeps (a secure key): past
 *  it, mermaid parses even those types without their comment lines */
 const MAX_TEXT_SIZE = 5e4;
-/** a header keyword, followed by the end of the line, a space, ":" or ";" */
-const HEADER = new RegExp(`^(?:${MERMAID_DIAGRAM_TYPES.map((t) => t.replace(/[.*+?^${}()|[\]\\-]/g, "\\$&")).join("|")})(?=$|[\\s:;])`);
+/**
+* The header keywords MERMAID_VERSION also draws in another casing, each with
+* the part its detector matches as written. Past that part, the detector
+* ignores case (src/diagrams/ishikawa/ishikawaDetector.ts) or matches no
+* further (src/diagrams/requirement/requirementDetector.ts stops at
+* `requirement`), and the grammar's lexer ignores case. Every other keyword
+* draws as listed only: its detector or its grammar reads it as written
+* (wardley-beta's and the railroad types' detectors ignore case, but their
+* grammars refuse `Wardley-beta`).
+*/
+const ANY_CASE_AFTER = /* @__PURE__ */ new Map([
+	["ishikawa", ""],
+	["ishikawa-beta", ""],
+	["requirementDiagram", "requirement"],
+	["stateDiagram-v2", "stateDiagram"],
+	["xychart-beta", "xychart"],
+	["sankey-beta", "sankey"]
+]);
+const escapeRegExp = (text) => text.replace(/[.*+?^${}()|[\]\\-]/g, "\\$&");
+/** `text` in any casing, a character class per letter: the `i` flag would
+*  cover every keyword, and not every browser reads an inline (?i:…) group */
+const anyCase = (text) => [...text].map((character) => character.toLowerCase() === character.toUpperCase() ? escapeRegExp(character) : `[${character.toLowerCase()}${character.toUpperCase()}]`).join("");
+/**
+* The header keyword `type` (a MERMAID_DIAGRAM_TYPES entry) in every casing
+* MERMAID_VERSION draws it in, as the source of a regular expression without
+* flags or anchors. mermaidHeader reads a header with it, and so does the web
+* app's source editor (apps/web/src/lib/mermaid-monarch.ts): the two never
+* disagree about a header.
+*/
+function mermaidKeywordPattern(type) {
+	const asWritten = ANY_CASE_AFTER.get(type) ?? type;
+	return escapeRegExp(asWritten) + anyCase(type.slice(asWritten.length));
+}
+/** a header keyword in a casing mermaid draws, followed by the end of the
+*  line, a space, ":" or ";" */
+const HEADER = new RegExp(`^(?:${MERMAID_DIAGRAM_TYPES.map(mermaidKeywordPattern).join("|")})(?=$|[\\s:;])`);
+/** the listed keyword of a header keyword HEADER read in another casing */
+const LISTED_BY_LOWER_CASE = new Map(MERMAID_DIAGRAM_TYPES.map((type) => [type.toLowerCase(), type]));
 /** mermaid's cleanupText: line breaks to \n, tag attributes single-quoted;
 *  the line structure stays, so the source lines can be matched against it */
 function cleanup(source) {
@@ -580,10 +660,11 @@ function mermaidHeader(source) {
 	const index = headerIndex(lines);
 	if (index < 0) return void 0;
 	const text = lines[index].trim();
+	const keyword = HEADER.exec(text)?.[0];
 	return {
 		line: mermaidSourceLine(source, index + 1),
 		text,
-		diagramType: HEADER.exec(text)?.[0]
+		diagramType: keyword === void 0 ? void 0 : LISTED_BY_LOWER_CASE.get(keyword.toLowerCase())
 	};
 }
 //#endregion
@@ -1053,7 +1134,7 @@ async function runCli() {
 	/** optional single-model filter (a model file stem) */
 	const only = argv[0];
 	const rel = (p) => p.startsWith("/") ? relative(ROOT, p) : p;
-	const { CONTENT_CONFIG_FILE, contentConfigConflict, discoverModels, legacyContentConfigFile, loadContentConfig } = await import("./content-CAFoHROH.js");
+	const { CONTENT_CONFIG_FILE, contentConfigConflict, discoverModels, legacyContentConfigFile, loadContentConfig } = await import("./content-aBn6QjJK.js");
 	const cfg = loadContentConfig(ROOT);
 	if (!cfg) {
 		console.error(notContentRepoError(ROOT));

package/dist/validate.js

@@ -1 +1 @@
-export { t as checkBpmnXml, n as checkDmnXml, r as checkModel, i as checkModelBaseline, a as checkSchemaModel, o as runCli } from "./validate-BWa99fy6.js";
+export { t as checkBpmnXml, n as checkDmnXml, r as checkModel, i as checkModelBaseline, a as checkSchemaModel, o as runCli } from "./validate-HHrcxggb.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miragon/design-iq-validator",
-  "version": "5.10.0",
+  "version": "5.11.0",
   "type": "module",
   "description": "Platform-owned validator for designIQ content repos — designiq.yml discovery, BPMN/DMN structure and diagram coverage, cross-model references, the schema check of Team Topologies, Context Maps and Value Chains, and a parse check for every other notation. Runs against any checkout via --root; never executes content-repo code.",
   "license": "MIT",