@wovin/core 0.1.36 → 0.2.0

package/dist/query/situations.d.ts

@@ -1,4 +1,5 @@
-import { Applog, query } from '@wovin/core';
+import { Applog } from '../applog/datom-types.ts';
+import { query } from './basic.ts';
 /**
  * Situations are meant to flag and possibly autocorrect or autosuggest solutions
  *

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

@@ -1 +1 @@
-{"version":3,"file":"situations.d.ts","sourceRoot":"","sources":["../../src/query/situations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAa,MAAM,aAAa,CAAA;AAKtD;;;;;;;;;GASG;AACH,UAAU,SAAS;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA;IACxD,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,iBAAiB,EAAE,UAAU,EAAE,CAAA;IAC/B,QAAQ,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAC7B,CAAA;CACD;AAED,UAAU,yBAAyB;IAClC,MAAM,EAAE,GAAG,CAAA;IACX,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,UAAU,CAAC,EAAE,UAAU,CAAA;CACvB;AAED,UAAU,UAAU;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,eAAe,EAAE,eAAe,CAAA;CAChC;AAED,UAAU,eAAe;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,UAAU,eAAe;IACxB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,UAAU,gBAAgB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,QAAA,MAAM,cAAc;;;;;;CAMV,CAAA;AACV,UAAU,UAAU;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,MAAM,EAAE,CAAA;CACzB;AA2ED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,GAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,eAAe,CAAC,EAAE,OAAO,CAAA;CACpB,GACJ,yBAAyB,CAqC3B;AAkBD;;GAEG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GACf,UAAU,CAmCZ"}
+{"version":3,"file":"situations.d.ts","sourceRoot":"","sources":["../../src/query/situations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAMlC;;;;;;;;;GASG;AACH,UAAU,SAAS;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA;IACxD,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,iBAAiB,EAAE,UAAU,EAAE,CAAA;IAC/B,QAAQ,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAC7B,CAAA;CACD;AAED,UAAU,yBAAyB;IAClC,MAAM,EAAE,GAAG,CAAA;IACX,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,UAAU,CAAC,EAAE,UAAU,CAAA;CACvB;AAED,UAAU,UAAU;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,eAAe,EAAE,eAAe,CAAA;CAChC;AAED,UAAU,eAAe;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,UAAU,eAAe;IACxB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,UAAU,gBAAgB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,QAAA,MAAM,cAAc;;;;;;CAMV,CAAA;AACV,UAAU,UAAU;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,MAAM,EAAE,CAAA;CACzB;AA2ED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,GAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,eAAe,CAAC,EAAE,OAAO,CAAA;CACpB,GACJ,yBAAyB,CAqC3B;AAkBD;;GAEG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GACf,UAAU,CAmCZ"}

package/dist/query/subscribable.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Push-based subscribable primitives for the query system.
+ *
+ * Two primitives:
+ * - Subscribable<T>     — any value + "changed" notifications
+ * - SubscribableArray<T> — array + incremental delta events (added/removed)
+ *
+ * Key property: **lazy subscribe** — upstream subscriptions only activate
+ * when the first subscriber attaches, and deactivate when the last leaves.
+ * This means one-off reads (.value / .items) have zero subscription overhead.
+ */
+export type Unsubscribe = () => void;
+export interface Subscribable<T> {
+    /** Current value — plain read, no side effects */
+    readonly value: T;
+    /**
+     * Subscribe to change notifications.
+     * - First call activates upstream subscriptions (lazy).
+     * - Callback does NOT fire immediately — read .value for current state.
+     * - Callback fires whenever .value changes.
+     * - Last unsubscribe deactivates upstream.
+     */
+    subscribe(cb: () => void, type?: 'derived' | 'reaction'): Unsubscribe;
+    /** Tear down all internal subscriptions */
+    dispose(): void;
+}
+/**
+ * Implementation of Subscribable<T> with lazy upstream activation.
+ */
+export declare class SubscribableImpl<T> implements Subscribable<T> {
+    private _value;
+    private _derivedSubscribers;
+    private _subscribers;
+    private _upstreamActive;
+    private _activateUpstream;
+    private _deactivateUpstream;
+    private _equals;
+    constructor(initialValue: T, activateUpstream?: () => Unsubscribe, opts?: {
+        equals?: false | ((a: T, b: T) => boolean);
+    });
+    get value(): T;
+    subscribe(cb: () => void, type?: 'derived' | 'reaction'): Unsubscribe;
+    /** Update value and notify subscribers (skips if equals check passes) */
+    _set(value: T): void;
+    private _notify;
+    dispose(): void;
+}
+/** Delta events — mirrors ThreadEvent shape */
+export type ArrayEvent<T> = {
+    init: readonly T[];
+} | {
+    added: readonly T[];
+    removed: readonly T[] | null;
+};
+/** Type guard for init events. Same logic as thread's isInitEvent. */
+export declare function isArrayInitEvent<T>(event: ArrayEvent<T>): event is {
+    init: readonly T[];
+};
+export interface SubscribableArray<T> {
+    /**
+     * Current snapshot — plain readonly array.
+     *
+     * NOTE: only stays current while at least one subscriber is active
+     * (upstream is lazily activated on first `.subscribe()`). With no
+     * subscribers this returns the initial snapshot from construction
+     * and does NOT reflect later mutations. Tests/consumers that want
+     * to observe updates must hold a subscription (`subscribe(() => {})`
+     * is enough).
+     */
+    readonly items: readonly T[];
+    /** Length shortcut */
+    readonly length: number;
+    /**
+     * Subscribe to delta events.
+     * - First call activates upstream subscriptions (lazy).
+     * - No init event on subscribe — read .items for current state.
+     * - Receives `{ init }` only on genuine resets (triggerRemap).
+     * - Last unsubscribe deactivates upstream.
+     */
+    subscribe(cb: (event: ArrayEvent<T>) => void, type?: 'derived' | 'reaction'): Unsubscribe;
+    /** Tear down all internal subscriptions */
+    dispose(): void;
+}
+/**
+ * Implementation of SubscribableArray with lazy upstream activation.
+ *
+ * Constructor takes initial items (computed synchronously at query time)
+ * and an optional activation function that sets up upstream subscriptions.
+ * The activation function is only called on first `.subscribe()`.
+ */
+export declare class SubscribableArrayImpl<T> implements SubscribableArray<T> {
+    private _items;
+    private _derivedSubscribers;
+    private _subscribers;
+    private _upstreamActive;
+    private _activateUpstream;
+    private _deactivateUpstream;
+    constructor(initialItems: T[], activateUpstream?: () => Unsubscribe);
+    get items(): readonly T[];
+    get length(): number;
+    subscribe(cb: (event: ArrayEvent<T>) => void, type?: 'derived' | 'reaction'): Unsubscribe;
+    /** Push items and notify subscribers */
+    _push(...items: T[]): void;
+    /** Remove items and notify subscribers */
+    _remove(items: readonly T[]): void;
+    /** Full reset — replace all items */
+    _reset(items: T[]): void;
+    private _notify;
+    dispose(): void;
+}
+//# sourceMappingURL=subscribable.d.ts.map

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

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

