@dialecte/core 0.4.15 → 0.4.17

package/dist/test/assert-valid-xml/assert-valid-xml.d.ts

@@ -0,0 +1,24 @@
+import { AssertValidXmlOptions, AssertValidXmlTestCasesParams, CreateXmlSchemaAssertionsParams } from './assert-valid-xml.types';
+/**
+ * Create structural XML assertions bound to a dialecte's generated `definition`
+ * and declared `namespaces`. Instantiate once per dialecte (e.g. in scl test) and
+ * re-export alongside createTestProject, like createXmlAssertions.
+ *
+ * `assertValidXml` asserts, structurally: every element's namespace matches its
+ * parent context, every element is an allowed child of its parent, and every
+ * attribute is a known attribute of its element. Elements unknown to the schema are
+ * skipped (bespoke content under a transparent `Private`), and so is any element in
+ * a namespace the dialecte does not declare — even when its local name collides with
+ * a schema element. An element in NO namespace is not foreign — it is a schema
+ * element the snippet forgot to put in its namespace, and stays validated.
+ *
+ * `requireComplete` (default `true`) additionally requires every schema-required
+ * attribute to be present. NOT yet enforced (planned with the validation feature):
+ * attribute VALUE facets (uuid pattern, enums, datatypes) and cross-element
+ * constraints (unique keys, keyref resolution).
+ */
+export declare function createXmlSchemaAssertions(params: CreateXmlSchemaAssertionsParams): {
+    assertValidXml: (xml: string, label?: string, options?: AssertValidXmlOptions) => void;
+    assertValidXmlTestCases: (params: AssertValidXmlTestCasesParams) => void;
+};
+//# sourceMappingURL=assert-valid-xml.d.ts.map

package/dist/test/assert-valid-xml/assert-valid-xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-valid-xml.d.ts","sourceRoot":"","sources":["../../../src/test/assert-valid-xml/assert-valid-xml.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,qBAAqB,EACrB,6BAA6B,EAG7B,+BAA+B,EAE/B,MAAM,0BAA0B,CAAA;AAGjC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,+BAA+B;0BA4I1E,MAAM,4BAEF,qBAAqB,KAC5B,IAAI;sCAWkC,6BAA6B,KAAG,IAAI;EAqB7E"}

package/dist/test/assert-valid-xml/assert-valid-xml.types.d.ts

@@ -0,0 +1,41 @@
+import { AnyDefinition, ElementDefinition, Namespace } from '../../types';
+/** Options controlling how strict a single-document validation is. */
+export type AssertValidXmlOptions = {
+    /**
+     * Also require every schema-required attribute to be present. Default `true`;
+     * minimal fixtures legitimately omit required attributes (a bare `<SCL>` without
+     * `version`/`revision`/`release`) and pass `false`.
+     */
+    requireComplete?: boolean;
+};
+export type CreateXmlSchemaAssertionsParams = {
+    /** The dialecte's generated element definitions, keyed by local name. */
+    definition: AnyDefinition;
+    /** The dialecte's declared namespaces; their URIs form the "known" set. */
+    namespaces: Record<string, Namespace>;
+    /** Names the schema in violation messages ("not valid SCL"). Default `'XML'`. */
+    schemaName?: string;
+};
+export type CollectElementViolationsParams = {
+    element: Element;
+    parentLocalName: string | undefined;
+    requireComplete: boolean;
+};
+export type CollectAttributeViolationsParams = {
+    element: Element;
+    elementDefinition: ElementDefinition;
+    requireComplete: boolean;
+};
+export type DescribeInvalidXmlParams = {
+    xml: string;
+    label: string;
+    requireComplete: boolean;
+};
+export type XmlSchemaTestCase = {
+    sourceXml: string;
+    targetXml?: string;
+};
+export type AssertValidXmlTestCasesParams = {
+    testCases: Record<string, XmlSchemaTestCase>;
+};
+//# sourceMappingURL=assert-valid-xml.types.d.ts.map

