@dialecte/core 0.0.20 → 0.1.0

package/dist/dialecte/index.d.ts

@@ -1,4 +1,2 @@
 export * from './main';
-export * from './state';
-export type * from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dialecte/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,mBAAmB,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dialecte/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA"}

package/dist/dialecte/main.d.ts

@@ -1,8 +1,8 @@
-import { DialecteCore } from './types';
-import { AnyDialecteConfig, ExtensionRegistry } from '../types';
-export declare function createDialecte<GenericConfig extends AnyDialecteConfig, GenericExtensionRegistry extends ExtensionRegistry<GenericConfig>>(params: {
-    databaseName: string;
-    dialecteConfig: GenericConfig;
-    extensions: GenericExtensionRegistry;
-}): DialecteCore<GenericConfig, GenericExtensionRegistry>;
+import { Document } from '../document';
+import { StorageOptions } from '../store';
+import { AnyDialecteConfig } from '../types';
+export declare function openDialecteDocument<GenericConfig extends AnyDialecteConfig>(params: {
+    config: GenericConfig;
+    storage: StorageOptions;
+}): Document<GenericConfig>;
 //# 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":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,SAAS,CAAA;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAc,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE/E,wBAAgB,cAAc,CAC7B,aAAa,SAAS,iBAAiB,EACvC,wBAAwB,SAAS,iBAAiB,CAAC,aAAa,CAAC,EAChE,MAAM,EAAE;IACT,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,aAAa,CAAA;IAC7B,UAAU,EAAE,wBAAwB,CAAA;CACpC,GAAG,YAAY,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAwBxD"}
+{"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"}

package/dist/document/document.d.ts

@@ -0,0 +1,77 @@
+import { Query } from './query';
+import { Transaction } from './transaction';
+import { PreparedTransaction, DocumentState } from './types';
+import { Store } from '../store';
+import { AnyDialecteConfig } from '../types/dialecte-config';
+/**
+ * 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.
+ * 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> {
+    protected store: Store;
+    protected config: GenericConfig;
+    readonly state: DocumentState;
+    /** Track concurrent transactions to manage loading flag */
+    private activeTransactions;
+    /**
+     * BroadcastChannel scoped to this database.
+     * Receives update events from other Document instances (other extensions)
+     * targeting the same database, keeping state.lastUpdate in sync.
+     *
+     * BroadcastChannel does not deliver messages back to the sender,
+     * so no self-filter is needed.
+     */
+    private channel;
+    constructor(store: Store, config: GenericConfig);
+    /**
+     * Override in dialecte subclass to return a domain-specific Query.
+     */
+    protected createQuery(): Query<GenericConfig>;
+    get query(): Query<GenericConfig>;
+    /**
+     * 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?: {
+        label?: string;
+    }): Promise<T>;
+    /**
+     * Build up operations without committing.
+     * Returns a PreparedTransaction with staged operations for preview,
+     * then call commit() to apply or discard() to throw away.
+     *
+     * @example
+     * ```ts
+     * const prepared = await doc.prepare(async (tx) => {
+     *   tx.addChild(parent, { tagName: 'Function', attributes: { ... } })
+     *   tx.deepClone(parent, tree)
+     * })
+     *
+     * // Show preview in UI
+     * renderDiff(prepared.operations, prepared.summary)
+     *
+     * // User confirms
+     * await prepared.commit()
+     * // or: prepared.discard()
+     * ```
+     */
+    prepare(fn: (tx: Transaction<GenericConfig>) => Promise<void>, options?: {
+        label?: string;
+    }): Promise<PreparedTransaction<GenericConfig>>;
+    undo(): Promise<void>;
+    redo(): Promise<void>;
+    /** Close the store connection */
+    close(): void;
+    /** Close connection and delete the database entirely */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=document.d.ts.map

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

