@dialecte/core 0.1.3 → 0.1.4

package/dist/dialecte/main.d.ts

@@ -1,8 +1,9 @@
 import { Document } from '../document';
 import { StorageOptions } from '../store';
-import { AnyDialecteConfig } from '../types';
-export declare function openDialecteDocument<GenericConfig extends AnyDialecteConfig>(params: {
+import { AnyDialecteConfig, ExtensionsRegistry } from '../types';
+export declare function openDialecteDocument<GenericConfig extends AnyDialecteConfig, GenericExt extends ExtensionsRegistry = {}>(params: {
     config: GenericConfig;
     storage: StorageOptions;
-}): Document<GenericConfig>;
+    extensions?: GenericExt;
+}): Document<GenericConfig, GenericExt>;
 //# sourceMappingURL=main.d.ts.map

package/dist/dialecte/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/dialecte/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,wBAAgB,oBAAoB,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IACrF,MAAM,EAAE,aAAa,CAAA;IACrB,OAAO,EAAE,cAAc,CAAA;CACvB,GAAG,QAAQ,CAAC,aAAa,CAAC,CAO1B"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/dialecte/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAEpE,wBAAgB,oBAAoB,CACnC,aAAa,SAAS,iBAAiB,EACvC,UAAU,SAAS,kBAAkB,GAAG,EAAE,EACzC,MAAM,EAAE;IACT,MAAM,EAAE,aAAa,CAAA;IACrB,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,CAAC,EAAE,UAAU,CAAA;CACvB,GAAG,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC,CAOtC"}

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

@@ -0,0 +1,10 @@
+import { ExtensionMap, QueryExtensionFn, TransactionExtensionFn } from '../types';
+/**
+ * Binds an extension map to an instance (Query or Transaction).
+ * Each function in the map gets `instance` prepended as its first argument,
+ * so the public API signature has that argument stripped.
+ *
+ * Returns a frozen object of { GroupName: { methodName: boundFn } }.
+ */
+export declare function bindExtensions<GenericExtensionsMap extends ExtensionMap<QueryExtensionFn | TransactionExtensionFn>>(extensionMap: GenericExtensionsMap | undefined, instance: unknown): Record<string, Record<string, (...args: unknown[]) => unknown>>;
+//# sourceMappingURL=bind-extensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bind-extensions.d.ts","sourceRoot":"","sources":["../../src/document/bind-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAErF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,oBAAoB,SAAS,YAAY,CAAC,gBAAgB,GAAG,sBAAsB,CAAC,EAEpF,YAAY,EAAE,oBAAoB,GAAG,SAAS,EAC9C,QAAQ,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAgBjE"}

package/dist/document/document.d.ts

@@ -3,21 +3,23 @@ import { Transaction } from './transaction';
 import { PreparedTransaction, DocumentState } from './types';
 import { Store } from '../store';
 import { AnyDialecteConfig } from '../types/dialecte-config';
+import { AllExtensions, ExtensionsRegistry, QueryExtensions } from '../types/extensions';
 /**
  * Document — the public entry point for querying and mutating a dialecte.
  *
  * Queries: doc.query.getRoot(), doc.query.findChildren(...), etc.
  * Mutations: doc.transaction(async (tx) => { tx.addChild(...) })
  *
- * Single observable state: doc.state — loading, error, activity, progress, history.
+ * Single observable state: doc.state — loading, error, progress, history.
  * Transaction mutates this state directly (no separate transaction state).
  *
  * Subclass in a dialecte to override createQuery() / createTransaction()
  * and return domain-specific subclasses (e.g. SclQuery, SclTransaction).
  */
