@dialecte/core 0.6.3 → 0.6.4

package/dist/document/query/get/attribute/get-attribute.d.ts

@@ -5,10 +5,10 @@ import { AttributeDefaults } from '../../../../utils';
  * Fetch a single attribute for the given ref or record.
  *
  * Resolves the record (a record given in full is read as it is, through the staged
- * operations; a ref via staged → cache → store, see `resolveRecord`), then extracts the named
- * attribute. Pass `namespace` to scope by a namespace key (a local `name` is resolved
- * to the stored `prefix:local` key). `defaults` (default `'optional'`) controls the
- * fallback for an absent attribute: `'none'` → `''`; `'optional'` → `fixed` /
+ * operations; a ref via staged → cache → store, see `resolveRecord`), then reads the named
+ * attribute with {@link readAttribute}. Pass `namespace` to scope by a namespace key (a local
+ * `name` is resolved to the stored `prefix:local` key). `defaults` (default `'optional'`)
+ * controls the fallback for an absent attribute: `'none'` → `''`; `'optional'` → `fixed` /
  * non-empty `default` (else `''`); `'required'` → required/fixed materialized value.
  *
  * @example
@@ -24,9 +24,9 @@ export declare function getAttribute<GenericConfig extends AnyDialecteConfig, Ge
 }): Promise<GenericAttribute['value'] | ''>;
 /**
  * Fetch a single attribute for the given ref or record as a full object (name + value +
- * namespace). `defaults` (default `'optional'`) fills an absent schema attribute by
- * synthesizing its object; `'none'` returns `undefined` when the attribute is not
- * stored.
+ * namespace), read with {@link readAttribute}. `defaults` (default `'optional'`) fills an
+ * absent schema attribute by synthesizing its object; `'none'` returns `undefined` when the
+ * attribute is not stored.
  *
  * @example
  * getAttribute({ context, ref, name: 'name', fullObject: true }) // → FullAttributeObject | undefined

package/dist/document/query/get/attribute/get-attribute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-attribute.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/attribute/get-attribute.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CACjC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,gBAAgB,SAAS,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAA;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC5B,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAmB1C;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC3C,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,gBAAgB,SAAS,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAA;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC5B,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAyBxC"}
+{"version":3,"file":"get-attribute.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/attribute/get-attribute.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CACjC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,gBAAgB,SAAS,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAA;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC5B,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAQ1C;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC3C,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,gBAAgB,SAAS,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAA;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC5B,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAQxC"}

package/dist/document/query/get/attribute/get-attributes.d.ts

@@ -3,7 +3,8 @@ import { AnyDialecteConfig, AttributesValueObjectOf, ElementsOf, FullAttributeOb
 import { AttributeDefaults } from '../../../../utils';
 /**
  * Fetch attributes for the given ref or record as a destructurable value object. A record given in full is read as it
- * is, through the staged operations, with no store round trip (see `resolveRecord`).
+ * is, through the staged operations, with no store round trip (see `resolveRecord`); the reading itself is
+ * {@link readAttributes}.
  *
  * Without `namespace`, every attribute under the name it is stored by (`aA`, `xsi:type`, `ext:cA`) - what a write takes
  * back. With a `namespace` key, only that namespace's attributes, with the prefix stripped from the keys
@@ -17,14 +18,15 @@ import { AttributeDefaults } from '../../../../utils';
  * getAttributes({ context, ref })                       // → { aA: '', bA: '', ... }
  * getAttributes({ context, ref, namespace: 'ext' })     // → { cA: '...' }
  */