@@ -0,0 +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;IA+Cb;;;;;;;;;;;;;;;;;;;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;IA0FxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB3B,iCAAiC;IACjC,KAAK,IAAI,IAAI;IAIb,wDAAwD;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI9B"}

package/dist/document/index.d.ts

@@ -0,0 +1,5 @@
+export { Document } from './document';
+export * from './query';
+export * from './transaction';
+export type { Context, CachedContext, PreparedTransaction, DocumentState, TransactionEntry, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAE7B,YAAY,EACX,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,gBAAgB,GAChB,MAAM,SAAS,CAAA"}

package/dist/{helpers/record/query → document/query/find/by-attribute}/find-by-attributes.d.ts

@@ -1,18 +1,15 @@
-import { FilterAttributes } from './types';
-import { DatabaseInstance } from '../../../database';
-import { AnyDialecteConfig, Context, ChainRecord, ElementsOf, RawRecord } from '../../../types';
+import { Context, FilterAttributes } from '../../..';
+import { AnyDialecteConfig, TrackedRecord, ElementsOf } from '../../../../types';
 /**
  * Find elements by tagName and attributes.
  * Core primitive for all query operations.
  * Returns all records matching tagName and attributes - no scope filtering.
  */
 export declare function findByAttributes<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
-    context: Context<GenericConfig, ElementsOf<GenericConfig>>;
-    dialecteConfig: GenericConfig;
-    databaseInstance: DatabaseInstance<GenericConfig>;
+    context: Context<GenericConfig>;
     tagName: GenericElement;
-    attributes?: FilterAttributes<GenericConfig, GenericElement>;
-}): Promise<ChainRecord<GenericConfig, GenericElement>[]>;
+    attributes: FilterAttributes<GenericConfig, GenericElement>;
+}): Promise<TrackedRecord<GenericConfig, GenericElement>[]>;
 /**
  * Checks if a record's attributes match the given filter criteria.
  * - Multiple attributes: AND logic (all must match)
@@ -20,7 +17,7 @@ export declare function findByAttributes<GenericConfig extends AnyDialecteConfig
  * - Undefined values: ignored (attribute removed from filter)
  */
 export declare function matchesAttributeFilter<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
-    record: RawRecord<GenericConfig, GenericElement>;
-    attributeFilter?: FilterAttributes<GenericConfig, GenericElement>;
+    record: TrackedRecord<GenericConfig, GenericElement>;
+    attributeFilter: FilterAttributes<GenericConfig, GenericElement>;
 }): boolean;
 //# sourceMappingURL=find-by-attributes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find-by-attributes.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/by-attribute/find-by-attributes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,UAAU,EAAgB,MAAM,SAAS,CAAA;AAEzF;;;;GAIG;AACH,wBAAsB,gBAAgB,CACrC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,gBAAgB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CAC3D,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC,CAa1D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,MAAM,EAAE,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACpD,eAAe,EAAE,gBAAgB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CAChE,GAAG,OAAO,CA4BV"}

package/dist/{helpers/record/query/types.d.ts → document/query/find/by-attribute/find-by-attributes.types.d.ts}

@@ -1,10 +1,5 @@
-import { AnyDialecteConfig, AttributesOf, AttributesValueObjectOf, ChainRecord, ElementsOf } from '../../../types';
+import { AnyDialecteConfig, AttributesOf, AttributesValueObjectOf, ElementsOf } from '../../../../types';
 export type FilterAttributes<GenericVersion extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericVersion>> = {
     [K in AttributesOf<GenericVersion, GenericElement>]?: AttributesValueObjectOf<GenericVersion, GenericElement>[K] | Array<AttributesValueObjectOf<GenericVersion, GenericElement>[K]>;
 };