-export declare class Document<GenericConfig extends AnyDialecteConfig> {
+export declare class Document<GenericConfig extends AnyDialecteConfig, GenericExtension extends ExtensionsRegistry = {}> {
     protected store: Store;
     protected config: GenericConfig;
+    private extensionsRegistry?;
     readonly state: DocumentState;
     /** Track concurrent transactions to manage loading flag */
     private activeTransactions;
@@ -30,18 +32,20 @@ export declare class Document<GenericConfig extends AnyDialecteConfig> {
      * so no self-filter is needed.
      */
     private channel;
-    constructor(store: Store, config: GenericConfig);
+    constructor(store: Store, config: GenericConfig, extensions?: GenericExtension);
+    private withQueryExtensions;
+    private withAllExtensions;
     /**
      * Override in dialecte subclass to return a domain-specific Query.
      */
     protected createQuery(): Query<GenericConfig>;
-    get query(): Query<GenericConfig>;
+    get query(): Query<GenericConfig> & QueryExtensions<GenericExtension>;
     /**
      * Override in dialecte subclass to return a domain-specific Transaction.
      * e.g. SclDocument overrides this to return new SclTransaction(...)
      */
     protected createTransaction(): Transaction<GenericConfig>;
-    transaction<T>(fn: (tx: Transaction<GenericConfig>) => Promise<T>, options?: {
+    transaction<T>(fn: (tx: Transaction<GenericConfig> & AllExtensions<GenericExtension>) => Promise<T>, options?: {
         label?: string;
     }): Promise<T>;
     /**
@@ -64,7 +68,7 @@ export declare class Document<GenericConfig extends AnyDialecteConfig> {
      * // or: prepared.discard()
      * ```
      */
-    prepare(fn: (tx: Transaction<GenericConfig>) => Promise<void>, options?: {
+    prepare(fn: (tx: Transaction<GenericConfig> & AllExtensions<GenericExtension>) => Promise<void>, options?: {
         label?: string;
     }): Promise<PreparedTransaction<GenericConfig>>;
     undo(): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/document/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAI3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ,CAAC,aAAa,SAAS,iBAAiB;IAC5D,SAAS,CAAC,KAAK,EAAE,KAAK,CAAA;IACtB,SAAS,CAAC,MAAM,EAAE,aAAa,CAAA;IAE/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAO5B;IAED,2DAA2D;IAC3D,OAAO,CAAC,kBAAkB,CAAI;IAE9B;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,CAAkB;gBAErB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa;IAW/C;;OAEG;IACH,SAAS,CAAC,WAAW,IAAI,KAAK,CAAC,aAAa,CAAC;IAI7C,IAAI,KAAK,IAAI,KAAK,CAAC,aAAa,CAAC,CAEhC;IAID;;;OAGG;IACH,SAAS,CAAC,iBAAiB,IAAI,WAAW,CAAC,aAAa,CAAC;IAInD,WAAW,CAAC,CAAC,EAClB,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAClD,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,OAAO,CAAC,CAAC,CAAC;IA6Cb;;;;;;;;;;;;;;;;;;;OAmBG;IACG,OAAO,CACZ,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EACrD,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,OAAO,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAwFxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B,iCAAiC;IACjC,KAAK,IAAI,IAAI;IAIb,wDAAwD;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI9B"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/document/document.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAI3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAE5F;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ,CACpB,aAAa,SAAS,iBAAiB,EACvC,gBAAgB,SAAS,kBAAkB,GAAG,EAAE;IAEhD,SAAS,CAAC,KAAK,EAAE,KAAK,CAAA;IACtB,SAAS,CAAC,MAAM,EAAE,aAAa,CAAA;IAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAkB;IAE7C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAM5B;IAED,2DAA2D;IAC3D,OAAO,CAAC,kBAAkB,CAAI;IAE9B;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,CAAkB;gBAErB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,gBAAgB;IAY9E,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,SAAS,CAAC,WAAW,IAAI,KAAK,CAAC,aAAa,CAAC;IAI7C,IAAI,KAAK,IAAI,KAAK,CAAC,aAAa,CAAC,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAEpE;IAID;;;OAGG;IACH,SAAS,CAAC,iBAAiB,IAAI,WAAW,CAAC,aAAa,CAAC;IAInD,WAAW,CAAC,CAAC,EAClB,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC,gBAAgB,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACpF,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,OAAO,CAAC,CAAC,CAAC;IA0Cb;;;;;;;;;;;;;;;;;;;OAmBG;IACG,OAAO,CACZ,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC,gBAAgB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EACvF,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,OAAO,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAqFxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B,iCAAiC;IACjC,KAAK,IAAI,IAAI;IAIb,wDAAwD;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI9B"}

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

@@ -1,4 +1,4 @@
-export { Query } from './main';
+export { Query } from './query';
 export * from './get';
 export * from './find';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/document/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC9B,cAAc,OAAO,CAAA;AACrB,cAAc,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/document/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,cAAc,OAAO,CAAA;AACrB,cAAc,QAAQ,CAAA"}

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

@@ -0,0 +1,182 @@
+import { Context } from '../types';
+import { FilterAttributes, DescendantsFilter, FindDescendantsReturn } from './find';
+import { GetTreeParams } from './get';
+import { Store } from '../../store';
+import { AnyDialecteConfig, AttributesOf, AttributesValueObjectOf, ElementsOf, FullAttributeObjectOf, TrackedRecord, TreeRecord, Operation, RefOrRecord, RootElementOf } from '../../types';
+/**
+ * Query — query-only access to a dialecte's store.
+ *
+ * Single source of truth for all read operations.
+ * Transaction extends this to overlay staged ops.
+ * Document exposes this via doc.query for direct store reads.
+ *
+ * Subclass in a dialecte (e.g. SclQuery) to add domain-specific queries.
+ */
+export declare class Query<GenericConfig extends AnyDialecteConfig> {
+    protected store: Store;
+    protected dialecteConfig: GenericConfig;
+    constructor(store: Store, dialecteConfig: GenericConfig);
+    /**
+     * Override point for Transaction: returns staged operations to overlay.
+     * Query returns [] — no staged ops. Transaction returns its stagedOperations.
+     */
+    protected getOperations(): Operation<GenericConfig>[];
+    /**
+     * Read-only context passed to record FP functions.
+     * Expose as `protected` so dialecte subclasses (e.g. SclQuery) can call
+     * the same FP functions for domain-specific queries.
+     */
+    protected get context(): Context<GenericConfig>;
+    /**
+     * Get the root element of the document.
+     *
+     * @returns The root record, or `undefined` if the database is empty.
+     *
+     * @example
+     * ```ts
+     * const root = await query.getRoot()
+     * ```
+     */
+    getRoot(): Promise<TrackedRecord<GenericConfig, RootElementOf<GenericConfig>>>;
+    /**
+     * Get a single record by ref, record, or relationship.
+     *
+     * @param refOrRecord - A ref `{ tagName, id }`, or any record/relationship.
+     * @returns The tracked record, or `undefined` if not found.
+     *
+     * @example
+     * ```ts
+     * const ied = await query.getRecord({ tagName: 'IED', id: knownId })
+     * ```
+     */
+    getRecord<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined): Promise<TrackedRecord<GenericConfig, GenericElement> | undefined>;
+    /**
+     * Get multiple records in a single call.
+     *
+     * @param refsOrRecords - Array of refs, records, or relationships.
+     * @returns Array of tracked records (same order, `undefined` for missing).
+     *
+     * @example
+     * ```ts
+     * const [bay1, bay2] = await query.getRecords([ref1, ref2])
+     * ```
+     */
+    getRecords<GenericElement extends ElementsOf<GenericConfig>>(refsOrRecords: (RefOrRecord<GenericConfig, GenericElement> | undefined)[]): Promise<(TrackedRecord<GenericConfig, GenericElement> | undefined)[]>;
+    /**
+     * Get all records of a given tag name.
+     *
+     * @param tagName - The element type to retrieve.
+     * @returns All tracked records matching that tag name.
+     *
+     * @example
+     * ```ts
+     * const ieds = await query.getRecordsByTagName('IED')
+     * ```
+     */
+    getRecordsByTagName<GenericElement extends ElementsOf<GenericConfig>>(tagName: GenericElement): Promise<TrackedRecord<GenericConfig, GenericElement>[]>;
+    /**
+     * Find all descendants of an element, grouped by tag name.
+     *
+     * @param refOrRecord - The ancestor element.
+     * @param filter - Optional filter to restrict which tag names are returned.
+     * @returns Object keyed by tag name, each value an array of tracked records.
+     *
+     * @example
+     * ```ts
+     * const { Bay, VoltageLevel } = await query.findDescendants(substation)
+     * ```
+     */
+    findDescendants<GenericElement extends ElementsOf<GenericConfig>, GenericFilter extends DescendantsFilter<GenericConfig> | undefined = undefined>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, filter?: GenericFilter): Promise<FindDescendantsReturn<GenericConfig, GenericElement, GenericFilter>>;
+    /**
+     * Build a full tree structure from an element down.
+     *
+     * @param refOrRecord - The root of the subtree.
+     * @param options - Optional depth/filter controls.
+     * @returns A tree record with nested children, or `undefined` if not found.
+     *
+     * @example
+     * ```ts
+     * const tree = await query.getTree(bay)
+     * ```
+     */
+    getTree<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, options?: GetTreeParams<GenericConfig, GenericElement>): Promise<TreeRecord<GenericConfig, GenericElement> | undefined>;
+    /**
+     * Get a single attribute value from a record.
+     *
+     * @param refOrRecord - The element to read from.
+     * @param params - Attribute name.
+     * @returns The attribute value, or `''` if absent.
+     *
+     * @example
+     * ```ts
+     * const name = await query.getAttribute(bay, { name: 'name' })
+     * ```
+     */
+    getAttribute<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: {
+        name: AttributesOf<GenericConfig, GenericElement>;
+        fullObject?: false;
+    }): Promise<FullAttributeObjectOf<GenericConfig, GenericElement>['value'] | ''>;
+    /**
+     * Get the full attribute object for a single attribute.
+     *
+     * @param refOrRecord - The element to read from.
+     * @param params - Attribute name and `fullObject: true`.
+     * @returns The full attribute object, or `undefined` if absent.
+     *
+     * @example
+     * ```ts
+     * const fullAttributeObject = await query.getAttribute(bay, { name: 'name', fullObject: true })
+     * ```
+     */
+    getAttribute<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: {
+        name: AttributesOf<GenericConfig, GenericElement>;
+        fullObject: true;
+    }): Promise<FullAttributeObjectOf<GenericConfig, GenericElement> | undefined>;
+    /**
+     * Get all attributes of a record as a destructurable key/value object.
+     *
+     * @param refOrRecord - The element to read from.
+     * @returns A `{ name, desc, ... }` object with attribute names as keys.
+     *
+     * @example
+     * ```ts
+     * const { name, desc } = await query.getAttributes(bay)
+     * ```
+     */
+    getAttributes<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params?: {
+        fullObject?: false;
+    }): Promise<AttributesValueObjectOf<GenericConfig, GenericElement>>;
+    /**
+     * Get all attributes of a record as an array of full attribute objects.
+     *
+     * @param refOrRecord - The element to read from.
+     * @returns An array of full attribute objects.
+     *
+     * @example
+     * ```ts
+     * const fullAttributeObjects = await query.getAttributes(bay, { fullObject: true })
+     * ```
+     */
+    getAttributes<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: {
+        fullObject: true;
+    }): Promise<FullAttributeObjectOf<GenericConfig, GenericElement>[]>;
+    /**
+     * Find records matching specific attribute values.
+     *
+     * @param params - Tag name and attribute filter criteria.
+     * @returns All matching tracked records.
+     *
+     * @example
+     * ```ts
+     * const bays = await query.findByAttributes({
+     *   tagName: 'Bay',
+     *   attributes: { name: 'Q01' },
+     * })
+     * ```
+     */
+    findByAttributes<GenericElement extends ElementsOf<GenericConfig>>(params: {
+        tagName: GenericElement;
+        attributes: FilterAttributes<GenericConfig, GenericElement>;
+    }): Promise<TrackedRecord<GenericConfig, GenericElement>[]>;
+}
+//# sourceMappingURL=query.d.ts.map

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

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

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,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAEzF;;;;GAIG;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,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,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,CAiB3D"}
+{"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,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAa,MAAM,SAAS,CAAA;AAEpG;;;;GAIG;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,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,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,CAiB3D"}

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

