@dialecte/core 0.6.4 → 0.8.0

package/dist/utils.js

@@ -1,2 +1 @@
-import { S as e, _ as t, a as n, b as r, c as i, d as a, f as o, g as s, h as c, i as l, l as u, m as d, n as f, o as p, p as m, r as h, s as g, t as _, u as v, v as y, y as b } from "./utils-CTBHUFs9.js";
-export { y as admittedXsiTypes, r as canonicalXsiType, h as compareQualifiedAttributes, o as enumeratedValues, d as extractLocalName, v as formatEmbeddedXml, a as formatXml, c as getAttributeRules, u as invariant, l as isNamespaceAllowedByWildcard, s as isSchemaDefaultValue, n as orderAttributesBySequence, f as orderByConfigSequence, b as resolveDefinition, p as resolveNamespaceByPrefix, g as resolveNamespaceByScope, i as resolvePrefixByNamespaceScope, t as resolveSchemaAttributeValue, e as resolveXsiType, _ as saveToDisk, m as valuePatterns };
+export { C as admittedXsiTypes, T as canonicalXsiType, v as childOccurrences, o as compareQualifiedAttributes, t as createSeededRandomUuid, g as enumeratedValues, y as extractLocalName, p as formatEmbeddedXml, m as formatXml, b as getAttributeRules, f as invariant, s as isNamespaceAllowedByWildcard, x as isSchemaDefaultValue, c as orderAttributesBySequence, a as orderByConfigSequence, i as requiredChoices, w as resolveDefinition, l as resolveNamespaceByPrefix, u as resolveNamespaceByScope, d as resolvePrefixByNamespaceScope, S as resolveSchemaAttributeValue, D as resolveXsiType, r as saveToDisk, _ as valuePatterns } from "./utils-USNkj4sT.js";

package/dist/xml/build/document-root.d.ts

@@ -0,0 +1,7 @@
+import { AnyDialecteConfig, AnyRawRecord } from '../../types';
+/** Whether the record is its document's root element: the dialecte's root tag, with no parent. */
+export declare function isDocumentRoot(params: {
+    record: AnyRawRecord;
+    config: AnyDialecteConfig;
+}): boolean;
+//# sourceMappingURL=document-root.d.ts.map

package/dist/xml/build/document-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-root.d.ts","sourceRoot":"","sources":["../../../src/xml/build/document-root.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE9D,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACtC,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,iBAAiB,CAAA;CACzB,GAAG,OAAO,CAGV"}

package/dist/xml/build/index.d.ts

@@ -1,7 +1,2 @@
-export * from './formatter';
 export * from './constant';
-export { downloadFile } from './download-file';
-export { xmlDocumentToString } from './serialize';
-export { buildXmlDocument } from './build-xml-document';
-export type { BuildXmlDocumentParams } from './build-xml-document.types';
 //# sourceMappingURL=index.d.ts.map

package/dist/xml/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/xml/build/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/xml/build/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA"}

package/dist/xml/build/record-element.d.ts

@@ -0,0 +1,15 @@
+import { RecordElementContext } from './record-element.types';
+import { XmlElement } from './xml-element.types';
+import { AnyRawRecord } from '../../types';
+/**
+ * The element a record is written as, with what the document holds on it: its attributes, the required and fixed
+ * attributes the schema asks for and the record does not hold, its xsi:type prefix bound, the namespaces it needs
+ * declared on the written root (where it is the root: the root attributes those namespaces bring), and its database
+ * id when asked. Its text and children are the writer's.
+ */
+export declare function createRecordElement(params: {
+    context: RecordElementContext;
+    record: AnyRawRecord;
+    parent: XmlElement | undefined;
+}): XmlElement;
+//# sourceMappingURL=record-element.d.ts.map

package/dist/xml/build/record-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-element.d.ts","sourceRoot":"","sources":["../../../src/xml/build/record-element.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EAIX,YAAY,EAEZ,MAAM,SAAS,CAAA;AAEhB;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC3C,OAAO,EAAE,oBAAoB,CAAA;IAC7B,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAA;CAC9B,GAAG,UAAU,CAKb"}

package/dist/xml/build/record-element.types.d.ts

@@ -0,0 +1,12 @@
+import { XmlElement } from './xml-element.types';
+import { AnyDialecteConfig, AnyRawRecord } from '../../types';
+/** What every element of one written document is made with; `rootElement` is the written root once created. */
+export type RecordElementContext = {
+    config: AnyDialecteConfig;
+    declareNamespaces: boolean;
+    withDatabaseIds: boolean;
+    /** The document's root record; `undefined` for a fragment, which gets no root attributes. */
+    documentRoot: AnyRawRecord | undefined;
+    rootElement: XmlElement | undefined;
+};
+//# sourceMappingURL=record-element.types.d.ts.map