-export type GroupedRecordsByTagName<GenericConfig extends AnyDialecteConfig, GenericRecords extends readonly ChainRecord<GenericConfig, any>[]> = {
-    [K in GenericRecords[number]['tagName']]?: Extract<GenericRecords[number], {
-        tagName: K;
-    }>[];
-};
-//# sourceMappingURL=types.d.ts.map
+//# sourceMappingURL=find-by-attributes.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find-by-attributes.types.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/by-attribute/find-by-attributes.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEnG,MAAM,MAAM,gBAAgB,CAC3B,cAAc,SAAS,iBAAiB,EACxC,cAAc,SAAS,UAAU,CAAC,cAAc,CAAC,IAC9C;KACF,CAAC,IAAI,YAAY,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,EACjD,uBAAuB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,GAC1D,KAAK,CAAC,uBAAuB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;CACpE,CAAA"}

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

@@ -0,0 +1,3 @@
+export { findByAttributes, matchesAttributeFilter } from './find-by-attributes';
+export type { FilterAttributes } from './find-by-attributes.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/by-attribute/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC/E,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA"}

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

@@ -0,0 +1,16 @@
+import { Context, DescendantsFilter, FindDescendantsReturn } from '../../..';
+import { AnyDialecteConfig, ElementsOf, Ref } from '../../../../types';
+/**
+ * Find descendants matching filter with "any depth" semantic.
+ *
+ * Two modes:
+ * 1. No filter → get all descendants from tree
+ * 2. With filter → query deepest level, validate ancestors at any depth
+ */
+export declare function findDescendants<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericFilter extends DescendantsFilter<GenericConfig> | undefined = undefined>(params: {
+    context: Context<GenericConfig>;
+    dialecteConfig: GenericConfig;
+    ref: Ref<GenericConfig, GenericElement>;
+    filter?: GenericFilter;
+}): Promise<FindDescendantsReturn<GenericConfig, GenericElement, GenericFilter>>;
+//# sourceMappingURL=find-descendant.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find-descendant.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/descendant/find-descendant.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AACnF,OAAO,KAAK,EACX,iBAAiB,EACjB,UAAU,EAGV,GAAG,EAGH,MAAM,SAAS,CAAA;AAEhB;;;;;;GAMG;AACH,wBAAsB,eAAe,CACpC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,aAAa,SAAS,iBAAiB,CAAC,aAAa,CAAC,GAAG,SAAS,GAAG,SAAS,EAC7E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,cAAc,EAAE,aAAa,CAAA;IAC7B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,MAAM,CAAC,EAAE,aAAa,CAAA;CACtB,GAAG,OAAO,CAAC,qBAAqB,CAAC,aAAa,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC,CAgB/E"}

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

@@ -0,0 +1,47 @@
+import { FilterAttributes } from '../by-attribute/find-by-attributes.types';
+import { AnyDialecteConfig, DescendantsOf, ElementsOf, TrackedRecord } from '../../../../types';
+type Depth = [never, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20];
+type FilterNode<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, D extends number> = Depth[D] extends never ? never : {
+    [K in DescendantsOf<GenericConfig, GenericElement>]: {
+        tagName: K;
+        /** Match only if this element has these attributes. */
+        attributes?: FilterAttributes<GenericConfig, K>;
+        /**
+         * When true, collect this element if present but do not require it on the path.
+         * Default: false (required — candidates whose path lacks this element are excluded).
+         */
+        isOptional?: boolean;
+        descendant?: FilterNode<GenericConfig, K, Depth[D]>;
+    };
+}[DescendantsOf<GenericConfig, GenericElement>];
+export type DescendantsFilter<GenericConfig extends AnyDialecteConfig> = {
+    [K in ElementsOf<GenericConfig>]: {
+        tagName: K;
+        /** Match only if this element has these attributes. */
+        attributes?: FilterAttributes<GenericConfig, K>;
+        /**
+         * When true, collect this element if present but do not require it on the path.
+         * Default: false (required — candidates whose path lacks this element are excluded).
+         */
+        isOptional?: boolean;
+        descendant?: FilterNode<GenericConfig, K, 20>;
+    };
+}[ElementsOf<GenericConfig>];
+export type FilterCondition<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>> = {
+    tagName: GenericElement;
+    attributes?: FilterAttributes<GenericConfig, GenericElement>;
+    optional: boolean;
+};
+export type ExtractTags<F> = F extends {
+    tagName: infer T;
+} ? T | (F extends {
+    descendant?: infer D;
+} ? ExtractTags<D> : never) : never;
+export type ResultMap<GenericConfig extends AnyDialecteConfig, GenericTags extends string> = {
+    [K in GenericTags]: TrackedRecord<GenericConfig, K>[];
+};
+export type FindDescendantsReturn<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericFilter extends DescendantsFilter<GenericConfig> | undefined> = GenericFilter extends undefined ? {
+    [K in GenericElement | DescendantsOf<GenericConfig, GenericElement>]: TrackedRecord<GenericConfig, K>[];
+} : GenericFilter extends DescendantsFilter<GenericConfig> ? ResultMap<GenericConfig, ExtractTags<GenericFilter>> : never;
+export {};
+//# sourceMappingURL=find-descendant.types.d.ts.map

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

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

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