@@ -1,4 +1,4 @@
-import { AnyDialecteConfig, ElementsOf, Ref } from '../../../types';
+import { AnyDialecteConfig, ElementsOf, RawRecord, Ref } from '../../../types';
 /**
  * Mapping of source to target refs during cloning operations.
  */
@@ -10,7 +10,7 @@ export type CloneMapping<GenericConfig extends AnyDialecteConfig> = {
  * Result of a deepClone operation.
  */
 export type CloneResult<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>> = {
-    ref: Ref<GenericConfig, GenericElement>;
+    record: RawRecord<GenericConfig, GenericElement>;
     mappings: CloneMapping<GenericConfig>[];
 };
 //# sourceMappingURL=clone.types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"clone.types.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/clone/clone.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAEjE;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,aAAa,SAAS,iBAAiB,IAAI;IACnE,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;IACrD,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;CACrD,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CACtB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,IAC7C;IACH,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,QAAQ,EAAE,YAAY,CAAC,aAAa,CAAC,EAAE,CAAA;CACvC,CAAA"}
+{"version":3,"file":"clone.types.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/clone/clone.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAE5E;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,aAAa,SAAS,iBAAiB,IAAI;IACnE,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;IACrD,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;CACrD,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CACtB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,IAC7C;IACH,MAAM,EAAE,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAChD,QAAQ,EAAE,YAAY,CAAC,aAAa,CAAC,EAAE,CAAA;CACvC,CAAA"}

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

@@ -1,6 +1,6 @@
 import { AddChildParams } from './create.types';
 import { Context } from '../..';
-import { AnyDialecteConfig, ElementsOf, ChildrenOf, Ref } from '../../../types';
+import { AnyDialecteConfig, ElementsOf, ChildrenOf, RawRecord, Ref } from '../../../types';
 /**
  * Fetches parent, builds and stages operations for adding a child.
  * Pushes operations directly to context.stagedOperations.
@@ -10,5 +10,5 @@ export declare function stageAddChild<GenericConfig extends AnyDialecteConfig, G
     context: Context<GenericConfig>;
     parentRef: Ref<GenericConfig, GenericElement>;
     params: AddChildParams<GenericConfig, GenericElement, GenericChildElement>;
-}): Promise<Ref<GenericConfig, GenericChildElement>>;
+}): Promise<RawRecord<GenericConfig, GenericChildElement>>;
 //# sourceMappingURL=create.d.ts.map

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":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAa,GAAG,EAAE,MAAM,SAAS,CAAA;AAExF;;;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,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,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,GAAG,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAoDnD"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/create/create.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAExF;;;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,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,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,CAoDzD"}

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

@@ -1,5 +1,5 @@
 import { Context } from '../..';
-import { AnyDialecteConfig, ElementsOf, ParentsOf, Ref } from '../../../types';
+import { AnyDialecteConfig, ElementsOf, ParentsOf, Ref, RawRecord } from '../../../types';
 /**
  * Stages deletion of a record and all its descendants.
  * Also removes the deleted record from its parent's children list.
@@ -8,5 +8,5 @@ import { AnyDialecteConfig, ElementsOf, ParentsOf, Ref } from '../../../types';
 export declare function stageDelete<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
     context: Context<GenericConfig>;
     ref: Ref<GenericConfig, GenericElement>;
-}): Promise<Ref<GenericConfig, ParentsOf<GenericConfig, GenericElement>>>;
+}): Promise<RawRecord<GenericConfig, ParentsOf<GenericConfig, GenericElement>>>;
 //# sourceMappingURL=delete.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/delete/delete.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,SAAS,EAAiB,GAAG,EAAE,MAAM,SAAS,CAAA;AAE3F;;;;GAIG;AACH,wBAAsB,WAAW,CAChC,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;CACvC,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC,CAqCxE"}
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/delete/delete.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EACX,iBAAiB,EACjB,UAAU,EACV,SAAS,EAET,GAAG,EACH,SAAS,EACT,MAAM,SAAS,CAAA;AAEhB;;;;GAIG;AACH,wBAAsB,WAAW,CAChC,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;CACvC,GAAG,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC,CAqC9E"}

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

@@ -1,3 +1,3 @@
-export { Transaction } from './main';
+export { Transaction } from './transaction';
 export { isTransactionContext } from './guard';
 //# 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,oBAAoB,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/document/transaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA"}

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

@@ -4,7 +4,7 @@ import { CloneResult } from './clone';
 import { AddChildParams } from './create';
 import { UpdateParams } from './update';
 import { Store } from '../../store';
-import { AnyDialecteConfig, AnyRawRecord, ChildrenOf, ElementsOf, Operation, ParentsOf, Ref, RefOrRecord, TreeRecord } from '../../types';
+import { AnyDialecteConfig, AnyRawRecord, ChildrenOf, ElementsOf, Operation, ParentsOf, RawRecord, RefOrRecord, TreeRecord } from '../../types';
 /**
  * Transaction — a scoped unit of work against a document.
  *
@@ -39,23 +39,23 @@ export declare class Transaction<GenericConfig extends AnyDialecteConfig> extend
      *
      * @param parentRefOrRecord - The parent element (ref, record, or relationship). `undefined` for root.
      * @param params - Child tagName, attributes and optional namespace, value, id.
-     * @returns Ref to the created child.
+     * @returns RawRecord of the created child.
      *
      * @example
      * ```ts
-     * const bayRef = await tx.addChild(substation, {
+     * const bayRecord = await tx.addChild(substation, {
      *   tagName: 'VoltageLevel',
      *   attributes: { name: 'VL1' },
      * })
      * ```
      */
-    addChild<GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(parentRefOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: AddChildParams<GenericConfig, GenericElement, GenericChildElement>): Promise<Ref<GenericConfig, GenericChildElement>>;
+    addChild<GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(parentRefOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: AddChildParams<GenericConfig, GenericElement, GenericChildElement>): Promise<RawRecord<GenericConfig, GenericChildElement>>;
     /**
      * Update attributes of an existing element.
      *
      * @param refOrRecord - The element to update (ref, record, or relationship).
      * @param params - New attribute values.
-     * @returns Ref to the updated element.
+     * @returns RawRecord of the updated element.
      *
      * @example
      * ```ts
@@ -64,19 +64,19 @@ export declare class Transaction<GenericConfig extends AnyDialecteConfig> extend
      * })
      * ```
      */
-    update<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: UpdateParams<GenericConfig, GenericElement>): Promise<Ref<GenericConfig, GenericElement>>;
+    update<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: UpdateParams<GenericConfig, GenericElement>): Promise<RawRecord<GenericConfig, GenericElement>>;
     /**
      * Delete an element and its entire subtree.
      *
      * @param refOrRecord - The element to delete (ref, record, or relationship).
-     * @returns Ref to the deleted element's parent.
+     * @returns RawRecord of the deleted element's parent.
      *
      * @example
      * ```ts
-     * const parentRef = await tx.delete(bay)
+     * const parentRecord = await tx.delete(bay)
      * ```
      */