package/dist/test/assert-valid-xml/assert-valid-xml.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-valid-xml.types.d.ts","sourceRoot":"","sources":["../../../src/test/assert-valid-xml/assert-valid-xml.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAE1E,sEAAsE;AACtE,MAAM,MAAM,qBAAqB,GAAG;IACnC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC7C,yEAAyE;IACzE,UAAU,EAAE,aAAa,CAAA;IACzB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACrC,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC5C,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,eAAe,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC9C,OAAO,EAAE,OAAO,CAAA;IAChB,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,eAAe,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACtC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzE,MAAM,MAAM,6BAA6B,GAAG;IAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CAC5C,CAAA"}

package/dist/test/assert-valid-xml/index.d.ts

@@ -0,0 +1,3 @@
+export * from './assert-valid-xml';
+export type * from './assert-valid-xml.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/test/assert-valid-xml/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/test/assert-valid-xml/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,mBAAmB,0BAA0B,CAAA"}

package/dist/test/index.d.ts

@@ -1,7 +1,9 @@
+export * from './assert-valid-xml';
 export * from './assert-xml';
 export * from './config';
 export * from './constant';
 export * from './create-test-dialecte';
+export * from './normalize-uuids';
 export * from './run-test-cases';
 export type * from './run-test-cases.type';
 export * from './test-record';

package/dist/test/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,mBAAmB,uBAAuB,CAAA;AAC1C,cAAc,eAAe,CAAA;AAC7B,mBAAmB,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,mBAAmB,uBAAuB,CAAA;AAC1C,cAAc,eAAe,CAAA;AAC7B,mBAAmB,qBAAqB,CAAA"}

package/dist/test/normalize-uuids.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeUuids(text: string): string;
+//# sourceMappingURL=normalize-uuids.d.ts.map

package/dist/test/normalize-uuids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-uuids.d.ts","sourceRoot":"","sources":["../../src/test/normalize-uuids.ts"],"names":[],"mappings":"AAYA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASnD"}

package/dist/test.js

@@ -1,15 +1,105 @@
-import { N as e, V as t, ft as n, ht as r, pt as i, t as a, u as o } from "./project-FFHlnZpz.js";
+import { N as e, V as t, ft as n, ht as r, pt as i, t as a, u as o } from "./project-nvZv2ie8.js";
 import { DIALECTE_NAMESPACES as s, standardizeRecord as c, toTrackedRecord as l, toTreeRecord as u } from "./helpers.js";
 import { expect as d, it as f } from "vitest";