@@ -0,0 +1,3 @@
+export { findDescendants } from './find-descendant';
+export type { DescendantsFilter, FindDescendantsReturn, ExtractTags, ResultMap, } from './find-descendant.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/find/descendant/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EACX,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,SAAS,GACT,MAAM,yBAAyB,CAAA"}

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

@@ -0,0 +1,3 @@
+export * from './by-attribute';
+export * from './descendant';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,31 @@
+import { Context } from '../../..';
+import { AnyDialecteConfig, AttributesOf, ElementsOf, FullAttributeObjectOf, Ref } from '../../../../types';
+/**
+ * Fetch a single attribute for the given ref.
+ *
+ * Resolves the record via context (staged → cache → store),
+ * then extracts the named attribute.
+ *
+ * @example
+ * getAttribute({ context, ref, name: 'name' })               // → string | ''
+ */
+export declare function getAttribute<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericAttribute extends FullAttributeObjectOf<GenericConfig, GenericElement>>(params: {
+    context: Context<GenericConfig>;
+    ref: Ref<GenericConfig, GenericElement>;
+    name: AttributesOf<GenericConfig, GenericElement>;
+}): Promise<GenericAttribute['value'] | ''>;
+/**
+ * Fetch a single attribute for the given ref.
+ *
+ * Resolves the record via context (staged → cache → store),
+ * then extracts the named attribute.
+ *
+ * @example
+ * getAttribute({ context, ref, name: 'name', fullObject: true }) // → FullAttributeObject | undefined
+ */
+export declare function getAttributeFullObject<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericAttribute extends FullAttributeObjectOf<GenericConfig, GenericElement>>(params: {
+    context: Context<GenericConfig>;
+    ref: Ref<GenericConfig, GenericElement>;
+    name: AttributesOf<GenericConfig, GenericElement>;
+}): Promise<GenericAttribute | undefined>;
+//# sourceMappingURL=get-attribute.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-attribute.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/attribute/get-attribute.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EACX,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,GAAG,EACH,MAAM,SAAS,CAAA;AAEhB;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CACjC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,gBAAgB,SAAS,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,IAAI,EAAE,YAAY,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CACjD,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAQ1C;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC3C,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,gBAAgB,SAAS,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,IAAI,EAAE,YAAY,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CACjD,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAOxC"}

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