-    delete<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined): Promise<Ref<GenericConfig, ParentsOf<GenericConfig, GenericElement>>>;
+    delete<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined): Promise<RawRecord<GenericConfig, ParentsOf<GenericConfig, GenericElement>>>;
     /**
      * Deep-clone a subtree under a new parent.
      *

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

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

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

@@ -0,0 +1,109 @@
+import { Query } from '../query';
+import { DocumentState, Context } from '../types';
+import { CloneResult } from './clone';
+import { AddChildParams } from './create';
+import { UpdateParams } from './update';
+import { Store } from '../../store';
+import { AnyDialecteConfig, AnyRawRecord, ChildrenOf, ElementsOf, Operation, ParentsOf, RawRecord, RefOrRecord, TreeRecord } from '../../types';
+/**
+ * Transaction — a scoped unit of work against a document.
+ *
+ * Extends Query: queries overlay staged ops on top of store reads
+ * via getOperations() override (the single override point).
+ * Adds mutation methods (addChild, update, delete, deepClone).
+ *
+ * Mutates Document's state directly (loading, progress, history).
+ * No separate transaction state — the UI sees one unified state.
+ *
+ * Lifecycle: created by Document → used in callback → committed by Document → discarded.
+ *
+ * Subclass in a dialecte (e.g. SclTransaction) to add domain-specific mutations.
+ */
+export declare class Transaction<GenericConfig extends AnyDialecteConfig> extends Query<GenericConfig> {
+    protected stagedOperations: Operation<GenericConfig>[];
+    protected documentState: DocumentState;
+    protected recordCache: Map<string, AnyRawRecord>;
+    constructor(store: Store, dialecteConfig: GenericConfig, documentState: DocumentState);
+    /**
+     * Override: returns staged operations so Query's record methods overlay them.
+     */
+    protected getOperations(): Operation<GenericConfig>[];
+    /**
+     * Single context for both reads and writes inside a Transaction.
+     * Overrides Query's cacheless context — adds the transaction-scoped cache
+     * and a mutable stagedOperations array (mutation FP functions push to it).
+     */
+    protected get context(): Context<GenericConfig>;
+    /**
+     * Add a child element to a parent.
+     *
+     * @param parentRefOrRecord - The parent element (ref, record, or relationship). `undefined` for root.
+     * @param params - Child tagName, attributes and optional namespace, value, id.
+     * @returns Ref to the created child.
+     *
+     * @example
+     * ```ts
+     * const bayRef = await tx.addChild(substation, {
+     *   tagName: 'VoltageLevel',
+     *   attributes: { name: 'VL1' },
+     * })
+     * ```
+     */
+    addChild<GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(parentRefOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: AddChildParams<GenericConfig, GenericElement, GenericChildElement>): Promise<RawRecord<GenericConfig, GenericChildElement>>;
+    /**
+     * Update attributes of an existing element.
+     *
+     * @param refOrRecord - The element to update (ref, record, or relationship).
+     * @param params - New attribute values.
+     * @returns Ref to the updated element.
+     *
+     * @example
+     * ```ts
+     * await tx.update(bay, {
+     *   attributes: { name: 'Q02', desc: 'Feeder bay' },
+     * })
+     * ```
+     */
+    update<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: UpdateParams<GenericConfig, GenericElement>): Promise<RawRecord<GenericConfig, GenericElement>>;
+    /**
+     * Delete an element and its entire subtree.
+     *
+     * @param refOrRecord - The element to delete (ref, record, or relationship).
+     * @returns Ref to the deleted element's parent.
+     *
+     * @example
+     * ```ts
+     * const parentRef = await tx.delete(bay)
+     * ```
+     */
+    delete<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined): Promise<RawRecord<GenericConfig, ParentsOf<GenericConfig, GenericElement>>>;
+    /**
+     * Deep-clone a subtree under a new parent.
+     *
+     * @param parentRefOrRecord - The target parent for the clone.
+     * @param record - The tree record to clone (from `getTree`).
+     * @returns The cloned root ref and an ID mapping from old to new.
+     *
+     * @example
+     * ```ts
+     * const tree = await tx.getTree(bay)
+     * const { ref, idMap } = await tx.deepClone(substation, tree)
+     * ```
+     */
+    deepClone<GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(parentRefOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, record: TreeRecord<GenericConfig, GenericChildElement>): Promise<CloneResult<GenericConfig, GenericChildElement>>;
+    /** Returns a read-only view of staged operations (for prepare/preview) */
+    getStagedOperations(): ReadonlyArray<Operation<GenericConfig>>;
+    /** Free staged operations from memory */
+    clearStagedOperations(): void;
+    /** Free cached records from memory */
+    clearRecordCache(): void;
+    /**
+     * Commit all staged operations to the store atomically.
+     * Called by Document.transaction() after user callback completes.
+     *
+     * Updates documentState (loading, progress, lastCommit).
+     * Merges operations by ID to optimize database writes.
+     */
+    commit(): Promise<void>;
+}
+//# sourceMappingURL=transaction.d.ts.map

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

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

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

