@dialecte/core 0.7.0 → 0.8.0

package/dist/document/bind-extensions.d.ts

@@ -1,6 +1,7 @@
 import { BoundExtensionMap, ExtensionMap, QueryExtensionFn, TransactionExtensionFn } from './types.extensions';
 /**
- * Binds an extension map to an instance (Query or Transaction).
+ * The extension map bound to an instance (a Query or a Transaction): same shape, each function called with the
+ * instance.
  * Each function in the map gets `instance` prepended as its first argument,
  * so the public API signature has that argument stripped.
  *
@@ -9,6 +10,8 @@ import { BoundExtensionMap, ExtensionMap, QueryExtensionFn, TransactionExtension
  * So `{ a: { aa: { getItems } } }` yields `instance.a.aa.getItems`.
  *
  * Returns an object mirroring the map's shape with each function bound.
+ *
+ * @intent attach an extension map to a query or a transaction, call extension functions as methods of an instance
  */
 export declare function bindExtensions<GenericExtensionsMap extends ExtensionMap<QueryExtensionFn | TransactionExtensionFn>>(extensionMap: GenericExtensionsMap | undefined, instance: unknown): BoundExtensionMap<GenericExtensionsMap>;
 //# sourceMappingURL=bind-extensions.d.ts.map

package/dist/document/bind-extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bind-extensions.d.ts","sourceRoot":"","sources":["../../src/document/bind-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,MAAM,oBAAoB,CAAA;AAE3B;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC7B,oBAAoB,SAAS,YAAY,CAAC,gBAAgB,GAAG,sBAAsB,CAAC,EAEpF,YAAY,EAAE,oBAAoB,GAAG,SAAS,EAC9C,QAAQ,EAAE,OAAO,GACf,iBAAiB,CAAC,oBAAoB,CAAC,CAIzC"}
+{"version":3,"file":"bind-extensions.d.ts","sourceRoot":"","sources":["../../src/document/bind-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,MAAM,oBAAoB,CAAA;AAE3B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC7B,oBAAoB,SAAS,YAAY,CAAC,gBAAgB,GAAG,sBAAsB,CAAC,EAEpF,YAAY,EAAE,oBAAoB,GAAG,SAAS,EAC9C,QAAQ,EAAE,OAAO,GACf,iBAAiB,CAAC,oBAAoB,CAAC,CAIzC"}

package/dist/document/document.d.ts

@@ -33,8 +33,8 @@ export declare class Document<GenericConfig extends AnyDialecteConfig, GenericEx
     readonly state: DocumentState;
     /**
      * Name of the project's BroadcastChannel. Open your own instance
-     * (`new BroadcastChannel(doc.channelName)`) to receive ProjectChannelMessage
-     * events for this project, same-tab and cross-tab.
+     * (`new BroadcastChannel(doc.channelName)`) to receive ProjectChannelEvent
+     * events for this project (each change, and a resync), same-tab and cross-tab.
      */
     readonly channelName: string;
     /** Announce a mutation on the project channel (provided by the owning Project) */
@@ -47,6 +47,8 @@ export declare class Document<GenericConfig extends AnyDialecteConfig, GenericEx
      * undo/redo, and folded-in cross-realm commits. `terminal` is `true` for the
      * final frame of an operation, letting a consumer flush it without coalescing.
      * Returns an unsubscribe function. Wired from the owning Project's registry.
+     *
+     * @intent react to document changes in a UI, refresh a view after a commit or an undo, follow transaction progress
      */
     readonly subscribe: (callback: (terminal: boolean) => void) => () => void;
     /** Wake this document's subscribers (provided by the owning Project). */
@@ -57,6 +59,12 @@ export declare class Document<GenericConfig extends AnyDialecteConfig, GenericEx
      * flags are up to date synchronously, without depending on a channel echo.
      */
     private refreshHistoryStatus;
+    /**
+     * Count a write of this Document (a transaction, a prepared commit) with the owning Project until the
+     * function it answers is called: the Project's close waits for it before it closes the store. Throws
+     * `PROJECT_NOT_OPENED` while that Project closes (provided by the owning Project).
+     */
+    private startWrite;
     /** Track concurrent transactions to manage loading flag */
     private activeTransactions;
     constructor(store: Store, config: GenericConfig, documentId: string, extensions: GenericExtension | undefined, hooks: DialecteHooks<GenericConfig> | undefined, project: {
@@ -67,6 +75,7 @@ export declare class Document<GenericConfig extends AnyDialecteConfig, GenericEx
         perf: Perf;
         subscribeState: (callback: (terminal: boolean) => void) => () => void;
         signalStateChange: (terminal: boolean) => void;
+        startWrite: () => () => void;
     });
     private withQueryExtensions;
     private withAllExtensions;
@@ -80,14 +89,35 @@ export declare class Document<GenericConfig extends AnyDialecteConfig, GenericEx
      * e.g. SclDocument overrides this to return new SclTransaction(...)
      */
     protected createTransaction(): Transaction<GenericConfig>;
+    /**
+     * Run `fn` against a new transaction and commit everything it staged as one undoable step; on a
+     * throw nothing is written. A second transaction started on this Document while one runs throws
+     * `CONCURRENT_TRANSACTION`.
+     *
+     * @intent change a document, add or update or delete elements and commit them, group edits into one undo step
+     *
+     * @example
+     * ```ts
+     * await doc.transaction(async (tx) => {
+     *   await tx.addChild(root, { tagName: 'A', attributes: { aA: 'a' } })
+     * }, { label: 'Add A' })
+     * ```
+     */
     transaction<T>(fn: (tx: Transaction<GenericConfig> & AllExtensions<GenericExtension>) => Promise<T>, options?: {
         label?: string;
     }): Promise<T>;
+    /**
+     * A commit refused with its engine lost may have landed (its outcome `running` or `unknown`): the document's
+     * history is read again and the change the store told of it posted. One known not to have landed changed nothing.
+     */
+    private readAgainAfterLoss;
     /**
      * Build up operations without committing.
      * Returns a PreparedTransaction with staged operations for preview,
      * then call commit() to apply or discard() to throw away.
      *
+     * @intent preview changes before committing, ask a user to confirm an edit, dry-run a transaction
+     *
      * @example
      * ```ts
      * const prepared = await doc.prepare(async (tx) => {
@@ -112,9 +142,32 @@ export declare class Document<GenericConfig extends AnyDialecteConfig, GenericEx
      * as its cause.
      */
     private reportFailure;
-    /** Close the store connection */
-    close(): void;
-    /** Close connection and delete the database entirely */
+    /**
+     * One write at a time on this Document: a transaction, a prepare or a prepared commit started while
+     * another is open would stage against records the other is about to overwrite.
+     */
+    private assertNoActiveTransaction;
+    /**
+     * Close the connection to the project's store, shared by every document of the project: after it,
+     * no document of this project can read or write. With a built-in store (local, in-memory), opening
+     * the project again gives a new store: documents opened before stay closed, open them again from
+     * the project. A custom store is reopened in place. To finish with the
+     * project, use `project.close`.
+     *
+     * Settled once the store counts no more (its running operations ended): never await it inside a hook or a
+     * transaction callback of this document - it waits for that work.
+     *
+     * @intent close the project's database connection from a document
+     */
+    close(): Promise<void>;
+    /**
+     * Delete the whole project database and let the connection go: every document of the project, its
+     * history and its blobs - not only this document; refused `PROJECT_OPEN_ELSEWHERE`, nothing removed and
+     * the connection kept, while another connection has the project open. To delete one document, use
+     * `project.removeDocument`.
+     *
+     * @intent delete the whole project database from a document, wipe every document of the project
+     */
     destroy(): Promise<void>;
 }
 //# sourceMappingURL=document.d.ts.map

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

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