@@ -0,0 +1,29 @@
+import { Context } from '../../..';
+import { AnyDialecteConfig, AttributesValueObjectOf, ElementsOf, FullAttributeObjectOf, Ref } from '../../../../types';
+/**
+ * Fetch all attributes for the given ref.
+ *
+ * Resolves the record via context (staged → cache → store),
+ * then returns attributes as a value object (destructurable).
+ *
+ * @example
+ * getAttributes({ context, ref })                      // → { name: '', desc: '', ... }
+ */
+export declare function getAttributes<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericAttribute extends FullAttributeObjectOf<GenericConfig, GenericElement>>(params: {
+    context: Context<GenericConfig>;
+    ref: Ref<GenericConfig, GenericElement>;
+}): Promise<AttributesValueObjectOf<GenericConfig, GenericElement>>;
+/**
+ * Fetch all attributes for the given ref.
+ *
+ * Resolves the record via context (staged → cache → store),
+ * then returns attributes as a full array.
+ *
+ * @example
+ * getAttributes({ context, ref, fullObject: true })    // → FullAttributeObject[]
+ */
+export declare function getAttributesFullObject<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>, GenericAttribute extends FullAttributeObjectOf<GenericConfig, GenericElement>>(params: {
+    context: Context<GenericConfig>;
+    ref: Ref<GenericConfig, GenericElement>;
+}): Promise<GenericAttribute[]>;
+//# sourceMappingURL=get-attributes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-attributes.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/attribute/get-attributes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EACX,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,qBAAqB,EACrB,GAAG,EACH,MAAM,SAAS,CAAA;AAEhB;;;;;;;;GAQG;AAEH,wBAAsB,aAAa,CAClC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,gBAAgB,SAAS,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CACvC,GAAG,OAAO,CAAC,uBAAuB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAYlE;AAED;;;;;;;;GAQG;AAEH,wBAAsB,uBAAuB,CAC5C,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAChD,gBAAgB,SAAS,qBAAqB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5E,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CACvC,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAM9B"}

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

@@ -0,0 +1,3 @@
+export { getAttribute, getAttributeFullObject } from './get-attribute';
+export { getAttributes, getAttributesFullObject } from './get-attributes';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/attribute/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA"}

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

@@ -0,0 +1,4 @@
+export * from './attribute';
+export * from './record';
+export * from './tree';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/document/query/get/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA"}

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

@@ -0,0 +1,16 @@
+import { Context } from '../../..';
+import { AnyDialecteConfig, ElementsOf, TrackedRecord, Ref } from '../../../../types';
+/**
+ * Fetch a single record by ref.
+ *
+ * Resolution order: staged operations → cache → store.
+ * For singleton elements (id absent), resolves by tagName.
+ * Always returns a TrackedRecord — 'unchanged' for clean store reads.
+ *
+ * Side effect: populates context.recordCache on store hits.
+ */
+export declare function getRecord<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
+    context: Context<GenericConfig>;
+    ref: Ref<GenericConfig, GenericElement>;
+}): Promise<TrackedRecord<GenericConfig, GenericElement> | undefined>;
+//# sourceMappingURL=get-record.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,15 @@
+import { Context } from '../../..';
+import { AnyDialecteConfig, ElementsOf, TrackedRecord } from '../../../../types';
+/**
+ * Fetch all records for a tagName, overlaid with staged operations.
+ *
+ * DB records are marked 'unchanged'; staged creates/updates/deletes are
+ * applied on top by overlayStaged.
+ *
+ * Side effect: populates context.recordCache for all fetched DB records.
+ */
+export declare function getRecordsByTagName<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
+    context: Context<GenericConfig>;
+    tagName: GenericElement;
+}): Promise<TrackedRecord<GenericConfig, GenericElement>[]>;
+//# sourceMappingURL=get-records-by-tagname.d.ts.map

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

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

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