-//#region src/test/assert-xml/xpath-parser.ts
+//#region src/test/assert-valid-xml/assert-valid-xml.ts
 function p(e) {
-	let t = m(e);
+	let { definition: t, namespaces: n, schemaName: r = "XML" } = e, i = Object.values(n).map((e) => e.uri);
+	function a(e) {
+		return e.namespaceURI !== null && !i.includes(e.namespaceURI);
+	}
+	function o(e, n) {
+		return ((e ? t[e]?.children.details[n]?.namespace : void 0) ?? t[n]?.namespace)?.uri;
+	}
+	function s(e, t) {
+		let n = e.children;
+		return n.any === !0 || n.sequence.includes(t) ? !0 : t in n.details;
+	}
+	function c(e) {
+		return new Set([...e.attributes.sequence, ...Object.keys(e.attributes.details)]);
+	}
+	function l(e) {
+		let { element: t, elementDefinition: n, requireComplete: r } = e, i = c(n), a = Array.from(t.attributes).filter((e) => e.namespaceURI === null && !i.has(e.localName)).map((e) => `[attribute] <${t.localName}> has unknown attribute '${e.localName}'`);
+		if (!r) return a;
+		let o = Object.entries(n.attributes.details).filter(([e, n]) => n.required && !t.hasAttribute(e)).map(([e]) => `[required] <${t.localName}> is missing required attribute '${e}'`);
+		return [...a, ...o];
+	}
+	function u(e) {
+		let { element: n, parentLocalName: r, requireComplete: i } = e, c = Array.from(n.children);
+		if (a(n)) return c.flatMap((e) => u({
+			element: e,
+			parentLocalName: void 0,
+			requireComplete: i
+		}));
+		let d = n.localName, f = [], p = o(r, d), m = n.namespaceURI ?? "";
+		if (p !== void 0 && m !== p) {
+			let e = r ? ` under <${r}>` : "";
+			f.push(`[namespace] <${n.tagName}>${e}: is in ${n.namespaceURI ?? "(no namespace)"}, schema declares ${p || "(no namespace)"}`);
+		}
+		let h = r ? t[r] : void 0;
+		h && !s(h, d) && f.push(`[containment] <${d}> is not a valid child of <${r}>`);
+		let g = t[d], _ = g ? l({
+			element: n,
+			elementDefinition: g,
+			requireComplete: i
+		}) : [], v = c.flatMap((e) => u({
+			element: e,
+			parentLocalName: d,
+			requireComplete: i
+		}));
+		return [
+			...f,
+			..._,
+			...v
+		];
+	}
+	function d(e) {
+		let { xml: t, label: n, requireComplete: i } = e;
+		if (!t.startsWith("<?xml") && t.trimStart().startsWith("<?xml")) return `${n}: malformed XML — the XML declaration must be the very first characters of the string: remove the declaration (a snippet does not need one) or the whitespace before it`;
+		let a = new DOMParser().parseFromString(t, "application/xml"), o = a.querySelector("parsererror");
+		if (o) return `${n}: malformed XML — ${o.textContent?.trim()}`;
+		if (!a.documentElement) return;
+		let s = u({
+			element: a.documentElement,
+			parentLocalName: void 0,
+			requireComplete: i
+		});
+		return s.length > 0 ? `${n}: not valid ${r}:\n  ${s.join("\n  ")}` : void 0;
+	}
+	function f(e, t = "test XML", n = {}) {
+		let r = d({
+			xml: e,
+			label: t,
+			requireComplete: n.requireComplete ?? !0
+		});
+		if (r) throw Error(r);
+	}
+	function p(e) {
+		let { testCases: t } = e, n = Object.entries(t).flatMap(([e, t]) => [d({
+			xml: t.sourceXml,
+			label: `${e} › sourceXml`,
+			requireComplete: !1
+		}), t.targetXml ? d({
+			xml: t.targetXml,
+			label: `${e} › targetXml`,
+			requireComplete: !1
+		}) : void 0].filter((e) => e !== void 0));
+		if (n.length > 0) throw Error(n.join("\n"));
+	}
+	return {
+		assertValidXml: f,
+		assertValidXmlTestCases: p
+	};
+}
+//#endregion
+//#region src/test/assert-xml/xpath-parser.ts
+function m(e) {
+	let t = h(e);
 	if (t.length === 0) return [e];
 	let n = [];
 	for (let r of t) n.push(e.slice(0, r));
 	return n.push(e), n;
 }