package/dist/xml/build/record-element.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-element.types.d.ts","sourceRoot":"","sources":["../../../src/xml/build/record-element.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE9D,+GAA+G;AAC/G,MAAM,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,iBAAiB,CAAA;IACzB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,eAAe,EAAE,OAAO,CAAA;IACxB,6FAA6F;IAC7F,YAAY,EAAE,YAAY,GAAG,SAAS,CAAA;IACtC,WAAW,EAAE,UAAU,GAAG,SAAS,CAAA;CACnC,CAAA"}

package/dist/xml/build/write-xml-records.d.ts

@@ -0,0 +1,7 @@
+import { WriteXmlRecordsParams } from './write-xml-records.types';
+/**
+ * Write a document (or the fragment rooted at `rootId`) held as a list of records: the bytes the store's export
+ * writes for the same records. Children follow the dialecte's sequence.
+ */
+export declare function writeXmlRecords(params: WriteXmlRecordsParams): string;
+//# sourceMappingURL=write-xml-records.d.ts.map

package/dist/xml/build/write-xml-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-xml-records.d.ts","sourceRoot":"","sources":["../../../src/xml/build/write-xml-records.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAGtE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAgCrE"}

package/dist/xml/build/write-xml-records.types.d.ts

@@ -0,0 +1,11 @@
+import { AnyDialecteConfig, AnyRawRecord } from '../../types';
+export type WriteXmlRecordsParams = {
+    records: AnyRawRecord[];
+    config: AnyDialecteConfig;
+    rootId?: string;
+    declareNamespaces?: boolean;
+    includeXmlDeclaration?: boolean;
+    withDatabaseIds?: boolean;
+    indent?: boolean;
+};
+//# sourceMappingURL=write-xml-records.types.d.ts.map

package/dist/xml/build/write-xml-records.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-xml-records.types.d.ts","sourceRoot":"","sources":["../../../src/xml/build/write-xml-records.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE9D,MAAM,MAAM,qBAAqB,GAAG;IACnC,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,MAAM,EAAE,iBAAiB,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA"}

package/dist/xml/build/xml-element.d.ts

@@ -0,0 +1,79 @@
+import { GeneratedPrefixes, NamespaceScope, XmlElement } from './xml-element.types';
+/** An element named as `createElementNS` (with a namespace) or `createElement` (without) names it. */
+export declare function createXmlElement(params: {
+    namespaceURI: string | null;
+    qualifiedName: string;
+    parent: XmlElement | undefined;
+}): XmlElement;
+/** `setAttribute`: the attribute of that qualified name takes the value, or a new one in no namespace is added last. */
+export declare function setAttribute(params: {
+    element: XmlElement;
+    qualifiedName: string;
+    value: string;
+}): void;
+/**
+ * `setAttributeNS`: the attribute of that namespace and local name takes the value (keeping its prefix), or a new one
+ * is added last.
+ */
+export declare function setAttributeNS(params: {
+    element: XmlElement;
+    namespaceURI: string;
+    qualifiedName: string;
+    value: string;
+}): void;
+/** `hasAttribute`: an attribute of that qualified name, whatever its namespace. */
+export declare function hasAttribute(params: {
+    element: XmlElement;
+    qualifiedName: string;
+}): boolean;
+/** `getAttributeNS`: the value of the attribute of that namespace and local name, `null` when absent. */
+export declare function getAttributeNS(params: {
+    element: XmlElement;
+    namespaceURI: string;
+    localName: string;
+}): string | null;
+/** `hasAttributeNS`: an attribute of that namespace and local name. */
+export declare function hasAttributeNS(params: {
+    element: XmlElement;
+    namespaceURI: string;
+    localName: string;
+}): boolean;
+/** The namespace a prefix (`null` = the default) names where the element stands: its own name, its declarations, its ancestors'. */
+export declare function lookupNamespaceURI(params: {
+    element: XmlElement;
+    prefix: string | null;
+}): string | null;
+/** A prefix bound to the namespace where the element stands: its own name's, its declarations', its ancestors'. */
+export declare function lookupPrefix(params: {
+    element: XmlElement;
+    namespaceURI: string;
+}): string | null;
+/**
+ * The start tag `XMLSerializer` writes for the element where `scope` is in force, without its closing `>` or `/>`,
+ * and the scope its children stand in. The element's own declarations count before anything is written; a namespace
+ * its name or an attribute needs and that is not bound there is declared where it is needed: right after the name for
+ * the element's, right before the attribute for an attribute's.
+ */
+export declare function serializeStartTag(params: {
+    element: XmlElement;
+    scope: NamespaceScope;
+    prefixes: GeneratedPrefixes;
+}): {
+    text: string;
+    scope: NamespaceScope;
+    /** The prefixes declared here for an attribute only (not by the element's own declarations or name) */
+    generated: ReadonlySet<string>;
+};
+/**
+ * A text value of the compact layout: as `XMLSerializer` writes it, and a carriage return as `&#13;`, so a reader
+ * of the file gets the value back (XML reads a raw carriage return as a line feed).
+ */
+export declare function escapeCompactTextValue(value: string): string;
+/** A text value as `XMLSerializer` writes it. */
+export declare function escapeTextValue(value: string): string;
+/** The name as written: `prefix:localName`, or the local name alone. */
+export declare function qualifiedNameOf(node: {
+    prefix: string | null;
+    localName: string;
+}): string;
+//# sourceMappingURL=xml-element.d.ts.map