@@ -0,0 +1,11 @@
+import { Context } from '../../..';
+import { AnyDialecteConfig, ElementsOf, TrackedRecord, Ref } from '../../../../types';
+/**
+ * Batch lookup — resolve multiple refs in parallel.
+ * Delegates to getRecord per ref; cache hits avoid redundant store calls.
+ */
+export declare function getRecords<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
+    context: Context<GenericConfig>;
+    refs: Ref<GenericConfig, GenericElement>[];
+}): Promise<(TrackedRecord<GenericConfig, GenericElement> | undefined)[]>;
+//# sourceMappingURL=get-records.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,4 @@
+export { getRecord } from './get-record';
+export { getRecords } from './get-records';
+export { getRecordsByTagName } from './get-records-by-tagname';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,30 @@
+import { AnyDialecteConfig, Operation, ElementsOf, TrackedRecord, RawRecord } from '../../../../types';
+/**
+ * Find the latest staged operation matching a record id.
+ * Scans operations in reverse (most recent first).
+ *
+ * When id is omitted (singleton), matches by tagName only.
+ *
+ * Pure function — no DB access, no side effects.
+ *
+ * @returns The record + operation status, or undefined if not in staged ops
+ */
+export declare function getLatestStagedRecord<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
+    stagedOperations: ReadonlyArray<Operation<GenericConfig>>;
+    tagName: GenericElement;
+    id?: string;
+}): TrackedRecord<GenericConfig, GenericElement> | undefined;
+/**
+ * Overlay staged operations on top of DB records for a given tagName.
+ * Applies creates/updates/deletes to produce the final merged array.
+ *
+ * Pure function — no DB access, no side effects.
+ *
+ * @returns Merged array with status: DB records get 'unchanged', staged records get their operation status
+ */
+export declare function overlayStaged<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
+    tagName: GenericElement;
+    rawRecords: RawRecord<GenericConfig, GenericElement>[];
+    stagedOperations: ReadonlyArray<Operation<GenericConfig>>;
+}): TrackedRecord<GenericConfig, GenericElement>[];
+//# sourceMappingURL=staged-lookup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"staged-lookup.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/record/staged-lookup.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,iBAAiB,EACjB,SAAS,EAET,UAAU,EACV,aAAa,EACb,SAAS,EACT,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACpC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,gBAAgB,EAAE,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAA;IACzD,OAAO,EAAE,cAAc,CAAA;IACvB,EAAE,CAAC,EAAE,MAAM,CAAA;CACX,GAAG,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAwE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC5B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAA;IACtD,gBAAgB,EAAE,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAA;CACzD,GAAG,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAoBjD"}

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

@@ -0,0 +1,9 @@
+import { GetTreeParams } from './get-tree.types';
+import { Context } from '../../..';
+import { AnyDialecteConfig, ElementsOf, TreeRecord, Ref } from '../../../../types';
+export declare function getTree<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
+    context: Context<GenericConfig>;
+    ref: Ref<GenericConfig, GenericElement>;
+    options?: GetTreeParams<GenericConfig, GenericElement>;
+}): Promise<TreeRecord<GenericConfig, GenericElement> | undefined>;
+//# sourceMappingURL=get-tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-tree.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/tree/get-tree.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAgC,MAAM,kBAAkB,CAAA;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAiB,UAAU,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAE5F,wBAAsB,OAAO,CAC5B,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CACtD,GAAG,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,CA4BjE"}

package/dist/{chain-methods/ending/queries → document/query/get/tree}/get-tree.types.d.ts

