@graphrefly/graphrefly 0.25.0 → 0.27.0

package/dist/index-B1tloyhO.d.cts

@@ -0,0 +1,34 @@
+import { Ref, WatchSource } from 'vue';
+import { N as Node } from './node-BmerH3kS.cjs';
+
+/**
+ * Subscribe to a read-only `Node<T>` as a Vue `Ref<T>`. Auto-unsubscribes on scope disposal.
+ * Subscription lifecycle is tied to Vue scope disposal (not node terminal messages).
+ */
+declare function useSubscribe<T>(node: Node<T>): Readonly<Ref<T | undefined | null>>;
+/**
+ * Bind a writable `Node<T>` as a Vue `Ref<T>`. Reads and writes are bidirectional.
+ * Value sets always dispatch `[[DIRTY], [DATA, value]]`, including `value === undefined`.
+ * Subscription lifecycle is tied to Vue scope disposal (not node terminal messages).
+ */
+declare function useStore<T>(node: Node<T>): Ref<T | undefined | null>;
+/** Maps a key to an object of nodes. Used by `useSubscribeRecord` factory. */
+type NodeFactory<K, R extends Record<string, any>> = (key: K) => {
+    [P in keyof R]: Node<R[P]>;
+};
+/**
+ * Subscribe to a dynamic set of keyed node records. When keys change,
+ * old subscriptions are torn down and new ones created automatically.
+ * Must be called during Vue `setup()`.
+ */
+declare function useSubscribeRecord<K extends string, R extends Record<string, any>>(keys: WatchSource<K[] | undefined>, factory: NodeFactory<K, R>): Readonly<Ref<Record<K, R>>>;
+
+type index_NodeFactory<K, R extends Record<string, any>> = NodeFactory<K, R>;
+declare const index_useStore: typeof useStore;
+declare const index_useSubscribe: typeof useSubscribe;
+declare const index_useSubscribeRecord: typeof useSubscribeRecord;
+declare namespace index {
+  export { type index_NodeFactory as NodeFactory, index_useStore as useStore, index_useSubscribe as useSubscribe, index_useSubscribeRecord as useSubscribeRecord };
+}
+
+export { type NodeFactory as N, useSubscribe as a, useSubscribeRecord as b, index as i, useStore as u };

package/dist/{index-CYkjxu3s.d.ts → index-B6D3QNSA.d.ts}

@@ -1,5 +1,5 @@
-import { k as GraphReFlyConfig } from './node-B-f-Lu-k.js';
-import { r as GraphPersistSnapshot, g as GraphCheckpointRecord, D as DescribeFilter, e as GRAPH_META_SEGMENT, G as Graph, f as GraphActorOptions, b as GraphAttachStorageOptions, h as GraphDescribeOptions, i as GraphDescribeOutput, j as GraphDiagramDirection, k as GraphDiagramOptions, l as GraphDiffChange, m as GraphDiffResult, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, d as GraphProfileOptions, c as GraphProfileResult, s as GraphVersionChange, t as GraphWALDiff, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, A as diffForWAL, B as graphProfile, C as reachable } from './graph-B6NFqv3z.js';
+import { j as GraphReFlyConfig } from './node-BmerH3kS.js';
+import { s as GraphPersistSnapshot, l as GraphCheckpointRecord, a as Graph, T as TopologyEvent, C as CausalChain, h as CausalStep, D as DescribeFilter, E as ExplainPathOptions, i as GRAPH_META_SEGMENT, j as GraphActorOptions, k as GraphAttachStorageOptions, b as GraphDescribeOptions, c as GraphDescribeOutput, m as GraphDiagramDirection, n as GraphDiagramOptions, o as GraphDiffChange, g as GraphDiffResult, p as GraphFactoryContext, f as GraphNodeFactory, q as GraphObserveAll, r as GraphObserveOne, G as GraphOptions, e as GraphProfileOptions, d as GraphProfileResult, t as GraphVersionChange, u as GraphWALDiff, N as NodeProfile, O as ObserveDetail, v as ObserveEvent, w as ObserveOptions, x as ObserveResult, y as ObserveTheme, z as ObserveThemeName, R as ReachableDirection, A as ReachableOptions, S as SNAPSHOT_VERSION, B as TraceEntry, F as diffForWAL, H as explainPath, I as graphProfile, J as reachable } from './graph-CCwGKLCm.js';
 
 /**
  * Approximate in-memory size estimation for arbitrary JS values.
@@ -254,14 +254,39 @@ declare function registerBuiltinCodecs(config: GraphReFlyConfig): void;
  */
 declare function replayWAL(entries: readonly WALEntry[]): GraphPersistSnapshot;
 
