@ingcreators/annot-product-docs 0.2.0 → 0.3.0

package/dist/index.js

@@ -1,15 +1,432 @@
-import { mkdir as e, readFile as t, readdir as n, writeFile as r } from "node:fs/promises";
-import { dirname as i, join as a, relative as o, resolve as s } from "node:path";
-import { test as c } from "@ingcreators/annot-playwright";
-import l from "js-yaml";
-import u from "remark-frontmatter";
-import d from "remark-mdx";
-import f from "remark-parse";
-import { unified as p } from "unified";
-import { visit as m } from "unist-util-visit";
-import { z as h } from "zod";
+import { annotSourceResolvers as e, test as t } from "@ingcreators/annot-playwright";
+import { mkdir as n, readFile as r, readdir as i, writeFile as a } from "node:fs/promises";
+import o from "js-yaml";
+import s from "remark-frontmatter";
+import c from "remark-mdx";
+import l from "remark-parse";
+import { unified as u } from "unified";
+import { visit as d } from "unist-util-visit";
+import { z as f } from "zod";
+import { dirname as p, isAbsolute as ee, join as te, relative as m, resolve as h } from "node:path";
+import { bboxAnnotationsToSvg as g } from "@ingcreators/annot-annotator";
+//#region src/config.ts
+var ne = f.enum([
+	"cover",
+	"history",
+	"list",
+	"screen",
+	"reference"
+]), re = f.object({
+	book: f.string().optional(),
+	sheet: f.string().optional(),
+	sheets: f.record(f.string(), f.string()).optional(),
+	role: ne.optional(),
+	order: f.number().optional()
+}).strict().refine((e) => !(e.sheet && e.sheets), "Specify either `xlsx.sheet` (single sheet) or `xlsx.sheets` (multi-sheet), not both."), ie = f.record(f.string(), f.unknown()), _ = f.object({
+	id: f.string().min(1, "`annot.id` is required."),
+	title: f.string().optional(),
+	purpose: f.string().optional(),
+	meta: ie.optional(),
+	xlsx: re.optional()
+}).strict(), ae = f.object({
+	template: f.string().optional(),
+	templateSheets: f.object({
+		cover: f.string().optional(),
+		history: f.string().optional(),
+		list: f.string().optional(),
+		screen: f.string().optional(),
+		reference: f.string().optional()
+	}).strict().optional()
+}).strict(), v = f.object({
+	meta: f.record(f.string(), f.unknown()).optional(),
+	xlsx: f.object({
+		defaultBook: f.string().optional(),
+		books: f.record(f.string(), ae).optional()
+	}).strict().optional()
+}).strict();
+function oe(e) {
+	let t = v.safeParse(e);
+	if (!t.success) {
+		let e = t.error.issues.map((e) => `  - ${e.path.length ? e.path.join(".") + ": " : ""}${e.message}`).join("\n");
+		throw Error(`Invalid \`annot-docs.config.ts\`:\n${e}`);
+	}
+	return t.data;
+}
+function se(e) {
+	return (e.xlsx?.role ?? "screen") === "screen";
+}
+//#endregion
+//#region src/mdx.ts
+var y = "annot:snapshot", ce = "/annot:snapshot", b = "annot:attributes", le = "/annot:attributes", ue = /^\s*\/\*\s*([^\s*]+)\s*([\s\S]*?)\*\/\s*$/;
+async function x(e) {
+	return S(await r(e, "utf8"), { filePath: e });
+}
+function S(e, t = {}) {
+	let n = u().use(l).use(s, ["yaml"]).use(c).parse(e), r = de(n, t.filePath);
+	if (!r) return null;
+	let i = [], a = [], o = [], f = [], p = {};
+	return d(n, (t) => {
+		switch (t.type) {
+			case "mdxJsxFlowElement":
+			case "mdxJsxTextElement":
+				pe(t, e, {
+					screens: i,
+					transitions: a,
+					history: o,
+					screenLists: f
+				});
+				return;
+			case "mdxFlowExpression":
+			case "mdxTextExpression":
+				ye(t, p);
+				return;
+		}
+	}), {
+		frontmatter: r,
+		screens: i,
+		transitions: a,
+		history: o,
+		screenLists: f,
+		commentBlocks: p,
+		source: e
+	};
+}
+function de(e, t) {
+	let n = e.children.find((e) => e.type === "yaml");
+	if (!n || !n.value) return null;
+	let r = o.load(n.value);
+	if (!r || typeof r != "object") return null;
+	let i = r.annot;
+	if (!i || typeof i != "object") return null;
+	let a = _.safeParse(i);
+	if (!a.success) {
+		let e = t ? ` in ${t}` : "";
+		throw Error(`Invalid \`annot:\` frontmatter${e}:\n${fe(a.error)}`);
+	}
+	return a.data;
+}
+function fe(e) {
+	return e.issues.map((e) => `  - ${e.path.length ? e.path.join(".") + ": " : ""}${e.message}`).join("\n");
+}
+function pe(e, t, n) {
+	let r = e;
+	switch (r.name) {
+		case "Screen":
+			n.screens.push(me(r, t));
+			return;
+		case "Transition":
+			n.transitions.push(ge(r, t));
+			return;
+		case "HistoryEntry":
+			n.history.push(_e(r, t));
+			return;
+		case "ScreenList":
+			n.screenLists.push(ve(r));
+			return;
+	}
+}
+function me(e, t) {
+	let n = C(e), r = [], i = (n) => {
+		let a = n;
+		if (a.name === "Overlay") {
+			r.push(he(a, t));
+			return;
+		}
+		if (!(a.name === "Screen" && a !== e)) for (let e of a.children ?? []) i(e);
+	};
+	for (let t of e.children ?? []) i(t);
+	let a = w(n.id);
+	if (!a) throw Error("<Screen> requires an `id` prop.");
+	return {
+		id: a,
+		src: w(n.src),
+		overlays: r
+	};
+}
+function he(e, t) {
+	let n = C(e), r = n.match;
+	if (!T(r)) throw Error("<Overlay> requires a `match` prop with at least `{ role, name }`.");
+	return {
+		match: r,
+		intent: w(n.intent),
+		number: xe(n.number),
+		body: E(e, t)
+	};
+}
+function ge(e, t) {
+	let n = C(e), r = n.trigger;
+	if (!T(r)) throw Error("<Transition> requires a `trigger` prop with at least `{ role, name }`.");
+	return {
+		trigger: r,
+		on: w(n.on),
+		to: w(n.to),
+		body: E(e, t)
+	};
+}
+function _e(e, t) {
+	let n = C(e), r = w(n.version) ?? "", i = w(n.date) ?? "", a = w(n.author) ?? "";
+	if (!r || !i) throw Error("<HistoryEntry> requires `version` and `date` props.");
+	return {
+		version: r,
+		date: i,
+		author: a,
+		body: E(e, t)
+	};
+}
+function ve(e) {
+	let t = C(e);
+	return {
+		book: w(t.book),
+		sort: w(t.sort)
+	};
+}
+function ye(e, t) {
+	let n = e.value;
+	if (typeof n != "string") return;
+	let r = n.match(ue);
+	if (!r) return;
+	let i = (r[1] ?? "").trim(), a = (r[2] ?? "").trim();
+	switch (i) {
+		case y:
+			t.snapshot = a;
+			return;
+		case b:
+			t.attributes = a;
+			return;
+		case ce:
+		case le: return;
+	}
+}
+function C(e) {
+	let t = {};
+	for (let n of e.attributes ?? []) {
+		let e = n;
+		if (e.type !== "mdxJsxAttribute" || !e.name) continue;
+		if (e.value === null || e.value === void 0) {
+			t[e.name] = !0;
+			continue;
+		}
+		if (typeof e.value == "string") {
+			t[e.name] = e.value;
+			continue;
+		}
+		let r = e.value;
+		r.type === "mdxJsxAttributeValueExpression" && typeof r.value == "string" && (t[e.name] = be(r.value));
+	}
+	return t;
+}
+function be(e) {
+	let t = e.trim();
+	if (t) {
+		if (t === "true") return !0;
+		if (t === "false") return !1;
+		if (t === "null") return null;
+		if (/^-?\d+(\.\d+)?$/.test(t)) return Number.parseFloat(t);
+		if (t.startsWith("\"") && t.endsWith("\"")) try {
+			return JSON.parse(t);
+		} catch {
+			return t.slice(1, -1);
+		}
+		if (t.startsWith("'") && t.endsWith("'")) {
+			let e = t.slice(1, -1), n = e.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+			try {
+				return JSON.parse(`"${n}"`);
+			} catch {
+				return e;
+			}
+		}
+		if (t.startsWith("{") && t.endsWith("}") || t.startsWith("[") && t.endsWith("]")) {
+			let e = t.replace(/([{,]\s*)([A-Za-z_$][A-Za-z0-9_$]*)(\s*:)/g, "$1\"$2\"$3").replace(/'([^'\\]*)'/g, "\"$1\"").replace(/,(\s*[}\]])/g, "$1");
+			try {
+				return JSON.parse(e);
+			} catch {
+				return t;
+			}
+		}
+		return t;
+	}
+}
+function w(e) {
+	return typeof e == "string" ? e : void 0;
+}
+function xe(e) {
+	return typeof e == "number" ? e : void 0;
+}
+function T(e) {
+	if (!e || typeof e != "object") return !1;
+	let t = e;
+	return !(typeof t.role != "string" || typeof t.name != "string" || t.under !== void 0 && !T(t.under));
+}
+function E(e, t) {
+	let n = e.position;
+	if (!n) return "";
+	let r = t.slice(n.start.offset, n.end.offset);
+	if (/\/>\s*$/.test(r)) return "";
+	let i = r.indexOf(">"), a = r.lastIndexOf("</");
+	return i < 0 || a < 0 || a <= i ? "" : r.slice(i + 1, a).trim();
+}
+function D(e, t) {
+	let n = e;
+	return t.snapshot !== void 0 && (n = O(n, y, t.snapshot)), t.attributes !== void 0 && (n = O(n, b, t.attributes)), n;
+}
+function O(e, t, n) {
+	let r = new RegExp(String.raw`\{\s*/\*\s*` + Ce(t) + String.raw`\s*[\s\S]*?\*/\s*\}`, "m"), i = Se(t, n);
+	return r.test(e) ? e.replace(r, i) : `${e.trimEnd()}\n\n${i}\n`;
+}
+function Se(e, t) {
+	let n = t.trim();
+	return n ? `{/* ${e}\n${n}\n*/}` : `{/* ${e} */}`;
+}
+function Ce(e) {
+	return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//#endregion
+//#region src/fixture.ts
+var k = [
+	"type",
+	"required",
+	"placeholder",
+	"maxlength",
+	"minlength",
+	"pattern",
+	"min",
+	"max",
+	"step",
+	"disabled",
+	"readonly",
+	"checked",
+	"aria-required",
+	"aria-disabled",
+	"aria-readonly"
+], we = t.extend({
+	productDocs: async ({ page: e }, t) => {
+		await t({ sync: (t) => A(e, t) });
+	},
+	screen: async ({ page: e }, t) => {
+		let n = (t) => A(e, t);
+		await t({
+			sync: n,
+			capture: n
+		});
+	}
+});
+async function A(e, t) {
+	let n = await x(t.mdxPath);
+	if (!n) throw Error(`syncProductDocs: ${t.mdxPath} has no \`annot:\` frontmatter — refusing to write.`);
+	let r = n.screens.find((e) => e.id === t.id);
+	if (!r) throw Error(`syncProductDocs: ${t.mdxPath} has no <Screen id="${t.id}"> block.`);
+	let i = await (t.rootLocator ?? e.locator("body")).ariaSnapshot({
+		mode: "ai",
+		boxes: !0
+	}), o = await j(e, r.overlays, t.attributeWhitelist ?? k), s = D(n.source, {
+		snapshot: i.trim(),
+		attributes: o
+	});
+	await a(t.mdxPath, s, "utf8");
+}
+var Te = A;
+async function j(e, t, n) {
+	let r = [];
+	for (let i of t) {
+		let t = e.getByRole(i.match.role, {
+			name: i.match.name,
+			exact: !0
+		});
+		if (await t.count() !== 1) continue;
+		let a = await t.evaluate((e, t) => {
+			let n = {};
+			for (let r of t) {
+				let t = e.getAttribute(r);
+				t !== null && (n[r] = t);
+			}
+			return n;
+		}, n), o = Object.keys(a);
+		if (o.length !== 0) {
+			r.push(`${i.match.role} "${i.match.name}":`);
+			for (let e of o) r.push(`  ${e}: ${a[e]}`);
+		}
+	}
+	return r.join("\n");
+}
+//#endregion
+//#region src/mdx-annotations.ts
+function M(e) {
+	let t = [];
+	for (let n of e.split(/\r?\n/)) {
+		if (!n.trim()) continue;
+		let e = n.match(/^\s*-\s+([a-z]+)(?:\s+"([^"]*?)")?/);
+		if (!e) continue;
+		let r = e[1] ?? "", i = e[2] ?? "", a = n.match(/\[ref=(e\d+)\]/)?.[1], o = n.match(/\[box=(-?\d+(?:\.\d+)?),(-?\d+(?:\.\d+)?),(-?\d+(?:\.\d+)?),(-?\d+(?:\.\d+)?)\]/);
+		!a || !o || t.push({
+			role: r,
+			name: i,
+			ref: a,
+			box: {
+				x: Number.parseFloat(o[1] ?? "0"),
+				y: Number.parseFloat(o[2] ?? "0"),
+				width: Number.parseFloat(o[3] ?? "0"),
+				height: Number.parseFloat(o[4] ?? "0")
+			}
+		});
+	}
+	return t;
+}
+function N(e, t, n) {
+	let r = [], i = 1;
+	for (let a of e) {
+		let e = t.find((e) => e.role === a.match.role && e.name === a.match.name);
+		if (!e) continue;
+		let o = a.number ?? i++;
+		r.push({
+			type: "numberedBadge",
+			bbox: e.box,
+			number: o,
+			placement: "auto",
+			imageWidth: n.width,
+			imageHeight: n.height,
+			intent: a.intent === "action" ? "warning" : a.intent === "required" ? "error" : "info"
+		});
+	}
+	return r;
+}
+async function P(e) {
+	let t = e.cwd ?? process.cwd(), n = await x(ee(e.mdxPath) ? e.mdxPath : h(t, e.mdxPath));
+	if (!n) throw Error(`resolveMdxAnnotations: ${e.mdxPath} has no \`annot:\` frontmatter — cannot resolve.`);
+	let r = n.screens.find((t) => t.id === e.screenId);
+	if (!r) throw Error(`resolveMdxAnnotations: ${e.mdxPath} has no <Screen id="${e.screenId}"> block.`);
+	let i = M(n.commentBlocks.snapshot ?? "");
+	return N(r.overlays, i, e.dims);
+}
+function Ee(e) {
+	return `<svg xmlns="http://www.w3.org/2000/svg">${g(e)}</svg>`;
+}
+function De(e) {
+	return e.length === 0 ? F() : `<svg xmlns="http://www.w3.org/2000/svg">${g(e)}</svg>`;
+}
+function F() {
+	return "<svg xmlns=\"http://www.w3.org/2000/svg\"></svg>";
+}
+//#endregion
+//#region src/playwright-screenshot-hook.ts
+var I = Symbol.for("@ingcreators/annot-product-docs:mdx-resolver"), L = async ({ annot: e, page: t }) => {
+	if (!e.mdx) return null;
+	let { id: n, path: r } = e.mdx;
+	return {
+		prepare: () => A(t, {
+			id: n,
+			mdxPath: r
+		}),
+		resolveAnnotations: (e) => P({
+			mdxPath: r,
+			screenId: n,
+			dims: e
+		})
+	};
+}, R = L;
+R[I] || (R[I] = !0, e.push(L));
+//#endregion
 //#region src/resolver.ts
-function g(e) {
+function z(e) {
 	let t = [], n = e.split(/\r?\n/), r = [];
 	for (let e of n) {
 		if (!e.trim()) continue;
@@ -35,16 +452,16 @@ function g(e) {
 	}
 	return t;
 }
-async function _(e, t, n) {
-	let r = te(t.filter((t) => t.role === e.role && t.name === e.name), e.under);
-	if (r.length === 0) return ne(e, t);
+async function B(e, t, n) {
+	let r = Ae(t.filter((t) => t.role === e.role && t.name === e.name), e.under);
+	if (r.length === 0) return je(e, t);
 	if (r.length > 1) return {
 		ok: !1,
 		kind: "ambiguous",
 		reason: `Multiple elements match role="${e.role}" name="${e.name}". Use \`under\` to disambiguate.`,
 		candidates: r.map((e) => `[ref=${e.ref}]`)
 	};
-	let i = r[0], a = v(n, e), o = await a.count();
+	let i = r[0], a = ke(n, e), o = await a.count();
 	return o === 0 ? {
 		ok: !1,
 		kind: "live-mismatch",
@@ -59,15 +476,15 @@ async function _(e, t, n) {
 		entry: i
 	};
 }
-async function ee(e, t, n) {
+async function Oe(e, t, n) {
 	let r = [];
 	for (let i of e) r.push({
 		overlay: i,
-		result: await _(i.match, t, n)
+		result: await B(i.match, t, n)
 	});
 	return r;
 }
-function v(e, t) {
+function ke(e, t) {
 	let n = e.getByRole(t.role, {
 		name: t.name,
 		exact: !0
@@ -80,10 +497,10 @@ function v(e, t) {
 		exact: !0
 	})), n;
 }
-function te(e, t) {
+function Ae(e, t) {
 	return t ? e.filter((e) => e.ancestors.some((e) => e.role === t.role && e.name === t.name)) : e;
 }
-function ne(e, t) {
+function je(e, t) {
 	let n = t.filter((t) => t.name === e.name);
 	if (n.length === 1 && n[0].role !== e.role) return {
 		ok: !1,
@@ -93,7 +510,7 @@ function ne(e, t) {
 	};
 	let r = t.filter((t) => t.role === e.role);
 	if (r.length > 0) {
-		let t = re(e.name, r.map((e) => e.name));
+		let t = Me(e.name, r.map((e) => e.name));
 		if (t) return {
 			ok: !1,
 			kind: "renamed",
@@ -107,16 +524,16 @@ function ne(e, t) {
 		reason: `No element with role="${e.role}" name="${e.name}".`
 	};
 }
-function re(e, t) {
+function Me(e, t) {
 	if (t.length === 0) return null;
-	let n = t[0], r = y(e, n);
+	let n = t[0], r = V(e, n);
 	for (let i of t.slice(1)) {
-		let t = y(e, i);
+		let t = V(e, i);
 		t > r && (n = i, r = t);
 	}
 	return r > .3 ? n : null;
 }
-function y(e, t) {
+function V(e, t) {
 	if (!e || !t) return 0;
 	let n = (e) => {
 		let t = /* @__PURE__ */ new Set();
@@ -130,7 +547,7 @@ function y(e, t) {
 }
 //#endregion
 //#region src/drift.ts
-function b(e) {
+function H(e) {
 	let { screen: t, liveSnapshot: n, storedAttributesYaml: r, freshAttributesYaml: i } = e, a = [], o = /* @__PURE__ */ new Set();
 	for (let e of t.overlays) {
 		let r = n.filter((t) => t.role === e.match.role && t.name === e.match.name);
@@ -160,7 +577,7 @@ function b(e) {
 		}
 		let s = n.filter((t) => t.role === e.match.role);
 		if (s.length > 0) {
-			let n = se(e.match.name, s.map((e) => e.name));
+			let n = Ie(e.match.name, s.map((e) => e.name));
 			if (n) {
 				o.add(`${e.match.role}|${n}`), a.push({
 					severity: "warning",
@@ -183,7 +600,7 @@ function b(e) {
 	}
 	let s = new Set(t.overlays.map((e) => `${e.match.role}|${e.match.name}`));
 	for (let e of n) {
-		if (!oe(e.role)) continue;
+		if (!Fe(e.role)) continue;
 		let n = `${e.role}|${e.name}`;
 		s.has(n) || o.has(n) || a.push({
 			severity: "warning",
@@ -196,22 +613,22 @@ function b(e) {
 			}
 		});
 	}
-	return r !== void 0 && i !== void 0 && C(r) !== C(i) && a.push({
+	return r !== void 0 && i !== void 0 && G(r) !== G(i) && a.push({
 		severity: "info",
 		kind: "attribute-drift",
 		screenId: t.id,
 		message: "`annot:attributes` block no longer matches live element attributes. Run `annot docs sync` to update."
 	}), a;
 }
-function ie(e) {
-	return b({
+function Ne(e) {
+	return H({
 		screen: e.screen,
-		liveSnapshot: g(e.liveSnapshotYaml),
+		liveSnapshot: z(e.liveSnapshotYaml),
 		storedAttributesYaml: e.storedAttributesYaml,
 		freshAttributesYaml: e.freshAttributesYaml
 	});
 }
-function x(e) {
+function U(e) {
 	let t = 0, n = 0, r = 0;
 	for (let i of e) i.severity === "error" ? t++ : i.severity === "warning" ? n++ : r++;
 	return {
@@ -220,7 +637,7 @@ function x(e) {
 		infos: r
 	};
 }
-var ae = new Set([
+var Pe = new Set([
 	"button",
 	"checkbox",
 	"combobox",
@@ -238,19 +655,19 @@ var ae = new Set([
 	"textbox",
 	"treeitem"
 ]);
-function oe(e) {
-	return ae.has(e);
+function Fe(e) {
+	return Pe.has(e);
 }
-function se(e, t) {
+function Ie(e, t) {
 	if (t.length === 0) return null;
-	let n = t[0], r = S(e, n);
+	let n = t[0], r = W(e, n);
 	for (let i of t.slice(1)) {
-		let t = S(e, i);
+		let t = W(e, i);
 		t > r && (n = i, r = t);
 	}
 	return r > .3 ? n : null;
 }
-function S(e, t) {
+function W(e, t) {
 	if (!e || !t) return 0;
 	let n = (e) => {
 		let t = /* @__PURE__ */ new Set();
@@ -262,364 +679,34 @@ function S(e, t) {
 	for (let e of r) i.has(e) && a++;
 	return a / Math.max(r.size, i.size);
 }
-function C(e) {
+function G(e) {
 	return e.split(/\r?\n/).map((e) => e.trimEnd()).filter((e) => e.length > 0).join("\n");
 }
-function w(e) {
+function K(e) {
 	return e.overlays.length > 0;
 }
-function T(e) {
-	return e.filter(w);
-}
-//#endregion
-//#region src/config.ts
-var E = h.enum([
-	"cover",
-	"history",
-	"list",
-	"screen",
-	"reference"
-]), ce = h.object({
-	book: h.string().optional(),
-	sheet: h.string().optional(),
-	sheets: h.record(h.string(), h.string()).optional(),
-	role: E.optional(),
-	order: h.number().optional()
-}).strict().refine((e) => !(e.sheet && e.sheets), "Specify either `xlsx.sheet` (single sheet) or `xlsx.sheets` (multi-sheet), not both."), le = h.record(h.string(), h.unknown()), D = h.object({
-	id: h.string().min(1, "`annot.id` is required."),
-	title: h.string().optional(),
-	purpose: h.string().optional(),
-	meta: le.optional(),
-	xlsx: ce.optional()
-}).strict(), ue = h.object({
-	template: h.string().optional(),
-	templateSheets: h.object({
-		cover: h.string().optional(),
-		history: h.string().optional(),
-		list: h.string().optional(),
-		screen: h.string().optional(),
-		reference: h.string().optional()
-	}).strict().optional()
-}).strict(), O = h.object({
-	meta: h.record(h.string(), h.unknown()).optional(),
-	xlsx: h.object({
-		defaultBook: h.string().optional(),
-		books: h.record(h.string(), ue).optional()
-	}).strict().optional()
-}).strict();
-function de(e) {
-	let t = O.safeParse(e);
-	if (!t.success) {
-		let e = t.error.issues.map((e) => `  - ${e.path.length ? e.path.join(".") + ": " : ""}${e.message}`).join("\n");
-		throw Error(`Invalid \`annot-docs.config.ts\`:\n${e}`);
-	}
-	return t.data;
-}
-function fe(e) {
-	return (e.xlsx?.role ?? "screen") === "screen";
-}
-//#endregion
-//#region src/mdx.ts
-var k = "annot:snapshot", pe = "/annot:snapshot", A = "annot:attributes", me = "/annot:attributes", he = /^\s*\/\*\s*([^\s*]+)\s*([\s\S]*?)\*\/\s*$/;
-async function j(e) {
-	return M(await t(e, "utf8"), { filePath: e });
-}
-function M(e, t = {}) {
-	let n = p().use(f).use(u, ["yaml"]).use(d).parse(e), r = N(n, t.filePath);
-	if (!r) return null;
-	let i = [], a = [], o = [], s = [], c = {};
-	return m(n, (t) => {
-		switch (t.type) {
-			case "mdxJsxFlowElement":
-			case "mdxJsxTextElement":
-				F(t, e, {
-					screens: i,
-					transitions: a,
-					history: o,
-					screenLists: s
-				});
-				return;
-			case "mdxFlowExpression":
-			case "mdxTextExpression":
-				_e(t, c);
-				return;
-		}
-	}), {
-		frontmatter: r,
-		screens: i,
-		transitions: a,
-		history: o,
-		screenLists: s,
-		commentBlocks: c,
-		source: e
-	};
-}
-function N(e, t) {
-	let n = e.children.find((e) => e.type === "yaml");
-	if (!n || !n.value) return null;
-	let r = l.load(n.value);
-	if (!r || typeof r != "object") return null;
-	let i = r.annot;
-	if (!i || typeof i != "object") return null;
-	let a = D.safeParse(i);
-	if (!a.success) {
-		let e = t ? ` in ${t}` : "";
-		throw Error(`Invalid \`annot:\` frontmatter${e}:\n${P(a.error)}`);
-	}
-	return a.data;
-}
-function P(e) {
-	return e.issues.map((e) => `  - ${e.path.length ? e.path.join(".") + ": " : ""}${e.message}`).join("\n");
-}
-function F(e, t, n) {
-	let r = e;
-	switch (r.name) {
-		case "Screen":
-			n.screens.push(I(r, t));
-			return;
-		case "Transition":
-			n.transitions.push(R(r, t));
-			return;
-		case "HistoryEntry":
-			n.history.push(ge(r, t));
-			return;
-		case "ScreenList":
-			n.screenLists.push(z(r));
-			return;
-	}
-}
-function I(e, t) {
-	let n = B(e), r = [], i = (n) => {
-		let a = n;
-		if (a.name === "Overlay") {
-			r.push(L(a, t));
-			return;
-		}
-		if (!(a.name === "Screen" && a !== e)) for (let e of a.children ?? []) i(e);
-	};
-	for (let t of e.children ?? []) i(t);
-	let a = V(n.id);
-	if (!a) throw Error("<Screen> requires an `id` prop.");
-	return {
-		id: a,
-		src: V(n.src),
-		overlays: r
-	};
-}
-function L(e, t) {
-	let n = B(e), r = n.match;
-	if (!H(r)) throw Error("<Overlay> requires a `match` prop with at least `{ role, name }`.");
-	return {
-		match: r,
-		intent: V(n.intent),
-		number: ye(n.number),
-		body: U(e, t)
-	};
-}
-function R(e, t) {
-	let n = B(e), r = n.trigger;
-	if (!H(r)) throw Error("<Transition> requires a `trigger` prop with at least `{ role, name }`.");
-	return {
-		trigger: r,
-		on: V(n.on),
-		to: V(n.to),
-		body: U(e, t)
-	};
-}
-function ge(e, t) {
-	let n = B(e), r = V(n.version) ?? "", i = V(n.date) ?? "", a = V(n.author) ?? "";
-	if (!r || !i) throw Error("<HistoryEntry> requires `version` and `date` props.");
-	return {
-		version: r,
-		date: i,
-		author: a,
-		body: U(e, t)
-	};
-}
-function z(e) {
-	let t = B(e);
-	return {
-		book: V(t.book),
-		sort: V(t.sort)
-	};
-}
-function _e(e, t) {
-	let n = e.value;
-	if (typeof n != "string") return;
-	let r = n.match(he);
-	if (!r) return;
-	let i = (r[1] ?? "").trim(), a = (r[2] ?? "").trim();
-	switch (i) {
-		case k:
-			t.snapshot = a;
-			return;
-		case A:
-			t.attributes = a;
-			return;
-		case pe:
-		case me: return;
-	}
-}
-function B(e) {
-	let t = {};
-	for (let n of e.attributes ?? []) {
-		let e = n;
-		if (e.type !== "mdxJsxAttribute" || !e.name) continue;
-		if (e.value === null || e.value === void 0) {
-			t[e.name] = !0;
-			continue;
-		}
-		if (typeof e.value == "string") {
-			t[e.name] = e.value;
-			continue;
-		}
-		let r = e.value;
-		r.type === "mdxJsxAttributeValueExpression" && typeof r.value == "string" && (t[e.name] = ve(r.value));
-	}
-	return t;
-}
-function ve(e) {
-	let t = e.trim();
-	if (t) {
-		if (t === "true") return !0;
-		if (t === "false") return !1;
-		if (t === "null") return null;
-		if (/^-?\d+(\.\d+)?$/.test(t)) return Number.parseFloat(t);
-		if (t.startsWith("\"") && t.endsWith("\"")) try {
-			return JSON.parse(t);
-		} catch {
-			return t.slice(1, -1);
-		}
-		if (t.startsWith("'") && t.endsWith("'")) {
-			let e = t.slice(1, -1), n = e.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
-			try {
-				return JSON.parse(`"${n}"`);
-			} catch {
-				return e;
-			}
-		}
-		if (t.startsWith("{") && t.endsWith("}") || t.startsWith("[") && t.endsWith("]")) {
-			let e = t.replace(/([{,]\s*)([A-Za-z_$][A-Za-z0-9_$]*)(\s*:)/g, "$1\"$2\"$3").replace(/'([^'\\]*)'/g, "\"$1\"").replace(/,(\s*[}\]])/g, "$1");
-			try {
-				return JSON.parse(e);
-			} catch {
-				return t;
-			}
-		}
-		return t;
-	}
-}
-function V(e) {
-	return typeof e == "string" ? e : void 0;
-}
-function ye(e) {
-	return typeof e == "number" ? e : void 0;
-}
-function H(e) {
-	if (!e || typeof e != "object") return !1;
-	let t = e;
-	return !(typeof t.role != "string" || typeof t.name != "string" || t.under !== void 0 && !H(t.under));
-}
-function U(e, t) {
-	let n = e.position;
-	if (!n) return "";
-	let r = t.slice(n.start.offset, n.end.offset);
-	if (/\/>\s*$/.test(r)) return "";
-	let i = r.indexOf(">"), a = r.lastIndexOf("</");
-	return i < 0 || a < 0 || a <= i ? "" : r.slice(i + 1, a).trim();
-}
-function W(e, t) {
-	let n = e;
-	return t.snapshot !== void 0 && (n = G(n, k, t.snapshot)), t.attributes !== void 0 && (n = G(n, A, t.attributes)), n;
-}
-function G(e, t, n) {
-	let r = new RegExp(String.raw`\{\s*/\*\s*` + xe(t) + String.raw`\s*[\s\S]*?\*/\s*\}`, "m"), i = be(t, n);
-	return r.test(e) ? e.replace(r, i) : `${e.trimEnd()}\n\n${i}\n`;
-}
-function be(e, t) {
-	let n = t.trim();
-	return n ? `{/* ${e}\n${n}\n*/}` : `{/* ${e} */}`;
-}
-function xe(e) {
-	return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-//#endregion
-//#region src/fixture.ts
-var K = [
-	"type",
-	"required",
-	"placeholder",
-	"maxlength",
-	"minlength",
-	"pattern",
-	"min",
-	"max",
-	"step",
-	"disabled",
-	"readonly",
-	"checked",
-	"aria-required",
-	"aria-disabled",
-	"aria-readonly"
-], Se = c.extend({ screen: async ({ page: e }, t) => {
-	await t({ capture: (t) => q(e, t) });
-} });
-async function q(e, t) {
-	let n = await j(t.mdxPath);
-	if (!n) throw Error(`captureScreen: ${t.mdxPath} has no \`annot:\` frontmatter — refusing to write.`);
-	let i = n.screens.find((e) => e.id === t.id);
-	if (!i) throw Error(`captureScreen: ${t.mdxPath} has no <Screen id="${t.id}"> block.`);
-	let a = await (t.rootLocator ?? e.locator("body")).ariaSnapshot({
-		mode: "ai",
-		boxes: !0
-	}), o = await J(e, i.overlays, t.attributeWhitelist ?? K), s = W(n.source, {
-		snapshot: a.trim(),
-		attributes: o
-	});
-	await r(t.mdxPath, s, "utf8");
-}
-async function J(e, t, n) {
-	let r = [];
-	for (let i of t) {
-		let t = e.getByRole(i.match.role, {
-			name: i.match.name,
-			exact: !0
-		});
-		if (await t.count() !== 1) continue;
-		let a = await t.evaluate((e, t) => {
-			let n = {};
-			for (let r of t) {
-				let t = e.getAttribute(r);
-				t !== null && (n[r] = t);
-			}
-			return n;
-		}, n), o = Object.keys(a);
-		if (o.length !== 0) {
-			r.push(`${i.match.role} "${i.match.name}":`);
-			for (let e of o) r.push(`  ${e}: ${a[e]}`);
-		}
-	}
-	return r.join("\n");
+function q(e) {
+	return e.filter(K);
 }
 //#endregion
 //#region src/cli.ts
-async function Ce(e, t = {}) {
+async function Le(e, t = {}) {
 	let n = t.stdout ?? ((e) => process.stdout.write(`${e}\n`)), r = t.stderr ?? ((e) => process.stderr.write(`${e}\n`)), i = t.cwd ?? process.cwd(), [, , a, ...o] = e;
-	if (a !== "init" && a !== "sync" && a !== "lint") return r(we), +!!a;
+	if (a !== "init" && a !== "sync" && a !== "lint") return r(Re), +!!a;
 	try {
 		switch (a) {
-			case "init": return await Te(o, {
+			case "init": return await ze(o, {
 				cwd: i,
 				stdout: n,
 				stderr: r
 			});
-			case "sync": return await ke(o, {
+			case "sync": return await He(o, {
 				...t,
 				cwd: i,
 				stdout: n,
 				stderr: r
 			});
-			case "lint": return await Ae(o, {
+			case "lint": return await Ue(o, {
 				...t,
 				cwd: i,
 				stdout: n,
@@ -630,7 +717,7 @@ async function Ce(e, t = {}) {
 		return r(`annot docs ${a}: ${e.message}`), 1;
 	}
 }
-var we = [
+var Re = [
 	"annot docs <command> [options]",
 	"",
 	"Commands:",
@@ -643,71 +730,71 @@ var we = [
 	"  --root <dir>               Override MDX search root (default: docs/)",
 	"  --help                     Show this help"
 ].join("\n");
-async function Te(t, n) {
-	let { cwd: a, stdout: o } = n, c = [
+async function ze(e, t) {
+	let { cwd: r, stdout: i } = t, o = [
 		{
 			path: "annot-docs.config.ts",
-			content: Ee
+			content: Be
 		},
 		{
 			path: "tests/docs/example.spec.ts",
-			content: De
+			content: J
 		},
 		{
 			path: "docs/books/example/SC-001-login.mdx",
-			content: Oe
+			content: Ve
 		}
-	], l = 0;
-	for (let t of c) {
-		let n = s(a, t.path);
+	], s = 0;
+	for (let e of o) {
+		let t = h(r, e.path);
 		try {
-			await e(i(n), { recursive: !0 }), await r(n, t.content, { flag: "wx" }), o(`  created ${t.path}`), l++;
-		} catch (e) {
-			if (e.code === "EEXIST") o(`  exists  ${t.path} (skipped)`);
-			else throw e;
+			await n(p(t), { recursive: !0 }), await a(t, e.content, { flag: "wx" }), i(`  created ${e.path}`), s++;
+		} catch (t) {
+			if (t.code === "EEXIST") i(`  exists  ${e.path} (skipped)`);
+			else throw t;
 		}
 	}
-	return o(l === 0 ? "annot docs init: nothing to do (all targets exist)" : `annot docs init: wrote ${l} file(s)`), 0;
+	return i(s === 0 ? "annot docs init: nothing to do (all targets exist)" : `annot docs init: wrote ${s} file(s)`), 0;
 }
-var Ee = "// Living product docs config for annot.\n// See https://github.com/ingcreators/annot/blob/main/docs/plans/living-product-docs.md\nimport { defineConfig } from \"@ingcreators/annot-product-docs\";\n\nexport default defineConfig({\n  meta: {\n    projectName: \"Example\",\n  },\n  xlsx: {\n    defaultBook: \"Screen spec\",\n    books: {\n      \"Screen spec\": {\n        // Drop your customer-supplied template here (Phase 3) and\n        // the Excel adapter will fill it. Until then the OSS\n        // default layout applies.\n        // template: \"./templates/customer-screen-spec.xlsx\",\n      },\n    },\n  },\n});\n", De = "// Tour file — runs through every screen and refreshes the\n// matching MDX's annot:snapshot / annot:attributes blocks.\n//\n// Run with: pnpm playwright test tests/docs/\n\nimport { test } from \"@ingcreators/annot-product-docs\";\n\ntest.describe.configure({ mode: \"serial\" });\n\ntest(\"login flow\", async ({ page, screen }) => {\n  await page.goto(\"/login\");\n  await screen.capture({\n    id: \"login\",\n    mdxPath: \"docs/books/example/SC-001-login.mdx\",\n  });\n});\n", Oe = "---\nannot:\n  id: SC-001\n  title: Login screen\n  meta:\n    author: TODO\n  xlsx:\n    book: Screen spec\n    sheet: SC-001 Login\n    role: screen\n    order: 100\n---\n\nimport { Screen, Overlay } from \"@ingcreators/annot-product-docs-astro\";\n\n# Login screen\n\nEnter your credentials to access the system.\n\n<Screen id=\"login\" src=\"./shots/login.png\">\n\n<Overlay match={{ role: \"textbox\", name: \"Email\" }} intent=\"required\" number={1}>\n**Email** — Enter your registered email address.\n</Overlay>\n\n<Overlay match={{ role: \"button\", name: \"Sign in\" }} intent=\"action\" number={2}>\nClick to sign in.\n</Overlay>\n\n</Screen>\n";
-async function ke(e, t) {
+var Be = "// Living product docs config for annot.\n// See https://github.com/ingcreators/annot/blob/main/docs/plans/living-product-docs.md\nimport { defineConfig } from \"@ingcreators/annot-product-docs\";\n\nexport default defineConfig({\n  meta: {\n    projectName: \"Example\",\n  },\n  xlsx: {\n    defaultBook: \"Screen spec\",\n    books: {\n      \"Screen spec\": {\n        // Drop your customer-supplied template here (Phase 3) and\n        // the Excel adapter will fill it. Until then the OSS\n        // default layout applies.\n        // template: \"./templates/customer-screen-spec.xlsx\",\n      },\n    },\n  },\n});\n", J = "// Tour file — runs through every screen and refreshes the\n// matching MDX's annot:snapshot / annot:attributes blocks.\n//\n// Run with: pnpm playwright test tests/docs/\n\nimport { test } from \"@ingcreators/annot-product-docs\";\n\ntest.describe.configure({ mode: \"serial\" });\n\ntest(\"login flow\", async ({ page, productDocs }) => {\n  await page.goto(\"/login\");\n  await productDocs.sync({\n    id: \"login\",\n    mdxPath: \"docs/books/example/SC-001-login.mdx\",\n  });\n});\n", Ve = "---\nannot:\n  id: SC-001\n  title: Login screen\n  meta:\n    author: TODO\n  xlsx:\n    book: Screen spec\n    sheet: SC-001 Login\n    role: screen\n    order: 100\n---\n\nimport { Screen, Overlay } from \"@ingcreators/annot-product-docs-astro\";\n\n# Login screen\n\nEnter your credentials to access the system.\n\n<Screen id=\"login\" src=\"./shots/login.png\">\n\n<Overlay match={{ role: \"textbox\", name: \"Email\" }} intent=\"required\" number={1}>\n**Email** — Enter your registered email address.\n</Overlay>\n\n<Overlay match={{ role: \"button\", name: \"Sign in\" }} intent=\"action\" number={2}>\nClick to sign in.\n</Overlay>\n\n</Screen>\n";
+async function He(e, t) {
 	let { cwd: n, stdout: r, stderr: i } = t, a = Z(e);
 	if (!a.url) return i("annot docs sync: --url <baseUrl> is required."), 1;
-	let c = await $(await Q(s(n, a.root ?? "docs")));
-	if (c.length === 0) return r(`annot docs sync: no MDX files with \`annot:\` frontmatter under ${a.root ?? "docs"}.`), 0;
-	r(`annot docs sync: ${c.length} MDX file(s) → ${a.url}`);
-	let { newPage: l, close: u } = await Y(a.url, t);
+	let o = await $(await Q(h(n, a.root ?? "docs")));
+	if (o.length === 0) return r(`annot docs sync: no MDX files with \`annot:\` frontmatter under ${a.root ?? "docs"}.`), 0;
+	r(`annot docs sync: ${o.length} MDX file(s) → ${a.url}`);
+	let { newPage: s, close: c } = await Y(a.url, t);
 	try {
-		for (let e of c) {
-			let t = await j(e);
+		for (let e of o) {
+			let t = await x(e);
 			if (!t) continue;
-			let i = T(t.screens);
+			let i = q(t.screens);
 			if (i.length === 0) {
-				r(`  skip   ${o(n, e)} (no <Screen> blocks)`);
+				r(`  skip   ${m(n, e)} (no <Screen> blocks)`);
 				continue;
 			}
 			for (let t of i) {
-				let { page: i, dispose: a } = await l(t.src ?? "/");
+				let { page: i, dispose: a } = await s(t.src ?? "/");
 				try {
-					await q(i, {
+					await A(i, {
 						id: t.id,
 						mdxPath: e
-					}), r(`  synced ${o(n, e)} (screen=${t.id})`);
+					}), r(`  synced ${m(n, e)} (screen=${t.id})`);
 				} finally {
 					await a();
 				}
 			}
 		}
 	} finally {
-		await u();
+		await c();
 	}
 	return 0;
 }
-async function Ae(e, t) {
+async function Ue(e, t) {
 	let { cwd: n, stdout: r, stderr: i } = t, a = Z(e);
 	if (!a.url) return i("annot docs lint: --url <baseUrl> is required."), 1;
-	let c = await $(await Q(s(n, a.root ?? "docs")));
-	if (c.length === 0) return a.json ? r(JSON.stringify({
+	let o = await $(await Q(h(n, a.root ?? "docs")));
+	if (o.length === 0) return a.json ? r(JSON.stringify({
 		findings: [],
 		summary: {
 			errors: 0,
@@ -715,34 +802,34 @@ async function Ae(e, t) {
 			infos: 0
 		}
 	})) : r(`annot docs lint: no MDX files with \`annot:\` frontmatter under ${a.root ?? "docs"}.`), 0;
-	a.json || r(`annot docs lint: ${c.length} MDX file(s) → ${a.url}`);
-	let l = [], u = /* @__PURE__ */ new Set(), { newPage: d, close: f } = await Y(a.url, t);
+	a.json || r(`annot docs lint: ${o.length} MDX file(s) → ${a.url}`);
+	let s = [], c = /* @__PURE__ */ new Set(), { newPage: l, close: u } = await Y(a.url, t);
 	try {
-		for (let e of c) {
-			let t = await j(e);
-			if (t) for (let r of T(t.screens)) {
-				let { page: t, dispose: i } = await d(r.src ?? "/");
+		for (let e of o) {
+			let t = await x(e);
+			if (t) for (let r of q(t.screens)) {
+				let { page: t, dispose: i } = await l(r.src ?? "/");
 				try {
-					let i = b({
+					let i = H({
 						screen: r,
-						liveSnapshot: g(await t.locator("body").ariaSnapshot({ mode: "ai" }))
+						liveSnapshot: z(await t.locator("body").ariaSnapshot({ mode: "ai" }))
 					});
-					for (let t of i) l.push({
-						file: o(n, e),
+					for (let t of i) s.push({
+						file: m(n, e),
 						finding: t
-					}), u.add(e);
+					}), c.add(e);
 				} finally {
 					await i();
 				}
 			}
 		}
 	} finally {
-		await f();
+		await u();
 	}
 	if (a.json) {
-		let e = x(l.map((e) => e.finding));
+		let e = U(s.map((e) => e.finding));
 		r(JSON.stringify({
-			findings: l.map(({ file: e, finding: t }) => ({
+			findings: s.map(({ file: e, finding: t }) => ({
 				file: e,
 				severity: t.severity,
 				kind: t.kind,
@@ -754,23 +841,23 @@ async function Ae(e, t) {
 			summary: e
 		}));
 	} else {
-		for (let { file: e, finding: t } of l) r(`${je(t.severity)} ${e} [${t.screenId}] ${t.kind}: ${t.message}`);
-		let e = x(l.map((e) => e.finding));
+		for (let { file: e, finding: t } of s) r(`${We(t.severity)} ${e} [${t.screenId}] ${t.kind}: ${t.message}`);
+		let e = U(s.map((e) => e.finding));
 		r(`annot docs lint: ${e.errors} error(s), ${e.warnings} warning(s), ${e.infos} info(s).`);
 	}
-	let p = 0;
-	if (a.fix && u.size > 0) {
+	let d = 0;
+	if (a.fix && c.size > 0) {
 		let { newPage: e, close: n } = await Y(a.url, t);
 		try {
-			for (let t of u) {
-				let n = await j(t);
-				if (n) for (let r of T(n.screens)) {
+			for (let t of c) {
+				let n = await x(t);
+				if (n) for (let r of q(n.screens)) {
 					let { page: n, dispose: i } = await e(r.src ?? "/");
 					try {
-						await q(n, {
+						await A(n, {
 							id: r.id,
 							mdxPath: t
-						}), p++;
+						}), d++;
 					} finally {
 						await i();
 					}
@@ -779,10 +866,10 @@ async function Ae(e, t) {
 		} finally {
 			await n();
 		}
-		a.json || r(`annot docs lint --fix: refreshed snapshot/attributes for ${p} screen(s).`);
+		a.json || r(`annot docs lint --fix: refreshed snapshot/attributes for ${d} screen(s).`);
 	}
-	let m = x(l.map((e) => e.finding));
-	return a.ci ? +(m.errors + m.warnings > 0) : +(m.errors > 0);
+	let f = U(s.map((e) => e.finding));
+	return a.ci ? +(f.errors + f.warnings > 0) : +(f.errors > 0);
 }
 async function Y(e, t) {
 	if (t.newPage) return {
@@ -823,21 +910,21 @@ function Z(e) {
 	return t;
 }
 async function Q(e) {
-	let t = [], r = [e];
-	for (; r.length > 0;) {
-		let e = r.pop(), i;
+	let t = [], n = [e];
+	for (; n.length > 0;) {
+		let e = n.pop(), r;
 		try {
-			i = await n(e, { withFileTypes: !0 });
+			r = await i(e, { withFileTypes: !0 });
 		} catch (e) {
 			if (e.code === "ENOENT") continue;
 			throw e;
 		}
-		for (let n of i) {
-			let i = a(e, n.name);
-			if (n.isDirectory()) {
-				if (n.name === "node_modules" || n.name.startsWith(".")) continue;
-				r.push(i);
-			} else n.isFile() && n.name.endsWith(".mdx") && t.push(i);
+		for (let i of r) {
+			let r = te(e, i.name);
+			if (i.isDirectory()) {
+				if (i.name === "node_modules" || i.name.startsWith(".")) continue;
+				n.push(r);
+			} else i.isFile() && i.name.endsWith(".mdx") && t.push(r);
 		}
 	}
 	return t.sort();
@@ -845,11 +932,11 @@ async function Q(e) {
 async function $(e) {
 	let t = [];
 	for (let n of e) try {
-		await j(n) && t.push(n);
+		await x(n) && t.push(n);
 	} catch {}
 	return t;
 }
-function je(e) {
+function We(e) {
 	switch (e) {
 		case "error": return "ERROR  ";
 		case "warning": return "WARN   ";
@@ -857,4 +944,4 @@ function je(e) {
 	}
 }
 //#endregion
-export { K as DEFAULT_ATTR_WHITELIST, O as annotDocsConfigSchema, D as annotFrontmatterSchema, q as captureScreen, J as collectAttributesYaml, de as defineConfig, b as detectDrift, ie as detectDriftFromYaml, $ as filterAnnotMdxFiles, w as isLintableScreen, fe as isScreenRole, T as lintableScreens, Ce as main, M as parseMdx, j as parseMdxFile, g as parseSnapshot, _ as resolveMatch, ee as resolveOverlays, x as summariseDrift, Se as test, W as updateCommentBlocks, Q as walkMdx };
+export { k as DEFAULT_ATTR_WHITELIST, v as annotDocsConfigSchema, _ as annotFrontmatterSchema, N as buildBadgeAnnotations, Te as captureScreen, j as collectAttributesYaml, oe as defineConfig, H as detectDrift, Ne as detectDriftFromYaml, F as emptyAnnotationsSvg, $ as filterAnnotMdxFiles, K as isLintableScreen, se as isScreenRole, q as lintableScreens, Le as main, S as parseMdx, x as parseMdxFile, z as parseSnapshot, M as parseSnapshotBoxes, B as resolveMatch, P as resolveMdxAnnotations, Oe as resolveOverlays, U as summariseDrift, Ee as svgFromBadges, De as svgFromBboxAnnotations, A as syncProductDocs, we as test, D as updateCommentBlocks, Q as walkMdx };