package/dist/xml/build/xml-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-element.d.ts","sourceRoot":"","sources":["../../../src/xml/build/xml-element.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACX,iBAAiB,EACjB,cAAc,EAEd,UAAU,EACV,MAAM,qBAAqB,CAAA;AAI5B,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACxC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAA;CAC9B,GAAG,UAAU,CAOb;AAED,wHAAwH;AACxH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACpC,OAAO,EAAE,UAAU,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACb,GAAG,IAAI,CAUP;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACtC,OAAO,EAAE,UAAU,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACb,GAAG,IAAI,CASP;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAG5F;AAED,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACtC,OAAO,EAAE,UAAU,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CACjB,GAAG,MAAM,GAAG,IAAI,CAEhB;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACtC,OAAO,EAAE,UAAU,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CACjB,GAAG,OAAO,CAEV;AAID,oIAAoI;AACpI,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAC1C,OAAO,EAAE,UAAU,CAAA;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,GAAG,MAAM,GAAG,IAAI,CAUhB;AAED,mHAAmH;AACnH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAcjG;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACzC,OAAO,EAAE,UAAU,CAAA;IACnB,KAAK,EAAE,cAAc,CAAA;IACrB,QAAQ,EAAE,iBAAiB,CAAA;CAC3B,GAAG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,cAAc,CAAA;IACrB,uGAAuG;IACvG,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC9B,CAsDA;AA8DD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAcD,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE1F"}

package/dist/xml/build/xml-element.types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * An attribute as a DOM element holds it: its namespace, the prefix it was set with, its local name (the whole name
+ * for an attribute set without a namespace) and its value.
+ */
+export type XmlAttribute = {
+    namespaceURI: string | null;
+    prefix: string | null;
+    localName: string;
+    value: string;
+};
+/**
+ * An element as the writer models it: what the DOM builder set on it, in the order it set it, and its parent. The
+ * namespace lookups and the serializer read it the way a DOM element is read; no DOM is needed.
+ */
+export type XmlElement = {
+    namespaceURI: string | null;
+    prefix: string | null;
+    localName: string;
+    attributes: XmlAttribute[];
+    parent: XmlElement | undefined;
+};
+/**
+ * The prefixes bound where an element stands (`''` = the default namespace): the bindings an element added, then its
+ * ancestors' scope. An element that binds nothing shares its parent's scope.
+ */
+export type NamespaceScope = {
+    readonly bindings: ReadonlyMap<string, string>;
+    readonly parent: NamespaceScope | undefined;
+};
+/** The number of the next prefix the serializer generates (`ns<k>`) for an attribute whose prefix is taken. */
+export type GeneratedPrefixes = {
+    next: number;
+};
+//# sourceMappingURL=xml-element.types.d.ts.map

package/dist/xml/build/xml-element.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-element.types.d.ts","sourceRoot":"","sources":["../../../src/xml/build/xml-element.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,MAAM,EAAE,UAAU,GAAG,SAAS,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9C,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAA;CAC3C,CAAA;AAED,+GAA+G;AAC/G,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/dist/xml/build/xml-writer.constants.d.ts