+/**
+ * Subscribe to structural changes across `graph` and every transitively
+ * mounted subgraph. `cb` fires on every {@link TopologyEvent} from any
+ * graph in the tree. Newly-mounted subgraphs are auto-wired when their
+ * parent emits `{kind: "added", nodeKind: "mount"}`; newly-unmounted
+ * subgraphs' subscriptions are disposed via the parent's
+ * `{kind: "removed", nodeKind: "mount"}` event plus the returned
+ * `GraphRemoveAudit`.
+ *
+ * The callback receives a third argument `prefix`: the `::`-delimited
+ * path from the root watched graph to the emitter, ending with `"::"`
+ * (empty string when the event comes from the root itself). Compute
+ * a qualified path for an added/removed entry as `prefix + event.name`.
+ *
+ * @param graph - Root graph to watch.
+ * @param cb - Receives `(event, emitterGraph, prefix)`.
+ * @returns Dispose function — tears down every active subscription.
+ *
+ * @category observability
+ */
+declare function watchTopologyTree(graph: Graph, cb: (event: TopologyEvent, emitter: Graph, prefix: string) => void): () => void;
+
 /**
  * Graph container: registry, wiring, introspection (Phase 1).
  */
 
+declare const index_CausalChain: typeof CausalChain;
+declare const index_CausalStep: typeof CausalStep;
 declare const index_DescribeFilter: typeof DescribeFilter;
 declare const index_ENVELOPE_VERSION: typeof ENVELOPE_VERSION;
 type index_EvictedSubgraphInfo = EvictedSubgraphInfo;
 type index_EvictionPolicy = EvictionPolicy;
+declare const index_ExplainPathOptions: typeof ExplainPathOptions;
 declare const index_GRAPH_META_SEGMENT: typeof GRAPH_META_SEGMENT;
 declare const index_Graph: typeof Graph;
 declare const index_GraphActorOptions: typeof GraphActorOptions;
@@ -296,6 +321,8 @@ declare const index_ObserveThemeName: typeof ObserveThemeName;
 declare const index_ReachableDirection: typeof ReachableDirection;
 declare const index_ReachableOptions: typeof ReachableOptions;
 declare const index_SIZEOF_SYMBOL: typeof SIZEOF_SYMBOL;
+declare const index_SNAPSHOT_VERSION: typeof SNAPSHOT_VERSION;
+declare const index_TopologyEvent: typeof TopologyEvent;
 declare const index_TraceEntry: typeof TraceEntry;
 type index_WALEntry = WALEntry;
 declare const index_createDagCborCodec: typeof createDagCborCodec;
@@ -303,13 +330,15 @@ declare const index_createDagCborZstdCodec: typeof createDagCborZstdCodec;
 declare const index_decodeEnvelope: typeof decodeEnvelope;
 declare const index_diffForWAL: typeof diffForWAL;
 declare const index_encodeEnvelope: typeof encodeEnvelope;
+declare const index_explainPath: typeof explainPath;
 declare const index_graphProfile: typeof graphProfile;
 declare const index_reachable: typeof reachable;
 declare const index_registerBuiltinCodecs: typeof registerBuiltinCodecs;
 declare const index_replayWAL: typeof replayWAL;
 declare const index_sizeof: typeof sizeof;