-export declare function getAttributes<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericAttribute extends FullAttributeObjectOf<GenericConfig, GenericElement>>(params: {
+export declare function getAttributes<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, _GenericAttribute extends FullAttributeObjectOf<GenericConfig, GenericElement>>(params: {
     context: Context<GenericConfig>;
     ref: RefOrRecord<GenericConfig, GenericElement> | undefined;
     namespace?: string;
     defaults?: AttributeDefaults;
 }): Promise<AttributesValueObjectOf<GenericConfig, GenericElement>>;
 /**
- * Fetch all attributes of the given ref or record as a full array (name + value + namespace).
+ * Fetch all attributes of the given ref or record as a full array (name + value + namespace), read with
+ * {@link readAttributes}.
  *
  * `defaults` (default `'optional'`) fills absent schema attributes just like
  * {@link getAttributes}: `'none'` returns the faithful stored-only set;

package/dist/document/query/get/attribute/get-attributes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-attributes.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/attribute/get-attributes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EACX,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,qBAAqB,EAErB,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD;;;;;;;;;;;;;;;GAeG;AAEH,wBAAsB,aAAa,CAClC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,gBAAgB,SAAS,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAA;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC5B,GAAG,OAAO,CAAC,uBAAuB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAqClE;AAmBD;;;;;;;;;;GAUG;AAEH,wBAAsB,uBAAuB,CAC5C,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,gBAAgB,SAAS,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAA;IAC3D,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC5B,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA6B9B"}
+{"version":3,"file":"get-attributes.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/attribute/get-attributes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EACX,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,qBAAqB,EACrB,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD;;;;;;;;;;;;;;;;GAgBG;AAEH,wBAAsB,aAAa,CAClC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,iBAAiB,SAAS,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC7E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAA;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC5B,GAAG,OAAO,CAAC,uBAAuB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CASlE;AAED;;;;;;;;;;;GAWG;AAEH,wBAAsB,uBAAuB,CAC5C,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,gBAAgB,SAAS,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAA;IAC3D,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC5B,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAW9B"}

package/dist/helpers/index.d.ts

@@ -6,4 +6,6 @@ export * from './assert-fixed';
 export * from './assert-xsi-type';
 export * from './merge-extensions';
 export * from './strip-attributes';
+export * from './read-attributes';
+export type * from './read-attributes.types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,mBAAmB,yBAAyB,CAAA"}

package/dist/helpers/read-attributes.d.ts

@@ -0,0 +1,56 @@
+import { ReadAttributesBaseParams } from './read-attributes.types';
+import { AnyAttribute } from '../types';
+/**
+ * Read one attribute of a record you hold, the way `query.getAttribute` reads it - same `namespace` scope, same
+ * `defaults` fill, same `''` for an absent attribute - with no query: synchronous, for an import pass or a pure
+ * composer. `query.getAttribute` itself delegates to it once it has the record.
+ *
+ * `fullObject: true` returns the attribute object, or `undefined` when there is none in that view: with
+ * `defaults: 'none'`, how to tell an absent attribute from one written empty.
+ *
+ * Reads the record as you hold it. Inside a transaction use `tx.getAttribute`, which sees the transaction's staged
+ * writes: a record held from before a write still reads its old values here.
+ *
+ * @example
+ * readAttribute({ record, dialecteConfig, name: 'aA' })                                      // → 'v' | ''
+ * readAttribute({ record, dialecteConfig, name: 'aA', defaults: 'none', fullObject: true }) // → undefined when absent
+ *
+ * @see {@link readAttributes}
+ */
+export declare function readAttribute(params: ReadAttributesBaseParams & {
+    name: string;
+    namespace?: string;
+    fullObject?: false;
+}): string;
+export declare function readAttribute(params: ReadAttributesBaseParams & {
+    name: string;
+    namespace?: string;
+    fullObject: true;
+}): AnyAttribute | undefined;
+/**
+ * Read the attributes of a record you hold, the way `query.getAttributes` reads them - each under the name it is
+ * stored by, or keyed by local name in a `namespace` scope, absent schema attributes filled per `defaults` - with no
+ * query: synchronous, for an import pass or a pure composer. `query.getAttributes`
+ * itself delegates to it once it has the record. Values are plain strings: for typed reads use the query.
+ *
+ * Namespace declarations are left out of the value object; `fullObject: true` returns the stored attributes as they
+ * are, a declaration a document carries included (stored by its prefix, in the xmlns namespace).
+ *
+ * Reads the record as you hold it. Inside a transaction use `tx.getAttributes`, which sees the transaction's staged
+ * writes: a record held from before a write still reads its old values here.
+ *
+ * @example
+ * readAttributes({ record, dialecteConfig })                        // → { aA: 'v', 'ext:cA': 'w' }
+ * readAttributes({ record, dialecteConfig, defaults: 'none' })      // → stored only
+ * readAttributes({ record, dialecteConfig, fullObject: true })      // → AnyAttribute[]
+ *
+ * @see {@link readAttribute}
+ */
+export declare function readAttributes(params: ReadAttributesBaseParams & {
+    namespace?: string;
+    fullObject?: false;
+}): Record<string, string>;
+export declare function readAttributes(params: ReadAttributesBaseParams & {
+    fullObject: true;
+}): AnyAttribute[];
+//# sourceMappingURL=read-attributes.d.ts.map

package/dist/helpers/read-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-attributes.d.ts","sourceRoot":"","sources":["../../src/helpers/read-attributes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AACvE,OAAO,KAAK,EAAE,YAAY,EAA8C,MAAM,SAAS,CAAA;AAGvF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,wBAAwB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,GACzF,MAAM,CAAA;AACT,wBAAgB,aAAa,CAC5B,MAAM,EAAE,wBAAwB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,IAAI,CAAA;CAAE,GACvF,YAAY,GAAG,SAAS,CAAA;AAyC3B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,wBAAwB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,GAC3E,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AACzB,wBAAgB,cAAc,CAC7B,MAAM,EAAE,wBAAwB,GAAG;IAAE,UAAU,EAAE,IAAI,CAAA;CAAE,GACrD,YAAY,EAAE,CAAA"}

package/dist/helpers/read-attributes.types.d.ts

@@ -0,0 +1,10 @@
+import { AnyDialecteConfig, AnyRawRecord } from '../types';
+import { AttributeDefaults } from '../utils';
+/** What every attribute read takes: the record as held (raw, tracked or tree), the config its schema values come from. */
+export type ReadAttributesBaseParams = {
+    record: AnyRawRecord;
+    dialecteConfig: AnyDialecteConfig;
+    /** How an absent schema attribute is filled - as in `query.getAttribute(s)`. Default `'optional'`. */
+    defaults?: AttributeDefaults;
+};
+//# sourceMappingURL=read-attributes.types.d.ts.map

package/dist/helpers/read-attributes.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-attributes.types.d.ts","sourceRoot":"","sources":["../../src/helpers/read-attributes.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,0HAA0H;AAC1H,MAAM,MAAM,wBAAwB,GAAG;IACtC,MAAM,EAAE,YAAY,CAAA;IACpB,cAAc,EAAE,iBAAiB,CAAA;IACjC,sGAAsG;IACtG,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC5B,CAAA"}

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-CTBHUFs9.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.js

@@ -1,3 +1,3 @@
-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 { $ 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-DGQAe9G9.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 };