@dialecte/core 0.7.0 → 0.8.0

package/dist/document/query/main.d.ts

@@ -42,6 +42,8 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
     /**
      * Get the full metadata record of this document.
      *
+     * @intent read the document name or extension, get document metadata, find which config a document uses
+     *
      * @returns The document record: `id`, `name`, `extension`, `configKey`,
      *   `createdAt`, and optional `metadata`.
      *
@@ -54,6 +56,8 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
     /**
      * Get the root element of the document.
      *
+     * @intent get the root element, start a walk from the top of the document
+     *
      * @returns The root record.
      *
      * @example
@@ -63,7 +67,9 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
      */
     getRoot(): Promise<TrackedRecord<GenericConfig, RootElementOf<GenericConfig>>>;
     /**
-     * Get a single record by ref, record, or relationship.
+     * Get a single record by ref, record, or relationship, in one store read.
+     *
+     * @intent load one element by id, resolve a ref or parent/child relationship to its record, refresh a record
      *
      * @param refOrRecord - A ref `{ tagName, id }`, or any record/relationship.
      * @returns The tracked record, or `undefined` if not found.
@@ -78,6 +84,8 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
      * The definition of an element in its context: the declaration its parent holds when the schema
      * declares the tag several ways, and what the type it names with xsi:type lets it hold.
      *
+     * @intent read the schema definition of an element, list allowed attributes or enumeration values, know what an xsi:type lets an element hold
+     *
      * @param refOrRecord - The element to describe; its record is fetched, so its parent is known.
      * @returns The `ResolvedDefinition`, or `undefined` when nothing is found.
      *
@@ -91,6 +99,8 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
     /**
      * Get multiple records in a single call.
      *
+     * @intent load several elements by ref at once, resolve a list of children or relationships in one batched read
+     *
      * @param refsOrRecords - Array of refs, records, or relationships.
      * @returns Array of tracked records (same order, `undefined` for missing).
      *
@@ -101,7 +111,9 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
      */
     getRecords<GenericElement extends ElementsOf<GenericConfig>>(refsOrRecords: (RefOrRecord<GenericConfig, GenericElement> | undefined)[]): Promise<(TrackedRecord<GenericConfig, GenericElement> | undefined)[]>;
     /**
-     * Get the first direct child of an element matching a given tag name.
+     * Get the first direct child of an element matching a given tag name; it looks one level down only.
+     *
+     * @intent get one direct child by tag name, check whether a child exists
      *
      * @param refOrRecord - The parent element.
      * @param tagName - The child element type to look for.
@@ -114,7 +126,9 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
      */
     getChild<GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, tagName: GenericChildElement): Promise<TrackedRecord<GenericConfig, GenericChildElement> | undefined>;
     /**
-     * Get all direct children of an element matching a given tag name.
+     * Get all direct children of an element matching a given tag name; it looks one level down only, no recursion.
+     *
+     * @intent list direct children of one tag name, iterate one level below an element
      *
      * @param refOrRecord - The parent element.
      * @param tagName - The child element type to look for.
@@ -127,7 +141,10 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
      */
     getChildren<GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, tagName: GenericChildElement): Promise<TrackedRecord<GenericConfig, GenericChildElement>[]>;
     /**
-     * Get all records of a given tag name.
+     * Get all records of a given tag name in the whole document, read from the tag index: the cheapest
+     * whole-document scan.
+     *
+     * @intent list every element of a tag in the whole document, scan all elements of one type regardless of position
      *
      * @param tagName - The element type to retrieve.
      * @returns All tracked records matching that tag name.
@@ -139,11 +156,11 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
      */
     getRecordsByTagName<GenericElement extends ElementsOf<GenericConfig>>(tagName: GenericElement): Promise<TrackedRecord<GenericConfig, GenericElement>[]>;
     /**
-     * Find all descendants of an element, grouped by tag name.
+     * Find all descendants of an element, grouped by tag name, in no guaranteed order: walk a `getTree`
+     * result for document order.
      *
-     * The groups are keyed by tag name; the records of a group come in no guaranteed order (the
-     * store's own; it is not guaranteed to be document order) - walk a `getTree` result for
-     * document order.
+     * The groups are keyed by tag name; the records of a group come in the store's own order, which is
+     * not document order.
      *
      * Reads: a flat collect reads each tag name's candidates from the store's tag index and
      * climbs their parent chains, each ancestor read once per call; the path form reads level
@@ -152,6 +169,8 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
      * memory - a large collect costs one `getByDocumentId`, never one read per ancestor step. A
      * flat collect under the document root with no `omit` climbs nothing.
      *
+     * @intent collect descendants of given tag names under an element, find nested elements at any depth below a scope
+     *
      * @param refOrRecord - The ancestor element.
      * @param options - Collect spec and optional omit list. When omitted, collects all descendant tag names.
      * @returns Object keyed by tag name, each value an array of tracked records.
@@ -167,7 +186,10 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
     findDescendants<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined): Promise<Partial<Record<DescendantsOf<GenericConfig, GenericElement>, TrackedRecord<GenericConfig, DescendantsOf<GenericConfig, GenericElement>>[]>>>;
     findDescendants<GenericElement extends ElementsOf<GenericConfig>, GenericCollect extends Collect<GenericConfig, GenericElement>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, options: FindDescendantsParams<GenericConfig, GenericElement, GenericCollect>): Promise<FindDescendantsReturn<GenericConfig, GenericElement, GenericCollect>>;
     /**
-     * Walk the parent chain from an element upward.
+     * Walk the parent chain from an element upward, one store read per step; for the parent alone,
+     * `getRecord(record.parent)` is enough.
+     *
+     * @intent list the ancestors of an element, find the enclosing element of a tag, build a path from the root
      *
      * @param refOrRecord - The starting element (not included in results).
      * @param options - Optional depth limit or stop-at tag name.
@@ -181,7 +203,10 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
      */
     findAncestors<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, options?: FindAncestorsOptions<GenericConfig>): Promise<TrackedRecord<GenericConfig, ElementsOf<GenericConfig>>[]>;
     /**
-     * Build a full tree structure from an element down.
+     * Build a full tree structure from an element down. It loads the whole document unless it is a
+     * committed read with an id and a depth.
+     *
+     * @intent read a subtree in document order, walk children recursively, project a filtered tree with select or omit, read a subtree to copy it with deepClone
      *
      * @param refOrRecord - The root of the subtree.
      * @param options - Optional depth/filter controls.
@@ -194,12 +219,15 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
      */
     getTree<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, options?: GetTreeParams<GenericConfig, GenericElement>): Promise<TreeRecord<GenericConfig, GenericElement> | undefined>;
     /**
-     * Snapshot the (uncommitted) document state as a tree, XML string, or both.
+     * Snapshot the (uncommitted) document state as a tree, XML string, or both: a view that includes
+     * staged changes. The stored file, to save or download, comes from `project.export`.
      *
      * Reads overlay staged operations, so calling this on a live transaction or a
      * prepared transaction's `query` reflects exactly what `commit()` would write.
      * Scope is controlled by `ref`/`ancestors`/`siblings`/`depth`; output by `as`.
      *
+     * @intent preview what a transaction would commit, read staged changes as XML or as a tree, show what a prepared transaction would produce
+     *
      * @example
      * ```ts
      * const prepared = await doc.prepare(async (tx) => tx.addChild(parent, payload))
@@ -216,7 +244,9 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
         as: 'both';
     }): Promise<SnapshotResult>;
     /**
-     * Get a single attribute value from a record.
+     * Read a single attribute value of an element (a ref, a record or a relationship).
+     *
+     * @intent read an attribute of an element, read one attribute value, read a namespaced attribute, read an attribute with its schema default
      *
      * @param refOrRecord - The element to read from.
      * @param params - Attribute `name` and an optional `namespace` scope. Without a
@@ -243,8 +273,10 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
         defaults?: AttributeDefaults;
     }): Promise<FullAttributeObjectOf<GenericConfig, GenericElement> | undefined>;
     /**
-     * Get a record's attributes as a destructurable value object, each under the name it is stored by - what a write
-     * takes back.
+     * Read an element's attributes as a destructurable value object, each under the name it is stored by - what a
+     * write takes back.
+     *
+     * @intent read the attributes of an element, read all attribute values of an element, destructure several attributes at once, read attributes of one namespace
      *
      * @param refOrRecord - The element to read from.
      * @returns A `{ aA, bA, 'ext:cA', 'xsi:type', ... }` object: unprefixed in the default namespace, prefixed otherwise.
@@ -301,7 +333,10 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
         defaults?: AttributeDefaults;
     }): Promise<FullAttributeObjectOf<GenericConfig, GenericElement>[]>;
     /**
-     * Find records matching specific attribute values.
+     * Find records of one tag matching specific attribute values; it scans every element of that tag in
+     * the document.
+     *
+     * @intent find elements by attribute value, look up an element by an identifying attribute, filter one tag's elements by attribute
      *
      * @param params - Tag name and attribute filter criteria.
      * @returns All matching tracked records.

package/dist/document/query/main.d.ts.map

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

package/dist/document/query/snapshot/collect-snapshot.d.ts

@@ -9,6 +9,8 @@ import { AnyDialecteConfig, ElementsOf } from '../../../types';
  * document (no `ref`, no `depth`) is collected via one bulk read + overlay; any
  * bounded scope (a `ref`, or a `depth` from the root) walks the tree (down
  * `depth`, up `ancestors`, optional `siblings`).
+ *
+ * @internal record collection step of `getSnapshot`
  */
 export declare function collectSnapshotRecords<GenericConfig extends AnyDialecteConfig>(params: {
     context: Context<GenericConfig>;

package/dist/document/query/snapshot/collect-snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collect-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/document/query/snapshot/collect-snapshot.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAoB,UAAU,EAAiB,MAAM,SAAS,CAAA;AAE7F;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAC7F,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,CAAC,EAAE,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,GAAG;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACzC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,OAAO,CAAA;CACxB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0G7B"}
+{"version":3,"file":"collect-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/document/query/snapshot/collect-snapshot.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAoB,UAAU,EAAiB,MAAM,SAAS,CAAA;AAE7F;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAC7F,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,CAAC,EAAE,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,GAAG;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACzC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,OAAO,CAAA;CACxB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0G7B"}

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

@@ -13,6 +13,8 @@ import { AnyDialecteConfig, AnyTreeRecord } from '../../../types';
  *
  * `omit`/`unwrap` shape the tree output only (shared with `getTree`); the XML
  * always reflects the full, unfiltered document — it is what `commit()` writes.
+ *
+ * @internal the context-level read behind `doc.query.getSnapshot`; callers use the query
  */
 export declare function getSnapshot<GenericConfig extends AnyDialecteConfig>(params: {
     context: Context<GenericConfig>;

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

@@ -1 +1 @@
-{"version":3,"file":"get-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/document/query/snapshot/get-snapshot.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAqB,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC7F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAc,MAAM,SAAS,CAAA;AAE3E;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAClF,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,OAAO,CAAC,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAA;CAC3C,GAAG,OAAO,CAAC,aAAa,GAAG,MAAM,GAAG,cAAc,CAAC,CA4BnD"}
+{"version":3,"file":"get-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/document/query/snapshot/get-snapshot.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAqB,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC7F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAc,MAAM,SAAS,CAAA;AAE3E;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAClF,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,OAAO,CAAC,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAA;CAC3C,GAAG,OAAO,CAAC,aAAa,GAAG,MAAM,GAAG,cAAc,CAAC,CA4BnD"}

package/dist/document/query/snapshot/records-to-tree.d.ts

@@ -9,6 +9,8 @@ import { AnyTreeRecord } from '../../../types';
  * tombstones (`status:'deleted'`) under their original parent, after the live
  * children — so the tree shows what a node looked like including pending
  * deletions. XML serialization never uses this path.
+ *
+ * @internal tree assembly step of `getSnapshot`
  */
 export declare function recordsToTree(snapshot: CollectedSnapshot): AnyTreeRecord;
 //# sourceMappingURL=records-to-tree.d.ts.map

package/dist/document/query/snapshot/records-to-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"records-to-tree.d.ts","sourceRoot":"","sources":["../../../../src/document/query/snapshot/records-to-tree.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,SAAS,CAAA;AAE9D;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,GAAG,aAAa,CAuCxE"}
+{"version":3,"file":"records-to-tree.d.ts","sourceRoot":"","sources":["../../../../src/document/query/snapshot/records-to-tree.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,SAAS,CAAA;AAE9D;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,GAAG,aAAa,CAuCxE"}

package/dist/document/query/tree-filter/omit.d.ts

@@ -23,6 +23,8 @@ export type OmitSpecification<GenericConfig extends AnyDialecteConfig> = {
  * Simple string entries go into `unconditional` (O(1) Set lookup).
  * Object entries with `where` conditions go into `conditional` (checked against record attributes).
  * This avoids re-parsing the omit array on every node visit.
+ *
+ * @internal `omit` parsing of `getTree` and `getSnapshot`
  */
 export declare function parseOmit<GenericConfig extends AnyDialecteConfig>(params: {
     omit: OmitEntry<GenericConfig>[] | undefined;
@@ -31,6 +33,8 @@ export declare function parseOmit<GenericConfig extends AnyDialecteConfig>(param
 /**
  * Whether a node itself should be dropped (`scope:'self'` omit, conditional or
  * unconditional).
+ *
+ * @internal `omit` check of the tree reads
  */
 export declare function isOmitted<GenericConfig extends AnyDialecteConfig>(params: {
     record: TrackedRecord<GenericConfig, ElementsOf<GenericConfig>>;
@@ -39,6 +43,8 @@ export declare function isOmitted<GenericConfig extends AnyDialecteConfig>(param
 /**
  * Whether traversal should stop below a node (`scope:'children'` omit) — the
  * node is kept but its descendants are dropped.
+ *
+ * @internal `omit` check of the tree reads
  */
 export declare function shouldStopTraversal<GenericConfig extends AnyDialecteConfig>(params: {
     record: TrackedRecord<GenericConfig, ElementsOf<GenericConfig>>;
@@ -50,6 +56,8 @@ export declare function shouldStopTraversal<GenericConfig extends AnyDialecteCon
  * The root is never dropped (it is the queried element); omit is applied to its
  * descendants, mirroring `getTree`'s fetch-time pruning so both features share
  * the same semantics.
+ *
+ * @internal `omit` post-pass of `getSnapshot`
  */
 export declare function applyOmit<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
     tree: TreeRecord<GenericConfig, GenericElement>;

package/dist/document/query/tree-filter/omit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"omit.d.ts","sourceRoot":"","sources":["../../../../src/document/query/tree-filter/omit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvF;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,CAAC,aAAa,SAAS,iBAAiB,IAAI;IACxE,kGAAkG;IAClG,cAAc,EAAE,aAAa,CAAA;IAC7B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1B,WAAW,EAAE,KAAK,CAAC;QAClB,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,CAAA;QAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC9B,KAAK,EAAE,MAAM,GAAG,UAAU,CAAA;KAC1B,CAAC,CAAA;CACF,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAC1E,IAAI,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE,GAAG,SAAS,CAAA;IAC5C,cAAc,EAAE,aAAa,CAAA;CAC7B,GAAG,iBAAiB,CAAC,aAAa,CAAC,CA8BnC;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAC1E,MAAM,EAAE,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;IAC/D,YAAY,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAA;CAC9C,GAAG,OAAO,CAiBV;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IACpF,MAAM,EAAE,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;IAC/D,YAAY,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAA;CAC9C,GAAG,OAAO,CAeV;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACxB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,IAAI,EAAE,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC/C,IAAI,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE,GAAG,SAAS,CAAA;IAC5C,cAAc,EAAE,aAAa,CAAA;CAC7B,GAAG,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAqB5C"}
+{"version":3,"file":"omit.d.ts","sourceRoot":"","sources":["../../../../src/document/query/tree-filter/omit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvF;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,CAAC,aAAa,SAAS,iBAAiB,IAAI;IACxE,kGAAkG;IAClG,cAAc,EAAE,aAAa,CAAA;IAC7B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1B,WAAW,EAAE,KAAK,CAAC;QAClB,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,CAAA;QAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC9B,KAAK,EAAE,MAAM,GAAG,UAAU,CAAA;KAC1B,CAAC,CAAA;CACF,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAC1E,IAAI,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE,GAAG,SAAS,CAAA;IAC5C,cAAc,EAAE,aAAa,CAAA;CAC7B,GAAG,iBAAiB,CAAC,aAAa,CAAC,CA8BnC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAC1E,MAAM,EAAE,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;IAC/D,YAAY,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAA;CAC9C,GAAG,OAAO,CAiBV;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IACpF,MAAM,EAAE,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;IAC/D,YAAY,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAA;CAC9C,GAAG,OAAO,CAeV;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACxB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,IAAI,EAAE,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC/C,IAAI,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE,GAAG,SAAS,CAAA;IAC5C,cAAc,EAAE,aAAa,CAAA;CAC7B,GAAG,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAqB5C"}

package/dist/document/query/tree-filter/order.d.ts

@@ -1,14 +1,17 @@
 import { AnyDialecteConfig, ElementsOf, TreeRecord } from '../../../types';
 /**
- * Order every node's children by the config-declared child sequence
- * (pure `TreeRecord → TreeRecord`).
+ * Order every node's children by the config-declared child sequence, a child a
+ * wildcard admits at that wildcard (pure `TreeRecord → TreeRecord`).
  *
  * Reuses the same `orderByConfigSequence` comparator as XML building, so a tree
  * and its XML serialization share one ordering. Apply as the final post-pass
  * (after `omit`/`unwrap`) so promoted children also sort into sequence.
+ *
+ * @internal child-order post-pass of the tree reads
  */
 export declare function applyOrder<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
     tree: TreeRecord<GenericConfig, GenericElement>;
     childrenConfig: GenericConfig['children'];
+    definition?: GenericConfig['definition'];
 }): TreeRecord<GenericConfig, GenericElement>;
 //# sourceMappingURL=order.d.ts.map

package/dist/document/query/tree-filter/order.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../../src/document/query/tree-filter/order.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACzB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,IAAI,EAAE,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC/C,cAAc,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;CACzC,GAAG,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAe5C"}
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../../src/document/query/tree-filter/order.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvF;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACzB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,IAAI,EAAE,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC/C,cAAc,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;IACzC,UAAU,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;CACxC,GAAG,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAgB5C"}

package/dist/document/query/tree-filter/unwrap.d.ts

@@ -5,6 +5,8 @@ import { AnyDialecteConfig, ElementsOf, TreeRecord } from '../../../types';
  *
  * Used to hide "transparent" structural elements that are abstracted away in the
  * UI, so both `getTree` and `getSnapshot` present the same shape.
+ *
+ * @internal `unwrap` post-pass of `getTree` and `getSnapshot`
  */
 export declare function applyUnwrap<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
     tree: TreeRecord<GenericConfig, GenericElement>;

package/dist/document/query/tree-filter/unwrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unwrap.d.ts","sourceRoot":"","sources":["../../../../src/document/query/tree-filter/unwrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAExE;;;;;;GAMG;AACH,wBAAgB,WAAW,CAC1B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,IAAI,EAAE,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC/C,cAAc,EAAE,UAAU,CAAC,aAAa,CAAC,EAAE,CAAA;CAC3C,GAAG,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAe5C"}
+{"version":3,"file":"unwrap.d.ts","sourceRoot":"","sources":["../../../../src/document/query/tree-filter/unwrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAExE;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAC1B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,IAAI,EAAE,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC/C,cAAc,EAAE,UAAU,CAAC,aAAa,CAAC,EAAE,CAAA;CAC3C,GAAG,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAe5C"}

package/dist/document/staged-operations.d.ts

@@ -1,5 +1,9 @@
 import { StagedOperations } from './types';
 import { AnyDialecteConfig } from '../types';
-/** Fresh empty staged-operations container (ordered log + derived by-id index). */
+/**
+ * Fresh empty staged-operations container (ordered log + derived by-id index).
+ *
+ * @internal the empty container a transaction stages its writes in; created by Document
+ */
 export declare function createStagedOperations<GenericConfig extends AnyDialecteConfig>(): StagedOperations<GenericConfig>;
 //# sourceMappingURL=staged-operations.d.ts.map

package/dist/document/staged-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"staged-operations.d.ts","sourceRoot":"","sources":["../../src/document/staged-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,mFAAmF;AACnF,wBAAgB,sBAAsB,CACrC,aAAa,SAAS,iBAAiB,KACnC,gBAAgB,CAAC,aAAa,CAAC,CAEnC"}
+{"version":3,"file":"staged-operations.d.ts","sourceRoot":"","sources":["../../src/document/staged-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,aAAa,SAAS,iBAAiB,KACnC,gBAAgB,CAAC,aAAa,CAAC,CAEnC"}

package/dist/document/transaction/clone/clone.d.ts

@@ -8,6 +8,8 @@ import { AnyDialecteConfig, ElementsOf, ChildrenOf, TreeRecord, TransactionHooks
  * Reference rewiring (e.g. repointing cloned refs onto the clone's identities) is
  * the dialecte's concern, done by the caller over the returned `mappings` — core
  * stays agnostic and structural.
+ *
+ * @internal the staging step behind `tx.deepClone`; callers use the transaction
  */
 export declare function stageDeepClone<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(params: {
     dialecteConfig: GenericConfig;

package/dist/document/transaction/clone/clone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/clone/clone.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,eAAe,CAAA;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EACX,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,UAAU,EAEV,gBAAgB,EAChB,MAAM,SAAS,CAAA;AAEhB;;;;;;;GAOG;AACH,wBAAsB,cAAc,CACnC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,mBAAmB,SAAS,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,EACpE,MAAM,EAAE;IACT,cAAc,EAAE,aAAa,CAAA;IAC7B,KAAK,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;IACvC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;IAC3B,SAAS,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC7C,MAAM,EAAE,UAAU,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAA;CACtD,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,CA+B3D"}
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/clone/clone.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,eAAe,CAAA;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EACX,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,UAAU,EAEV,gBAAgB,EAChB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CACnC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,mBAAmB,SAAS,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,EACpE,MAAM,EAAE;IACT,cAAc,EAAE,aAAa,CAAA;IAC7B,KAAK,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;IACvC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;IAC3B,SAAS,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC7C,MAAM,EAAE,UAAU,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAA;CACtD,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,CA+B3D"}

package/dist/document/transaction/commit/commit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/commit/commit.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAE3D,wBAAsB,iBAAiB,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IACxF,gBAAgB,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE,CAAA;IAC5C,KAAK,EAAE,KAAK,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,aAAa,CAAA;IAC5B,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,IAAI,CAAC,EAAE,IAAI,CAAA;CACX,GAAG,OAAO,CAAC,IAAI,CAAC,CA8ChB"}
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/commit/commit.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAE3D,wBAAsB,iBAAiB,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IACxF,gBAAgB,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE,CAAA;IAC5C,KAAK,EAAE,KAAK,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,aAAa,CAAA;IAC5B,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,IAAI,CAAC,EAAE,IAAI,CAAA;CACX,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDhB"}

package/dist/document/transaction/commit/merge-operations.d.ts

@@ -13,7 +13,7 @@ import { AnyDialecteConfig, Operation } from '../../../types';
  * @param operations - Array of staged operations to merge
  * @returns Object containing arrays of merged creates, updates, and deletes
  */
-export declare function mergeOperations<GenericConfig extends AnyDialecteConfig>(operations: Operation<GenericConfig>[]): {
+export declare function mergeOperations<GenericConfig extends AnyDialecteConfig>(operations: ReadonlyArray<Operation<GenericConfig>>): {
     creates: {
         status: "created";
         oldRecord: undefined;

package/dist/document/transaction/commit/merge-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge-operations.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/commit/merge-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAE3D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,aAAa,SAAS,iBAAiB,EACtE,UAAU,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE;;;;;;;;;;;;;;;;EAuDtC"}
+{"version":3,"file":"merge-operations.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/commit/merge-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAE3D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,aAAa,SAAS,iBAAiB,EACtE,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;;;;;;;;;;;;;;;;EAuDnD"}

package/dist/document/transaction/commit/summarize-operations.d.ts

@@ -0,0 +1,16 @@
+import { OperationsSummary } from './summarize-operations.types';
+import { AnyDialecteConfig, Operation } from '../../../types';
+/**
+ * What staged operations write, counted per record as the commit merges them (a record created then
+ * updated is one creation; created then deleted, nothing): totals, and per tag in tag order.
+ *
+ * @intent count what a transaction will create, update and delete, summarize a prepared transaction per tag, show a confirmation summary before commit
+ *
+ * @example
+ * ```ts
+ * const prepared = await doc.prepare(async (tx) => { ... })
+ * summarizeOperations(prepared.operations).byTag // { A: { created: 0, updated: 1, deleted: 0 }, ... }
+ * ```
+ */
+export declare function summarizeOperations<GenericConfig extends AnyDialecteConfig>(operations: ReadonlyArray<Operation<GenericConfig>>): OperationsSummary;
+//# sourceMappingURL=summarize-operations.d.ts.map

package/dist/document/transaction/commit/summarize-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-operations.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/commit/summarize-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAmB,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAE3D;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,SAAS,iBAAiB,EAC1E,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,GACjD,iBAAiB,CAenB"}

package/dist/document/transaction/commit/summarize-operations.types.d.ts

@@ -0,0 +1,17 @@
+/** How many records of one tag a transaction creates, updates and deletes. */
+export type OperationCounts = {
+    created: number;
+    updated: number;
+    deleted: number;
+};
+/**
+ * What a transaction writes, one count per record (several staged writes to the same record count
+ * once, as the commit merges them): totals, and per tag in tag order.
+ */
+export type OperationsSummary = {
+    creates: number;
+    updates: number;
+    deletes: number;
+    byTag: Record<string, OperationCounts>;
+};
+//# sourceMappingURL=summarize-operations.types.d.ts.map

package/dist/document/transaction/commit/summarize-operations.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-operations.types.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/commit/summarize-operations.types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CACtC,CAAA"}

package/dist/document/transaction/create/create.d.ts

@@ -4,6 +4,8 @@ import { AnyDialecteConfig, ElementsOf, ChildrenOf, RawRecord, TransactionHooks
 /**
  * Fetches parent, builds and stages operations for adding a child.
  * Pushes operations directly to context.stagedOperations.log.
+ *
+ * @internal the staging step behind `tx.addChild`; callers use the transaction
  */
 export declare function stageAddChild<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(params: {
     dialecteConfig: GenericConfig;

package/dist/document/transaction/create/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/create/create.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,gBAAgB,CAAA;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EACX,iBAAiB,EAGjB,UAAU,EACV,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,MAAM,SAAS,CAAA;AAEhB;;;GAGG;AACH,wBAAsB,aAAa,CAClC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,mBAAmB,SAAS,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,EACpE,MAAM,EAAE;IACT,cAAc,EAAE,aAAa,CAAA;IAC7B,KAAK,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;IACvC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;IAC3B,SAAS,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC7C,MAAM,EAAE,cAAc,CAAC,aAAa,EAAE,cAAc,EAAE,mBAAmB,CAAC,CAAA;CAC1E,GAAG,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAsEzD"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/create/create.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,gBAAgB,CAAA;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EACX,iBAAiB,EAGjB,UAAU,EACV,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,MAAM,SAAS,CAAA;AAEhB;;;;;GAKG;AACH,wBAAsB,aAAa,CAClC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,mBAAmB,SAAS,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,EACpE,MAAM,EAAE;IACT,cAAc,EAAE,aAAa,CAAA;IAC7B,KAAK,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;IACvC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;IAC3B,SAAS,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC7C,MAAM,EAAE,cAAc,CAAC,aAAa,EAAE,cAAc,EAAE,mBAAmB,CAAC,CAAA;CAC1E,GAAG,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAsEzD"}

package/dist/document/transaction/guard.d.ts

@@ -1,4 +1,9 @@
 import { CachedContext, Context } from '../types';
 import { AnyDialecteConfig } from '../../types';
+/**
+ * Whether a context is a transaction's (one carrying a record cache), narrowing it to `CachedContext`.
+ *
+ * @internal context check of the query layer
+ */
 export declare function isTransactionContext<GenericConfig extends AnyDialecteConfig>(context: Context<GenericConfig>): context is CachedContext<GenericConfig>;
 //# sourceMappingURL=guard.d.ts.map

package/dist/document/transaction/guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/document/transaction/guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE3C,wBAAgB,oBAAoB,CAAC,aAAa,SAAS,iBAAiB,EAC3E,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAC7B,OAAO,IAAI,aAAa,CAAC,aAAa,CAAC,CAEzC"}
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/document/transaction/guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE3C;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,SAAS,iBAAiB,EAC3E,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAC7B,OAAO,IAAI,aAAa,CAAC,aAAa,CAAC,CAEzC"}

package/dist/document/transaction/index.d.ts

@@ -1,8 +1,10 @@
 export { Transaction } from './main';
 export { AnyTransaction } from './any';
 export { isTransactionContext } from './guard';
+export { summarizeOperations } from './commit/summarize-operations';
 export type * from './any';
 export type * from './clone';
 export type * from './create';
 export type * from './update';
+export type * from './commit/summarize-operations.types';
 //# sourceMappingURL=index.d.ts.map

package/dist/document/transaction/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/document/transaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAE9C,mBAAmB,OAAO,CAAA;AAC1B,mBAAmB,SAAS,CAAA;AAC5B,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/document/transaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAEnE,mBAAmB,OAAO,CAAA;AAC1B,mBAAmB,SAAS,CAAA;AAC5B,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,qCAAqC,CAAA"}