@@ -0,0 +1,24 @@
+import { NamespaceScope } from './xml-element.types';
+/** The XML declaration every written document starts with, unless asked without one. */
+export declare const XML_DECLARATION = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>";
+/** The namespace of the `xml:` prefix, bound everywhere without a declaration. */
+export declare const XML_NAMESPACE_URI = "http://www.w3.org/XML/1998/namespace";
+/** The line break of the formatted layout. */
+export declare const LINE_SEPARATOR = "\r\n";
+/** One level of indentation of the formatted layout. */
+export declare const INDENTATION = "    ";
+/** The characters `XMLSerializer` escapes in an attribute value, and in a text value. */
+export declare const ATTRIBUTE_ESCAPED: RegExp;
+export declare const ATTRIBUTE_ESCAPED_ALL: RegExp;
+export declare const TEXT_ESCAPED: RegExp;
+export declare const TEXT_ESCAPED_ALL: RegExp;
+/** In the compact layout a text value's carriage return is escaped too. */
+export declare const COMPACT_TEXT_ESCAPED: RegExp;
+export declare const COMPACT_TEXT_ESCAPED_ALL: RegExp;
+/** The reference each escaped character is written as. */
+export declare const ESCAPES: Record<string, string>;
+/** Where the written root stands: nothing bound. */
+export declare const EMPTY_SCOPE: NamespaceScope;
+/** No prefix: what an element that generates none answers, shared. */
+export declare const NO_PREFIXES: ReadonlySet<string>;
+//# sourceMappingURL=xml-writer.constants.d.ts.map

package/dist/xml/build/xml-writer.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-writer.constants.d.ts","sourceRoot":"","sources":["../../../src/xml/build/xml-writer.constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,wFAAwF;AACxF,eAAO,MAAM,eAAe,+CAA2C,CAAA;AAEvE,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,yCAAyC,CAAA;AAEvE,8CAA8C;AAC9C,eAAO,MAAM,cAAc,SAAS,CAAA;AAEpC,wDAAwD;AACxD,eAAO,MAAM,WAAW,SAAS,CAAA;AAEjC,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,QAAiB,CAAA;AAC/C,eAAO,MAAM,qBAAqB,QAAkB,CAAA;AACpD,eAAO,MAAM,YAAY,QAAU,CAAA;AACnC,eAAO,MAAM,gBAAgB,QAAW,CAAA;AACxC,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,QAAY,CAAA;AAC7C,eAAO,MAAM,wBAAwB,QAAa,CAAA;AAElD,0DAA0D;AAC1D,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQ1C,CAAA;AAED,oDAAoD;AACpD,eAAO,MAAM,WAAW,EAAE,cAA2D,CAAA;AAErF,sEAAsE;AACtE,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,CAAa,CAAA"}

package/dist/xml/build/xml-writer.d.ts

@@ -0,0 +1,40 @@
+import { XmlWriterParams } from './xml-writer.types';
+import { AnyRawRecord } from '../../types';
+/**
+ * Write records as XML text, element by element in document order, with no DOM, as `XMLSerializer` writes the same
+ * elements: formatted (4 spaces, CRLF, a text value on its element's line) or compact. The root start tag is only
+ * complete once every element is written (the namespaces the document needs are declared on it as they are met), so
+ * the writer hands the body as it goes (`take`) and the head (declaration and root start tag) at the end (`head`).
+ */
+export declare class XmlWriter {
+    private readonly context;
+    private readonly indent;
+    private readonly includeXmlDeclaration;
+    private readonly openElements;
+    private body;
+    private root;
+    /** The root's bindings as they stand: its declarations grow while its descendants are written. */
+    private readonly rootBindings;
+    private readonly rootScope;
+    private rootAttributeCount;
+    /** The prefixes generated for the elements below the root, numbered across the document */
+    private readonly prefixes;
+    /** A line break and the indentation of each level, made once */
+    private readonly newLines;
+    constructor(params: XmlWriterParams);
+    /** Open the element of the next record in document order (the first is the written root). */
+    openElement(params: {
+        record: AnyRawRecord;
+    }): void;
+    /** Close the element opened last. */
+    closeElement(): void;
+    /** The body written since the last call: what follows the root start tag. */
+    take(): string;
+    /** The XML declaration and the root start tag, complete once the root is closed. */
+    head(): string;
+    /** Bring the root's bindings up to date: the root gains declarations while its descendants are written. */
+    private refreshRootScope;
+    private writeText;
+    private newLine;
+}
+//# sourceMappingURL=xml-writer.d.ts.map

