@dialecte/core 0.1.3 → 0.1.5

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.
  *
@@ -12,7 +12,7 @@ import { AnyDialecteConfig, AnyRawRecord, ChildrenOf, ElementsOf, Operation, Par
  * via getOperations() override (the single override point).
  * Adds mutation methods (addChild, update, delete, deepClone).
  *
- * Mutates Document's state directly (activity, progress, history).
+ * 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.
@@ -39,54 +39,76 @@ 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, {
-     *   tagName: 'VoltageLevel',
-     *   attributes: { name: 'VL1' },
+     * const aRecord = await tx.addChild(root, {
+     *   tagName: 'A',
+     *   attributes: { name: 'aA1' },
      * })
      * ```
      */
-    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>>;
+    /**
+     * Get an existing child record or create it under the given parent.
+     *
+     * Lookup strategy:
+     * - Singleton child (id absent in params): resolves by tagName.
+     * - Non-singleton child (id present in params): resolves by tagName + id.
+     * - Non-singleton child without id: no lookup, always creates.
+     *
+     * @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 existing or created child.
+     *
+     * @example
+     * ```ts
+     * const aRef = await tx.ensureChild(root, {
+     *   tagName: 'A',
+     *   attributes: {},
+     * })
+     * ```
+     * If A already exists under root, returns its ref. Otherwise, creates it and returns the new ref.
+     */
+    ensureChild<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
-     * await tx.update(bay, {
-     *   attributes: { name: 'Q02', desc: 'Feeder bay' },
+     * await tx.update(root, {
+     *   attributes: { name: 'aA1', desc: 'new element' },
      * })
      * ```
      */
-    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(aRecord)
      * ```
      */
-    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.
      *
      * @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.
+     * @returns The cloned root raw record and an ID mapping from old to new.
      *
      * @example
      * ```ts
-     * const tree = await tx.getTree(bay)
+     * const tree = await tx.getTree(aRecord)
      * const { ref, idMap } = await tx.deepClone(substation, tree)
      * ```
      */
@@ -101,7 +123,7 @@ export declare class Transaction<GenericConfig extends AnyDialecteConfig> extend
      * Commit all staged operations to the store atomically.
      * Called by Document.transaction() after user callback completes.
      *
-     * Updates documentState (activity, progress, lastCommit).
+     * Updates documentState (loading, progress, lastCommit).
      * Merges operations by ID to optimize database writes.
      */
     commit(): Promise<void>;

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/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;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/document/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEzE;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,CAAC,aAAa,SAAS,iBAAiB,IAAI;IAC9D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS,CAAA;IAC3D,gBAAgB,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE,CAAA;CAC5C,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,aAAa,SAAS,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG;IAC7F,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAC/C,CAAA;AAID,MAAM,MAAM,mBAAmB,CAAC,aAAa,SAAS,iBAAiB,IAAI;IAC1E,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAA;IAC5D,QAAQ,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IACvE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,OAAO,IAAI,IAAI,CAAA;CACf,CAAA;AAID,MAAM,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CACrC,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;IAE3B,2DAA2D;IAC3D,QAAQ,EAAE;QACT,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,MAAM,CAAA;KACf,GAAG,IAAI,CAAA;IAER,+EAA+E;IAC/E,QAAQ,EAAE;QACT,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,EAAE,MAAM,CAAA;KACb,GAAG,IAAI,CAAA;IAER,4DAA4D;IAC5D,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAE3B;;;;OAIG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/document/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEzE;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,CAAC,aAAa,SAAS,iBAAiB,IAAI;IAC9D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS,CAAA;IAC3D,gBAAgB,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE,CAAA;CAC5C,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,aAAa,SAAS,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG;IAC7F,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAC/C,CAAA;AAID,MAAM,MAAM,mBAAmB,CAAC,aAAa,SAAS,iBAAiB,IAAI;IAC1E,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAA;IAC5D,QAAQ,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IACvE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,OAAO,IAAI,IAAI,CAAA;CACf,CAAA;AAID,MAAM,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CACrC,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;IAE3B,6EAA6E;IAC7E,QAAQ,EAAE;QACT,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,EAAE,MAAM,CAAA;KACb,GAAG,IAAI,CAAA;IAER,4DAA4D;IAC5D,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAE3B;;;;OAIG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,CAAA"}

package/dist/helpers/guard.d.ts

@@ -1,4 +1,4 @@
-import { RawRecord, TrackedRecord, AnyDialecteConfig, ElementsOf, FullAttributeObjectOf, AttributesValueObjectOf, TreeRecord } from '../types';
+import { RawRecord, TrackedRecord, AnyDialecteConfig, ElementsOf, FullAttributeObjectOf, AttributesValueObjectOf, TreeRecord, AnyRelationship } from '../types';
 /**
  * Type guard to check if attributes are in array format (FullAttributeObject[])
  */
@@ -18,4 +18,23 @@ export declare function isTreeRecord<GenericConfig extends AnyDialecteConfig, Ge
 export declare function isRecordOf<GenericConfig extends AnyDialecteConfig, GenericTagName extends ElementsOf<GenericConfig>>(record: TreeRecord<GenericConfig, ElementsOf<GenericConfig>>, tagName: GenericTagName): record is TreeRecord<GenericConfig, GenericTagName>;
 export declare function isRecordOf<GenericConfig extends AnyDialecteConfig, GenericTagName extends ElementsOf<GenericConfig>>(record: TrackedRecord<GenericConfig, ElementsOf<GenericConfig>>, tagName: GenericTagName): record is TrackedRecord<GenericConfig, GenericTagName>;
 export declare function isRecordOf<GenericConfig extends AnyDialecteConfig, GenericTagName extends ElementsOf<GenericConfig>>(record: RawRecord<GenericConfig, ElementsOf<GenericConfig>>, tagName: GenericTagName): record is RawRecord<GenericConfig, GenericTagName>;
+/**
+ * Type predicate narrowing a relationship to a specific tag name.
+ *
+ * @example
+ * const aa1Refs = recordA.children.filter((child) => isChildOf(child, 'AA_1'))
+ * const aa1Elements = await query.getRecords(aa1Refs) // TrackedRecord<Config, 'AA_1'>[]
+ */
+export declare function isChildOf<T extends string>(child: AnyRelationship, tagName: T): child is AnyRelationship & {
+    tagName: T;
+};
+/**
+ * Type predicate narrowing a parent relationship to a specific tag name.
+ *
+ * @example
+ * if (record.parent && isParentOf(record.parent, 'Root')) { ... }
+ */
+export declare function isParentOf<T extends string>(parent: AnyRelationship, tagName: T): parent is AnyRelationship & {
+    tagName: T;
+};
 //# sourceMappingURL=guard.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/helpers/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,UAAU,EAIV,MAAM,SAAS,CAAA;AAkChB;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAEhD,UAAU,EACP,uBAAuB,CAAC,aAAa,EAAE,cAAc,CAAC,GACtD,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,GACvD,UAAU,IAAI,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAEtE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAC1B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAErE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAEhD,MAAM,EACH,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,GACxC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAC5C,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,GAC1C,MAAM,IAAI,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAExD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC3B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAEhD,MAAM,EACH,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,GACxC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAC5C,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,GAC1C,MAAM,IAAI,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAErD;AAED,wBAAgB,UAAU,CACzB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAEhD,MAAM,EAAE,UAAU,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,EAC5D,OAAO,EAAE,cAAc,GACrB,MAAM,IAAI,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;AACtD,wBAAgB,UAAU,CACzB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAEhD,MAAM,EAAE,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,EAC/D,OAAO,EAAE,cAAc,GACrB,MAAM,IAAI,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;AACzD,wBAAgB,UAAU,CACzB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAEhD,MAAM,EAAE,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,EAC3D,OAAO,EAAE,cAAc,GACrB,MAAM,IAAI,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA"}
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/helpers/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,UAAU,EAIV,eAAe,EACf,MAAM,SAAS,CAAA;AAkChB;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAEhD,UAAU,EACP,uBAAuB,CAAC,aAAa,EAAE,cAAc,CAAC,GACtD,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,GACvD,UAAU,IAAI,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAEtE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAC1B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAErE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAEhD,MAAM,EACH,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,GACxC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAC5C,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,GAC1C,MAAM,IAAI,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAExD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC3B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAEhD,MAAM,EACH,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,GACxC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAC5C,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,GAC1C,MAAM,IAAI,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAErD;AAED,wBAAgB,UAAU,CACzB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAEhD,MAAM,EAAE,UAAU,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,EAC5D,OAAO,EAAE,cAAc,GACrB,MAAM,IAAI,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;AACtD,wBAAgB,UAAU,CACzB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAEhD,MAAM,EAAE,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,EAC/D,OAAO,EAAE,cAAc,GACrB,MAAM,IAAI,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;AACzD,wBAAgB,UAAU,CACzB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAEhD,MAAM,EAAE,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,EAC3D,OAAO,EAAE,cAAc,GACrB,MAAM,IAAI,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;AAQrD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EACzC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,CAAC,GACR,KAAK,IAAI,eAAe,GAAG;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAE3C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAC1C,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,CAAC,GACR,MAAM,IAAI,eAAe,GAAG;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAE5C"}

package/dist/helpers/index.d.ts

@@ -2,4 +2,5 @@ export * from './constant';
 export * from './guard';
 export * from './converter';
 export * from './standardizing';
+export * from './merge-extensions';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/helpers/merge-extensions.d.ts

@@ -0,0 +1,13 @@
+import { ExtensionModules, MergedExtensions } from '../types/extensions';
+/**
+ * Merges named extension modules into the flat { query, transaction } registry
+ * expected by openDialecteDocument.
+ *
+ * @example
+ * ```ts
+ * export const EXTENSIONS = mergeExtensions({ History, IED })
+ * // → { query: { History: ..., IED: ... }, transaction: { History: ..., IED: ... } }
+ * ```
+ */
+export declare function mergeExtensions<Modules extends ExtensionModules>(modules: Modules): MergedExtensions<Modules>;
+//# sourceMappingURL=merge-extensions.d.ts.map

package/dist/helpers/merge-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-extensions.d.ts","sourceRoot":"","sources":["../../src/helpers/merge-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE5E;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,SAAS,gBAAgB,EAC/D,OAAO,EAAE,OAAO,GACd,gBAAgB,CAAC,OAAO,CAAC,CAU3B"}

package/dist/helpers.js

@@ -1,128 +1,26 @@
-import { a as g } from "./index-CqwLClK7.js";
-const h = "db-id", C = {
-  uri: "http://dialecte.dev/XML/DEV",
-  prefix: "dev"
-}, z = `${C.prefix}:${h}`, R = [
-  "id",
-  "tagName",
-  "namespace",
-  "attributes",
-  "children",
-  "parent",
-  "value"
-], m = [...R, "status"], S = [...m, "tree"];
-function u(e, t) {
-  if (typeof e != "object" || e === null)
-    return !1;
-  const a = Object.keys(e);
-  return t.every((n) => n in e) && a.every((n) => t.includes(n)) && a.length === t.length;
-}
-function y(e) {
-  return Array.isArray(e);
-}
-function F(e) {
-  return u(e, R);
-}
-function K(e) {
-  return u(e, m);
-}
-function j(e) {
-  return u(e, S);
-}
-function V(e, t) {
-  return e.tagName === t;
-}
-function O(e) {
-  return {
-    id: e.id,
-    tagName: e.tagName,
-    namespace: e.namespace,
-    attributes: e.attributes,
-    value: e.value,
-    parent: e.parent,
-    children: e.children
-  };
-}
-function I(e) {
-  const { record: t, status: a } = e, n = a ?? ("status" in t ? t.status : "unchanged");
-  return {
-    ...O(t),
-    status: n
-  };
-}
-function Y(e) {
-  const { record: t, status: a, tree: n } = e, r = n ?? ("tree" in t ? t.tree : []);
-  return {
-    ...I({ record: t, status: a }),
-    tree: r
-  };
-}
-function x(e) {
-  const { dialecteConfig: t, tagName: a, attributes: n } = e;
-  return y(n) ? n : Object.entries(n).map(
-    ([r, s]) => ({
-      name: r,
-      value: s,
-      namespace: t.definition[a]?.attributes.details[r]?.namespace || void 0
-    })
-  );
-}
-function w(e) {
-  return g(e, {
-    detail: "The record or ref is undefined"
-  }), {
-    id: e.id,
-    tagName: e.tagName
-  };
-}
-function B(e) {
-  const { dialecteConfig: t, record: a } = e, { id: n, tagName: r, attributes: s, namespace: E, value: A } = a, b = n ?? crypto.randomUUID(), c = s ? x({ tagName: r, attributes: s, dialecteConfig: t }) : [], l = {
-    id: b,
-    tagName: r,
-    attributes: c,
-    namespace: E ?? {
-      prefix: "prefixNeededForNotSupportedNamespace",
-      uri: "uriNeededForNotSupportedNamespace"
-    },
-    value: A ?? "",
-    parent: a.parent ?? null,
-    children: a.children ?? []
-  };
-  if (!t.elements.includes(r)) return l;
-  const f = t.definition[r].attributes.sequence, o = t.definition[r].attributes.details, T = f.flatMap((i) => {
-    const _ = o[i].required, D = o[i]?.namespace || void 0, p = c.find((N) => N.name === i)?.value || (_ ? o[i]?.default || "" : void 0);
-    return p === void 0 ? [] : [
-      {
-        name: i,
-        value: p,
-        namespace: D
-      }
-    ];
-  }), v = c.filter(
-    (i) => "namespace" in i && i.namespace != null && !f.includes(i.name)
-  );
-  let d = {
-    ...l,
-    namespace: t.definition[r].namespace,
-    attributes: [...T, ...v]
-  };
-  return t.hooks?.afterStandardizedRecord && (d = t.hooks.afterStandardizedRecord({
-    record: d
-  })), d;
+import { C as n, a as R, D as d, i as T, b as f, c as E, d as A, e as u, f as _, g as C, s as O, t as D, h as l, j as y, k as I, l as b } from "./standardizing-27Zk5ECm.js";
+function o(t) {
+  const s = {}, e = {};
+  for (const [a, r] of Object.entries(t))
+    r.query && (s[a] = r.query), r.transaction && (e[a] = r.transaction);
+  return { query: s, transaction: e };
 }
 export {
-  z as CUSTOM_RECORD_ID_ATTRIBUTE,
-  h as CUSTOM_RECORD_ID_ATTRIBUTE_NAME,
-  C as DIALECTE_DEV_NAMESPACE,
-  y as isFullAttributeArray,
-  F as isRawRecord,
-  V as isRecordOf,
-  K as isTrackedRecord,
-  j as isTreeRecord,
-  B as standardizeRecord,
-  x as toFullAttributeArray,
-  O as toRawRecord,
-  w as toRef,
+  n as CUSTOM_RECORD_ID_ATTRIBUTE,
+  R as CUSTOM_RECORD_ID_ATTRIBUTE_NAME,
+  d as DIALECTE_DEV_NAMESPACE,
+  T as isChildOf,
+  f as isFullAttributeArray,
+  E as isParentOf,
+  A as isRawRecord,
+  u as isRecordOf,
+  _ as isTrackedRecord,
+  C as isTreeRecord,
+  o as mergeExtensions,
+  O as standardizeRecord,
+  D as toFullAttributeArray,
+  l as toRawRecord,
+  y as toRef,
   I as toTrackedRecord,
-  Y as toTreeRecord
+  b as toTreeRecord
 };