@dialecte/core 0.1.3 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/dist/dialecte/main.d.ts +4 -3
  2. package/dist/dialecte/main.d.ts.map +1 -1
  3. package/dist/document/bind-extensions.d.ts +10 -0
  4. package/dist/document/bind-extensions.d.ts.map +1 -0
  5. package/dist/document/document.d.ts +10 -6
  6. package/dist/document/document.d.ts.map +1 -1
  7. package/dist/document/query/find/ancestor/find-ancestor.d.ts +17 -0
  8. package/dist/document/query/find/ancestor/find-ancestor.d.ts.map +1 -0
  9. package/dist/document/query/find/ancestor/find-ancestor.types.d.ts +6 -0
  10. package/dist/document/query/find/ancestor/find-ancestor.types.d.ts.map +1 -0
  11. package/dist/document/query/find/ancestor/index.d.ts +3 -0
  12. package/dist/document/query/find/ancestor/index.d.ts.map +1 -0
  13. package/dist/document/query/find/index.d.ts +1 -0
  14. package/dist/document/query/find/index.d.ts.map +1 -1
  15. package/dist/document/query/get/record/get-child.d.ts +13 -0
  16. package/dist/document/query/get/record/get-child.d.ts.map +1 -0
  17. package/dist/document/query/get/record/get-children.d.ts +13 -0
  18. package/dist/document/query/get/record/get-children.d.ts.map +1 -0
  19. package/dist/document/query/get/record/get-record.d.ts +2 -2
  20. package/dist/document/query/get/record/get-record.d.ts.map +1 -1
  21. package/dist/document/query/get/record/get-records.d.ts +2 -2
  22. package/dist/document/query/get/record/get-records.d.ts.map +1 -1
  23. package/dist/document/query/get/record/index.d.ts +2 -0
  24. package/dist/document/query/get/record/index.d.ts.map +1 -1
  25. package/dist/document/query/main.d.ts +56 -16
  26. package/dist/document/query/main.d.ts.map +1 -1
  27. package/dist/document/transaction/clone/clone.d.ts.map +1 -1
  28. package/dist/document/transaction/clone/clone.types.d.ts +2 -2
  29. package/dist/document/transaction/clone/clone.types.d.ts.map +1 -1
  30. package/dist/document/transaction/create/create.d.ts +2 -2
  31. package/dist/document/transaction/create/create.d.ts.map +1 -1
  32. package/dist/document/transaction/delete/delete.d.ts +2 -2
  33. package/dist/document/transaction/delete/delete.d.ts.map +1 -1
  34. package/dist/document/transaction/ensure/ensure.d.ts +24 -0
  35. package/dist/document/transaction/ensure/ensure.d.ts.map +1 -0
  36. package/dist/document/transaction/ensure/index.d.ts +2 -0
  37. package/dist/document/transaction/ensure/index.d.ts.map +1 -0
  38. package/dist/document/transaction/main.d.ts +39 -17
  39. package/dist/document/transaction/main.d.ts.map +1 -1
  40. package/dist/document/transaction/update/update.d.ts +2 -2
  41. package/dist/document/transaction/update/update.d.ts.map +1 -1
  42. package/dist/document/types.d.ts +3 -7
  43. package/dist/document/types.d.ts.map +1 -1
  44. package/dist/helpers/guard.d.ts +20 -1
  45. package/dist/helpers/guard.d.ts.map +1 -1
  46. package/dist/helpers/index.d.ts +1 -0
  47. package/dist/helpers/index.d.ts.map +1 -1
  48. package/dist/helpers/merge-extensions.d.ts +13 -0
  49. package/dist/helpers/merge-extensions.d.ts.map +1 -0
  50. package/dist/helpers.js +22 -124
  51. package/dist/{index-ni-jr0mc.js → index-Cl4q6wr5.js} +2384 -2233
  52. package/dist/index.js +26 -23
  53. package/dist/standardizing-27Zk5ECm.js +136 -0
  54. package/dist/{test-fixtures → test}/assert-xml/assert-xml.d.ts +1 -1
  55. package/dist/test/assert-xml/assert-xml.d.ts.map +1 -0
  56. package/dist/test/assert-xml/index.d.ts.map +1 -0
  57. package/dist/test/assert-xml/types.d.ts.map +1 -0
  58. package/dist/test/assert-xml/xpath-parser.d.ts.map +1 -0
  59. package/dist/test/config.d.ts +2109 -0
  60. package/dist/{test-fixtures/test-record.d.ts.map → test/config.d.ts.map} +1 -1
  61. package/dist/test/constant.d.ts.map +1 -0
  62. package/dist/{test-fixtures → test}/create-test-dialecte.d.ts +0 -3
  63. package/dist/test/create-test-dialecte.d.ts.map +1 -0
  64. package/dist/{test-fixtures → test}/generated/constants.generated.d.ts +105 -121
  65. package/dist/test/generated/constants.generated.d.ts.map +1 -0
  66. package/dist/test/generated/definition.generated.d.ts +1901 -0
  67. package/dist/test/generated/definition.generated.d.ts.map +1 -0
  68. package/dist/test/generated/index.d.ts +4 -0
  69. package/dist/test/generated/index.d.ts.map +1 -0
  70. package/dist/{test-fixtures → test}/generated/types.generated.d.ts +52 -53
  71. package/dist/test/generated/types.generated.d.ts.map +1 -0
  72. package/dist/{test-fixtures → test}/index.d.ts +2 -0
  73. package/dist/test/index.d.ts.map +1 -0
  74. package/dist/test/run-test-cases.d.ts +12 -0
  75. package/dist/test/run-test-cases.d.ts.map +1 -0
  76. package/dist/test/run-test-cases.type.d.ts +24 -0
  77. package/dist/test/run-test-cases.type.d.ts.map +1 -0
  78. package/dist/test/test-record.d.ts +16804 -0
  79. package/dist/test/test-record.d.ts.map +1 -0
  80. package/dist/test/test-record.types.d.ts.map +1 -0
  81. package/dist/test.d.ts +1 -1
  82. package/dist/test.js +1494 -12226
  83. package/dist/types/definition.d.ts +67 -50
  84. package/dist/types/definition.d.ts.map +1 -1
  85. package/dist/types/extensions.d.ts +73 -0
  86. package/dist/types/extensions.d.ts.map +1 -0
  87. package/dist/types/index.d.ts +1 -0
  88. package/dist/types/index.d.ts.map +1 -1
  89. package/dist/types/ref.d.ts +0 -1
  90. package/dist/types/ref.d.ts.map +1 -1
  91. package/package.json +2 -1
  92. package/dist/document/query/main.types.d.ts +0 -22
  93. package/dist/document/query/main.types.d.ts.map +0 -1
  94. package/dist/magic-string.es-uPKorP4O.js +0 -663
  95. package/dist/script/generate-test-fixtures.d.ts +0 -16
  96. package/dist/script/generate-test-fixtures.d.ts.map +0 -1
  97. package/dist/test-fixtures/assert-xml/assert-xml.d.ts.map +0 -1
  98. package/dist/test-fixtures/assert-xml/index.d.ts.map +0 -1
  99. package/dist/test-fixtures/assert-xml/types.d.ts.map +0 -1
  100. package/dist/test-fixtures/assert-xml/xpath-parser.d.ts.map +0 -1
  101. package/dist/test-fixtures/config.d.ts +0 -210
  102. package/dist/test-fixtures/config.d.ts.map +0 -1
  103. package/dist/test-fixtures/constant.d.ts.map +0 -1
  104. package/dist/test-fixtures/create-test-dialecte.d.ts.map +0 -1
  105. package/dist/test-fixtures/generated/constants.generated.d.ts.map +0 -1
  106. package/dist/test-fixtures/generated/definition.d.ts +0 -3
  107. package/dist/test-fixtures/generated/definition.d.ts.map +0 -1
  108. package/dist/test-fixtures/generated/index.d.ts +0 -4
  109. package/dist/test-fixtures/generated/index.d.ts.map +0 -1
  110. package/dist/test-fixtures/generated/types.generated.d.ts.map +0 -1
  111. package/dist/test-fixtures/index.d.ts.map +0 -1
  112. package/dist/test-fixtures/test-record.d.ts +0 -1612
  113. package/dist/test-fixtures/test-record.types.d.ts.map +0 -1
  114. /package/dist/{test-fixtures → test}/assert-xml/index.d.ts +0 -0
  115. /package/dist/{test-fixtures → test}/assert-xml/types.d.ts +0 -0
  116. /package/dist/{test-fixtures → test}/assert-xml/xpath-parser.d.ts +0 -0
  117. /package/dist/{test-fixtures → test}/constant.d.ts +0 -0
  118. /package/dist/{test-fixtures → test}/test-record.types.d.ts +0 -0