@@ -1,5 +1,5 @@
-import { FilterAttributes } from '../../../helpers';
-import { AnyDialecteConfig, ElementsOf, ChildrenOf } from '../../../types';
+import { FilterAttributes } from '../../..';
+import { AnyDialecteConfig, ChildrenOf, ElementsOf } from '../../../../types';
 export type GetTreeParams<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>> = {
     include?: IncludeFilter<GenericConfig, GenericElement>;
     exclude?: ExcludeFilter<GenericConfig>[];

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-tree.types.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/tree/get-tree.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAExE,MAAM,MAAM,aAAa,CACxB,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,IAC7C;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACtD,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,EAAE,CAAA;IACxC,MAAM,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,EAAE,CAAA;CACpC,CAAA;AAKD,MAAM,MAAM,aAAa,CACxB,aAAa,SAAS,iBAAiB,EACvC,aAAa,SAAS,UAAU,CAAC,aAAa,CAAC,IAE/C,UAAU,CAAC,aAAa,EAAE,aAAa,CAAC,SAAS,MAAM,KAAK,GACzD,KAAK,SAAS,UAAU,CAAC,aAAa,CAAC,GACtC;IACA,OAAO,EAAE,KAAK,CAAA;IACd,UAAU,CAAC,EAAE,gBAAgB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;IACnD,QAAQ,CAAC,EAAE,aAAa,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,CAAA;CAChD,GACA,KAAK,GACN,KAAK,CAAA;AAGT,MAAM,MAAM,aAAa,CAAC,aAAa,SAAS,iBAAiB,IAAI;IACpE,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,CAAA;IAClC,UAAU,CAAC,EAAE,gBAAgB,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;IACvE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;CAC3B,CAAA"}

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

@@ -0,0 +1,3 @@
+export { getTree } from './get-tree';
+export type { GetTreeParams, IncludeFilter, ExcludeFilter } from './get-tree.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/document/query/get/tree/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}

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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,58 @@
+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>;
+    getRoot(): Promise<TrackedRecord<GenericConfig, RootElementOf<GenericConfig>> | undefined>;
+    getRecord<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined): Promise<TrackedRecord<GenericConfig, GenericElement> | undefined>;
+    getRecords<GenericElement extends ElementsOf<GenericConfig>>(refsOrRecords: (RefOrRecord<GenericConfig, GenericElement> | undefined)[]): Promise<(TrackedRecord<GenericConfig, GenericElement> | undefined)[]>;
+    getRecordsByTagName<GenericElement extends ElementsOf<GenericConfig>>(tagName: GenericElement): Promise<TrackedRecord<GenericConfig, GenericElement>[]>;
+    findDescendants<GenericElement extends ElementsOf<GenericConfig>, GenericFilter extends DescendantsFilter<GenericConfig> | undefined = undefined>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, filter?: GenericFilter): Promise<FindDescendantsReturn<GenericConfig, GenericElement, GenericFilter>>;
+    getTree<GenericElement extends ElementsOf<GenericConfig>>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, options?: GetTreeParams<GenericConfig, GenericElement>): Promise<TreeRecord<GenericConfig, GenericElement> | undefined>;
+    /**
+     * @example
+     * await doc.query.getAttribute({ ref, name: 'name' })                    // → string | ''
+     * await doc.query.getAttribute({ ref, name: 'name', fullObject: true })  // → FullAttributeObject | undefined
+     */
+    getAttribute<GenericElement extends ElementsOf<GenericConfig>, GenericAttribute extends FullAttributeObjectOf<GenericConfig, GenericElement>, FullObject extends boolean = false>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: {
+        name: AttributesOf<GenericConfig, GenericElement>;
+        fullObject?: FullObject;
+    }): Promise<GenericAttribute | undefined | GenericAttribute['value'] | ''>;
+    /**
+     * @example
+     * const { name, desc } = await doc.query.getAttributes({ ref })                   // destructurable
+     * const fullAttrs      = await doc.query.getAttributes({ ref, fullObject: true }) // FullAttributeObject[]
+     */
+    getAttributes<GenericElement extends ElementsOf<GenericConfig>, GenericAttribute extends FullAttributeObjectOf<GenericConfig, GenericElement>, FullObject extends boolean = false>(refOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params?: {
+        fullObject?: FullObject;
+    }): Promise<GenericAttribute[] | AttributesValueObjectOf<GenericConfig, GenericElement>>;
+    findByAttributes<GenericElement extends ElementsOf<GenericConfig>>(params: {
+        tagName: GenericElement;
+        attributes: FilterAttributes<GenericConfig, GenericElement>;
+    }): Promise<TrackedRecord<GenericConfig, GenericElement>[]>;
+}
+//# sourceMappingURL=main.d.ts.map