@dialecte/core 0.5.2 → 0.5.3

package/dist/test.js

@@ -1,4 +1,4 @@
-import { N as e, V as t, gt as n, mt as r, pt as i, t as a, u as o } from "./project-Bd3fSPam.js";
+import { N as e, V as t, gt as n, mt as r, pt as i, t as a, u as o } from "./project-U2L6RvRW.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-valid-xml/assert-valid-xml.ts

package/dist/utils/invariant.d.ts

@@ -1,17 +1,21 @@
-import { DialecteErrorKey } from '../errors';
+import { DialecteErrorDefinition, DialecteErrorKey } from '../errors';
 /**
  * Assert a condition, throwing a structured DialecteError if it fails.
  *
+ * `key` is a key of the core catalogue or an error a dialecte declared with `defineErrors`;
+ * `meta` says what the error is about, as data a consumer can build its own wording from.
+ *
  * @example
  * invariant(record, { detail: 'addChild: parent not found' })
  * invariant(ref.id, { detail: 'Singleton element has no id', key: 'ELEMENT_NOT_FOUND' })
  */
 export declare function invariant(condition: unknown, error: {
     detail: string;
-    key?: DialecteErrorKey;
+    key?: DialecteErrorKey | DialecteErrorDefinition;
     ref?: {
         tagName: string;
         id?: string;
     };
+    meta?: Record<string, unknown>;
 }): asserts condition;
 //# sourceMappingURL=invariant.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../src/utils/invariant.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEhD;;;;;;GAMG;AACH,wBAAgB,SAAS,CACxB,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE;IACN,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,gBAAgB,CAAA;IACtB,GAAG,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACtC,GACC,OAAO,CAAC,SAAS,CAInB"}
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../src/utils/invariant.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEzE;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACxB,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE;IACN,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,gBAAgB,GAAG,uBAAuB,CAAA;IAChD,GAAG,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B,GACC,OAAO,CAAC,SAAS,CAInB"}

package/dist/{utils-ERge2irW.js → utils-Cgqv3qwv.js}

@@ -139,30 +139,65 @@ var e = {
 };
 //#endregion
 //#region src/errors/errors.ts
-function t(t, r) {
-	let i = e[t], a = {
-		code: i.code,
+function t(e, t) {
+	throw n(e, t);
+}
+function n(t, n) {
+	let r = typeof t == "string" ? {
 		key: t,
-		message: r.message ?? i.message,
-		detail: r.detail,
-		method: n((/* @__PURE__ */ Error()).stack),
-		ref: r.ref,
-		cause: r.cause
-	}, o = Error(r.detail);
-	throw o.cause = a, o;
+		...e[t]
+	} : t, i = {
+		code: r.code,
+		key: r.key,
+		message: n.message ?? r.message,
+		detail: n.detail,
+		method: c((/* @__PURE__ */ Error()).stack),
+		ref: n.ref,
+		meta: n.meta,
+		cause: n.cause
+	}, a = Error(n.detail);
+	return a.cause = i, a;
+}
+function r(n) {
+	let r = {}, a = /* @__PURE__ */ new Map();
+	for (let [o, s] of Object.entries(n)) {
+		Object.hasOwn(e, o) && t("ASSERTION_FAILED", { detail: `defineErrors: "${o}" is a key of the core catalogue` }), i.has(s.code) && t("ASSERTION_FAILED", { detail: `defineErrors: "${o}" uses "${s.code}", a code of the core catalogue` });
+		let n = a.get(s.code);
+		n && t("ASSERTION_FAILED", { detail: `defineErrors: "${o}" uses "${s.code}", the code of "${n}"` }), a.set(s.code, o), r[o] = {
+			key: o,
+			...s
+		};
+	}
+	return r;
+}
+var i = new Set(Object.values(e).map((e) => e.code));
+function a(e) {
+	if (!(e instanceof Error)) return;
+	let t = e.cause;
+	if (!(!t || t instanceof Error) && !(typeof t.key != "string" || typeof t.code != "string")) return t;
+}
+function o(t, n) {
+	return Object.hasOwn(e, t.key) ? !0 : n.catalogues.some((e) => Object.hasOwn(e, t.key) && e[t.key]?.code === t.code);
 }
-function n(e) {
+var s = new Set([
+	"throwDialecteError",
+	"createDialecteError",
+	"invariant",
+	"reportFailure"
+]);
+function c(e) {
 	if (!e) return "unknown";
-	let t = e.split("\n").slice(1).find((e) => !/\b(throwDialecteError|assert)\b/.test(e));
-	if (!t) return "unknown";
-	let n = t.match(/\bat\s+(\S+)\s+\(([^)]+)\)/), r = n?.[1], i = n?.[2];
-	if (!i || !r) return r ?? "unknown";
-	let a = i.match(/(\w[\w-]*\/src\/[^?:]+)/);
-	return a ? `${a[1].replace(/\.[^/.]+$/, "")}::${r}` : r;
+	let t = e.split("\n").slice(1).map((e) => e.match(/\bat\s+(?:async\s+)?(\S+)(?:\s+\[as\s+[^\]]+\])?\s+\(([^)]+)\)/)).find((e) => !l(e?.[1])), n = t?.[1]?.replace(/^Object\./, ""), r = t?.[2];
+	if (!r || !n) return n ?? "unknown";
+	let i = r.match(/(\w[\w-]*\/src\/[^?:]+)/);
+	return i ? `${i[1].replace(/\.[^/.]+$/, "")}::${n}` : n;
+}
+function l(e) {
+	return e ? s.has(e.slice(e.lastIndexOf(".") + 1)) : !1;
 }
 //#endregion
 //#region src/utils/resolve-definition.ts