@@ -1,8 +1,9 @@
1
1
  import { Document } from '../document';
2
2
  import { StorageOptions } from '../store';
3
- import { AnyDialecteConfig } from '../types';
4
- export declare function openDialecteDocument<GenericConfig extends AnyDialecteConfig>(params: {
3
+ import { AnyDialecteConfig, ExtensionsRegistry } from '../types';
4
+ export declare function openDialecteDocument<GenericConfig extends AnyDialecteConfig, GenericExt extends ExtensionsRegistry = {}>(params: {
5
5
  config: GenericConfig;
6
6
  storage: StorageOptions;
7
- }): Document<GenericConfig>;
7
+ extensions?: GenericExt;
8
+ }): Document<GenericConfig, GenericExt>;
8
9
  //# sourceMappingURL=main.d.ts.map
@@ -1 +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"}
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,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"}
@@ -0,0 +1,10 @@
1
+ import { ExtensionMap, QueryExtensionFn, TransactionExtensionFn } from '../types';
2
+ /**
3
+ * Binds an extension map to an instance (Query or Transaction).
4
+ * Each function in the map gets `instance` prepended as its first argument,
5
+ * so the public API signature has that argument stripped.
6
+ *
7
+ * Returns a frozen object of { GroupName: { methodName: boundFn } }.
8
+ */
9
+ export declare function bindExtensions<GenericExtensionsMap extends ExtensionMap<QueryExtensionFn | TransactionExtensionFn>>(extensionMap: GenericExtensionsMap | undefined, instance: unknown): Record<string, Record<string, (...args: unknown[]) => unknown>>;
10
+ //# sourceMappingURL=bind-extensions.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -3,21 +3,23 @@ import { Transaction } from './transaction';
3
3
  import { PreparedTransaction, DocumentState } from './types';