package/dist/query/types.d.ts

@@ -1,6 +1,6 @@
-import { SearchContext } from '../applog/datom-types';
-import type { Thread } from '../thread/basic';
-import { ReadonlyObservableArray } from '../types/typescript-utils';
+import { SearchContext } from '../applog/datom-types.ts';
+import type { Thread } from '../thread/basic.ts';
+import { ArrayEvent, SubscribableArray, Unsubscribe } from './subscribable.ts';
 export declare class QueryNode {
     readonly logsOfThisNode: Thread;
     readonly variables: SearchContext;
@@ -10,21 +10,61 @@ export declare class QueryNode {
     get threadOfTrail(): Thread;
     get trailLogs(): any;
 }
+/** Shared interface for query results (one-off and live) */
+export interface IQueryResult {
+    readonly nodes: readonly QueryNode[];
+    readonly size: number;
+    readonly isEmpty: boolean;
+    readonly records: readonly SearchContext[];
+    readonly leafNodeLogs: readonly import('../applog/datom-types').Applog[];
+    readonly leafNodeThread: Thread;
+    readonly threadOfAllTrails: Thread;
+    readonly thread: Thread;
+    readonly allApplogs: readonly import('../applog/datom-types').Applog[];
+}
+/**
+ * One-off query result — plain frozen snapshot.
+ * No subscribe method. No stale-data risk.
+ */
+export declare class QueryResult implements IQueryResult {
+    readonly nodes: readonly QueryNode[];
+    constructor(nodes: readonly QueryNode[]);
+    get size(): number;
+    get isEmpty(): boolean;
+    get untrackedSize(): number;
+    get records(): readonly SearchContext[];
+    get leafNodeThread(): import("../thread.ts").MappedThread;
+    get leafNodeLogSet(): (readonly import("../applog.ts").Applog[])[];
+    get leafNodeLogs(): import("../applog.ts").Applog[];
+    get threadOfAllTrails(): import("../thread.ts").MappedThread;
+    get thread(): import("../thread.ts").MappedThread;
+    get allApplogs(): readonly import("../applog.ts").Applog[];
+}
 /**
- * The result of a query (-step)
+ * Live query result — eagerly activated, always up-to-date.
+ *
+ * `.nodes` returns the current live view.
+ * `.subscribe()` receives future delta events (consistent with current state).
+ * Must call `.dispose()` when done to tear down upstream subscriptions.
  */
-export declare class QueryResult {
-    nodes: ReadonlyObservableArray<QueryNode>;
-    constructor(nodes: ReadonlyObservableArray<QueryNode>);
+export declare class LiveQueryResult implements IQueryResult {
+    private _source;
+    constructor(_source: SubscribableArray<QueryNode>, activate?: boolean);
+    private _activationUnsub;
+    /** Subscribe to node change events. Callback fires on future changes only. */
+    subscribe(cb: (event: ArrayEvent<QueryNode>) => void, type?: 'derived' | 'reaction'): Unsubscribe;
+    /** Current nodes — live view, always up-to-date while not disposed */
+    get nodes(): readonly QueryNode[];
     get size(): number;
     get isEmpty(): boolean;
     get untrackedSize(): number;
-    get records(): ReadonlyObservableArray<SearchContext>;
-    get leafNodeThread(): import("..").MappedThread;
-    get leafNodeLogSet(): ReadonlyObservableArray<readonly import("..").Applog[]>;
-    get leafNodeLogs(): ReadonlyObservableArray<import("..").Applog>;
-    get threadOfAllTrails(): import("..").MappedThread;
-    get thread(): import("..").MappedThread;
-    get allApplogs(): readonly import("..").Applog[];
+    get records(): readonly SearchContext[];
+    get leafNodeThread(): import("../thread.ts").MappedThread;
+    get leafNodeLogSet(): (readonly import("../applog.ts").Applog[])[];
+    get leafNodeLogs(): import("../applog.ts").Applog[];
+    get threadOfAllTrails(): import("../thread.ts").MappedThread;
+    get thread(): import("../thread.ts").MappedThread;
+    get allApplogs(): readonly import("../applog.ts").Applog[];
+    dispose(): void;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/query/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAErD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAEnE,qBAAa,SAAS;IAEpB,QAAQ,CAAC,cAAc,EAAE,MAAM;IAC/B,QAAQ,CAAC,SAAS,EAAE,aAAa;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;gBAF1B,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,aAAa,EACxB,QAAQ,GAAE,SAAS,GAAG,IAAW;IAM3C,IAAI,MAAM,kBAET;IAED,IAAI,aAAa,WAMhB;IACD,IAAI,SAAS,QAEZ;CACD;AACD;;GAEG;AACH,qBAAa,WAAW;IAEf,KAAK,EAAE,uBAAuB,CAAC,SAAS,CAAC;gBAAzC,KAAK,EAAE,uBAAuB,CAAC,SAAS,CAAC;IASjD,IAAI,IAAI,WAEP;IACD,IAAI,OAAO,YAEV;IACD,IAAI,aAAa,WAEhB;IAED,IAAI,OAAO,2CAEV;IACD,IAAI,cAAc,8BAIjB;IACD,IAAI,cAAc,4DAEjB;IACD,IAAI,YAAY,iDAIf;IAID,IAAI,iBAAiB,8BAEpB;IACD,IAAI,MAAM,8BAET;IACD,IAAI,UAAU,mCAEb;CACD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/query/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAyB,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAErG,qBAAa,SAAS;IAEpB,QAAQ,CAAC,cAAc,EAAE,MAAM;IAC/B,QAAQ,CAAC,SAAS,EAAE,aAAa;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;gBAF1B,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,aAAa,EACxB,QAAQ,GAAE,SAAS,GAAG,IAAW;IAE3C,IAAI,MAAM,kBAET;IAED,IAAI,aAAa,WAMhB;IACD,IAAI,SAAS,QAEZ;CACD;AAED,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAA;IAC1C,QAAQ,CAAC,YAAY,EAAE,SAAS,OAAO,uBAAuB,EAAE,MAAM,EAAE,CAAA;IACxE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,OAAO,uBAAuB,EAAE,MAAM,EAAE,CAAA;CACtE;AAED;;;GAGG;AACH,qBAAa,WAAY,YAAW,YAAY;IAE9C,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE;gBAA3B,KAAK,EAAE,SAAS,SAAS,EAAE;IAGrC,IAAI,IAAI,WAEP;IACD,IAAI,OAAO,YAEV;IACD,IAAI,aAAa,WAEhB;IAED,IAAI,OAAO,IAAI,SAAS,aAAa,EAAE,CAEtC;IACD,IAAI,cAAc,wCAIjB;IACD,IAAI,cAAc,iDAEjB;IACD,IAAI,YAAY,oCAEf;IACD,IAAI,iBAAiB,wCAEpB;IACD,IAAI,MAAM,wCAET;IACD,IAAI,UAAU,6CAEb;CACD;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAElD,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,EAC7C,QAAQ,UAAO;IAShB,OAAO,CAAC,gBAAgB,CAA2B;IAEnD,8EAA8E;IAC9E,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW;IAIjG,sEAAsE;IACtE,IAAI,KAAK,IAAI,SAAS,SAAS,EAAE,CAEhC;IAED,IAAI,IAAI,WAEP;IACD,IAAI,OAAO,YAEV;IACD,IAAI,aAAa,WAEhB;IAED,IAAI,OAAO,IAAI,SAAS,aAAa,EAAE,CAEtC;IACD,IAAI,cAAc,wCAIjB;IACD,IAAI,cAAc,iDAEjB;IACD,IAAI,YAAY,oCAEf;IACD,IAAI,iBAAiB,wCAEpB;IACD,IAAI,MAAM,wCAET;IACD,IAAI,UAAU,6CAEb;IAED,OAAO;CAKP"}

package/dist/query.d.ts

@@ -1,6 +1,10 @@
-export * from './mobx/mobx-utils';
-export * from './query/basic';
-export * from './query/divergences';
-export * from './query/matchers';
-export * from './query/types';
+export * from './utils/debug-name.ts';
+export * from './query/basic.ts';
+export * from './query/divergences.ts';
+export * from './query/matchers.ts';
+export * from './query/memoized.ts';
+export * from './query/subscribable.ts';
+export * from './query/types.ts';
+export * from './query/attr-helpers.ts';
+export * from './query/entity-collection.ts';
 //# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,8BAA8B,CAAA"}

package/dist/{query.min.js → query.js}

@@ -1,9 +1,11 @@
 import {
   includedIn,
   includes,
+  liveEntityCollection,
   queryDivergencesByPrev
-} from "./chunk-2Y2PYHGR.min.js";
+} from "./chunk-CPSDKFBG.js";
 import {
+  LiveQueryResult,
   QueryNode,
   QueryResult,
   agentsOfThread,
@@ -13,6 +15,19 @@ import {
   entityOverlapMap,
   filterAndMap,
   lastWriteWins,
+  liveEntityAt,
+  liveEntityOverlapCount,
+  liveFilterAndMap,
+  liveQuery,
+  liveQueryAndMap,
+  liveQueryEntity,
+  liveQueryNot,
+  liveQuerySingle,
+  liveQuerySingleAndMap,
+  liveQueryStep,
+  makeApplogMapper,
+  mapApplogsWith,
+  mapAttributes,
   mapQueryResultWith,
   mapThreadWith,
   prefixAt,
@@ -23,42 +38,33 @@ import {
   queryNot,
   querySingle,
   querySingleAndMap,
-  queryStep,
+  queryStepOnce,
+  resolveKeyMapper,
   startsWith,
+  stripAtPrefix,
   threadFromMaybeArray,
   throwOnTimeout,
   withTimeout,
   withoutDeleted
-} from "./chunk-COXXILXC.min.js";
+} from "./chunk-QZXKQCAY.js";
 import {
-  applogThreadComparer,
-  autorunButAlsoImmediately,
-  compareStructuralButThreadsOnIdentity,
-  computedFnDeepCompare,
-  computedStructuralComparer,
+  SubscribableArrayImpl,
+  SubscribableImpl,
   createDebugName,
   createDebugNameObj,
-  observableArrayMap,
-  observableMapMap,
-  observableMapToObject,
-  observableSetMap,
+  isArrayInitEvent,
+  memoizedFn,
   prettifyThreadName,
-  queryNodesComparer,
-  rootsQueries
-} from "./chunk-GDX2OO7L.min.js";
-import "./chunk-HYMC7W6S.min.js";
-import "./chunk-QO2KMGDN.min.js";
-import "./chunk-KEHU7HGZ.min.js";
-import "./chunk-PHITDXZT.min.js";
+  refCountedMemoizedFn
+} from "./chunk-L5EEEGE6.js";
+import "./chunk-ZAADLBSB.js";
 export {
+  LiveQueryResult,
   QueryNode,
   QueryResult,
+  SubscribableArrayImpl,
+  SubscribableImpl,
   agentsOfThread,
-  applogThreadComparer,
-  autorunButAlsoImmediately,
-  compareStructuralButThreadsOnIdentity,
-  computedFnDeepCompare,
-  computedStructuralComparer,
   createDebugName,
   createDebugNameObj,
   createObjMapper,
@@ -68,13 +74,25 @@ export {
   filterAndMap,
   includedIn,
   includes,
+  isArrayInitEvent,
   lastWriteWins,
+  liveEntityAt,
+  liveEntityCollection,
+  liveEntityOverlapCount,
+  liveFilterAndMap,
+  liveQuery,
+  liveQueryAndMap,
+  liveQueryEntity,
+  liveQueryNot,
+  liveQuerySingle,
+  liveQuerySingleAndMap,
+  liveQueryStep,
+  makeApplogMapper,
+  mapApplogsWith,
+  mapAttributes,
   mapQueryResultWith,
   mapThreadWith,
-  observableArrayMap,
-  observableMapMap,
-  observableMapToObject,
-  observableSetMap,
+  memoizedFn,
   prefixAt,
   prefixAttrs,
   prettifyThreadName,
@@ -82,16 +100,17 @@ export {
   queryAndMap,
   queryDivergencesByPrev,
   queryEntity,
-  queryNodesComparer,
   queryNot,
   querySingle,
   querySingleAndMap,
-  queryStep,
-  rootsQueries,
+  queryStepOnce,
+  refCountedMemoizedFn,
+  resolveKeyMapper,
   startsWith,
+  stripAtPrefix,
   threadFromMaybeArray,
   throwOnTimeout,
   withTimeout,
   withoutDeleted
 };
-//# sourceMappingURL=query.min.js.map
+//# sourceMappingURL=query.js.map

package/dist/retrieve/index.d.ts

@@ -1,2 +1,2 @@
-export * from './update-thread';
+export * from './update-thread.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrieve/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrieve/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA"}

package/dist/retrieve/update-thread.d.ts

@@ -1,7 +1,7 @@
 import { CID } from 'multiformats/cid';
-import type { Applog } from '../applog/datom-types';
-import type { WriteableThread } from '../thread/writeable';
-import type { BlockStore } from '../blockstore/index';
+import type { Applog } from '../applog/datom-types.ts';
+import type { WriteableThread } from '../thread/writeable.ts';
+import type { BlockStore } from '../blockstore/index.ts';
 /**
  * Block retrieval abstraction - fetch or get blocks.
  * Implemented by gateway retriever or local blockstore.

package/dist/retrieve/update-thread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-thread.d.ts","sourceRoot":"","sources":["../../src/retrieve/update-thread.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAKnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAIrD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,8BAA8B;IAC9B,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAClC,sEAAsE;IACtE,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAAC;QAAE,GAAG,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC,CAAA;CAChE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,UAAU,GACf,cAAc,CAUhB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,GAAG,CAAA;IACxB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,gCAAgC;IAChC,GAAG,EAAE,GAAG,CAAA;IACR,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAA;IACrB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,0CAA0C;IAC1C,YAAY,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CACzD;AA4BD;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,cAAc,EACzB,OAAO,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAqIvB"}
+{"version":3,"file":"update-thread.d.ts","sourceRoot":"","sources":["../../src/retrieve/update-thread.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAKtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,8BAA8B;IAC9B,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAClC,sEAAsE;IACtE,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAAC;QAAE,GAAG,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC,CAAA;CAChE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,UAAU,GACf,cAAc,CAUhB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,GAAG,CAAA;IACxB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,gCAAgC;IAChC,GAAG,EAAE,GAAG,CAAA;IACR,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAA;IACrB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,0CAA0C;IAC1C,YAAY,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CACzD;AA4BD;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,cAAc,EACzB,OAAO,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAqIvB"}

package/dist/retrieve.d.ts

@@ -1,2 +1,2 @@
-export * from './retrieve/update-thread';
+export * from './retrieve/update-thread.ts';
 //# sourceMappingURL=retrieve.d.ts.map

package/dist/retrieve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve.d.ts","sourceRoot":"","sources":["../src/retrieve.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA"}
+{"version":3,"file":"retrieve.d.ts","sourceRoot":"","sources":["../src/retrieve.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAA"}

package/dist/retrieve.js

@@ -0,0 +1,14 @@
+import {
+  updateThreadFromSnapshot,
+  withBlockCache
+} from "./chunk-J2FDHGOZ.js";
+import "./chunk-3WZVG277.js";
+import "./chunk-YDAKBU6Q.js";
+import "./chunk-QZXKQCAY.js";
+import "./chunk-L5EEEGE6.js";
+import "./chunk-ZAADLBSB.js";
+export {
+  updateThreadFromSnapshot,
+  withBlockCache
+};
+//# sourceMappingURL=retrieve.js.map

package/dist/thread/basic.d.ts

@@ -1,33 +1,29 @@
-import { IObservableArray } from 'mobx';
 import { CID } from 'multiformats';
-import { type Applog, ApplogForInsert, CidString } from '../applog/datom-types';
-import { ArrayOrSingle } from '../types/typescript-utils';
-export type ThreadEvent = {
-    added: readonly Applog[];
-    removed: readonly Applog[] | null;
-} | {
-    init: readonly Applog[];
-};
-export declare function isInitEvent(event: ThreadEvent): event is {
-    init: readonly Applog[];
-};
+import { type Applog, ApplogForInsert, CidString } from '../applog/datom-types.ts';
+import type { SubscribableArray, ArrayEvent } from '../query/subscribable.ts';
+import { isArrayInitEvent } from '../query/subscribable.ts';
+import { ArrayOrSingle } from '../types/typescript-utils.ts';
+export type ThreadEvent = ArrayEvent<Applog>;
+/** @deprecated Use isArrayInitEvent from @wovin/core/query */
+export declare const isInitEvent: typeof isArrayInitEvent;
 export type ApplogsOrThread = Thread | readonly Applog[];
-export declare abstract class Thread {
+export declare abstract class Thread implements SubscribableArray<Applog> {
     readonly name: string;
     protected _applogs: Applog[];
     readonly filters: readonly string[];
-    readonly parents: IObservableArray<Thread> | Thread[] | readonly Thread[] | null;
+    readonly parents: Thread[] | readonly Thread[] | null;
     protected _derivedSubscribers: ((event: ThreadEvent) => void)[];
     protected _subscribers: ((event: ThreadEvent) => void)[];
-    constructor(name: string, /* = null */ parents: ArrayOrSingle<Thread> | IObservableArray<Thread> | readonly Thread[] | null, filters: readonly string[], _applogs?: Applog[], opts?: {
-        skipObservable?: boolean;
-    });
+    /** Monotonic counter incremented on every mutation. Used by memoizedFn to invalidate caches. */
+    _version: number;
+    constructor(name: string, /* = null */ parents: ArrayOrSingle<Thread> | readonly Thread[] | null, filters: readonly string[], _applogs?: Applog[]);
     get readOnly(): any;
     insert(appLogsToInsert: ArrayOrSingle<ApplogForInsert>): any;
     insertRaw(appLogsToInsert: readonly Applog[]): any;
     subscribe(callback: (event: ThreadEvent) => void, type?: 'derived' | 'reaction'): () => void;
-    unsubscribe(callback: (event: ThreadEvent) => void): void;
     protected notifySubscribers(event: ThreadEvent): void;
+    get items(): readonly Applog[];
+    dispose(): void;
     get applogs(): readonly Applog[];
     get applogsCids(): readonly CidString[];
     get applogsCidSet(): ReadonlySet<CidString>;
@@ -58,7 +54,7 @@ export declare abstract class Thread {
 export declare const getLogsFromThread: (logsOrThread: ApplogsOrThread) => readonly Applog[];
 export declare class StaticThread extends Thread {
     static fromArray(applogs: Applog[], name?: string): StaticThread;
-    constructor(name: string, /* = null */ parents: ArrayOrSingle<Thread> | IObservableArray<Thread> | readonly Thread[] | null, filters: readonly string[], _applogs: Applog[]);
+    constructor(name: string, /* = null */ parents: ArrayOrSingle<Thread> | readonly Thread[] | null, filters: readonly string[], _applogs: Applog[]);
     get readOnly(): boolean;
 }
 //# sourceMappingURL=basic.d.ts.map

package/dist/thread/basic.d.ts.map

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

package/dist/thread/filters.d.ts

@@ -1,21 +1,19 @@
-import { IObservableArray, ObservableMap, ObservableSet } from 'mobx';
-import { Applog, ApplogForInsert, ApplogValue, CidString, DatalogQueryPattern } from '../applog/datom-types';
-import { Thread, ThreadEvent } from './basic';
-import { ApplogEventMapper, MappedThread } from './mapped';
+import { Applog, ApplogForInsert, DatalogQueryPattern } from '../applog/datom-types.ts';
+import type { Subscribable } from '../query/subscribable.ts';
+import { Thread, ThreadEvent } from './basic.ts';
+import { MappedThread, type ThreadDerivation } from './mapped.ts';
 export declare const rollingFilter: (thread: Thread, pattern: DatalogQueryPattern, opts?: {
     name?: string;
     extraFilterName?: string;
 }) => MappedThread;
-export declare const rollingMapper: (thread: Thread, eventMapper: ApplogEventMapper, opts?: {
+export declare const rollingMapper: (thread: Thread, derivation: ThreadDerivation, opts?: {
     name?: string;
     extraFilterName?: string;
 }) => MappedThread;
-export declare const rollingAcc: <ACC extends IObservableArray | ObservableMap | ObservableSet>(thread: Thread, acc: ACC, eventMapper: (event: ThreadEvent, acc: ACC) => void, opts?: {
+export declare const rollingAcc: <ACC>(thread: Thread, acc: ACC, eventMapper: (event: ThreadEvent, acc: ACC) => void, opts?: {
     name?: string;
-}) => ACC;
-export declare const getUntrackedPattern: (pattern: DatalogQueryPattern) => {
-    [k: string]: string | number | boolean | import("..").AgentHash | CidString | ReadonlySet<string> | ObservableSet<string> | readonly string[] | ((value: string) => boolean) | ReadonlySet<CidString> | ObservableSet<CidString> | readonly CidString[] | ((value: CidString) => boolean) | ReadonlySet<import("..").AgentHash> | ObservableSet<import("..").AgentHash> | readonly import("..").AgentHash[] | ((value: import("..").AgentHash) => boolean) | ReadonlySet<ApplogValue> | ObservableSet<ApplogValue> | readonly ApplogValue[] | ((value: ApplogValue) => boolean);
-};
+}) => Subscribable<ACC>;
+export declare const getUntrackedPattern: (pattern: DatalogQueryPattern) => Partial<import("../applog.ts").WithMatchers<Applog>>;
 export declare function makeFilter(pattern: DatalogQueryPattern): (logs: readonly Applog[]) => Applog[];
 /**
  * // ! think twice before using

package/dist/thread/filters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/thread/filters.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,gBAAgB,EAEhB,aAAa,EACb,aAAa,EAKb,MAAM,MAAM,CAAA;AAIb,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,mBAAmB,EAAkB,MAAM,uBAAuB,CAAA;AAE5H,OAAO,EAAe,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAI1D,eAAO,MAAM,aAAa,WACjB,MAAM,WACL,mBAAmB,SACtB;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,iBAmEhD,CAAA;AAEF,eAAO,MAAM,aAAa,WACjB,MAAM,eACD,iBAAiB,SACxB;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,iBAmBhD,CAAA;AAEF,eAAO,MAAM,UAAU,GAEF,GAAG,SAAS,gBAAgB,GAAG,aAAa,GAAG,aAAa,UACvE,MAAM,OACT,GAAG,eACK,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,SAC7C;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,QAYxB,CAAA;AAwBD,eAAO,MAAM,mBAAmB,GAC/B,SAAS,mBAAmB;;CAS5B,CAAA;AACD,wBAAgB,UAAU,CACzB,OAAO,EAAE,mBAAmB,IAED,MAAM,SAAS,MAAM,EAAE,cAclD;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,GACrC,QAAQ,MAAM,EACd,SAAS,mBAAmB,EAC5B,OAAM;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,aAK5B,CAAA;AAKD,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,GAAG;IACzD,OAAO,EAAE,SAAS,CAAC,EAAE,CAAA;CACrB,CAAA;AACD,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAEpG;AACD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAItB,oBAAoB,CACrC;AACD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM;;;;EAM/C;AACD,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAA;AACjE,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;AAChE,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,CAAC,eAAe,GAAG,gBAAgB,CAAC,CAAA;AAC7F,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,EAAE,CAAA;CAAE,CAAA;AAE3D,gCAAgC;AAChC,eAAO,MAAM,UAAU,gCAA0B,CAAA;AAMjD,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,eAAe,CAAA;AACjF,eAAO,MAAM,kBAAkB,GAC9B,QAAQ,MAAM,EACd,WAAW,YAAY,EACvB,OAAM;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,iBAwDtD,CAAA"}
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/thread/filters.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,eAAe,EAA0B,mBAAmB,EAAkB,MAAM,0BAA0B,CAAA;AAI/H,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAe,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7D,OAAO,EAAsC,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAIrG,eAAO,MAAM,aAAa,WACjB,MAAM,WACL,mBAAmB,SACtB;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,iBAkChD,CAAA;AAEF,eAAO,MAAM,aAAa,WACjB,MAAM,cACF,gBAAgB,SACtB;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,iBAUhD,CAAA;AAEF,eAAO,MAAM,UAAU,GAEF,GAAG,UACd,MAAM,OACT,GAAG,eACK,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,SAC7C;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KACrB,YAAY,CAAC,GAAG,CAcnB,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC/B,SAAS,mBAAmB,yDAM5B,CAAA;AACD,wBAAgB,UAAU,CACzB,OAAO,EAAE,mBAAmB,IAED,MAAM,SAAS,MAAM,EAAE,cAclD;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,GACrC,QAAQ,MAAM,EACd,SAAS,mBAAmB,EAC5B,OAAM;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,aAK5B,CAAA;AAKD,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,GAAG;IACzD,OAAO,EAAE,SAAS,CAAC,EAAE,CAAA;CACrB,CAAA;AACD,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAEpG;AACD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAItB,oBAAoB,CACrC;AACD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM;;;;EAM/C;AACD,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAA;AACjE,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;AAChE,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,CAAC,eAAe,GAAG,gBAAgB,CAAC,CAAA;AAC7F,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,EAAE,CAAA;CAAE,CAAA;AAE3D,gCAAgC;AAChC,eAAO,MAAM,UAAU,gCAA0B,CAAA;AAMjD,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,eAAe,CAAA;AACjF,eAAO,MAAM,kBAAkB,GAC9B,QAAQ,MAAM,EACd,WAAW,YAAY,EACvB,OAAM;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,iBAyDtD,CAAA"}

package/dist/thread/indexes.d.ts

@@ -0,0 +1,56 @@
+import { Applog, ApplogValue, EntityID } from '../applog/datom-types.ts';
+import { type Subscribable } from '../query/subscribable.ts';
+import { Thread } from './basic.ts';
+/**
+ * Live index of applogs grouped by entity ID. Memoized per thread — one subscription
+ * per thread regardless of how many consumers call this. Updated incrementally on
+ * each parent event (O(event-size)). Lookup is O(1) via `map.get(en)`.
+ *
+ * Subscriber order: registers a 'derived' subscription on `thread` at first call. By
+ * the FIFO subscriber-order convention (`thread/basic.ts:notifySubscribers`),
+ * consumers that subscribe to `thread` AFTER calling `applogsByEntity(thread)` will
+ * see an up-to-date index when their handler runs.
+ */
+export declare const applogsByEntity: (thread: Thread) => ReadonlyMap<EntityID, readonly Applog[]>;
+/**
+ * Live index of applogs grouped by value for a given attribute. Value-based counterpart
+ * to `applogsByEntity` (which groups by entity ID).
+ *
+ * Uses `rollingFilter` internally for the attribute filter (memoized, shared with any
+ * other code filtering by the same attribute).
+ *
+ * Returns a `Subscribable` with lazy upstream activation:
+ * - Snapshot use: read `.value` — zero subscription overhead
+ * - Reactive use: `.subscribe()` activates the chain for incremental updates
+ */
+export declare const applogsByAttrValue: (thread: Thread, attr: string) => Subscribable<ReadonlyMap<ApplogValue, readonly Applog[]>>;
+export interface LinkEntry {
+    /** The link entity's own ID */
+    linkId: EntityID;
+    /** Value of attrA on this link entity */
+    aValue: EntityID;
+    /** Value of attrB on this link entity */
+    bValue: EntityID;
+}
+export interface EntityLinkIndexValue {
+    /** Lookup by attrA value → link entries (each has linkId + bValue) */
+    byA: ReadonlyMap<EntityID, readonly LinkEntry[]>;
+    /** Lookup by attrB value → link entries (each has linkId + aValue) */
+    byB: ReadonlyMap<EntityID, readonly LinkEntry[]>;
+}
+/**
+ * Live bidirectional index for entity-link relations: a common wovin pattern where
+ * a **link entity** connects two targets via two attributes.
+ *
+ * Example: note3 relations use a relation entity with `relation/block` (→ child block)
+ * and `relation/childOf` (→ parent block).
+ *
+ * Returns a `Subscribable` with lazy upstream activation:
+ * - Snapshot use: read `.value` — zero subscription overhead
+ * - Reactive use: `.subscribe()` activates the chain for incremental updates
+ *
+ * Link entity IDs are included in entries so consumers can look up full link state
+ * via `applogsByEntity`.
+ */
+export declare const entityLinkIndex: (thread: Thread, attrA: string, attrB: string) => Subscribable<EntityLinkIndexValue>;
+//# sourceMappingURL=indexes.d.ts.map

package/dist/thread/indexes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.d.ts","sourceRoot":"","sources":["../../src/thread/indexes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAExE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAe,MAAM,EAAE,MAAM,YAAY,CAAA;AAKhD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,WAEM,MAAM,KAAG,WAAW,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAiCjF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,WAGrB,MAAM,QACR,MAAM,KACV,YAAY,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC,CAwC3D,CAAA;AAID,MAAM,WAAW,SAAS;IACzB,+BAA+B;IAC/B,MAAM,EAAE,QAAQ,CAAA;IAChB,yCAAyC;IACzC,MAAM,EAAE,QAAQ,CAAA;IAChB,yCAAyC;IACzC,MAAM,EAAE,QAAQ,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACpC,sEAAsE;IACtE,GAAG,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC,CAAA;IAChD,sEAAsE;IACtE,GAAG,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC,CAAA;CAChD;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,WAGlB,MAAM,SACP,MAAM,SACN,MAAM,KACX,YAAY,CAAC,oBAAoB,CAiGpC,CAAA"}