-function m(e) {
+function h(e) {
 	let t = [], n = 0, r = 0, i = null;
 	for (let a = 0; a < e.length; a++) {
 		let o = e[a];
@@ -50,60 +140,60 @@ function m(e) {
 }
 //#endregion
 //#region src/test/assert-xml/assert-xml.ts
-var h = /* @__PURE__ */ r(t(), 1);
-function g(e) {
-	let { namespaces: t } = e, n = v(t);
+var g = /* @__PURE__ */ r(t(), 1);
+function _(e) {
+	let { namespaces: t } = e, n = y(t);
 	return {
 		assertExpectedElementQueries(e) {
-			_({
+			v({
 				...e,
 				nsResolver: n
 			});
 		},
 		assertUnexpectedElementQueries(e) {
-			y({
+			b({
 				...e,
 				nsResolver: n
 			});
 		}
 	};
 }
-function _(e) {
+function v(e) {
 	let { xmlDocument: t, queries: n, nsResolver: r } = e;
-	for (let e of n) b({
+	for (let e of n) x({
 		xmlDocument: t,
 		xpath: e,
 		nsResolver: r
 	});
 }
-function v(e) {
+function y(e) {
 	return (t) => t ? e[t]?.uri ?? null : null;
 }
-function y(e) {
+function b(e) {
 	let { xmlDocument: t, queries: n, nsResolver: r } = e;
-	for (let e of n) S({
+	for (let e of n) C({
 		xmlDocument: t,
 		xpath: e,
 		nsResolver: r
 	});
 }
-function b(e) {
-	let { xmlDocument: t, xpath: n, nsResolver: r } = e, i = p(n), a = null, o = 0;
+function x(e) {
+	let { xmlDocument: t, xpath: n, nsResolver: r } = e, i = m(n), a = null, o = 0;
 	for (let e = 0; e < i.length; e++) {
 		let s = i[e], c = t.evaluate(s, t, r ?? null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue;
 		if (c) {
 			a = c, o = e + 1;
 			continue;
 		}
-		let l = e === 0 ? i[0] : n.slice(i[e - 1].length), u = o === 0 ? `[No parent matched — failed from document root]\n  Document:\n${x({ xml: new XMLSerializer().serializeToString(t) })}` : `[Last match at step ${o}/${i.length}]:\n${a ? x({ xml: a.outerHTML }) : "(none)"}`;
+		let l = e === 0 ? i[0] : n.slice(i[e - 1].length), u = o === 0 ? `[No parent matched — failed from document root]\n  Document:\n${S({ xml: new XMLSerializer().serializeToString(t) })}` : `[Last match at step ${o}/${i.length}]:\n${a ? S({ xml: a.outerHTML }) : "(none)"}`;
 		d(c, `Element not found in XML.\n  Failed at step ${e + 1}/${i.length}: ${l.trim()}\n  Full XPath: ${n}\n  ${u}`).toBeTruthy();
 		return;
 	}
 }
-function x(e) {
+function S(e) {
 	let { xml: t } = e;
 	try {
-		return (0, h.default)(t, {
+		return (0, g.default)(t, {
 			indentation: "  ",
 			collapseContent: !0
 		});
@@ -111,23 +201,23 @@ function x(e) {
 		return t;
 	}
 }
-function S(e) {
-	let { xmlDocument: t, xpath: n, nsResolver: r } = e, i = p(n);
+function C(e) {
+	let { xmlDocument: t, xpath: n, nsResolver: r } = e, i = m(n);
 	if (i.length > 1) {
 		let e = null;
 		for (let a = 0; a < i.length - 1; a++) {
-			let o = i[a], s = t.evaluate(o, t, r ?? null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue, c = a === 0 ? i[0] : n.slice(i[a - 1].length), l = a === 0 ? "[Document root — no parent context]" : `[Parent element found at step ${a}]:\n${e ? x({ xml: e.outerHTML }) : "(none)"}`;
+			let o = i[a], s = t.evaluate(o, t, r ?? null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue, c = a === 0 ? i[0] : n.slice(i[a - 1].length), l = a === 0 ? "[Document root — no parent context]" : `[Parent element found at step ${a}]:\n${e ? S({ xml: e.outerHTML }) : "(none)"}`;
 			d(s, `Absent assertion is unreliable: ancestor step does not exist.
   The query passes but for the wrong reason — an ancestor is missing, not the target element.
   Missing at step ${a + 1}/${i.length}: ${c.trim()}\n  Full XPath: ${n}\n  ${l}`).toBeTruthy(), e = s;
 		}
 	}
 	let a = t.evaluate(n, t, r ?? null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue;
-	d(a, `Element should NOT exist in XML but was found.\n  XPath: ${n}\n  Found:\n${a ? x({ xml: a.outerHTML }) : "(none)"}`).toBeFalsy();
+	d(a, `Element should NOT exist in XML but was found.\n  XPath: ${n}\n  Found:\n${a ? S({ xml: a.outerHTML }) : "(none)"}`).toBeFalsy();
 }
 //#endregion
 //#region src/test/constant.ts
-var C = {
+var w = {
 	...s,
 	default: {
 		uri: "http://dialecte.dev/XML/DEFAULT",
@@ -137,7 +227,7 @@ var C = {
 		uri: "http://dialecte.dev/XML/DEV-EXT",
 		prefix: "ext"
 	}
-}, w = `xmlns="${C.default.uri}"`, T = `xmlns:${C.dev.prefix}="${C.dev.uri}"`, E = `xmlns:${C.ext.prefix}="${C.ext.uri}"`, D = /* @__PURE__ */ "A.AAAA_1.AAAA_2.AAAA_3.AAA_1.AAA_2.AAA_3.AA_1.AA_2.AA_3.B.BBBB_1.BBBB_2.BBBB_3.BBB_1.BBB_2.BBB_3.BB_1.BB_2.BB_3.C.CCCC_1.CCCC_2.CCCC_3.CCC_1.CCC_2.CCC_3.CC_1.CC_2.CC_3.Root".split("."), O = {
+}, T = `xmlns="${w.default.uri}"`, E = `xmlns:${w.dev.prefix}="${w.dev.uri}"`, D = `xmlns:${w.ext.prefix}="${w.ext.uri}"`, O = /* @__PURE__ */ "A.AAAA_1.AAAA_2.AAAA_3.AAA_1.AAA_2.AAA_3.AA_1.AA_2.AA_3.B.BBBB_1.BBBB_2.BBBB_3.BBB_1.BBB_2.BBB_3.BB_1.BB_2.BB_3.C.CCCC_1.CCCC_2.CCCC_3.CCC_1.CCC_2.CCC_3.CC_1.CC_2.CC_3.Root".split("."), k = {
 	A: [
 		"AA_1",
 		"AA_2",
@@ -257,7 +347,7 @@ var C = {
 		"B",
 		"C"
 	]
-}, k = {
+}, A = {
 	A: ["Root"],
 	AAAA_1: [
 		"AAA_1",
@@ -361,7 +451,7 @@ var C = {
 	CC_2: ["C"],
 	CC_3: ["C"],
 	Root: []
-}, A = {
+}, j = {
 	A: [
 		"AAAA_1",
 		"AAAA_2",
@@ -522,7 +612,7 @@ var C = {
 		"CCC_3"
 	],
 	Root: /* @__PURE__ */ "A.AAAA_1.AAAA_2.AAAA_3.AAA_1.AAA_2.AAA_3.AA_1.AA_2.AA_3.B.BBBB_1.BBBB_2.BBBB_3.BBB_1.BBB_2.BBB_3.BB_1.BB_2.BB_3.C.CCCC_1.CCCC_2.CCCC_3.CCC_1.CCC_2.CCC_3.CC_1.CC_2.CC_3".split(".")
-}, j = {
+}, M = {
 	A: ["Root"],
 	AAAA_1: [
 		"A",
@@ -689,7 +779,7 @@ var C = {
 	CC_2: ["C", "Root"],
 	CC_3: ["C", "Root"],
 	Root: []
-}, M = "Root", N = [
+}, N = "Root", P = [
 	"A",
 	"AA_1",
 	"B",
@@ -698,7 +788,7 @@ var C = {
 	"CC_1",
 	"CC_2",
 	"Root"
-], P = {
+], F = {
 	A: {
 		aA: "",
 		bA: "",
@@ -853,7 +943,7 @@ var C = {
 		"ext:root": "",
 		root: ""
 	}
-}, F = {
+}, I = {
 	A: {
 		tag: "A",
 		namespace: {
@@ -2694,7 +2784,7 @@ var C = {
 			} }]
 		}]
 	}
-}, I = { supportedFileExtensions: [".xml"] }, L = {
+}, L = { supportedFileExtensions: [".xml"] }, R = {
 	recordSchema: {
 		primaryKey: "id",
 		indexes: [
@@ -2709,24 +2799,24 @@ var C = {
 		name: "xmlElements",
 		schema: "id, tagName, [id+tagName], parent.id, parent.tagName, *children.id, *children.tagName"
 	} }
-}, R = {
-	rootElementName: M,
-	singletonElements: N,
-	elements: D,
-	namespaces: C,
-	attributes: P,
-	children: O,
-	parents: k,
-	descendants: A,
-	ancestors: j,
-	database: L,
-	io: I,
-	definition: F
+}, z = {
+	rootElementName: N,
+	singletonElements: P,
+	elements: O,
+	namespaces: w,
+	attributes: F,
+	children: k,
+	parents: A,
+	descendants: j,
+	ancestors: M,
+	database: R,
+	io: L,
+	definition: I
 };
 //#endregion
 //#region src/test/create-test-dialecte.ts
-async function z(e) {
-	let { sourceXml: t, targetXml: n, dialecteConfig: r = R, extensions: i, hooks: o, dev: s } = e, c = `test-${crypto.randomUUID()}`, l = await new a({
+async function B(e) {
+	let { sourceXml: t, targetXml: n, dialecteConfig: r = z, extensions: i, hooks: o, dev: s } = e, c = `test-${crypto.randomUUID()}`, l = await new a({
 		configs: { default: r },
 		defaultConfigKey: "default",
 		storage: { type: "local" },
@@ -2750,7 +2840,7 @@ async function z(e) {
 		target: f
 	};
 }
-async function B(t) {
+async function V(t) {
 	let { databaseName: r, dialecteConfig: a, documentId: s } = t, c = new o(r, { recordSchema: a.database.recordSchema });
 	return await c.open(), {
 		dialecteConfig: a,
@@ -2769,19 +2859,31 @@ async function B(t) {
 	};
 }
 //#endregion
+//#region src/test/normalize-uuids.ts
+var H = /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi;
+function U(e) {
+	let t = /* @__PURE__ */ new Map();
+	return e.replace(H, (e) => {
+		let n = t.get(e);
+		if (n) return n;
+		let r = `uuid-${t.size + 1}`;
+		return t.set(e, r), r;
+	});
+}
+//#endregion
 //#region src/test/run-test-cases.ts
-var V = crypto.randomUUID.bind(crypto);
-function H() {
+var W = crypto.randomUUID.bind(crypto);
+function G() {
 	let e = 0;
 	return function() {
 		return `${e++}`;
 	};
 }
-function U(e) {
-	let { testCases: t, act: n, extensions: r, hooks: i, dialecteConfig: a = R } = e, { assertExpectedElementQueries: o, assertUnexpectedElementQueries: s } = g({ namespaces: a.namespaces });
+function K(e) {
+	let { testCases: t, act: n, extensions: r, hooks: i, dialecteConfig: a = z } = e, { assertExpectedElementQueries: o, assertUnexpectedElementQueries: s } = _({ namespaces: a.namespaces });
 	for (let [e, c] of Object.entries(t)) (c.only ? f.only : f)(e, async () => {
-		crypto.randomUUID = V;
-		let { project: e, source: t, target: l } = await z({
+		crypto.randomUUID = W;
+		let { project: e, source: t, target: l } = await B({
 			sourceXml: c.sourceXml,
 			targetXml: c.targetXml,
 			dialecteConfig: a,
@@ -2789,7 +2891,7 @@ function U(e) {
 			hooks: i
 		});
 		try {
-			crypto.randomUUID = H();
+			crypto.randomUUID = G();
 			let r = await n({
 				testCase: c,
 				project: e,
@@ -2810,15 +2912,15 @@ function U(e) {
 				queries: c.unexpectedQueries
 			});
 		} finally {
-			crypto.randomUUID = V, await e.destroy();
+			crypto.randomUUID = W, await e.destroy();
 		}
 	});
 }
-function W(e) {
-	let { testCases: t, act: n, extensions: r, hooks: i, dialecteConfig: a = R } = e;
+function q(e) {
+	let { testCases: t, act: n, extensions: r, hooks: i, dialecteConfig: a = z } = e;
 	for (let [e, o] of Object.entries(t)) (o.only ? f.only : f)(e, async () => {
-		crypto.randomUUID = V;
-		let { project: e, source: t, target: s } = await z({
+		crypto.randomUUID = W;
+		let { project: e, source: t, target: s } = await B({
 			sourceXml: o.sourceXml,
 			targetXml: o.targetXml,
 			dialecteConfig: a,
@@ -2826,42 +2928,42 @@ function W(e) {
 			hooks: i
 		});
 		try {
-			crypto.randomUUID = H(), await n({
+			crypto.randomUUID = G(), await n({
 				testCase: o,
 				project: e,
 				source: t.document,
 				target: s?.document
 			});
 		} finally {
-			crypto.randomUUID = V, await e.destroy();
+			crypto.randomUUID = W, await e.destroy();
 		}
 	});
 }
-function G(e, t) {
+function J(e, t) {
 	for (let [n, r] of Object.entries(e)) (r.only ? f.only : f)(n, () => t(r));
 }
-var K = q({ dialecteConfig: R });
-function q(e) {
+var Y = X({ dialecteConfig: z });
+function X(e) {
 	let { dialecteConfig: t, hooks: n, extensions: r } = e;
 	return {
-		withExport: (e) => U({
+		withExport: (e) => K({
 			dialecteConfig: t,
 			extensions: r,
 			hooks: n,
 			...e
 		}),
-		withoutExport: (e) => W({
+		withoutExport: (e) => q({
 			dialecteConfig: t,
 			extensions: r,
 			hooks: n,
 			...e
 		}),
-		generic: G
+		generic: J
 	};
 }
 //#endregion
 //#region src/test/test-record.ts
-function J(e) {
+function Z(e) {
 	function t(t) {
 		let { record: n, type: r = "raw" } = t, i = c({
 			record: n,
@@ -2876,6 +2978,6 @@ function J(e) {
 	}
 	return t;
 }
-var Y = J(R);
+var Q = Z(z);
 //#endregion
-export { L as DATABASE_CONFIG, C as DIALECTE_TEST_NAMESPACES, I as IO_CONFIG, R as TEST_DIALECTE_CONFIG, w as XMLNS_DEFAULT_NAMESPACE, T as XMLNS_DEV_NAMESPACE, E as XMLNS_EXT_NAMESPACE, _ as assertExpectedElementQueries, y as assertUnexpectedElementQueries, H as createMockRandomUUID, B as createTestContext, z as createTestProject, Y as createTestRecord, J as createTestRecordFactory, q as createTestRunner, g as createXmlAssertions, K as runTestCases, p as splitXpathIntoSteps };
+export { R as DATABASE_CONFIG, w as DIALECTE_TEST_NAMESPACES, L as IO_CONFIG, z as TEST_DIALECTE_CONFIG, T as XMLNS_DEFAULT_NAMESPACE, E as XMLNS_DEV_NAMESPACE, D as XMLNS_EXT_NAMESPACE, v as assertExpectedElementQueries, b as assertUnexpectedElementQueries, G as createMockRandomUUID, V as createTestContext, B as createTestProject, Q as createTestRecord, Z as createTestRecordFactory, X as createTestRunner, _ as createXmlAssertions, p as createXmlSchemaAssertions, U as normalizeUuids, Y as runTestCases, m as splitXpathIntoSteps };

package/dist/utils/format-xml.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Format an XML string to a canonical, readable shape: one structural tag per line, indented by depth,
+ * with pure-text leaves kept inline (`<Name ...>text</Name>`).
+ *
+ * NON-VALIDATING and tolerant of `${...}` template interpolations (treated as opaque characters), so it
+ * works on XML embedded in JS/TS template literals — where a `${templateUuid}` interpolation can stand
+ * for a whole attribute, which a real XML parser silently mis-parses. It only rewrites the insignificant
+ * whitespace *between* elements: attribute text and leaf text are preserved verbatim, and an element with
+ * mixed text + element content is emitted with its original inner content untouched, so no significant
+ * value is ever altered. Idempotent.
+ */
+export declare function formatXml(source: string, options?: {
+    indent?: string;
+    baseIndent?: string;
+}): string;
+/**
+ * Reformat every XML snippet embedded in a JS/TS source string — a template literal preceded by a
+ * `/* xml *\/` marker comment — with {@link formatXml}, re-indented under the marker's own line with the
+ * closing backtick aligned to the statement. Leaves the rest of the source untouched. The reusable core
+ * of an `xmlfmt`-style step for test fixtures (see the `dialecte-xmlfmt` bin).
+ */
+export declare function formatEmbeddedXml(sourceCode: string, options?: {
+    indent?: string;
+}): string;
+//# sourceMappingURL=format-xml.d.ts.map

package/dist/utils/format-xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-xml.d.ts","sourceRoot":"","sources":["../../src/utils/format-xml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,MAAM,CAOR;AAyJD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAW/F"}

package/dist/utils/index.d.ts

@@ -1,4 +1,5 @@
 export * from './attribute-rules';
+export * from './format-xml';
 export * from './invariant';
 export * from './order-children';
 export * from './save-to-disk';

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA"}