4
4
  import { Store } from '../store';
5
5
  import { AnyDialecteConfig } from '../types/dialecte-config';
6
+ import { AllExtensions, ExtensionsRegistry, QueryExtensions } from '../types/extensions';
6
7
  /**
7
8
  * Document — the public entry point for querying and mutating a dialecte.
8
9
  *
9
10
  * Queries: doc.query.getRoot(), doc.query.findChildren(...), etc.
10
11
  * Mutations: doc.transaction(async (tx) => { tx.addChild(...) })
11
12
  *
12
- * Single observable state: doc.state — loading, error, activity, progress, history.
13
+ * Single observable state: doc.state — loading, error, progress, history.
13
14
  * Transaction mutates this state directly (no separate transaction state).
14
15
  *
15
16
  * Subclass in a dialecte to override createQuery() / createTransaction()
16
17
  * and return domain-specific subclasses (e.g. SclQuery, SclTransaction).
17
18
  */
18
- export declare class Document<GenericConfig extends AnyDialecteConfig> {
19
+ export declare class Document<GenericConfig extends AnyDialecteConfig, GenericExtension extends ExtensionsRegistry = {}> {
19
20
  protected store: Store;
20
21
  protected config: GenericConfig;
22
+ private extensionsRegistry?;
21
23
  readonly state: DocumentState;
22
24
  /** Track concurrent transactions to manage loading flag */
23
25
  private activeTransactions;
@@ -30,18 +32,20 @@ export declare class Document<GenericConfig extends AnyDialecteConfig> {
30
32
  * so no self-filter is needed.
31
33
  */
32
34
  private channel;
33
- constructor(store: Store, config: GenericConfig);
35
+ constructor(store: Store, config: GenericConfig, extensions?: GenericExtension);
36
+ private withQueryExtensions;
37
+ private withAllExtensions;
34
38
  /**
35
39
  * Override in dialecte subclass to return a domain-specific Query.
36
40
  */
37
41
  protected createQuery(): Query<GenericConfig>;
38
- get query(): Query<GenericConfig>;
42
+ get query(): Query<GenericConfig> & QueryExtensions<GenericExtension>;
39
43
  /**
40
44
  * Override in dialecte subclass to return a domain-specific Transaction.
41
45
  * e.g. SclDocument overrides this to return new SclTransaction(...)
42
46
  */
43
47
  protected createTransaction(): Transaction<GenericConfig>;
44
- transaction<T>(fn: (tx: Transaction<GenericConfig>) => Promise<T>, options?: {
48
+ transaction<T>(fn: (tx: Transaction<GenericConfig> & AllExtensions<GenericExtension>) => Promise<T>, options?: {
45
49
  label?: string;
46
50
  }): Promise<T>;
47
51
  /**
@@ -64,7 +68,7 @@ export declare class Document<GenericConfig extends AnyDialecteConfig> {
64
68
  * // or: prepared.discard()
65
69
  * ```
66
70
  */
67
- prepare(fn: (tx: Transaction<GenericConfig>) => Promise<void>, options?: {
71
+ prepare(fn: (tx: Transaction<GenericConfig> & AllExtensions<GenericExtension>) => Promise<void>, options?: {
68
72
  label?: string;
69
73
  }): Promise<PreparedTransaction<GenericConfig>>;
70
74
  undo(): Promise<void>;
@@ -1 +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"}
1
+ {"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"}
@@ -0,0 +1,17 @@
1
+ import { FindAncestorsOptions } from './find-ancestor.types';
2
+ import { Context } from '../../..';
3
+ import { AnyDialecteConfig, ElementsOf, TrackedRecord, Ref } from '../../../../types';
4
+ /**
5
+ * Walk the parent chain from a record upward.
6
+ *
7
+ * Returns ancestors bottom-up: [parent, grandparent, …, root].
8
+ * The starting record is NOT included.
9
+ * When `stopAtTagName` is set, the walk stops after collecting that element (inclusive).
10
+ * When `depth` is set, at most that many ancestors are returned.
11
+ */
12
+ export declare function findAncestors<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
13
+ context: Context<GenericConfig>;
14
+ ref: Ref<GenericConfig, GenericElement>;
15
+ options?: FindAncestorsOptions<GenericConfig>;
16
+ }): Promise<TrackedRecord<GenericConfig, ElementsOf<GenericConfig>>[]>;
17
+ //# sourceMappingURL=find-ancestor.d.ts.map
@@ -0,0 +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,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAChF;;;;;;;GAOG;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,CAwBrE"}
@@ -0,0 +1,6 @@
1
+ import { AnyDialecteConfig, ElementsOf } from '../../../../types';
2
+ export type FindAncestorsOptions<GenericConfig extends AnyDialecteConfig> = {
3
+ depth?: number;
4
+ stopAtTagName?: ElementsOf<GenericConfig>;
5
+ };
6
+ //# sourceMappingURL=find-ancestor.types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"find-ancestor.types.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/ancestor/find-ancestor.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAE5D,MAAM,MAAM,oBAAoB,CAAC,aAAa,SAAS,iBAAiB,IAAI;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,CAAA;CACzC,CAAA"}
@@ -0,0 +1,3 @@
1
+ export { findAncestors } from './find-ancestor';
2
+ export type * from './find-ancestor.types';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/ancestor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,mBAAmB,uBAAuB,CAAA"}
@@ -1,3 +1,4 @@
1
+ export * from './ancestor';
1
2
  export * from './by-attribute';
2
3
  export * from './descendant';
3
4
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/document/query/find/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/document/query/find/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA"}
@@ -0,0 +1,13 @@
1
+ import { Context } from '../../..';
2
+ import { AnyDialecteConfig, ChildrenOf, ElementsOf, TrackedRecord, RefOrRecord } from '../../../../types';
3
+ /**
4
+ * Fetch the first direct child of a parent matching a given tag name.
5
+ *
6
+ * Returns `undefined` when the parent does not exist or has no matching child.
7
+ */
8
+ export declare function getChild<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(params: {
9
+ context: Context<GenericConfig>;
10
+ ref: RefOrRecord<GenericConfig, GenericElement>;
11
+ tagName: GenericChildElement;
12
+ }): Promise<TrackedRecord<GenericConfig, GenericChildElement> | undefined>;
13
+ //# sourceMappingURL=get-child.d.ts.map
@@ -0,0 +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,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEpG;;;;GAIG;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,CAUzE"}
@@ -0,0 +1,13 @@
1
+ import { Context } from '../../..';
2
+ import { AnyDialecteConfig, ChildrenOf, ElementsOf, TrackedRecord, RefOrRecord } from '../../../../types';
3
+ /**
4
+ * Fetch all direct children of a parent matching a given tag name.
5
+ *
6
+ * Returns an empty array when the parent does not exist or has no matching children.
7
+ */
8
+ export declare function getChildren<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(params: {
9
+ context: Context<GenericConfig>;
10
+ ref: RefOrRecord<GenericConfig, GenericElement>;
11
+ tagName: GenericChildElement;
12
+ }): Promise<TrackedRecord<GenericConfig, GenericChildElement>[]>;
13
+ //# sourceMappingURL=get-children.d.ts.map
@@ -0,0 +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,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEpG;;;;GAIG;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,CAe/D"}
@@ -1,5 +1,5 @@
1
1
  import { Context } from '../../..';
2
- import { AnyDialecteConfig, ElementsOf, TrackedRecord, Ref } from '../../../../types';
2
+ import { AnyDialecteConfig, ElementsOf, TrackedRecord, RefOrRecord } from '../../../../types';
3
3
  /**
4
4
  * Fetch a single record by ref.
5
5
  *
@@ -11,6 +11,6 @@ import { AnyDialecteConfig, ElementsOf, TrackedRecord, Ref } from '../../../../t
11
11
  */
12
12
  export declare function getRecord<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
13
13
  context: Context<GenericConfig>;
14
- ref: Ref<GenericConfig, GenericElement>;
14
+ ref: RefOrRecord<GenericConfig, GenericElement>;
15
15
  }): Promise<TrackedRecord<GenericConfig, GenericElement> | undefined>;
16
16
  //# sourceMappingURL=get-record.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"get-record.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/get-record.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAa,aAAa,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAE3F;;;;;;;;GAQG;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,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CACvC,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,CAgDpE"}
1
+ {"version":3,"file":"get-record.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/get-record.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAa,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEnG;;;;;;;;GAQG;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,CAgDpE"}
@@ -1,11 +1,11 @@
1
1
  import { Context } from '../../..';
2
- import { AnyDialecteConfig, ElementsOf, TrackedRecord, Ref } from '../../../../types';
2
+ import { AnyDialecteConfig, ElementsOf, TrackedRecord, RefOrRecord } from '../../../../types';
3
3
  /**
4
4
  * Batch lookup — resolve multiple refs in parallel.
5
5
  * Delegates to getRecord per ref; cache hits avoid redundant store calls.
6
6
  */
7
7
  export declare function getRecords<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
8
8
  context: Context<GenericConfig>;
9
- refs: Ref<GenericConfig, GenericElement>[];
9
+ refs: RefOrRecord<GenericConfig, GenericElement>[];
10
10
  }): Promise<(TrackedRecord<GenericConfig, GenericElement> | undefined)[]>;
11
11
  //# sourceMappingURL=get-records.d.ts.map
@@ -1 +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,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAEhF;;;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,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAA;CAC1C,GAAG,OAAO,CAAC,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,CAGxE"}
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,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAExF;;;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"}
@@ -1,4 +1,6 @@
1
1
  export { getRecord } from './get-record';
2
2
  export { getRecords } from './get-records';
3
3
  export { getRecordsByTagName } from './get-records-by-tagname';
4
+ export { getChild } from './get-child';
5
+ export { getChildren } from './get-children';
4
6
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA"}
@@ -1,8 +1,8 @@
1
1
  import { Context } from '../types';
2
- import { FilterAttributes, DescendantsFilter, FindDescendantsReturn } from './find';
2
+ import { FindAncestorsOptions, FilterAttributes, DescendantsFilter, FindDescendantsReturn } from './find';
3
3
  import { GetTreeParams } from './get';
4
4
  import { Store } from '../../store';
5
- import { AnyDialecteConfig, AttributesOf, AttributesValueObjectOf, ElementsOf, FullAttributeObjectOf, TrackedRecord, TreeRecord, Operation, RefOrRecord, RootElementOf } from '../../types';
5
+ import { AnyDialecteConfig, AttributesOf, AttributesValueObjectOf, ElementsOf, ChildrenOf, FullAttributeObjectOf, TrackedRecord, TreeRecord, Operation, RefOrRecord, RootElementOf } from '../../types';
6
6
  /**
7
7
  * Query — query-only access to a dialecte's store.
8
8
  *
@@ -30,14 +30,14 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
30
30
  /**
31
31
  * Get the root element of the document.
32
32
  *
33
- * @returns The root record, or `undefined` if the database is empty.
33
+ * @returns The root record.
34
34
  *
35
35
  * @example
36
36
  * ```ts
37
37
  * const root = await query.getRoot()
38
38
  * ```
39
39
  */
40
- getRoot(): Promise<TrackedRecord<GenericConfig, RootElementOf<GenericConfig>> | undefined>;
40
+ getRoot(): Promise<TrackedRecord<GenericConfig, RootElementOf<GenericConfig>>>;
41
41
  /**
42
42
  * Get a single record by ref, record, or relationship.
43
43
  *
@@ -46,7 +46,7 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
46
46
  *
47
47
  * @example
48
48
  * ```ts
49
- * const ied = await query.getRecord({ tagName: 'IED', id: knownId })
49
+ * const a = await query.getRecord({ tagName: 'A', id: knownId })
50
50
  * ```
51
51
  */
52
52
  getRecord<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined): Promise<TrackedRecord<GenericConfig, GenericElement> | undefined>;
