@dialecte/core 0.6.3 → 0.7.0

package/dist/helpers.js

@@ -1,6 +1,6 @@
-import { A as e, C as t, D as n, E as r, L as i, M as a, N as o, O as s, S as c, a as l, h as u, i as d, j as f, k as p, l as m, m as h, o as g, s as _, v, w as y, x as b, y as x } from "./utils-CTBHUFs9.js";
+import { A as e, C as t, D as n, E as r, L as i, M as a, N as o, O as s, S as c, _ as l, a as u, c as d, h as f, i as p, j as m, k as h, l as g, m as _, o as v, s as y, v as b, w as x, x as S, y as C } from "./utils-DJN0Md0v.js";
 //#region src/helpers/guard.ts
-var S = [
+var w = [
 	"id",
 	"tagName",
 	"namespace",
@@ -8,34 +8,34 @@ var S = [
 	"children",
 	"parent",
 	"value"
-], C = [...S, "status"], w = [...C, "tree"];
-function T(e, t) {
+], T = [...w, "status"], E = [...T, "tree"];
+function D(e, t) {
 	if (typeof e != "object" || !e) return !1;
 	let n = Object.keys(e);
 	return t.every((t) => t in e) && n.every((e) => t.includes(e)) && n.length === t.length;
 }
-function E(e) {
+function O(e) {
 	return Array.isArray(e);
 }
-function D(e) {
-	return T(e, S);
+function k(e) {
+	return D(e, w);
 }
-function O(e) {
-	return T(e, C);
+function A(e) {
+	return D(e, T);
 }
-function k(e) {
-	return T(e, w);
+function j(e) {
+	return D(e, E);
 }
-function A(e, t) {
+function M(e, t) {
 	return e.tagName === t;
 }
-function j(e, t) {
+function N(e, t) {
 	return e.tagName === t;
 }
-function M(e, t) {
+function ee(e, t) {
 	return e.tagName === t;
 }
-function N(e, t) {
+function te(e, t) {
 	return t.elements.includes(e);
 }
 function P(e, t) {
@@ -105,14 +105,14 @@ function B(e) {
 }
 function V(e) {
 	let { attribute: t, dialecteConfig: n, tagName: r } = e, a;
-	typeof t.namespace == "string" ? (a = _(n, t.namespace), a || i("UNKNOWN_NAMESPACE_PREFIX", {
+	typeof t.namespace == "string" ? (a = y(n, t.namespace), a || i("UNKNOWN_NAMESPACE_PREFIX", {
 		detail: `Unknown namespace '${t.namespace}' on attribute '${t.name}' — use a registered namespace key or pass a full { name, namespace: { prefix, uri } }.`,
 		ref: { tagName: r }
 	})) : a = t.namespace;
 	let o = t.name.indexOf(":");
 	if (!a && o !== -1) {
 		let e = t.name.slice(0, o);
-		e !== "xmlns" && (a = g(n, e), a || i("UNKNOWN_NAMESPACE_PREFIX", {
+		e !== "xmlns" && (a = v(n, e), a || i("UNKNOWN_NAMESPACE_PREFIX", {
 			detail: `Unknown namespace prefix '${e}' on attribute '${t.name}' — pass it explicitly as { name, namespace: { prefix, uri } }.`,
 			ref: { tagName: r }
 		}));
@@ -122,7 +122,7 @@ function V(e) {
 		uri: a.uri
 	}) ?? a), a && a.prefix && a.prefix !== "xmlns" ? {
 		...t,
-		name: `${a.prefix}:${h(t.name)}`,
+		name: `${a.prefix}:${_(t.name)}`,
 		namespace: a
 	} : (t.namespace, {
 		...t,
@@ -134,7 +134,7 @@ function H(e) {
 	return Object.values(t.namespaces).find((e) => e.uri === n && e.prefix !== "");
 }
 function U(e) {
-	return m(e, { detail: "The record or ref is undefined" }), {
+	return g(e, { detail: "The record or ref is undefined" }), {
 		id: e.id,
 		tagName: e.tagName
 	};
@@ -142,17 +142,17 @@ function U(e) {
 //#endregion
 //#region src/helpers/standardizing.ts
 function W(e) {
-	let { dialecteConfig: t, hooks: n, record: r } = e, { id: i, tagName: a, attributes: o, namespace: s, value: c } = r, u = i ?? crypto.randomUUID(), f = G({
+	let { dialecteConfig: t, hooks: n, record: r } = e, { id: i, tagName: a, attributes: o, namespace: s, value: c } = r, l = i ?? crypto.randomUUID(), d = G({
 		dialecteConfig: t,
 		attributes: o ? z({
 			tagName: a,
 			attributes: o,
 			dialecteConfig: t
 		}) : []
-	}), p = {
-		id: u,
+	}), f = {
+		id: l,
 		tagName: a,
-		attributes: f,
+		attributes: d,
 		namespace: s ?? {
 			prefix: "prefixNeededForNotSupportedNamespace",
 			uri: "uriNeededForNotSupportedNamespace"
@@ -161,35 +161,35 @@ function W(e) {
 		parent: r.parent ?? null,
 		children: r.children ?? []
 	}, m = Object.values(t.namespaces).map(({ uri: e }) => e), h = s?.uri != null && !m.includes(s.uri);
-	if (!(t.elements.includes(a) && !h)) return p;
-	let g = x({
+	if (!(t.elements.includes(a) && !h)) return f;
+	let g = C({
 		dialecteConfig: t,
 		record: {
-			...p,
+			...f,
 			namespace: s
 		}
-	}), _ = g?.attributes.sequence ?? [], v = d({
+	}), _ = g?.attributes.sequence ?? [], v = p({
 		wildcard: g?.attributes.any,
 		namespaceUri: ""
-	}), y = f.filter((e) => {
+	}), y = d.filter((e) => {
 		let t = _.includes(e.name), n = "namespace" in e && e.namespace != null;
 		if (!t && !n && !v) return !1;
 		let r = e.value === void 0 || e.value === null || e.value === "";
 		return !(t && r);
-	}), b = t.namespaces.default.uri, S = y.map((e) => {
+	}), b = t.namespaces.default.uri, x = y.map((e) => {
 		if ("namespace" in e && e.namespace?.uri === b) {
 			let { namespace: t, ...n } = e;
 			return n;
 		}
 		return e;
-	}), C = t.definition[a], w = [g?.namespace ?? C.namespace, ...Object.values(C.declarations ?? {}).map((e) => e.namespace)], T = w.find((e) => e.uri === s?.uri), E = {
-		...p,
+	}), S = t.definition[a], w = [g?.namespace ?? S.namespace, ...Object.values(S.declarations ?? {}).map((e) => e.namespace)], T = w.find((e) => e.uri === s?.uri), E = {
+		...f,
 		namespace: T ?? s ?? w[0],
-		attributes: l(S, _)
+		attributes: u(x, _)
 	};
 	return n?.afterStandardizedRecord && (E = n.afterStandardizedRecord({ record: E }), E = {
 		...E,
-		attributes: l(G({
+		attributes: u(G({
 			dialecteConfig: t,
 			attributes: E.attributes
 		}), _)
@@ -197,7 +197,7 @@ function W(e) {
 }
 function G(e) {
 	let { dialecteConfig: n, attributes: r } = e;
-	return y({
+	return x({
 		dialecteConfig: n,
 		attributes: r,
 		namespaceOf: t({
@@ -211,7 +211,7 @@ function G(e) {
 function K(e) {
 	let { dialecteConfig: t, record: n, attributes: r } = e;
 	for (let e of r) {
-		let r = u({
+		let r = f({
 			dialecteConfig: t,
 			record: n,
 			attributeName: e.name
@@ -225,13 +225,13 @@ function K(e) {
 //#endregion
 //#region src/helpers/assert-xsi-type.ts
 function q(e) {
-	let { dialecteConfig: t, record: n } = e, r = n.attributes.find(b);
+	let { dialecteConfig: t, record: n } = e, r = n.attributes.find(S);
 	if (r === void 0) {
-		x({
+		C({
 			dialecteConfig: t,
 			record: n
 		})?.abstractType && i("XSI_TYPE_REQUIRED", {
-			detail: `'${n.tagName}' is declared with an abstract type: name one of its variants with xsi:type (${v({
+			detail: `'${n.tagName}' is declared with an abstract type: name one of its variants with xsi:type (${b({
 				dialecteConfig: t,
 				record: n
 			}).join(", ")}).`,
@@ -239,7 +239,7 @@ function q(e) {
 		});
 		return;
 	}
-	if (x({
+	if (C({
 		dialecteConfig: t,
 		record: n
 	}) === void 0) return;
@@ -248,7 +248,7 @@ function q(e) {
 		record: n
 	});
 	if (a?.namespace === "http://www.w3.org/2001/XMLSchema") return;
-	let o = v({
+	let o = b({
 		dialecteConfig: t,
 		record: n
 	});
@@ -262,7 +262,7 @@ function q(e) {
 	});
 }
 function J(e) {
-	let { dialecteConfig: t, merged: n, record: r } = e, a = new Set(r.attributes.map((e) => e.name)), o = n.filter((e) => e.value !== "" && !a.has(e.name)).map((e) => e.name), s = x({
+	let { dialecteConfig: t, merged: n, record: r } = e, a = new Set(r.attributes.map((e) => e.name)), o = n.filter((e) => e.value !== "" && !a.has(e.name)).map((e) => e.name), s = C({
 		dialecteConfig: t,
 		record: r
 	}), c = new Set(s?.children.sequence ?? []), l = s?.children.any ? [] : [...new Set(r.children.map((e) => e.tagName))].filter((e) => !c.has(e));
@@ -280,7 +280,7 @@ function J(e) {
 function Y(e, t, n, r) {
 	if (!e || !t) return;
 	let i = Object.keys(t).filter((t) => t in e);
-	m(i.length === 0, {
+	g(i.length === 0, {
 		key: "EXTENSION_METHOD_COLLISION",
 		detail: `Module "${n}" has conflicting ${r} method(s): ${i.map((e) => `"${e}"`).join(", ")}`
 	});
@@ -312,4 +312,128 @@ function Z(e, t) {
 	} : r;
 }
 //#endregion
-export { r as CUSTOM_RECORD_ID_ATTRIBUTE, n as CUSTOM_RECORD_ID_ATTRIBUTE_NAME, s as DIALECTE_DEV_NAMESPACE, p as DIALECTE_NAMESPACES, e as XMLNS_NAMESPACE_URI, f as XMLNS_XSI_NAMESPACE, a as XSD_NAMESPACE_URI, o as XSI_NAMESPACE, K as assertNoFixedViolation, q as assertXsiTypeAdmitted, J as assertXsiTypeChangeLeavesNothing, P as isAttributeOf, j as isChildOf, N as isElementOf, E as isFullAttributeArray, M as isParentOf, D as isRawRecord, A as isRecordOf, O as isTrackedRecord, k as isTreeRecord, X as mergeExtensions, W as standardizeRecord, Z as stripAttributes, z as toFullAttributeArray, F as toRawRecord, U as toRef, L as toTrackedRecord, R as toTreeRecord, I as widen };
+//#region src/helpers/read-attributes.ts
+function ne(e) {
+	let { record: t, dialecteConfig: n, name: r, namespace: i, fullObject: a, defaults: o = "optional" } = e, s = re({
+		dialecteConfig: n,
+		name: r,
+		namespace: i
+	}), c = t.attributes.find((e) => e.name === s);
+	if (c) return a ? c : c.value;
+	let u = l({
+		dialecteConfig: n,
+		record: t,
+		attributeName: s,
+		defaults: o
+	});
+	if (!a) return u ?? "";
+	if (u === void 0) return;
+	let { namespace: d } = f({
+		dialecteConfig: n,
+		record: t,
+		attributeName: s
+	});
+	return {
+		name: s,
+		value: u,
+		namespace: d
+	};
+}
+function re(e) {
+	let { dialecteConfig: t, name: n, namespace: r } = e;
+	if (r === void 0) return n;
+	let i = d(t, r);
+	return i ? `${i}:${n}` : n;
+}
+function ie(e) {
+	return e.fullObject ? oe(e) : ae(e);
+}
+function ae(e) {
+	let { record: t, dialecteConfig: n, namespace: r, defaults: i = "optional" } = e, a = r === void 0 ? void 0 : d(n, r), o = {};
+	for (let e of t.attributes) {
+		let t = $({
+			name: e.name,
+			namespace: e.namespace,
+			targetPrefix: a
+		});
+		t !== void 0 && (o[t] = e.value ?? "");
+	}
+	if (i === "none") return o;
+	for (let e of Q({
+		dialecteConfig: n,
+		record: t
+	})) {
+		let r = $({
+			name: e,
+			targetPrefix: a
+		});
+		if (r === void 0 || r in o) continue;
+		let s = l({
+			dialecteConfig: n,
+			record: t,
+			attributeName: e,
+			defaults: i
+		});
+		s !== void 0 && (o[r] = s);
+	}
+	return o;
+}
+function oe(e) {
+	let { record: t, dialecteConfig: n, defaults: r = "optional" } = e, i = [...t.attributes];
+	if (r === "none") return i;
+	let a = new Set(i.map((e) => e.name));
+	for (let e of Q({
+		dialecteConfig: n,
+		record: t
+	})) {
+		if (a.has(e)) continue;
+		let o = l({
+			dialecteConfig: n,
+			record: t,
+			attributeName: e,
+			defaults: r
+		});
+		if (o === void 0) continue;
+		let { namespace: s } = f({
+			dialecteConfig: n,
+			record: t,
+			attributeName: e
+		});
+		i.push({
+			name: e,
+			value: o,
+			namespace: s
+		});
+	}
+	return i;
+}
+function Q(e) {
+	let { dialecteConfig: t, record: n } = e;
+	return C({
+		dialecteConfig: t,
+		record: n
+	})?.attributes.sequence ?? [];
+}
+function $(e) {
+	let { name: t, namespace: n, targetPrefix: r } = e, { prefix: i, local: a, isXmlns: o } = se(t);
+	if (!(o || n?.uri === "http://www.w3.org/2000/xmlns/")) return r === void 0 ? t : i === r ? a : void 0;
+}
+function se(e) {
+	if (e === "xmlns" || e.startsWith("xmlns:")) return {
+		prefix: "",
+		local: e,
+		isXmlns: !0
+	};
+	let t = e.indexOf(":");
+	return t === -1 ? {
+		prefix: "",
+		local: e,
+		isXmlns: !1
+	} : {
+		prefix: e.slice(0, t),
+		local: e.slice(t + 1),
+		isXmlns: !1
+	};
+}
+//#endregion
+export { r as CUSTOM_RECORD_ID_ATTRIBUTE, n as CUSTOM_RECORD_ID_ATTRIBUTE_NAME, s as DIALECTE_DEV_NAMESPACE, h as DIALECTE_NAMESPACES, e as XMLNS_NAMESPACE_URI, m as XMLNS_XSI_NAMESPACE, a as XSD_NAMESPACE_URI, o as XSI_NAMESPACE, K as assertNoFixedViolation, q as assertXsiTypeAdmitted, J as assertXsiTypeChangeLeavesNothing, P as isAttributeOf, N as isChildOf, te as isElementOf, O as isFullAttributeArray, ee as isParentOf, k as isRawRecord, M as isRecordOf, A as isTrackedRecord, j as isTreeRecord, X as mergeExtensions, ne as readAttribute, ie as readAttributes, W as standardizeRecord, Z as stripAttributes, z as toFullAttributeArray, F as toRawRecord, U as toRef, L as toTrackedRecord, R as toTreeRecord, I as widen };

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './diagnostics';
 export * from './document';
 export * from './errors';
 export * from './perf';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AAErB,mBAAmB,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AAErB,mBAAmB,SAAS,CAAA"}

package/dist/index.js

@@ -1,3 +1,22 @@
-import { $ as e, A as t, B as n, C as r, D as i, E as a, F as o, G as s, H as c, I as l, J as u, K as d, L as f, M as p, N as m, O as h, P as g, Q as _, R as v, S as y, T as b, U as x, W as S, X as C, Y as w, Z as T, _ as E, _t as D, a as O, at as k, b as A, c as j, ct as M, d as N, dt as P, et as F, f as I, ft as L, g as R, h as z, ht as B, i as V, it as H, j as U, k as W, l as G, lt as K, m as q, mt as J, n as Y, nt as X, o as Z, ot as Q, p as $, pt as ee, q as te, r as ne, rt as re, s as ie, st as ae, t as oe, tt as se, u as ce, ut as le, v as ue, w as de, x as fe, y as pe, z as me } from "./project-DEiVpWVV.js";
-import { F as he, I as ge, L as _e, P as ve, R as ye, z as be } from "./utils-CTBHUFs9.js";
-export { W as AnyQuery, i as AnyTransaction, N as BLOBS_SCHEMA, I as BLOB_DATA_SCHEMA, $ as CHANGELOG_SCHEMA, q as DOCUMENTS_SCHEMA, ce as DexieStore, de as Document, be as ERROR_CATALOG, G as InMemoryStore, z as META_SCHEMA, m as NOOP_PERF, g as ParseSession, oe as Project, h as Query, R as TABLE_BLOBS, E as TABLE_BLOB_PREFIX, ue as TABLE_CHANGELOG, pe as TABLE_DOCUMENTS, A as TABLE_META, fe as TABLE_RECORD_PREFIX, me as TEMP_IDB_ID_ATTRIBUTE_NAME, a as Transaction, d as applyOmit, s as applyOrder, C as applyUnwrap, D as bindExtensions, y as blobTableName, V as buildDocumentState, l as buildXmlDocument, x as collectSnapshotRecords, ve as createDialecteError, p as createPerf, B as createStagedOperations, he as defineErrors, f as downloadFile, Z as exportBlob, ie as exportDocument, k as findAncestors, re as findByAttributes, X as findDescendants, n as formatXml, F as getAttribute, se as getAttributeFullObject, _ as getAttributes, e as getAttributesFullObject, M as getChild, ae as getChildren, T as getDefinition, L as getRecord, le as getRecords, K as getRecordsByTagName, t as getSnapshot, S as getTree, ne as importDocument, ee as indexStagedDeletesByParent, Y as initEmptyDocument, o as inspectXml, ge as isKnownDialecteError, te as isOmitted, b as isTransactionContext, Q as loadLiveRecords, H as matchesAttributeFilter, J as overlayAllStaged, u as parseOmit, U as parseXmlFile, O as reconcileDocumentState, r as recordTableName, c as recordsToTree, P as resolveRecord, j as resolveStore, w as shouldStopTraversal, _e as throwDialecteError, ye as toDialecteError, v as xmlDocumentToString };
+import { $ as e, A as t, B as n, C as r, D as i, E as a, F as o, G as s, H as ee, I as te, J as c, K as l, L as u, M as d, N as f, O as p, P as m, Q as h, R as g, S as _, T as v, V as y, W as b, X as x, Y as S, Z as C, _ as w, _t as T, a as E, at as D, b as O, c as k, ct as A, d as j, dt as M, et as N, f as P, ft as F, g as I, gt as L, h as R, ht as z, i as B, it as V, j as H, k as U, l as ne, lt as W, m as G, mt as K, n as q, nt as J, o as Y, ot as X, p as Z, pt as re, q as ie, r as ae, rt as oe, s as se, st as ce, t as le, tt as ue, u as de, ut as fe, v as pe, w as me, x as Q, y as he, yt as ge, z as _e } from "./project-DIKdMMHx.js";
+import { F as ve, I as ye, L as $, P as be, R as xe, z as Se } from "./utils-DJN0Md0v.js";
+//#region src/diagnostics/diagnostics.ts
+function Ce(e, t, n) {
+	let r = e.codes[t];
+	r || $("ASSERTION_FAILED", { detail: `createDiagnostic: "${t}" is not a code of the "${e.source}" catalogue` });
+	let { ref: i, message: a = r.message, related: o, meta: s } = n;
+	return {
+		code: t,
+		severity: r.severity,
+		source: e.source,
+		message: a,
+		ref: i,
+		...o && { related: o },
+		...s && { meta: s }
+	};
+}
+function we(e, t) {
+	return t.catalogues.some((t) => t.source === e.source && Object.hasOwn(t.codes, e.code));
+}
+//#endregion
+export { H as AnyQuery, U as AnyTransaction, Z as BLOBS_SCHEMA, G as BLOB_DATA_SCHEMA, R as CHANGELOG_SCHEMA, I as DOCUMENTS_SCHEMA, P as DexieStore, a as Document, Se as ERROR_CATALOG, Y as IMPORT_HEARTBEAT_MS, j as InMemoryStore, w as META_SCHEMA, o as NOOP_PERF, te as ParseSession, le as Project, t as Query, se as STALE_IMPORT_MS, pe as TABLE_BLOBS, he as TABLE_BLOB_PREFIX, O as TABLE_CHANGELOG, Q as TABLE_DOCUMENTS, _ as TABLE_META, r as TABLE_RECORD_PREFIX, y as TEMP_IDB_ID_ATTRIBUTE_NAME, p as Transaction, c as applyOmit, ie as applyOrder, h as applyUnwrap, ge as bindExtensions, me as blobTableName, B as buildDocumentState, g as buildXmlDocument, s as collectSnapshotRecords, Ce as createDiagnostic, be as createDialecteError, m as createPerf, T as createStagedOperations, ve as defineErrors, _e as downloadFile, k as exportBlob, ne as exportDocument, ce as findAncestors, D as findByAttributes, V as findDescendants, ee as formatXml, J as getAttribute, oe as getAttributeFullObject, N as getAttributes, ue as getAttributesFullObject, fe as getChild, W as getChildren, e as getDefinition, K as getRecord, F as getRecords, M as getRecordsByTagName, d as getSnapshot, l as getTree, ae as importDocument, z as indexStagedDeletesByParent, q as initEmptyDocument, u as inspectXml, we as isKnownDiagnostic, ye as isKnownDialecteError, S as isOmitted, i as isTransactionContext, A as loadLiveRecords, X as matchesAttributeFilter, L as overlayAllStaged, x as parseOmit, f as parseXmlFile, E as reconcileDocumentState, v as recordTableName, b as recordsToTree, re as resolveRecord, de as resolveStore, C as shouldStopTraversal, $ as throwDialecteError, xe as toDialecteError, n as xmlDocumentToString };

package/dist/project/index.d.ts

@@ -1,10 +1,11 @@
 export { Project } from './project';
 export { buildDocumentState, reconcileDocumentState } from './state/document-state';
+export { IMPORT_HEARTBEAT_MS, STALE_IMPORT_MS } from './state/document-lifecycle';
 export { exportDocument } from './io/export-document';
 export { exportBlob } from './io/export-blob';
 export { initEmptyDocument } from './io/init-empty-document';
 export { importDocument } from './io/import-document';
 export { resolveStore } from '../store/resolve-store';
-export type { ProjectParams, InitEmptyDocumentOptions, ImportDocumentOptions, ExportDocumentOptions, ExportBlobOptions, StorageParam, DocumentRecord, DocumentEntry, ProjectState, ProjectChannelMessage, } from './types';
+export type { ProjectParams, InitEmptyDocumentOptions, ImportDocumentOptions, ImportedDocument, ImportEntry, ExportDocumentOptions, ExportBlobOptions, StorageParam, DocumentRecord, DocumentStatus, DocumentEntry, ProjectState, ProjectChannelMessage, } from './types';
 export type { InitEmptyDocumentParams, InitEmptyDocumentResult, ImportDocumentParams, ImportDocumentResult, ExportDocumentParams, ExportDocumentResult, ExportBlobParams, ExportBlobResult, } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,YAAY,EACX,aAAa,EACb,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACZ,qBAAqB,GACrB,MAAM,SAAS,CAAA;AAChB,YAAY,EACX,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AACnF,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,YAAY,EACX,aAAa,EACb,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,EACZ,qBAAqB,GACrB,MAAM,SAAS,CAAA;AAChB,YAAY,EACX,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,SAAS,CAAA"}

package/dist/project/io/import-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-document.d.ts","sourceRoot":"","sources":["../../../src/project/io/import-document.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAG1E;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAsDhG"}
+{"version":3,"file":"import-document.d.ts","sourceRoot":"","sources":["../../../src/project/io/import-document.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAI1E;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA4EhG"}

package/dist/project/io/init-empty-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-empty-document.d.ts","sourceRoot":"","sources":["../../../src/project/io/init-empty-document.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAkB,MAAM,UAAU,CAAA;AAGhG;;;GAGG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,uBAAuB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CA4ClC"}
+{"version":3,"file":"init-empty-document.d.ts","sourceRoot":"","sources":["../../../src/project/io/init-empty-document.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAkB,MAAM,UAAU,CAAA;AAGhG;;;GAGG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,uBAAuB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CA2ClC"}

package/dist/project/io/resolve-config.d.ts

@@ -0,0 +1,4 @@
+import { ResolveConfigParams, ResolvedConfig } from '../types';
+/** The config a document is imported or created with: the key given, or the project's default. */
+export declare function resolveConfig(params: ResolveConfigParams): ResolvedConfig;
+//# sourceMappingURL=resolve-config.d.ts.map

package/dist/project/io/resolve-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../../../src/project/io/resolve-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAEnE,kGAAkG;AAClG,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,cAAc,CAUzE"}

package/dist/project/project.d.ts

@@ -1,5 +1,5 @@
 import { Document, ExtensionModules, MergedExtensions, QueryExtensions, Query } from '../document';
-import { InitEmptyDocumentOptions, ImportDocumentOptions, ExportDocumentOptions, ExportBlobOptions, ExportBlobResult, ProjectParams, ProjectState, DocumentRecord } from './types';
+import { InitEmptyDocumentOptions, ImportDocumentOptions, ImportedDocument, ImportEntry, ExportDocumentOptions, ExportBlobOptions, ExportBlobResult, ProjectParams, ProjectState, DocumentRecord } from './types';
 import { Perf } from '../perf';
 import { Store } from '../store';
 import { AnyDialecteConfig, BlobAttachment, BlobRecord, DialecteHooks } from '../types';
@@ -22,6 +22,8 @@ export declare class Project<GenericConfig extends AnyDialecteConfig, GenericMod
     private _channel?;
     /** Set once close()/destroy() begins, to stop new channel-triggered store work. */
     private closing;
+    /** While open: the imports whose heartbeat went stale are swept every `STALE_IMPORT_MS`. */
+    private staleSweep?;
     /** In-flight fire-and-forget work triggered by foreign messages, awaited on teardown. */
     private readonly pendingBroadcastWork;
     private readonly storage;
@@ -32,7 +34,17 @@ export declare class Project<GenericConfig extends AnyDialecteConfig, GenericMod
     /** Single project-lived dev perf helper; frozen no-op unless `dev.perf`. */
     readonly perf: Perf;
     get name(): string;
+    /** The store of an open project: one never opened, closed or destroyed has none to read or write. */
     private get store();
+    /**
+     * The imports of this project, one after the other: a call made while another import runs
+     * waits for it. The chain never blocks on a failed import; each caller gets its own outcome.
+     */
+    private importChain;
+    /** Run `work` once every import queued before it has settled: one file in flight per project. */
+    private enqueueImport;
+    /** Resolved once every import queued so far has settled, however it settled. */
+    private settledImports;
     private get channel();
     /**
      * Name of this project's BroadcastChannel — the public event contract.
@@ -96,11 +108,13 @@ export declare class Project<GenericConfig extends AnyDialecteConfig, GenericMod
     /** Recompute canUndo/canRedo for a document from the store's history. */
     private refreshHistoryStatus;
     /**
-     * Close the store and release resources.
+     * Close the store and release resources, once the imports in flight have landed - they
+     * broadcast on the live channel. From the call on, the project is closed: a new call throws
+     * `PROJECT_NOT_OPENED`.
      */
-    close(): void;
+    close(): Promise<void>;
     /**
-     * Destroy the project - deletes the database entirely.
+     * Destroy the project - deletes the database entirely, once the imports in flight have landed.
      */
     destroy(): Promise<void>;
     /**
@@ -113,12 +127,27 @@ export declare class Project<GenericConfig extends AnyDialecteConfig, GenericMod
      */
     removeDocument(documentId: string): Promise<void>;
     /**
-     * Import one or more Files into the project: register, parse XML, persist records.
+     * What is about an import call, checked at the call and before any file: an open project (its
+     * store, which the import then writes to even if the project closes meanwhile), a known
+     * `configKey`.
      */
-    import(files: File[], options?: ImportDocumentOptions): Promise<Array<{
-        documentId: string;
-        recordCount: number;
-    }>>;
+    private importStore;
+    /**
+     * Import Files into the project: one entry per file, in the order given. The files are imported
+     * one after the other - memory is bounded by one file's batches, the registry sees one import -
+     * and a file that fails is its own `failed` entry, the next file still attempted: nothing of a
+     * failed file lands. The call itself rejects only for what is about the call: an unknown
+     * `configKey`, a project not open.
+     */
+    import(files: File[], options?: ImportDocumentOptions): Promise<ImportEntry[]>;
+    /**
+     * Import one File into the project: register, parse XML, persist records. The document is in
+     * the project state and broadcast once its last record is stored; whatever fails before that
+     * removes it again and is thrown (`PARSE_ERROR` for a malformed file). One file is in flight
+     * per project: a call made while another import runs waits for it.
+     */
+    importFile(file: File, options?: ImportDocumentOptions): Promise<ImportedDocument>;
+    private importOne;
     /**
      * Export a document as an XMLDocument built from stored records.
      */
@@ -126,6 +155,7 @@ export declare class Project<GenericConfig extends AnyDialecteConfig, GenericMod
         xmlDocument: XMLDocument;
         filename: string;
     }>;
+    /** The documents of the project; one still importing - here or in another realm - is not among them. */
     getDocuments(): Promise<DocumentRecord[]>;
     getDocument(documentId: string): Promise<DocumentRecord | undefined>;
     /**

package/dist/project/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/project/project.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/project/project.ts"],"names":[],"mappings":"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"}

package/dist/project/state/document-lifecycle.d.ts

@@ -0,0 +1,18 @@
+import { DocumentRecord } from '../types';
+/** How often an import says it is still alive, through `DocumentRecord.importingAt`. */
+export declare const IMPORT_HEARTBEAT_MS = 2000;
+/**
+ * An import whose last heartbeat is older than this was left by a realm that died (a tab closed
+ * mid-import): `open()` removes it. Generous on purpose - a false "dead" loses a running import, a
+ * false "alive" only keeps a hidden leftover a few minutes longer: a hidden tab's timers are
+ * throttled to once a minute by the browser, and a dialecte's `afterImport` on a very large file
+ * may hold the main thread for tens of seconds.
+ */
+export declare const STALE_IMPORT_MS: number;
+/** A document whose records are still being stored - by this realm or another one. */
+export declare function isImporting(record: DocumentRecord): boolean;
+/** An import nobody is running any more: still `importing`, its heartbeat long gone. */
+export declare function isStaleImport(record: DocumentRecord, now?: number): boolean;
+/** The documents a project opens, lists and serves: nothing half-imported is ever visible. */
+export declare function openableDocuments(records: readonly DocumentRecord[]): DocumentRecord[];
+//# sourceMappingURL=document-lifecycle.d.ts.map

package/dist/project/state/document-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/project/state/document-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,OAAQ,CAAA;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,QAAa,CAAA;AAEzC,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAE3D;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,SAAa,GAAG,OAAO,CAE/E;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,EAAE,CAEtF"}

package/dist/project/types.d.ts

@@ -1,4 +1,6 @@
+import { Diagnostic } from '../diagnostics';
 import { DocumentState, ExtensionModules } from '../document';
+import { DialecteError } from '../errors';
 import { Perf } from '../perf';
 import { Store } from '../store/store.types';
 import { AnyDialecteConfig, BlobAttachment, BlobRecord, ChunkOptions, DialecteHooks } from '../types';
@@ -21,7 +23,17 @@ export type DocumentRecord = {
     createdAt: number;
     /** Extensible per-file metadata, populated by config.extractMetadata at import */
     metadata?: Record<string, unknown>;
+    /**
+     * `importing` from registration until the last record is stored, `ready` after. A failed import
+     * removes the document; one left `importing` with no heartbeat for `STALE_IMPORT_MS` was left
+     * by a realm that died, and `open()` removes it. A document is never opened, listed or served
+     * while `importing`.
+     */
+    status: DocumentStatus;
+    /** While `importing`: the last time the importing realm said it was alive (ms since epoch). */
+    importingAt?: number;
 };
+export type DocumentStatus = 'importing' | 'ready';
 /**
  * DocumentState - observable state for a single document within a Project.
  * Extends DocumentState with project-level fields.
@@ -117,6 +129,16 @@ export type ProjectParams<GenericConfig extends AnyDialecteConfig, BaseExtension
     /** All lifecycle hooks (IO + record), applied to every Document opened from this Project */
     hooks?: DialecteHooks<GenericConfig>;
 };
+export type ResolveConfigParams = {
+    configs: Record<string, AnyDialecteConfig>;
+    defaultConfigKey: string;
+    /** Key into configs registry. Defaults to defaultConfigKey. */
+    configKey?: string;
+};
+export type ResolvedConfig = {
+    configKey: string;
+    config: AnyDialecteConfig;
+};
 export type InitEmptyDocumentOptions = {
     /** Filename without extension. Defaults to 'untitled'. */
     name?: string;
@@ -166,6 +188,28 @@ export type ImportDocumentResult = {
     record: DocumentRecord;
     documentState: DocumentEntry;
     recordCount: number;
+    /** What the import had to say about the file; `[]` when nothing */
+    diagnostics: Diagnostic[];
+};
+/** A file `Project.importFile` imported: the document it is now, and what the import had to say. */
+export type ImportedDocument = {
+    /** `file.name` as given */
+    fileName: string;
+    documentId: string;
+    recordCount: number;
+    /** Always present, `[]` when the import had nothing to say; an open union, narrowed with `isKnownDiagnostic` */
+    diagnostics: Diagnostic[];
+};
+/**
+ * What `Project.import` says of one file: imported, or failed with the structured error - a file's
+ * failure is its entry, never the call's.
+ */
+export type ImportEntry = ({
+    status: 'imported';
+} & ImportedDocument) | {
+    status: 'failed';
+    fileName: string;
+    error: DialecteError;
 };
 export type ExportDocumentParams = {
     documentId: string;