-function r(e) {
+function u(e) {
 	let { dialecteConfig: t, record: n } = e, r = t.definition[n.tagName];
 	if (r === void 0) return;
 	let i = n.parent?.tagName;
@@ -183,75 +218,75 @@ function r(e) {
 }
 //#endregion
 //#region src/utils/attribute-rules.ts
-function i(e) {
-	let { dialecteConfig: t, record: n, attributeName: i } = e, a = t.elements.includes(n.tagName), o = a ? r({
+function d(e) {
+	let { dialecteConfig: t, record: n, attributeName: r } = e, i = t.elements.includes(n.tagName), a = i ? u({
 		dialecteConfig: t,
 		record: n
-	}) : void 0, s = o?.attributes.details[i];
+	}) : void 0, o = a?.attributes.details[r];
 	return {
-		isKnownElement: a,
-		isDefined: !!s,
-		isRequired: !!s?.required,
-		isIdentityField: o?.attributes.identityFields?.includes(i) ?? !1,
-		fixed: s?.fixed,
-		default: s?.default,
-		namespace: s?.namespace || void 0
+		isKnownElement: i,
+		isDefined: !!o,
+		isRequired: !!o?.required,
+		isIdentityField: a?.attributes.identityFields?.includes(r) ?? !1,
+		fixed: o?.fixed,
+		default: o?.default,
+		namespace: o?.namespace || void 0
 	};
 }
-function a(e) {
-	let { dialecteConfig: t, record: n, attributeName: r, defaults: a } = e;
-	if (a === "none") return;
-	let o = i({
+function f(e) {
+	let { dialecteConfig: t, record: n, attributeName: r, defaults: i } = e;
+	if (i === "none") return;
+	let a = d({
 		dialecteConfig: t,
 		record: n,
 		attributeName: r
 	});
-	if (a === "required") return o.isRequired || o.fixed !== void 0 ? o.fixed ?? o.default ?? "" : void 0;
-	if (o.fixed !== void 0) return o.fixed;
-	if (o.default) return o.default;
+	if (i === "required") return a.isRequired || a.fixed !== void 0 ? a.fixed ?? a.default ?? "" : void 0;
+	if (a.fixed !== void 0) return a.fixed;
+	if (a.default) return a.default;
 }
-function o(e) {
-	let { dialecteConfig: t, record: n, attributeName: r, value: a } = e, o = i({
+function p(e) {
+	let { dialecteConfig: t, record: n, attributeName: r, value: i } = e, a = d({
 		dialecteConfig: t,
 		record: n,
 		attributeName: r
-	}), s = o.fixed ?? o.default;
-	return s !== void 0 && a === s;
+	}), o = a.fixed ?? a.default;
+	return o !== void 0 && i === o;
 }
-function s(e) {
+function m(e) {
 	let t = e.lastIndexOf(":");
 	return t === -1 ? e : e.slice(t + 1);
 }
-function c(e, t) {
+function h(e, t) {
 	if (t) return Object.values(e.namespaces).find((e) => e.prefix === t);
 }
-function l(e, t) {
-	return e.namespaces[t] ?? c(e, t);
+function g(e, t) {
+	return e.namespaces[t] ?? h(e, t);
 }
-function u(e, t) {
+function _(e, t) {
 	return e.namespaces[t]?.prefix ?? t;
 }
-function d(e, t) {
+function v(e, t) {
 	let n = e.namespace?.uri ?? "", r = t.namespace?.uri ?? "";
 	return n === r ? e.name === t.name ? 0 : e.name < t.name ? -1 : 1 : n < r ? -1 : 1;
 }
-function f(e, t) {
-	let n = t.flatMap((t) => e.filter((e) => e.name === t)), r = e.filter((e) => !t.includes(e.name)).sort(d);
+function y(e, t) {
+	let n = t.flatMap((t) => e.filter((e) => e.name === t)), r = e.filter((e) => !t.includes(e.name)).sort(v);
 	return [...n, ...r];
 }
 //#endregion
 //#region src/utils/format-xml.ts
-function p(e, t = {}) {
-	let n = t.indent ?? "	", r = t.baseIndent ?? "", i = g(h(e.trim())), a = [];
-	for (let e of i) v(e, r, n, a);
+function b(e, t = {}) {
+	let n = t.indent ?? "	", r = t.baseIndent ?? "", i = C(S(e.trim())), a = [];
+	for (let e of i) T(e, r, n, a);
 	return a.join("\n");
 }
-function m(e, t) {
+function x(e, t) {
 	let n = t;
 	for (; n < e.length && !/[\s/>]/.test(e[n]);) n++;
 	return e.slice(t, n);
 }
-function h(e) {
+function S(e) {
 	let t = [], n = 0;
 	for (; n < e.length;) {
 		if (e[n] === "<") {
@@ -282,15 +317,15 @@ function h(e) {
 			let a = r < e.length ? r + 1 : e.length, o = e.slice(n, a);
 			n = a, o[1] === "/" ? t.push({
 				type: "close",
-				name: m(o, 2),
+				name: x(o, 2),
 				raw: o
 			}) : o.endsWith("/>") ? t.push({
 				type: "selfclose",
-				name: m(o, 1),
+				name: x(o, 1),
 				raw: o
 			}) : t.push({
 				type: "open",
-				name: m(o, 1),
+				name: x(o, 1),
 				raw: o
 			});
 			continue;
@@ -303,7 +338,7 @@ function h(e) {
 	}
 	return t;
 }
-function g(e) {
+function C(e) {
 	let t = 0, n = () => {
 		let r = [];
 		for (; t < e.length;) {
@@ -333,10 +368,10 @@ function g(e) {
 	};
 	return n();
 }
-function _(e) {
-	return e.kind === "element" ? e.selfClosing ? e.openRaw : `${e.openRaw}${e.children.map(_).join("")}</${e.name}>` : e.raw;
+function w(e) {
+	return e.kind === "element" ? e.selfClosing ? e.openRaw : `${e.openRaw}${e.children.map(w).join("")}</${e.name}>` : e.raw;
 }
-function v(e, t, n, r) {
+function T(e, t, n, r) {
 	if (e.kind === "text") {
 		e.raw.trim() !== "" && r.push(t + e.raw.trim());
 		return;
@@ -356,17 +391,17 @@ function v(e, t, n, r) {
 		return;
 	}
 	if (o) {
-		r.push(t + e.openRaw + e.children.map(_).join("") + i);
+		r.push(t + e.openRaw + e.children.map(w).join("") + i);
 		return;
 	}
 	r.push(t + e.openRaw);
-	for (let i of e.children) i.kind !== "text" && v(i, t + n, n, r);
+	for (let i of e.children) i.kind !== "text" && T(i, t + n, n, r);
 	r.push(t + i);
 }
-function y(e, t = {}) {
+function E(e, t = {}) {
 	let n = t.indent ?? "	";
 	return e.replace(/^([ \t]*)(.*?\/\*\s*xml\s*\*\/[ \t]*)`([\s\S]*?)`/gm, (e, t, r, i) => {
-		let a = p(i, {
+		let a = b(i, {
 			indent: n,
 			baseIndent: t + n
 		});
@@ -375,17 +410,18 @@ function y(e, t = {}) {
 }
 //#endregion
 //#region src/utils/invariant.ts
-function b(e, n) {
+function D(e, n) {
 	if (e) return;
-	let { detail: r, key: i = "ASSERTION_FAILED", ref: a } = n;
+	let { detail: r, key: i = "ASSERTION_FAILED", ref: a, meta: o } = n;
 	t(i, {
 		detail: r,
-		ref: a
+		ref: a,
+		meta: o
 	});
 }
 //#endregion
 //#region src/utils/order-children.ts
-function x(e) {
+function O(e) {
 	let { parentTagName: t, children: n, childrenConfig: r } = e, i = r[t];
 	if (!i || i.length === 0) return n;
 	let a = new Set(i), o = /* @__PURE__ */ new Map();
@@ -404,7 +440,7 @@ function x(e) {
 }
 //#endregion
 //#region src/utils/save-to-disk.ts
-async function S(e) {
+async function k(e) {
 	let { data: t, filename: n, pickerType: r } = e;
 	if ("showSaveFilePicker" in window) try {
 		let e = await (await window.showSaveFilePicker({
@@ -422,4 +458,4 @@ async function S(e) {
 	a.href = i, a.download = n, document.body.appendChild(a), a.click(), a.remove(), URL.revokeObjectURL(i);
 }
 //#endregion
-export { e as _, p as a, i as c, c as d, l as f, t as g, r as h, y as i, o as l, a as m, x as n, d as o, u as p, b as r, s, S as t, f as u };
+export { r as _, b as a, a as b, d as c, h as d, g as f, n as g, u as h, E as i, p as l, f as m, O as n, v as o, _ as p, D as r, m as s, k as t, y as u, o as v, e as x, t as y };

package/dist/utils.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, d as n, f as r, h as i, i as a, l as o, m as s, n as c, o as l, p as u, r as d, s as f, t as p, u as m } from "./utils-ERge2irW.js";
+import { a as e, c as t, d as n, f as r, h as i, i as a, l as o, m as s, n as c, o as l, p as u, r as d, s as f, t as p, u as m } from "./utils-Cgqv3qwv.js";
 export { l as compareQualifiedAttributes, f as extractLocalName, a as formatEmbeddedXml, e as formatXml, t as getAttributeRules, d as invariant, o as isSchemaDefaultValue, m as orderAttributesBySequence, c as orderByConfigSequence, i as resolveDefinition, n as resolveNamespaceByPrefix, r as resolveNamespaceByScope, u as resolvePrefixByNamespaceScope, s as resolveSchemaAttributeValue, p as saveToDisk };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dialecte/core",
-	"version": "0.5.2",
+	"version": "0.5.3",
 	"description": "Dialecte - Core functionality for Dialecte SDK",
 	"license": "MIT",
 	"repository": {