@@ -58,10 +58,36 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
58
58
  *
59
59
  * @example
60
60
  * ```ts
61
- * const [bay1, bay2] = await query.getRecords([ref1, ref2])
61
+ * const [a1, a2] = await query.getRecords([ref1, ref2])
62
62
  * ```
63
63
  */
64
64
  getRecords<GenericElement extends ElementsOf<GenericConfig>>(refsOrRecords: (RefOrRecord<GenericConfig, GenericElement> | undefined)[]): Promise<(TrackedRecord<GenericConfig, GenericElement> | undefined)[]>;
65
+ /**
66
+ * Get the first direct child of an element matching a given tag name.
67
+ *
68
+ * @param refOrRecord - The parent element.
69
+ * @param tagName - The child element type to look for.
70
+ * @returns The first matching child record, or `undefined` if none.
71
+ *
72
+ * @example
73
+ * ```ts
74
+ * const aa1 = await query.getChild(a, 'AA_1')
75
+ * ```
76
+ */
77
+ getChild<GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, tagName: GenericChildElement): Promise<TrackedRecord<GenericConfig, GenericChildElement> | undefined>;
78
+ /**
79
+ * Get all direct children of an element matching a given tag name.
80
+ *
81
+ * @param refOrRecord - The parent element.
82
+ * @param tagName - The child element type to look for.
83
+ * @returns All matching child records.
84
+ *
85
+ * @example
86
+ * ```ts
87
+ * const children = await query.getChildren(a, 'AA_1')
88
+ * ```
89
+ */
90
+ getChildren<GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, tagName: GenericChildElement): Promise<TrackedRecord<GenericConfig, GenericChildElement>[]>;
65
91
  /**
66
92
  * Get all records of a given tag name.
67
93
  *
@@ -70,7 +96,7 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
70
96
  *
71
97
  * @example
72
98
  * ```ts
73
- * const ieds = await query.getRecordsByTagName('IED')
99
+ * const records = await query.getRecordsByTagName('A')
74
100
  * ```
75
101
  */