+declare const index_watchTopologyTree: typeof watchTopologyTree;
 declare namespace index {
-  export { index_DescribeFilter as DescribeFilter, index_ENVELOPE_VERSION as ENVELOPE_VERSION, type index_EvictedSubgraphInfo as EvictedSubgraphInfo, type index_EvictionPolicy as EvictionPolicy, index_GRAPH_META_SEGMENT as GRAPH_META_SEGMENT, index_Graph as Graph, index_GraphActorOptions as GraphActorOptions, index_GraphAttachStorageOptions as GraphAttachStorageOptions, index_GraphCheckpointRecord as GraphCheckpointRecord, type index_GraphCodec as GraphCodec, index_GraphDescribeOptions as GraphDescribeOptions, index_GraphDescribeOutput as GraphDescribeOutput, index_GraphDiagramDirection as GraphDiagramDirection, index_GraphDiagramOptions as GraphDiagramOptions, index_GraphDiffChange as GraphDiffChange, index_GraphDiffResult as GraphDiffResult, index_GraphFactoryContext as GraphFactoryContext, index_GraphNodeFactory as GraphNodeFactory, index_GraphObserveAll as GraphObserveAll, index_GraphObserveOne as GraphObserveOne, index_GraphOptions as GraphOptions, index_GraphPersistSnapshot as GraphPersistSnapshot, index_GraphProfileOptions as GraphProfileOptions, index_GraphProfileResult as GraphProfileResult, index_GraphVersionChange as GraphVersionChange, index_GraphWALDiff as GraphWALDiff, index_JsonCodec as JsonCodec, type index_LazyGraphCodec as LazyGraphCodec, index_NodeProfile as NodeProfile, index_ObserveDetail as ObserveDetail, index_ObserveEvent as ObserveEvent, index_ObserveOptions as ObserveOptions, index_ObserveResult as ObserveResult, index_ObserveTheme as ObserveTheme, index_ObserveThemeName as ObserveThemeName, index_ReachableDirection as ReachableDirection, index_ReachableOptions as ReachableOptions, OVERHEAD as SIZEOF_OVERHEAD, index_SIZEOF_SYMBOL as SIZEOF_SYMBOL, index_TraceEntry as TraceEntry, type index_WALEntry as WALEntry, index_createDagCborCodec as createDagCborCodec, index_createDagCborZstdCodec as createDagCborZstdCodec, index_decodeEnvelope as decodeEnvelope, index_diffForWAL as diffForWAL, index_encodeEnvelope as encodeEnvelope, index_graphProfile as graphProfile, index_reachable as reachable, index_registerBuiltinCodecs as registerBuiltinCodecs, index_replayWAL as replayWAL, index_sizeof as sizeof };
+  export { index_CausalChain as CausalChain, index_CausalStep as CausalStep, index_DescribeFilter as DescribeFilter, index_ENVELOPE_VERSION as ENVELOPE_VERSION, type index_EvictedSubgraphInfo as EvictedSubgraphInfo, type index_EvictionPolicy as EvictionPolicy, index_ExplainPathOptions as ExplainPathOptions, index_GRAPH_META_SEGMENT as GRAPH_META_SEGMENT, index_Graph as Graph, index_GraphActorOptions as GraphActorOptions, index_GraphAttachStorageOptions as GraphAttachStorageOptions, index_GraphCheckpointRecord as GraphCheckpointRecord, type index_GraphCodec as GraphCodec, index_GraphDescribeOptions as GraphDescribeOptions, index_GraphDescribeOutput as GraphDescribeOutput, index_GraphDiagramDirection as GraphDiagramDirection, index_GraphDiagramOptions as GraphDiagramOptions, index_GraphDiffChange as GraphDiffChange, index_GraphDiffResult as GraphDiffResult, index_GraphFactoryContext as GraphFactoryContext, index_GraphNodeFactory as GraphNodeFactory, index_GraphObserveAll as GraphObserveAll, index_GraphObserveOne as GraphObserveOne, index_GraphOptions as GraphOptions, index_GraphPersistSnapshot as GraphPersistSnapshot, index_GraphProfileOptions as GraphProfileOptions, index_GraphProfileResult as GraphProfileResult, index_GraphVersionChange as GraphVersionChange, index_GraphWALDiff as GraphWALDiff, index_JsonCodec as JsonCodec, type index_LazyGraphCodec as LazyGraphCodec, index_NodeProfile as NodeProfile, index_ObserveDetail as ObserveDetail, index_ObserveEvent as ObserveEvent, index_ObserveOptions as ObserveOptions, index_ObserveResult as ObserveResult, index_ObserveTheme as ObserveTheme, index_ObserveThemeName as ObserveThemeName, index_ReachableDirection as ReachableDirection, index_ReachableOptions as ReachableOptions, OVERHEAD as SIZEOF_OVERHEAD, index_SIZEOF_SYMBOL as SIZEOF_SYMBOL, index_SNAPSHOT_VERSION as SNAPSHOT_VERSION, index_TopologyEvent as TopologyEvent, index_TraceEntry as TraceEntry, type index_WALEntry as WALEntry, index_createDagCborCodec as createDagCborCodec, index_createDagCborZstdCodec as createDagCborZstdCodec, index_decodeEnvelope as decodeEnvelope, index_diffForWAL as diffForWAL, index_encodeEnvelope as encodeEnvelope, index_explainPath as explainPath, index_graphProfile as graphProfile, index_reachable as reachable, index_registerBuiltinCodecs as registerBuiltinCodecs, index_replayWAL as replayWAL, index_sizeof as sizeof, index_watchTopologyTree as watchTopologyTree };
 }
 
