@graphrefly/graphrefly 0.26.0 → 0.28.0

package/dist/{index-DFhjO4Gg.d.cts → index-DL-rYJrx.d.cts}

@@ -1,4 +1,4 @@
-import { N as Node } from './node-C_IBuvX2.cjs';
+import { a as Node } from './node-Cc1TniY8.cjs';
 
 /**
  * Subscribe to a read-only `Node<T>` as a React value. Re-renders on node value settlement.

package/dist/index-DP4ZTkdw.d.ts

@@ -0,0 +1,139 @@
+import { a as Node } from './node-Cc1TniY8.js';
+import { G as Graph } from './graph-BZGRXwOm.js';
+
+/**
+ * Memory patterns (roadmap §4.3).
+ *
+ * Domain-layer helpers composed from GraphRefly primitives. `vectorIndex` uses
+ * an exact-search backend by default; an HNSW adapter can be injected as an
+ * optional dependency.
+ */
+
+type CollectionPolicy = "fifo" | "lru";
+type VectorBackend = "flat" | "hnsw";
+type LightCollectionEntry<T> = {
+    readonly id: string;
+    readonly value: T;
+    readonly createdAtNs: number;
+    readonly lastAccessNs: number;
+};
+type LightCollectionOptions = {
+    name?: string;
+    maxSize?: number;
+    policy?: CollectionPolicy;
+};
+type LightCollectionBundle<T> = {
+    readonly entries: Node<ReadonlyMap<string, LightCollectionEntry<T>>>;
+    upsert: (id: string, value: T) => void;
+    remove: (id: string) => void;
+    clear: () => void;
+    get: (id: string) => T | undefined;
+    has: (id: string) => boolean;
+};
+type CollectionEntry<T> = LightCollectionEntry<T> & {
+    readonly baseScore: number;
+};
+type RankedCollectionEntry<T> = CollectionEntry<T> & {
+    readonly score: number;
+};
+type CollectionOptions<T> = {
+    maxSize?: number;
+    policy?: CollectionPolicy;
+    /**
+     * Produces a base score at insert/update time.
+     */
+    score?: (value: T) => number;
+    /**
+     * Exponential decay rate per second. 0 disables decay.
+     */
+    decayRate?: number;
+    /**
+     * Minimum score floor after decay.
+     */
+    minScore?: number;
+};
+type CollectionGraph<T> = Graph & {
+    upsert: (id: string, value: T, opts?: {
+        score?: number;
+    }) => void;
+    remove: (id: string) => void;
+    clear: () => void;
+    getItem: (id: string) => CollectionEntry<T> | undefined;
+};
+type VectorRecord<TMeta> = {
+    readonly id: string;
+    readonly vector: readonly number[];
+    readonly meta?: TMeta;
+};
+type VectorSearchResult<TMeta> = {
+    readonly id: string;
+    readonly score: number;
+    readonly meta?: TMeta;
+};
+type HnswAdapter<TMeta> = {
+    upsert: (id: string, vector: readonly number[], meta?: TMeta) => void;
+    remove: (id: string) => void;
+    clear: () => void;
+    search: (query: readonly number[], k: number) => ReadonlyArray<VectorSearchResult<TMeta>>;
+};
+type VectorIndexOptions<TMeta> = {
+    backend?: VectorBackend;
+    dimension?: number;
+    /**
+     * Optional dependency seam for HNSW.
+     */
+    hnswFactory?: () => HnswAdapter<TMeta>;
+};
+type VectorIndexBundle<TMeta> = {
+    readonly backend: VectorBackend;
+    readonly entries: Node<ReadonlyMap<string, VectorRecord<TMeta>>>;
+    upsert: (id: string, vector: readonly number[], meta?: TMeta) => void;
+    remove: (id: string) => void;
+    clear: () => void;
+    search: (query: readonly number[], k?: number) => ReadonlyArray<VectorSearchResult<TMeta>>;
+};
+type KnowledgeEdge<TRelation extends string = string> = {
+    readonly from: string;
+    readonly to: string;
+    readonly relation: TRelation;
+    readonly weight: number;
+};
+type KnowledgeGraphGraph<TEntity, TRelation extends string = string> = Graph & {
+    upsertEntity: (id: string, value: TEntity) => void;
+    removeEntity: (id: string) => void;
+    link: (from: string, to: string, relation: TRelation, weight?: number) => void;
+    unlink: (from: string, to: string, relation?: TRelation) => void;
+    related: (id: string, relation?: TRelation) => ReadonlyArray<KnowledgeEdge<TRelation>>;
+};
+declare function decay(baseScore: number, ageSeconds: number, ratePerSecond: number, minScore?: number): number;
+declare function lightCollection<T>(opts?: LightCollectionOptions): LightCollectionBundle<T>;
+declare function collection<T>(name: string, opts?: CollectionOptions<T>): CollectionGraph<T>;
+declare function vectorIndex<TMeta>(opts?: VectorIndexOptions<TMeta>): VectorIndexBundle<TMeta>;
+declare function knowledgeGraph<TEntity, TRelation extends string = string>(name: string): KnowledgeGraphGraph<TEntity, TRelation>;
+
+type index_CollectionEntry<T> = CollectionEntry<T>;
+type index_CollectionGraph<T> = CollectionGraph<T>;
+type index_CollectionOptions<T> = CollectionOptions<T>;
+type index_CollectionPolicy = CollectionPolicy;
+type index_HnswAdapter<TMeta> = HnswAdapter<TMeta>;
+type index_KnowledgeEdge<TRelation extends string = string> = KnowledgeEdge<TRelation>;
+type index_KnowledgeGraphGraph<TEntity, TRelation extends string = string> = KnowledgeGraphGraph<TEntity, TRelation>;
+type index_LightCollectionBundle<T> = LightCollectionBundle<T>;
+type index_LightCollectionEntry<T> = LightCollectionEntry<T>;
+type index_LightCollectionOptions = LightCollectionOptions;
+type index_RankedCollectionEntry<T> = RankedCollectionEntry<T>;
+type index_VectorBackend = VectorBackend;
+type index_VectorIndexBundle<TMeta> = VectorIndexBundle<TMeta>;
+type index_VectorIndexOptions<TMeta> = VectorIndexOptions<TMeta>;
+type index_VectorRecord<TMeta> = VectorRecord<TMeta>;
+type index_VectorSearchResult<TMeta> = VectorSearchResult<TMeta>;
+declare const index_collection: typeof collection;
+declare const index_decay: typeof decay;
+declare const index_knowledgeGraph: typeof knowledgeGraph;
+declare const index_lightCollection: typeof lightCollection;
+declare const index_vectorIndex: typeof vectorIndex;
+declare namespace index {
+  export { type index_CollectionEntry as CollectionEntry, type index_CollectionGraph as CollectionGraph, type index_CollectionOptions as CollectionOptions, type index_CollectionPolicy as CollectionPolicy, type index_HnswAdapter as HnswAdapter, type index_KnowledgeEdge as KnowledgeEdge, type index_KnowledgeGraphGraph as KnowledgeGraphGraph, type index_LightCollectionBundle as LightCollectionBundle, type index_LightCollectionEntry as LightCollectionEntry, type index_LightCollectionOptions as LightCollectionOptions, type index_RankedCollectionEntry as RankedCollectionEntry, type index_VectorBackend as VectorBackend, type index_VectorIndexBundle as VectorIndexBundle, type index_VectorIndexOptions as VectorIndexOptions, type index_VectorRecord as VectorRecord, type index_VectorSearchResult as VectorSearchResult, index_collection as collection, index_decay as decay, index_knowledgeGraph as knowledgeGraph, index_lightCollection as lightCollection, index_vectorIndex as vectorIndex };
+}
+
+export { type CollectionEntry as C, type HnswAdapter as H, type KnowledgeGraphGraph as K, type LightCollectionBundle as L, type RankedCollectionEntry as R, type VectorIndexBundle as V, type VectorSearchResult as a, type CollectionGraph as b, type CollectionOptions as c, type CollectionPolicy as d, type KnowledgeEdge as e, type LightCollectionEntry as f, type LightCollectionOptions as g, type VectorBackend as h, index as i, type VectorIndexOptions as j, type VectorRecord as k, collection as l, decay as m, knowledgeGraph as n, lightCollection as o, vectorIndex as v };