76
102
  getRecordsByTagName<GenericElement extends ElementsOf<GenericConfig>>(tagName: GenericElement): Promise<TrackedRecord<GenericConfig, GenericElement>[]>;
@@ -83,10 +109,24 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
83
109
  *
84
110
  * @example
85
111
  * ```ts
86
- * const { Bay, VoltageLevel } = await query.findDescendants(substation)
112
+ * const { AA_1, AA_2 } = await query.findDescendants(a)
87
113
  * ```
88
114
  */
89
115
  findDescendants<GenericElement extends ElementsOf<GenericConfig>, GenericFilter extends DescendantsFilter<GenericConfig> | undefined = undefined>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, filter?: GenericFilter): Promise<FindDescendantsReturn<GenericConfig, GenericElement, GenericFilter>>;
116
+ /**
117
+ * Walk the parent chain from an element upward.
118
+ *
119
+ * @param refOrRecord - The starting element (not included in results).
120
+ * @param options - Optional depth limit or stop-at tag name.
121
+ * @returns Ancestors bottom-up: [parent, grandparent, …, root]. Stop element is included.
122
+ *
123
+ * @example
124
+ * ```ts
125
+ * const ancestors = await query.findAncestors(aa1)
126
+ * // [A, Root]
127
+ * ```
128
+ */
129
+ findAncestors<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, options?: FindAncestorsOptions<GenericConfig>): Promise<TrackedRecord<GenericConfig, ElementsOf<GenericConfig>>[]>;
90
130
  /**
91
131
  * Build a full tree structure from an element down.
92
132
  *
@@ -96,7 +136,7 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
96
136
  *
97
137
  * @example
98
138
  * ```ts
99
- * const tree = await query.getTree(bay)
139
+ * const tree = await query.getTree(a)
100
140
  * ```
101
141
  */