-export { ENVELOPE_VERSION as E, type GraphCodec as G, JsonCodec as J, type LazyGraphCodec as L, OVERHEAD as O, SIZEOF_SYMBOL as S, type WALEntry as W, type EvictedSubgraphInfo as a, type EvictionPolicy as b, createDagCborCodec as c, createDagCborZstdCodec as d, decodeEnvelope as e, encodeEnvelope as f, replayWAL as g, index as i, registerBuiltinCodecs as r, sizeof as s };
+export { ENVELOPE_VERSION as E, type GraphCodec as G, JsonCodec as J, type LazyGraphCodec as L, OVERHEAD as O, SIZEOF_SYMBOL as S, type WALEntry as W, type EvictedSubgraphInfo as a, type EvictionPolicy as b, createDagCborCodec as c, createDagCborZstdCodec as d, decodeEnvelope as e, encodeEnvelope as f, replayWAL as g, index as i, registerBuiltinCodecs as r, sizeof as s, watchTopologyTree as w };

package/dist/index-B6EhDnjH.d.cts

@@ -0,0 +1,37 @@
+import { a as Graph } from './graph-DNCrvZSn.cjs';
+
+/** Zustand-compatible Store API. */
+interface StoreApi<T> {
+    getState: () => T;
+    setState: (partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean) => void;
+    getInitialState: () => T;
+    subscribe: (listener: (state: T, prevState: T) => void) => () => void;
+    destroy: () => void;
+}
+/** Function type for initializing the store. */
+type StateCreator<T> = (set: StoreApi<T>["setState"], get: StoreApi<T>["getState"], api: StoreApi<T>) => T;
+/**
+ * Creates a Zustand-compatible store backed by a GraphReFly state node.
+ * returns an object that is both a Graph and a StoreApi.
+ *
+ * @example
+ * ```ts
+ * const store = create((set) => ({
+ *   count: 0,
+ *   inc: () => set((s) => ({ count: s.count + 1 }))
+ * }));
+ * store.getState().inc();
+ * ```
+ *
+ * @category compat
+ */
+declare function create<T extends object>(initializer: StateCreator<T>): Graph & StoreApi<T>;
+
+type index_StateCreator<T> = StateCreator<T>;
+type index_StoreApi<T> = StoreApi<T>;
+declare const index_create: typeof create;
+declare namespace index {
+  export { type index_StateCreator as StateCreator, type index_StoreApi as StoreApi, index_create as create };
+}
+
+export { type StateCreator as S, type StoreApi as a, create as c, index as i };

package/dist/index-B9B7_HEY.d.ts

@@ -0,0 +1,37 @@
+import { a as Graph } from './graph-CCwGKLCm.js';
+
+/** Zustand-compatible Store API. */
+interface StoreApi<T> {
+    getState: () => T;
+    setState: (partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean) => void;
+    getInitialState: () => T;
+    subscribe: (listener: (state: T, prevState: T) => void) => () => void;
+    destroy: () => void;
+}
+/** Function type for initializing the store. */
+type StateCreator<T> = (set: StoreApi<T>["setState"], get: StoreApi<T>["getState"], api: StoreApi<T>) => T;
+/**
+ * Creates a Zustand-compatible store backed by a GraphReFly state node.
+ * returns an object that is both a Graph and a StoreApi.
+ *
+ * @example
+ * ```ts
+ * const store = create((set) => ({
+ *   count: 0,
+ *   inc: () => set((s) => ({ count: s.count + 1 }))
+ * }));
+ * store.getState().inc();
+ * ```
+ *
+ * @category compat
+ */
+declare function create<T extends object>(initializer: StateCreator<T>): Graph & StoreApi<T>;
+
+type index_StateCreator<T> = StateCreator<T>;
+type index_StoreApi<T> = StoreApi<T>;
+declare const index_create: typeof create;
+declare namespace index {
+  export { type index_StateCreator as StateCreator, type index_StoreApi as StoreApi, index_create as create };
+}
+
+export { type StateCreator as S, type StoreApi as a, create as c, index as i };