package/dist/xml/build/xml-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-writer.d.ts","sourceRoot":"","sources":["../../../src/xml/build/xml-writer.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C;;;;;GAKG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,IAAI,CAAyB;IACrC,kGAAkG;IAClG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqE;IAC/F,OAAO,CAAC,kBAAkB,CAAK;IAC/B,2FAA2F;IAC3F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;gBAE5B,MAAM,EAAE,eAAe;IAanC,6FAA6F;IAC7F,WAAW,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI;IAsCnD,qCAAqC;IACrC,YAAY,IAAI,IAAI;IAOpB,6EAA6E;IAC7E,IAAI,IAAI,MAAM;IAMd,oFAAoF;IACpF,IAAI,IAAI,MAAM;IAcd,2GAA2G;IAC3G,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,OAAO;CAMf"}

package/dist/xml/build/xml-writer.types.d.ts

@@ -0,0 +1,34 @@
+import { NamespaceScope, XmlElement } from './xml-element.types';
+import { AnyDialecteConfig, AnyRawRecord } from '../../types';
+export type XmlWriterParams = {
+    config: AnyDialecteConfig;
+    /**
+     * The document's root record, when the record written first is the document root; absent for a fragment, which
+     * gets no root attributes.
+     */
+    documentRoot?: AnyRawRecord;
+    /** Formatted (4 spaces, CRLF, a text value on its element's line); `false` = compact. Default `true`. */
+    indent?: boolean;
+    /** Declare namespaces (`xmlns`, `xmlns:*`); `false` writes prefixed names literally, a bare fragment. Default `true`. */
+    declareNamespaces?: boolean;
+    /** Start with the XML declaration. Default `true`. */
+    includeXmlDeclaration?: boolean;
+    /** The record id as `_temp-idb-id` on every element. Default `false`. */
+    withDatabaseIds?: boolean;
+};
+/** An element the writer has opened and not yet closed. */
+export type OpenElement = {
+    element: XmlElement;
+    qualifiedName: string;
+    /** Its depth: the root is at 0. */
+    level: number;
+    /** The scope its children stand in. */
+    scope: NamespaceScope;
+    /** Written with neither text nor children: `/>`. */
+    empty: boolean;
+    /** Its content is written inline, as the formatter keeps it: no line breaks or indentation below it. */
+    inline: boolean;
+    /** It stands inside an inline element. */
+    insideInline: boolean;
+};
+//# sourceMappingURL=xml-writer.types.d.ts.map

package/dist/xml/build/xml-writer.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-writer.types.d.ts","sourceRoot":"","sources":["../../../src/xml/build/xml-writer.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE9D,MAAM,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,iBAAiB,CAAA;IACzB;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,yGAAyG;IACzG,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,yHAAyH;IACzH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,sDAAsD;IACtD,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,yEAAyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAED,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,UAAU,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,KAAK,EAAE,cAAc,CAAA;IACrB,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAA;IACd,wGAAwG;IACxG,MAAM,EAAE,OAAO,CAAA;IACf,0CAA0C;IAC1C,YAAY,EAAE,OAAO,CAAA;CACrB,CAAA"}

package/dist/xml/dom/index.d.ts

@@ -0,0 +1,3 @@
+export { parseXmlDocument } from './xml-document-from-file';
+export type { ParseXmlDocumentParams } from './xml-document-from-file.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/xml/dom/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/xml/dom/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/xml/dom/xml-document-from-file.d.ts

@@ -0,0 +1,10 @@
+import { ParseXmlDocumentParams } from './xml-document-from-file.types';
+/**
+ * The DOM of an XML file, in the page (a worker or Node has no `DOMParser`). Parse the compact export
+ * (`indent: false`) to get the document the stored records make, with no whitespace-only text node.
+ * A file that is not well-formed throws `PARSE_ERROR`, with what the parser said.
+ *
+ * @intent get the DOM of an exported XML file, read an export as an XMLDocument in the page, query an export with XPath
+ */
+export declare function parseXmlDocument(params: ParseXmlDocumentParams): Promise<XMLDocument>;
+//# sourceMappingURL=xml-document-from-file.d.ts.map

package/dist/xml/dom/xml-document-from-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-document-from-file.d.ts","sourceRoot":"","sources":["../../../src/xml/dom/xml-document-from-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAE5E;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CAW3F"}

package/dist/xml/dom/xml-document-from-file.types.d.ts

@@ -0,0 +1,5 @@
+export type ParseXmlDocumentParams = {
+    /** An XML file: the compact export (`indent: false`) gives the DOM the stored records make */
+    file: Blob;
+};
+//# sourceMappingURL=xml-document-from-file.types.d.ts.map