102
142
  getTree<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, options?: GetTreeParams<GenericConfig, GenericElement>): Promise<TreeRecord<GenericConfig, GenericElement> | undefined>;
@@ -109,7 +149,7 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
109
149
  *
110
150
  * @example
111
151
  * ```ts
112
- * const name = await query.getAttribute(bay, { name: 'name' })
152
+ * const val = await query.getAttribute(a, { name: 'aA' })
113
153
  * ```
114
154
  */
115
155
  getAttribute<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: {
@@ -125,7 +165,7 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
125
165
  *
126
166
  * @example
127
167
  * ```ts
128
- * const fullAttributeObject = await query.getAttribute(bay, { name: 'name', fullObject: true })
168
+ * const fullAttributeObject = await query.getAttribute(a, { name: 'aA', fullObject: true })
129
169
  * ```
130
170
  */
131
171
  getAttribute<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: {
@@ -140,7 +180,7 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
140
180
  *
141
181
  * @example
142
182
  * ```ts
143
- * const { name, desc } = await query.getAttributes(bay)
183
+ * const { aA } = await query.getAttributes(a)
144
184
  * ```
145
185
  */
146
186
  getAttributes<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params?: {
@@ -154,7 +194,7 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
154
194
  *
155
195
  * @example
156
196
  * ```ts
157
- * const fullAttributeObjects = await query.getAttributes(bay, { fullObject: true })
197
+ * const fullAttributeObjects = await query.getAttributes(a, { fullObject: true })
158
198
  * ```
159
199
  */
160
200
  getAttributes<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: {
@@ -168,9 +208,9 @@ export declare class Query<GenericConfig extends AnyDialecteConfig> {
168
208
  *
169
209
  * @example
170
210
  * ```ts
171
- * const bays = await query.findByAttributes({
172
- * tagName: 'Bay',
173
- * attributes: { name: 'Q01' },
211
+ * const records = await query.findByAttributes({
212
+ * tagName: 'A',
213
+ * attributes: { aA: 'val' },
174
214
  * })
175
215
  * ```
176
216
  */
@@ -1 +1 @@
1
- {"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/document/query/main.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAA;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EACX,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,qBAAqB,EACrB,aAAa,EACb,UAAU,EACV,SAAS,EAET,WAAW,EACX,aAAa,EACb,MAAM,SAAS,CAAA;AAEhB;;;;;;;;GAQG;AACH,qBAAa,KAAK,CAAC,aAAa,SAAS,iBAAiB;IACzD,SAAS,CAAC,KAAK,EAAE,KAAK,CAAA;IACtB,SAAS,CAAC,cAAc,EAAE,aAAa,CAAA;gBAE3B,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa;IAOvD;;;OAGG;IACH,SAAS,CAAC,aAAa,IAAI,SAAS,CAAC,aAAa,CAAC,EAAE;IAIrD;;;;OAIG;IACH,SAAS,KAAK,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAM9C;IAID;;;;;;;;;OASG;IACG,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,GAAG,SAAS,CAAC;IAUhG;;;;;;;;;;OAUG;IACG,SAAS,CAAC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/D,WAAW,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,GACjE,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;IAIpE;;;;;;;;;;OAUG;IACG,UAAU,CAAC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChE,aAAa,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,EAAE,GACvE,OAAO,CAAC,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;IAKxE;;;;;;;;;;OAUG;IACG,mBAAmB,CAAC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EACzE,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC;IAI1D;;;;;;;;;;;OAWG;IACG,eAAe,CACpB,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,aAAa,SAAS,iBAAiB,CAAC,aAAa,CAAC,GAAG,SAAS,GAAG,SAAS,EAE9E,WAAW,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,EACnE,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,qBAAqB,CAAC,aAAa,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IAS/E;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC7D,WAAW,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,EACnE,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GACpD,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;IAMjE;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAClE,WAAW,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,EACnE,MAAM,EAAE;QAAE,IAAI,EAAE,YAAY,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,KAAK,CAAA;KAAE,GAC/E,OAAO,CAAC,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9E;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAClE,WAAW,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,EACnE,MAAM,EAAE;QAAE,IAAI,EAAE,YAAY,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAAC,UAAU,EAAE,IAAI,CAAA;KAAE,GAC7E,OAAO,CAAC,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;IAkB5E;;;;;;;;;;OAUG;IACG,aAAa,CAAC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EACnE,WAAW,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,EACnE,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,KAAK,CAAA;KAAE,GAC7B,OAAO,CAAC,uBAAuB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAClE;;;;;;;;;;OAUG;IACG,aAAa,CAAC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EACnE,WAAW,EAAE,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,EACnE,MAAM,EAAE;QAAE,UAAU,EAAE,IAAI,CAAA;KAAE,GAC1B,OAAO,CAAC,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC;IAiBlE;;;;;;;;;;;;;OAaG;IACG,gBAAgB,CAAC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE;QAChF,OAAO,EAAE,cAAc,CAAA;QACvB,UAAU,EAAE,gBAAgB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;KAC3D,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC;CAG3D"}
1
+ {"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/document/query/main.ts"],"names":[],"mappings":"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"}
@@ -1 +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"}
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,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"}
@@ -1,4 +1,4 @@
1
- import { AnyDialecteConfig, ElementsOf, Ref } from '../../../types';
1
+ import { AnyDialecteConfig, ElementsOf, RawRecord, Ref } from '../../../types';
2
2
  /**
3
3
  * Mapping of source to target refs during cloning operations.
4
4
  */
@@ -10,7 +10,7 @@ export type CloneMapping<GenericConfig extends AnyDialecteConfig> = {
10
10
  * Result of a deepClone operation.
11
11
  */
12
12
  export type CloneResult<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>> = {
13
- ref: Ref<GenericConfig, GenericElement>;
13
+ record: RawRecord<GenericConfig, GenericElement>;
14
14
  mappings: CloneMapping<GenericConfig>[];
15
15
  };
16
16
  //# sourceMappingURL=clone.types.d.ts.map
@@ -1 +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"}
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,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"}
@@ -1,6 +1,6 @@
1
1
  import { AddChildParams } from './create.types';
2
2
  import { Context } from '../..';
3
- import { AnyDialecteConfig, ElementsOf, ChildrenOf, Ref } from '../../../types';
3
+ import { AnyDialecteConfig, ElementsOf, ChildrenOf, RawRecord, Ref } from '../../../types';
4
4
  /**
5
5
  * Fetches parent, builds and stages operations for adding a child.
6
6
  * Pushes operations directly to context.stagedOperations.
@@ -10,5 +10,5 @@ export declare function stageAddChild<GenericConfig extends AnyDialecteConfig, G
10
10
  context: Context<GenericConfig>;
11
11
  parentRef: Ref<GenericConfig, GenericElement>;
12
12
  params: AddChildParams<GenericConfig, GenericElement, GenericChildElement>;
13
- }): Promise<Ref<GenericConfig, GenericChildElement>>;
13
+ }): Promise<RawRecord<GenericConfig, GenericChildElement>>;
14
14
  //# sourceMappingURL=create.d.ts.map
@@ -1 +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"}
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,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"}
@@ -1,5 +1,5 @@
1
1
  import { Context } from '../..';
2
- import { AnyDialecteConfig, ElementsOf, ParentsOf, Ref } from '../../../types';
2
+ import { AnyDialecteConfig, ElementsOf, ParentsOf, Ref, RawRecord } from '../../../types';
3
3
  /**
4
4
  * Stages deletion of a record and all its descendants.
5
5
  * Also removes the deleted record from its parent's children list.
@@ -8,5 +8,5 @@ import { AnyDialecteConfig, ElementsOf, ParentsOf, Ref } from '../../../types';
8
8
  export declare function stageDelete<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
9
9
  context: Context<GenericConfig>;
10
10
  ref: Ref<GenericConfig, GenericElement>;
11
- }): Promise<Ref<GenericConfig, ParentsOf<GenericConfig, GenericElement>>>;
11
+ }): Promise<RawRecord<GenericConfig, ParentsOf<GenericConfig, GenericElement>>>;
12
12
  //# sourceMappingURL=delete.d.ts.map
@@ -1 +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"}
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,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"}
@@ -0,0 +1,24 @@
1
+ import { AddChildParams } from '../create/create.types';
2
+ import { Context } from '../..';
3
+ import { AnyDialecteConfig, ElementsOf, ChildrenOf, RawRecord, TrackedRecord, Ref } from '../../../types';
4
+ /**
5
+ * Get an existing child record or create it under the given parent.
6
+ *
7
+ * Lookup strategy (in order):
8
+ * 1. Non-empty attributes → findByAttributes, returns first match.
9
+ * 2. No attributes → getRecord (by id if present, by tagName alone for singletons).
10
+ * 3. No match → creates.
11
+ *
12
+ * @example
13
+ * // singleton
14
+ * const a = await stageEnsureChild({ ..., params: { tagName: 'A', attributes: {} } })
15
+ * // by attributes
16
+ * const aa1 = await stageEnsureChild({ ..., params: { tagName: 'AA_1', attributes: { aAA_1: 'foo' } } })
17
+ */
18
+ export declare function stageEnsureChild<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(params: {
19
+ dialecteConfig: GenericConfig;
20
+ context: Context<GenericConfig>;
21
+ parentRef: Ref<GenericConfig, GenericElement>;
22
+ params: AddChildParams<GenericConfig, GenericElement, GenericChildElement>;
23
+ }): Promise<TrackedRecord<GenericConfig, GenericChildElement> | RawRecord<GenericConfig, GenericChildElement>>;
24
+ //# sourceMappingURL=ensure.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ensure.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/ensure/ensure.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,YAAY,CAAA;AAC3D,OAAO,KAAK,EACX,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,GAAG,EACH,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACrC,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,CACV,aAAa,CAAC,aAAa,EAAE,mBAAmB,CAAC,GAAG,SAAS,CAAC,aAAa,EAAE,mBAAmB,CAAC,CACjG,CA2BA"}
@@ -0,0 +1,2 @@
1
+ export { stageEnsureChild } from './ensure';
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/ensure/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA"}