@@ -1,6 +1,6 @@
 import { UpdateParams } from './update.types';
 import { Context } from '../..';
-import { AnyDialecteConfig, ElementsOf, Ref } from '../../../types';
+import { AnyDialecteConfig, ElementsOf, RawRecord, Ref } from '../../../types';
 /**
  * Merges attribute/value changes onto an existing record.
  * Undefined/null attribute values are stripped (treated as removals).
@@ -11,5 +11,5 @@ export declare function stageUpdate<GenericConfig extends AnyDialecteConfig, Gen
     context: Context<GenericConfig>;
     ref: Ref<GenericConfig, GenericElement>;
     params: UpdateParams<GenericConfig, GenericElement>;
-}): Promise<Ref<GenericConfig, GenericElement>>;
+}): Promise<RawRecord<GenericConfig, GenericElement>>;
 //# sourceMappingURL=update.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/update/update.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAEjE;;;;GAIG;AACH,wBAAsB,WAAW,CAChC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,cAAc,EAAE,aAAa,CAAA;IAC7B,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,MAAM,EAAE,YAAY,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CACnD,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAqC9C"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/update/update.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAE5E;;;;GAIG;AACH,wBAAsB,WAAW,CAChC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,cAAc,EAAE,aAAa,CAAA;IAC7B,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,MAAM,EAAE,YAAY,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CACnD,GAAG,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAqCpD"}

package/dist/document/types.d.ts

@@ -43,18 +43,14 @@ export type TransactionEntry = {
  * Single observable state for a Document.
  * In Vue: reactive(doc.state) makes all fields trigger re-renders.
  *
- * Usage: const { loading, error, activity, progress } = doc.state
+ * Usage: const { loading, error, progress } = doc.state
  */
 export type DocumentState = {
     loading: boolean;
     error: DialecteError | null;
-    /** What's happening right now — drives spinners, toasts */
-    activity: {
-        method: string;
-        message: string;
-    } | null;
-    /** Measurable progress — drives progress bars (deepClone, commit, bulk ops) */
+    /** Drives progress bars and status messages (commit, deepClone, bulk ops) */
     progress: {
+        message: string;
         current: number;
         total: number;
     } | null;