package/dist/document/progress/progress.types.d.ts

@@ -36,13 +36,30 @@ export type PlanInput = {
  * whole stack.
  */
 export type ProgressReporter = {
-    /** Push a plan level (child of the current innermost, or the main if none). */
+    /**
+     * Push a plan level (child of the current innermost, or the main if none).
+     *
+     * @intent report progress of a long operation, announce how many steps a transaction or nested step has, show a progress bar caption
+     */
     plan(plan: PlanInput): void;
-    /** Advance the innermost plan by one step (close-previous); optionally recaption. */
+    /**
+     * Advance the innermost plan by one step (close-previous); optionally recaption.
+     *
+     * @intent mark a progress step done, update the progress caption
+     */
     nextStep(label?: string): void;
-    /** Pop the innermost plan. Clears progress only once the stack is empty. */
+    /**
+     * Pop the innermost plan. Clears progress only once the stack is empty.
+     *
+     * @intent close a nested progress plan, finish reporting progress for a step
+     */
     endPlan(): void;
-    /** Unconditional clear — empties the whole plan stack regardless of balance. */
+    /**
+     * Unconditional clear — empties the whole plan stack regardless of balance. `Document.transaction`
+     * calls it when it ends or fails.
+     *
+     * @internal Used by the transaction to reset progress when it ends.
+     */
     forceClear(): void;
 };
 //# sourceMappingURL=progress.types.d.ts.map

package/dist/document/progress/progress.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"progress.types.d.ts","sourceRoot":"","sources":["../../../src/document/progress/progress.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC/C,GAAG,IAAI,CAAA;AAER,mEAAmE;AACnE,MAAM,MAAM,SAAS,GAAG;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,+EAA+E;IAC/E,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,4EAA4E;IAC5E,OAAO,IAAI,IAAI,CAAA;IACf,gFAAgF;IAChF,UAAU,IAAI,IAAI,CAAA;CAClB,CAAA"}
+{"version":3,"file":"progress.types.d.ts","sourceRoot":"","sources":["../../../src/document/progress/progress.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC/C,GAAG,IAAI,CAAA;AAER,mEAAmE;AACnE,MAAM,MAAM,SAAS,GAAG;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAA;IACf;;;;;OAKG;IACH,UAAU,IAAI,IAAI,CAAA;CAClB,CAAA"}

package/dist/document/query/find/ancestor/find-ancestor.d.ts

@@ -9,6 +9,8 @@ import { AnyDialecteConfig, ElementsOf, TrackedRecord } from '../../../../types'
  * The starting record is NOT included.
  * When `stopAtTagName` is set, the walk stops after collecting that element (inclusive).
  * When `depth` is set, at most that many ancestors are returned.
+ *
+ * @internal the context-level read behind `doc.query.findAncestors`; callers use the query
  */
 export declare function findAncestors<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
     context: Context<GenericConfig>;

package/dist/document/query/find/ancestor/find-ancestor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-ancestor.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/ancestor/find-ancestor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC3E;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAClC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,OAAO,CAAC,EAAE,oBAAoB,CAAC,aAAa,CAAC,CAAA;CAC7C,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAyBrE"}
+{"version":3,"file":"find-ancestor.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/ancestor/find-ancestor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC3E;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAClC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,OAAO,CAAC,EAAE,oBAAoB,CAAC,aAAa,CAAC,CAAA;CAC7C,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAyBrE"}

package/dist/document/query/find/by-attribute/find-by-attributes.d.ts

@@ -4,6 +4,8 @@ import { AnyDialecteConfig, TrackedRecord, ElementsOf } from '../../../../types'
  * Find elements by tagName and attributes.
  * Core primitive for all query operations.
  * Returns all records matching tagName and attributes - no scope filtering.
+ *
+ * @internal the context-level read behind `doc.query.findByAttributes`; callers use the query
  */
 export declare function findByAttributes<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
     context: Context<GenericConfig>;
@@ -17,6 +19,8 @@ export declare function findByAttributes<GenericConfig extends AnyDialecteConfig
  * - Undefined values: ignored (attribute removed from filter)
  * - `xsi:type`: compared as the type it names, whatever form the filter writes it in (local name, dialecte prefix,
  *   Clark name) or the record holds it in
+ *
+ * @internal the attribute filter of `findByAttributes` and `getTree`'s `where`
  */
 export declare function matchesAttributeFilter<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
     dialecteConfig: GenericConfig;

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

@@ -1 +1 @@
-{"version":3,"file":"find-by-attributes.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/by-attribute/find-by-attributes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,KAAK,EACX,iBAAiB,EAEjB,aAAa,EACb,UAAU,EAEV,MAAM,SAAS,CAAA;AAEhB;;;;GAIG;AACH,wBAAsB,gBAAgB,CACrC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,gBAAgB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CAC3D,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC,CAmB1D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACrC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,cAAc,EAAE,aAAa,CAAA;IAC7B,MAAM,EAAE,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACpD,eAAe,EAAE,gBAAgB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CAChE,GAAG,OAAO,CAiCV"}
+{"version":3,"file":"find-by-attributes.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/by-attribute/find-by-attributes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,KAAK,EACX,iBAAiB,EAEjB,aAAa,EACb,UAAU,EAEV,MAAM,SAAS,CAAA;AAEhB;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACrC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,gBAAgB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CAC3D,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC,CAmB1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACrC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,cAAc,EAAE,aAAa,CAAA;IAC7B,MAAM,EAAE,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACpD,eAAe,EAAE,gBAAgB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CAChE,GAAG,OAAO,CAiCV"}

package/dist/document/query/find/descendant/find-descendant.d.ts

@@ -12,6 +12,8 @@ import { AnyDialecteConfig, ElementsOf } from '../../../../types';
  *
  * 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).
+ *
+ * @internal the context-level read behind `doc.query.findDescendants`; callers use the query
  */
 export declare function findDescendants<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericCollect extends Collect<GenericConfig, GenericElement>>(params: {
     context: Context<GenericConfig>;

package/dist/document/query/find/descendant/find-descendant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-descendant.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/descendant/find-descendant.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAEpG,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAa,MAAM,YAAY,CAAA;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAiB,MAAM,SAAS,CAAA;AAM3E;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACpC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,cAAc,SAAS,OAAO,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5D,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,OAAO,EAAE,qBAAqB,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,CAAC,CAAA;CAC7E,GAAG,OAAO,CAAC,qBAAqB,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC,CA2ChF"}
+{"version":3,"file":"find-descendant.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/descendant/find-descendant.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAEpG,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAa,MAAM,YAAY,CAAA;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAiB,MAAM,SAAS,CAAA;AAM3E;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACpC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,cAAc,SAAS,OAAO,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5D,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,OAAO,EAAE,qBAAqB,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,CAAC,CAAA;CAC7E,GAAG,OAAO,CAAC,qBAAqB,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC,CA2ChF"}

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

@@ -11,6 +11,8 @@ import { AttributeDefaults } from '../../../../utils';
  * controls the fallback for an absent attribute: `'none'` → `''`; `'optional'` → `fixed` /
  * non-empty `default` (else `''`); `'required'` → required/fixed materialized value.
  *
+ * @internal the context-level read behind `doc.query.getAttribute`; callers use the query
+ *
  * @example
  * getAttribute({ context, ref, name: 'aA' })                    // → string | ''
  * getAttribute({ context, ref, name: 'cA', namespace: 'ext' })  // → ext:cA value
@@ -28,6 +30,8 @@ export declare function getAttribute<GenericConfig extends AnyDialecteConfig, Ge
  * absent schema attribute by synthesizing its object; `'none'` returns `undefined` when the
  * attribute is not stored.
  *
+ * @internal the context-level read behind `doc.query.getAttribute` with `fullObject`; callers use the query
+ *
  * @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":"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"}
+{"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;;;;;;;;;;;;;;;GAeG;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;;;;;;;;;;GAUG;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

@@ -14,6 +14,8 @@ import { AttributeDefaults } from '../../../../utils';
  * `'none'` = stored only; `'optional'` = read view (fixed / non-empty default);
  * `'required'` = XSD/export view (required as `''` + fixed). Stored values always win.
  *
+ * @internal the context-level read behind `doc.query.getAttributes`; callers use the query
+ *
  * @example
  * getAttributes({ context, ref })                       // → { aA: '', bA: '', ... }
  * getAttributes({ context, ref, namespace: 'ext' })     // → { cA: '...' }
@@ -33,6 +35,8 @@ export declare function getAttributes<GenericConfig extends AnyDialecteConfig, G
  * `'optional'`/`'required'` synthesize missing schema attributes (with their
  * schema-derived namespace).
  *
+ * @internal the context-level read behind `doc.query.getAttributes` with `fullObject`; callers use the query
+ *
  * @example
  * getAttributes({ context, ref, fullObject: true })    // → FullAttributeObject[]
  */

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":"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"}
+{"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;;;;;;;;;;;;;;;;;;GAkBG;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;;;;;;;;;;;;;GAaG;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/document/query/get/definition/get-definition.d.ts

@@ -4,6 +4,8 @@ import { AnyDialecteConfig, ElementsOf, ResolvedDefinition } from '../../../../t
  * The definition of an element in its context. The record is fetched (staged → cache → store),
  * so the parent is always known and a homonym reads as declared under it. `undefined` when the
  * ref points at no record, or at a tag the dialecte does not know.
+ *
+ * @internal the context-level read behind `doc.query.getDefinition`; callers use the query
  */
 export declare function getDefinition<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
     context: Context<GenericConfig>;

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

@@ -1 +1 @@
-{"version":3,"file":"get-definition.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/definition/get-definition.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAEhF;;;;GAIG;AACH,wBAAsB,aAAa,CAClC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CAC/C,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAK1C"}
+{"version":3,"file":"get-definition.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/definition/get-definition.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAEhF;;;;;;GAMG;AACH,wBAAsB,aAAa,CAClC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CAC/C,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAK1C"}

package/dist/document/query/get/record/get-child.d.ts

@@ -7,6 +7,8 @@ import { AnyDialecteConfig, ChildrenOf, ElementsOf, TrackedRecord } from '../../
  * looks through those wrapper elements to find a matching child one level deeper.
  *
  * Returns `undefined` when the parent does not exist or has no matching child.
+ *
+ * @internal the context-level read behind `doc.query.getChild`; callers use the query
  */
 export declare function getChild<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(params: {
     context: Context<GenericConfig>;

package/dist/document/query/get/record/get-child.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-child.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/get-child.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEvF;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC7B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,mBAAmB,SAAS,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,EACpE,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC/C,OAAO,EAAE,mBAAmB,CAAA;CAC5B,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,mBAAmB,CAAC,GAAG,SAAS,CAAC,CA0BzE"}
+{"version":3,"file":"get-child.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/get-child.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEvF;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAC7B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,mBAAmB,SAAS,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,EACpE,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC/C,OAAO,EAAE,mBAAmB,CAAA;CAC5B,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,mBAAmB,CAAC,GAAG,SAAS,CAAC,CA0BzE"}

package/dist/document/query/get/record/get-children.d.ts

@@ -7,6 +7,8 @@ import { AnyDialecteConfig, ChildrenOf, ElementsOf, TrackedRecord } from '../../
  * looks through those wrapper elements to find matching children one level deeper.
  *
  * Returns an empty array when the parent does not exist or has no matching children.
+ *
+ * @internal the context-level read behind `doc.query.getChildren`; callers use the query
  */
 export declare function getChildren<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(params: {
     context: Context<GenericConfig>;

package/dist/document/query/get/record/get-children.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-children.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/get-children.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEvF;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAChC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,mBAAmB,SAAS,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,EACpE,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC/C,OAAO,EAAE,mBAAmB,CAAA;CAC5B,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,mBAAmB,CAAC,EAAE,CAAC,CAsC/D"}
+{"version":3,"file":"get-children.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/get-children.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEvF;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAChC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,mBAAmB,SAAS,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,EACpE,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC/C,OAAO,EAAE,mBAAmB,CAAA;CAC5B,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,mBAAmB,CAAC,EAAE,CAAC,CAsC/D"}

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

@@ -9,6 +9,8 @@ import { AnyDialecteConfig, ElementsOf, TrackedRecord } from '../../../../types'
  *
  * Side effect: populates context.recordCache on store hits.
  *
+ * @internal the context-level read behind `doc.query.getRecord`; callers use the query
+ *
  * @throws {@link DialecteError} `ELEMENT_TAGNAME_MISMATCH` when a record is found by id
  * but its tagName differs from `ref.tagName` (mirrors the staged-lookup path).
  */

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

@@ -1 +1 @@
-{"version":3,"file":"get-record.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/get-record.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAa,aAAa,EAAE,MAAM,SAAS,CAAA;AAEtF;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC9B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CAC/C,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,CA8DpE"}
+{"version":3,"file":"get-record.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/get-record.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAa,aAAa,EAAE,MAAM,SAAS,CAAA;AAEtF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAC9B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CAC/C,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,CA+DpE"}

package/dist/document/query/get/record/get-records-by-tagname.d.ts

@@ -7,6 +7,8 @@ import { AnyDialecteConfig, ElementsOf, TrackedRecord } from '../../../../types'
  * applied on top by overlayStaged.
  *
  * Side effect: populates context.recordCache for all fetched DB records.
+ *
+ * @internal the context-level read behind `doc.query.getRecordsByTagName`; callers use the query
  */
 export declare function getRecordsByTagName<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
     context: Context<GenericConfig>;

package/dist/document/query/get/record/get-records-by-tagname.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-records-by-tagname.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/get-records-by-tagname.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAa,aAAa,EAAE,MAAM,SAAS,CAAA;AAEtF;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACxC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,OAAO,EAAE,cAAc,CAAA;CACvB,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC,CAa1D"}
+{"version":3,"file":"get-records-by-tagname.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/get-records-by-tagname.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAa,aAAa,EAAE,MAAM,SAAS,CAAA;AAEtF;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACxC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,OAAO,EAAE,cAAc,CAAA;CACvB,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC,CAa1D"}

package/dist/document/query/get/record/get-records.d.ts

@@ -3,6 +3,8 @@ import { AnyDialecteConfig, ElementsOf, TrackedRecord } from '../../../../types'
 /**
  * Batch lookup — resolve multiple refs in parallel.
  * Delegates to getRecord per ref; cache hits avoid redundant store calls.
+ *
+ * @internal the context-level read behind `doc.query.getRecords`; callers use the query
  */
 export declare function getRecords<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
     context: Context<GenericConfig>;

package/dist/document/query/get/record/get-records.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-records.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/get-records.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE3E;;;GAGG;AACH,wBAAsB,UAAU,CAC/B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,IAAI,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAA;CAClD,GAAG,OAAO,CAAC,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,CAGxE"}
+{"version":3,"file":"get-records.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/get-records.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE3E;;;;;GAKG;AACH,wBAAsB,UAAU,CAC/B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,IAAI,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAA;CAClD,GAAG,OAAO,CAAC,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,CAGxE"}

package/dist/document/query/get/record/load-live-records.d.ts

@@ -4,6 +4,8 @@ import { AnyDialecteConfig, ElementsOf, TrackedRecord } from '../../../../types'
  * Read every record of the document once and overlay the staged operations: the in-memory
  * data source of a whole-tree read (`getTree`) and of a descendant collect that has outgrown
  * its climb (`findDescendants`). One `getByDocumentId` round trip, whatever the document size.
+ *
+ * @internal whole-document read of `getTree` and `findDescendants`
  */
 export declare function loadLiveRecords<GenericConfig extends AnyDialecteConfig>(context: Context<GenericConfig>): Promise<Map<string, TrackedRecord<GenericConfig, ElementsOf<GenericConfig>>>>;
 //# sourceMappingURL=load-live-records.d.ts.map

package/dist/document/query/get/record/load-live-records.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-live-records.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/load-live-records.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE3E;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,aAAa,SAAS,iBAAiB,EAC5E,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAC7B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAQ/E"}
+{"version":3,"file":"load-live-records.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/load-live-records.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE3E;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,aAAa,SAAS,iBAAiB,EAC5E,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAC7B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAQ/E"}

package/dist/document/query/get/record/resolve-record.d.ts

@@ -10,6 +10,8 @@ import { AnyDialecteConfig, ElementsOf, TrackedRecord } from '../../../../types'
  *
  * Perf: counts `core::query::getRecord.fromRecord` when the record given is the one read.
  *
+ * @internal the record lookup every context-level read starts with; callers use the query
+ *
  * @throws {@link DialecteError} when `ref` is undefined.
  */
 export declare function resolveRecord<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {

package/dist/document/query/get/record/resolve-record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-record.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/resolve-record.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE3E;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAClC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAA;CAC3D,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,CAoBpE"}
+{"version":3,"file":"resolve-record.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/resolve-record.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE3E;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAClC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAA;CAC3D,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,CAoBpE"}

package/dist/document/query/get/record/staged-lookup.d.ts

@@ -38,6 +38,8 @@ export declare function overlayStaged<GenericConfig extends AnyDialecteConfig, G
  * and deleted in the same staged set (a net no-op that never reaches the store).
  *
  * Pure function — no DB access, no side effects.
+ *
+ * @internal staged-write overlay of the query layer
  */
 export declare function overlayAllStaged<GenericConfig extends AnyDialecteConfig>(params: {
     rawRecords: AnyRawRecord[];
@@ -60,6 +62,8 @@ export declare function overlayAllStaged<GenericConfig extends AnyDialecteConfig
  * no-op that never reaches the store).
  *
  * Pure function — no DB access, no side effects.
+ *
+ * @internal staged-delete index of the snapshot and tree reads
  */
 export declare function indexStagedDeletesByParent<GenericConfig extends AnyDialecteConfig>(stagedOperations: ReadonlyArray<Operation<GenericConfig>>): Map<string, AnyTrackedRecord[]>;
 //# sourceMappingURL=staged-lookup.d.ts.map

package/dist/document/query/get/record/staged-lookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"staged-lookup.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/staged-lookup.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,KAAK,EACX,iBAAiB,EACjB,SAAS,EAET,UAAU,EACV,aAAa,EACb,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACpC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,gBAAgB,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;IACjD,OAAO,EAAE,cAAc,CAAA;IACvB,EAAE,CAAC,EAAE,MAAM,CAAA;CACX,GAAG,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAgC3D;AA0CD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC5B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAA;IACtD,gBAAgB,EAAE,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAA;CACzD,GAAG,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAoBjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IACjF,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,gBAAgB,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;IACjD,cAAc,CAAC,EAAE,OAAO,CAAA;CACxB,GAAG;IAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAqCvE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,SAAS,iBAAiB,EACjF,gBAAgB,EAAE,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,GACvD,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAqBjC"}
+{"version":3,"file":"staged-lookup.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/staged-lookup.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,KAAK,EACX,iBAAiB,EACjB,SAAS,EAET,UAAU,EACV,aAAa,EACb,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACpC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,gBAAgB,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;IACjD,OAAO,EAAE,cAAc,CAAA;IACvB,EAAE,CAAC,EAAE,MAAM,CAAA;CACX,GAAG,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAgC3D;AA2CD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC5B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAA;IACtD,gBAAgB,EAAE,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAA;CACzD,GAAG,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAoBjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IACjF,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,gBAAgB,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;IACjD,cAAc,CAAC,EAAE,OAAO,CAAA;CACxB,GAAG;IAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAqCvE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,SAAS,iBAAiB,EACjF,gBAAgB,EAAE,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,GACvD,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAqBjC"}

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

@@ -1,6 +1,12 @@
 import { GetTreeParams } from './get-tree.types';
 import { Context, Ref } from '../../..';
 import { AnyDialecteConfig, ElementsOf, TreeRecord } from '../../../../types';
+/**
+ * The subtree under a ref as a `TreeRecord`, staged writes overlaid, shaped by `select`, `omit`, `unwrap` and
+ * `depth`; the context-level read behind `doc.query.getTree`.
+ *
+ * @internal the context-level read behind `doc.query.getTree`; callers use the query
+ */
 export declare function getTree<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
     context: Context<GenericConfig>;
     ref: Ref<GenericConfig, GenericElement>;

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

@@ -1 +1 @@
-{"version":3,"file":"get-tree.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/tree/get-tree.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,kBAAkB,CAAA;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAiB,UAAU,EAAE,MAAM,SAAS,CAAA;AAIvF,wBAAsB,OAAO,CAC5B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACtD,cAAc,CAAC,EAAE,aAAa,CAAA;CAC9B,GAAG,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,CAmDjE"}
+{"version":3,"file":"get-tree.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/tree/get-tree.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,kBAAkB,CAAA;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAiB,UAAU,EAAE,MAAM,SAAS,CAAA;AAIvF;;;;;GAKG;AACH,wBAAsB,OAAO,CAC5B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACtD,cAAc,CAAC,EAAE,aAAa,CAAA;CAC9B,GAAG,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,CAoDjE"}