package/dist/xml/dom/xml-document-from-file.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-document-from-file.types.d.ts","sourceRoot":"","sources":["../../../src/xml/dom/xml-document-from-file.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG;IACpC,8FAA8F;IAC9F,IAAI,EAAE,IAAI,CAAA;CACV,CAAA"}

package/dist/xml/index.d.ts

@@ -1,4 +1,5 @@
 export * from './build';
+export * from './dom';
 export * from './inspect-xml';
 export * from './parse';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/xml/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/xml/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AACrB,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA"}

package/dist/xml/inspect-xml.d.ts

@@ -31,6 +31,8 @@ export type InspectionReport<GenericConfig extends AnyDialecteConfig, T extends
  *
  * Streams the input via SAX and stops as soon as all elements are found.
  * Case-sensitive: `'project'` and `'Project'` are distinct entries.
+ *
+ * @intent peek at an XML file before importing it, read the root element or a version attribute without a full parse, detect which config a file needs
  */
 export declare function inspectXml<const GenericConfig extends AnyDialecteConfig = AnyDialecteConfig, const GenericElements extends readonly ElementsOf<GenericConfig>[] = readonly ElementsOf<GenericConfig>[]>(xml: string, params: {
     config?: GenericConfig;

package/dist/xml/inspect-xml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspect-xml.d.ts","sourceRoot":"","sources":["../../src/xml/inspect-xml.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEjG;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,gBAAgB,CAC3B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,IAC7C;IACH,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC,uBAAuB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAA;IAC3E,iEAAiE;IACjE,QAAQ,EAAE,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAA;IACrD,KAAK,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,gBAAgB,CAC3B,aAAa,SAAS,iBAAiB,EACvC,CAAC,SAAS,SAAS,UAAU,CAAC,aAAa,CAAC,EAAE,IAC3C;KACF,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,SAAS;CAChE,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACzB,KAAK,CAAC,aAAa,SAAS,iBAAiB,GAAG,iBAAiB,EACjE,KAAK,CAAC,eAAe,SAAS,SAAS,UAAU,CAAC,aAAa,CAAC,EAAE,GACjE,SAAS,UAAU,CAAC,aAAa,CAAC,EAAE,EAErC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GAC3D,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,aAAa,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAsEtF"}
+{"version":3,"file":"inspect-xml.d.ts","sourceRoot":"","sources":["../../src/xml/inspect-xml.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEjG;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,gBAAgB,CAC3B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,IAC7C;IACH,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC,uBAAuB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAA;IAC3E,iEAAiE;IACjE,QAAQ,EAAE,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAA;IACrD,KAAK,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,gBAAgB,CAC3B,aAAa,SAAS,iBAAiB,EACvC,CAAC,SAAS,SAAS,UAAU,CAAC,aAAa,CAAC,EAAE,IAC3C;KACF,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,SAAS;CAChE,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACzB,KAAK,CAAC,aAAa,SAAS,iBAAiB,GAAG,iBAAiB,EACjE,KAAK,CAAC,eAAe,SAAS,SAAS,UAAU,CAAC,aAAa,CAAC,EAAE,GACjE,SAAS,UAAU,CAAC,aAAa,CAAC,EAAE,EAErC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GAC3D,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,aAAa,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAsEtF"}

package/dist/xml/parse/index.d.ts

@@ -1,5 +1,5 @@
 export { parseXmlFile } from './parse-xml-document';
 export { ParseSession } from './parse-session';
-export type { ParseXmlFileParams, ParseXmlFileResult } from './parse-xml-document.types';
+export type { ParseTarget, ParseXmlFileParams, ParseXmlFileResult, } from './parse-xml-document.types';
 export type * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/xml/parse/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/xml/parse/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACxF,mBAAmB,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/xml/parse/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EACX,WAAW,EACX,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,4BAA4B,CAAA;AACnC,mBAAmB,SAAS,CAAA"}

package/dist/xml/parse/parse-xml-document.constants.d.ts

@@ -0,0 +1,5 @@
+/** Bytes read from the file per chunk (32 KiB). */
+export declare const DEFAULT_CHUNK_SIZE: number;
+/** Records handed to the store per batch. */
+export declare const DEFAULT_BATCH_SIZE = 2000;
+//# sourceMappingURL=parse-xml-document.constants.d.ts.map

package/dist/xml/parse/parse-xml-document.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-xml-document.constants.d.ts","sourceRoot":"","sources":["../../../src/xml/parse/parse-xml-document.constants.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,QAAY,CAAA;AAE3C,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,OAAO,CAAA"}

package/dist/xml/parse/parse-xml-document.d.ts

@@ -1,4 +1,5 @@
 import { ParseXmlFileParams, ParseXmlFileResult } from './parse-xml-document.types';
+import { ImportControl } from '../../store/store.types';
 export type { ParseXmlFileParams, ParseXmlFileResult } from './parse-xml-document.types';
 /**
  * Parse a single XML file and persist records into a Store via chunked streaming.
@@ -6,7 +7,17 @@ export type { ParseXmlFileParams, ParseXmlFileResult } from './parse-xml-documen
  * - Uses SAX streaming to avoid loading full XML into memory
  * - Batches records and flushes to Store.bulkWrite in chunks
  * - ParseSession encapsulates parent-child resolution state (no module globals)
- * - Database-agnostic: only calls Store.bulkWrite(documentId, ops)
+ * - Database-agnostic: only calls its target's bulkWrite (the file's records) and writeSession (the session's)
+ * - `control`: progress told after each stored batch (never awaited), an abort honoured before each
+ *   batch and before the session's writes (`IMPORT_ABORTED`; the records already stored are the
+ *   caller's to remove)
+ *
+ * @internal the streaming parser `runImport` drives; callers import through the project
  */
-export declare function parseXmlFile(params: ParseXmlFileParams): Promise<ParseXmlFileResult>;
+export declare function parseXmlFile(params: ParseXmlFileParams, control?: ImportControl): Promise<ParseXmlFileResult>;
+/** An aborted import goes no further: `IMPORT_ABORTED`. */
+export declare function throwIfAborted(params: {
+    signal?: AbortSignal;
+    file: File;
+}): void;
 //# sourceMappingURL=parse-xml-document.d.ts.map

package/dist/xml/parse/parse-xml-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-xml-document.d.ts","sourceRoot":"","sources":["../../../src/xml/parse/parse-xml-document.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAKxF,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AASxF;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoD1F"}
+{"version":3,"file":"parse-xml-document.d.ts","sourceRoot":"","sources":["../../../src/xml/parse/parse-xml-document.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAEX,kBAAkB,EAClB,kBAAkB,EAClB,MAAM,4BAA4B,CAAA;AAGnC,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,qBAAqB,CAAA;AAGxE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAIxF;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,aAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAoE7B;AA8ID,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,CAOjF"}

package/dist/xml/parse/parse-xml-document.types.d.ts

@@ -1,10 +1,18 @@
+import { Diagnostic } from '../../diagnostics';
 import { Perf } from '../../perf';
-import { Store } from '../../store/store.types';
+import { ImportTarget } from '../../store/store.types';
 import { AnyDialecteConfig, ChunkOptions, DialecteHooks } from '../../types';
+/**
+ * What the parse writes through: the file's records, then its session's writes; registering the document and marking
+ * it ready are its caller's.
+ */
+export type ParseTarget = Pick<ImportTarget, 'bulkWrite' | 'writeSession'>;
 export type ParseXmlFileParams = {
     file: File;
     documentId: string;
-    store: Store;
+    /** The key the config is registered under; given to the import session */
+    configKey: string;
+    store: ParseTarget;
     config: AnyDialecteConfig;
     /** Use custom record IDs from XML attributes (testing) */
     useCustomRecordsIds?: boolean;
@@ -18,5 +26,7 @@ export type ParseXmlFileParams = {
 export type ParseXmlFileResult = {
     documentId: string;
     recordCount: number;
+    /** What the import session had to say; `[]` when nothing */
+    diagnostics: Diagnostic[];
 };
 //# sourceMappingURL=parse-xml-document.types.d.ts.map

package/dist/xml/parse/parse-xml-document.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-xml-document.types.d.ts","sourceRoot":"","sources":["../../../src/xml/parse/parse-xml-document.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE7E,MAAM,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,IAAI,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,iBAAiB,CAAA;IACzB,0DAA0D;IAC1D,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,iCAAiC;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;IACpC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAA;IACxC,sEAAsE;IACtE,IAAI,CAAC,EAAE,IAAI,CAAA;CACX,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACnB,CAAA"}
+{"version":3,"file":"parse-xml-document.types.d.ts","sourceRoot":"","sources":["../../../src/xml/parse/parse-xml-document.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE7E;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,cAAc,CAAC,CAAA;AAE1E,MAAM,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,IAAI,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,WAAW,CAAA;IAClB,MAAM,EAAE,iBAAiB,CAAA;IACzB,0DAA0D;IAC1D,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,iCAAiC;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;IACpC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAA;IACxC,sEAAsE;IACtE,IAAI,CAAC,EAAE,IAAI,CAAA;CACX,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,4DAA4D;IAC5D,WAAW,EAAE,UAAU,EAAE,CAAA;CACzB,CAAA"}

package/dist/xml/parse/parser.constants.d.ts

@@ -0,0 +1,7 @@
+import type * as sax from 'sax';
+/**
+ * The options core's XML reader builds sax with. sax's own trim and normalize are off: they use JavaScript's
+ * whitespace (a no-break space, a byte order mark...), core trims and collapses each run of text with XML's.
+ */
+export declare const SAX_PARSER_OPTIONS: sax.SAXOptions;
+//# sourceMappingURL=parser.constants.d.ts.map

package/dist/xml/parse/parser.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.constants.d.ts","sourceRoot":"","sources":["../../../src/xml/parse/parser.constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAA;AAE/B;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,GAAG,CAAC,UAMpC,CAAA"}

package/dist/xml/parse/parser.d.ts

@@ -1,7 +1,7 @@
 import { ParseSession } from './parse-session';
 import { ParserInstance } from './types';
 import { Perf } from '../../perf';
-import { AnyDialecteConfig, DialecteHooks } from '../../types';
+import { AnyDialecteConfig, ImportSession, TransactionHooks } from '../../types';
 /**
  * Sets up the SAX parser for XML parsing.
  * @param namespaces Namespace configuration from dialecte
@@ -12,7 +12,9 @@ export declare function setSaxParser(params: {
     dialecteConfig: AnyDialecteConfig;
     useCustomRecordsIds: boolean;
     session: ParseSession;
-    hooks?: DialecteHooks<AnyDialecteConfig>;
+    /** The record hooks standardization applies; the per-record io hook is the import session's */
+    hooks?: TransactionHooks<AnyDialecteConfig>;
+    importSession?: ImportSession;
     perf?: Perf;
 }): ParserInstance;
 //# sourceMappingURL=parser.d.ts.map

package/dist/xml/parse/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/xml/parse/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAS9C,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,SAAS,CAAA;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,KAAK,EAEX,iBAAiB,EAKjB,aAAa,EACb,MAAM,SAAS,CAAA;AAIhB;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACpC,cAAc,EAAE,iBAAiB,CAAA;IACjC,mBAAmB,EAAE,OAAO,CAAA;IAC5B,OAAO,EAAE,YAAY,CAAA;IACrB,KAAK,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAA;IACxC,IAAI,CAAC,EAAE,IAAI,CAAA;CACX,GAAG,cAAc,CA+DjB"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/xml/parse/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAc9C,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,SAAS,CAAA;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,KAAK,EAEX,iBAAiB,EAKjB,aAAa,EACb,gBAAgB,EAChB,MAAM,SAAS,CAAA;AAIhB;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACpC,cAAc,EAAE,iBAAiB,CAAA;IACjC,mBAAmB,EAAE,OAAO,CAAA;IAC5B,OAAO,EAAE,YAAY,CAAA;IACrB,+FAA+F;IAC/F,KAAK,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAA;IAC3C,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,IAAI,CAAC,EAAE,IAAI,CAAA;CACX,GAAG,cAAc,CA0DjB"}

package/dist/xml/parse/types.d.ts

@@ -9,5 +9,7 @@ export type ParserState = {
     defaultNamespace: Namespace | null;
     stack: AnyRawRecord[];
     recordsBatch: AnyRawRecord[];
+    /** The root element was opened: a second one at depth 0 is a parse error (sax lets it through) */
+    sawRoot: boolean;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/xml/parse/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/xml/parse/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAEpC,MAAM,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,SAAS,CAAA;IACjB,UAAU,EAAE,MAAM,YAAY,EAAE,CAAA;IAChC,OAAO,EAAE,MAAM,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACzB,gBAAgB,EAAE,SAAS,GAAG,IAAI,CAAA;IAClC,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,YAAY,EAAE,YAAY,EAAE,CAAA;CAC5B,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/xml/parse/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAEpC,MAAM,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,SAAS,CAAA;IACjB,UAAU,EAAE,MAAM,YAAY,EAAE,CAAA;IAChC,OAAO,EAAE,MAAM,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACzB,gBAAgB,EAAE,SAAS,GAAG,IAAI,CAAA;IAClC,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,YAAY,EAAE,YAAY,EAAE,CAAA;IAC5B,kGAAkG;IAClG,OAAO,EAAE,OAAO,CAAA;CAChB,CAAA"}