@graphrefly/ts 0.0.0

package/dist/graph/index.d.cts

@@ -0,0 +1,251 @@
+export { DescribeChangeset, DescribeEvent, PipeOperator, Stratified, StratifyOptions, StratifyRule, pipe, stratify, stratifyBranch, topologyDiff } from '../composition/index.cjs';
+export { C as CapacityPolicy, I as IndexChange, a as IndexRow, L as ListChange, c as LogChange, M as MapChange, O as OrderedCapacityPolicy, j as ReactiveIndex, k as ReactiveIndexCapacityOrder, l as ReactiveIndexCapacityPolicy, m as ReactiveIndexOpt, n as ReactiveIndexOptions, s as ReactiveOpt, t as ReactiveView, u as RetentionPolicy, V as ViewCachePolicy, H as reactiveIndex } from '../reactive-collection-BxBqtIOE.cjs';
+export { R as ReactiveList, a as ReactiveListOpt, b as ReactiveListOptions, c as ReactiveLog, d as ReactiveLogOptions, e as ReactiveMap, f as ReactiveMapOpt, g as ReactiveMapOptions, h as ReactiveMapRetentionEntry, i as ReactiveMapRetentionPolicy, m as mergeReactiveLogs, r as reactiveList, j as reactiveLog, k as reactiveMap, s as scanLog } from '../reactive-map-D-g3dv8I.cjs';
+export { restoreReactiveIndex, restoreReactiveList, restoreReactiveLog, restoreReactiveMap } from '../data-structures/index.cjs';
+export { DescribeToAsciiOptions, DescribeToD2Options, DescribeToJsonOptions, DescribeToMermaidOptions, DescribeToMermaidUrlOptions, DescribeToPrettyOptions, DiagramDirection, MermaidLiveTheme, MermaidLiveUrlOptions, describeToAscii, describeToD2, describeToJson, describeToMermaid, describeToMermaidUrl, describeToPretty, mermaidLiveUrl } from '../render/index.cjs';
+import { d as Graph } from '../graph-s23RbbFO.cjs';
+export { b as DerivedFn, E as EffectFn, G as GRAPH_BLUEPRINT_VERSION, c as GRAPH_CHECKPOINT_VERSION, e as GraphBlueprint, f as GraphBlueprintDiagnosticCode, g as GraphBlueprintDiagnosticIssue, h as GraphBlueprintDiagnostics, i as GraphBlueprintHash, j as GraphBlueprintHashInput, k as GraphBlueprintHashOptions, l as GraphBlueprintJson, m as GraphBlueprintOptions, n as GraphBlueprintProvenance, o as GraphCheckpoint, p as GraphCheckpointEdge, q as GraphCheckpointFactory, r as GraphCheckpointJson, s as GraphCheckpointMount, t as GraphCheckpointNode, u as GraphCheckpointTerminal, v as GraphCheckpointValue, w as GraphCheckpointVersion, x as GraphOptions, z as GraphRestoreDescriptor, A as GraphRestoreDescriptorContext, C as GraphRestoreRegistry, N as NodeProfile, F as NormalizedGraphTopologyNode, H as NormalizedGraphTopologySnapshot, O as ObserveEvent, I as ObserveEventEquals, J as ObservePredicate, K as ObserveStream, P as Profile, R as RestoreGraphOptions, Q as StateNode, T as SugarOpts, V as TopologyEvent, W as TopologyEventKind, X as TopologyGroup, Y as TopologyGroupOptions, Z as TopologyGroupReleaseOptions, _ as TopologyStream, a0 as canonicalTopologyBytes, a1 as canonicalTopologyJson, a3 as coalesceObserve, a4 as defaultRestoreRegistry, a9 as filterObserve, ac as graph, ad as graphBlueprintDiagnostics, aj as normalizeTopology, ao as restoreGraph, at as stateRestoreDescriptor, av as takeRestoreDescriptor, az as timerRestoreDescriptor, aB as withBlueprintHash, aC as withBlueprintProvenance } from '../graph-s23RbbFO.cjs';
+import { N as Node, C as Ctx } from '../types-bNMSWKqF.cjs';
+export { b as DriverCancel, c as DriverResult, E as EnvironmentDrivers, d as EnvironmentDriversInit, F as FetchLike, e as FetchResponseLike, g as HttpRequest, h as HttpResponse, L as LocalHttpDriver, i as LocalProcessDriver, j as LocalSseDriver, k as LocalWebSocketDriver, l as LocalWebhookDriver, w as ProcessCommand, x as ProcessResult, y as SseDriverEvent, z as SseEvent, A as SseRequest, G as WebSocketConstructorLike, I as WebSocketDriverEvent, J as WebSocketEvent, K as WebSocketLike, M as WebSocketRequest, O as WebSocketSend, Q as WebSocketSendResult, U as WebSocketSessionHandle, V as WebhookDriverEvent, X as WebhookEvent, Y as WebhookRegistration, a4 as domWebSocketDriver, a6 as fetchHttpDriver } from '../types-bNMSWKqF.cjs';
+import { f as KvStorageTier } from '../append-log-DisvEReb.cjs';
+import { b as ReadThroughLookupTier } from '../read-through-B1CYPfq_.cjs';
+import { a as DescribeNode, c as DescribeSnapshot } from '../describe-Ciu8SUnN.cjs';
+export { D as DescribeEdge, b as DescribeOpts, G as GraphTopologyEdge, d as GraphTopologyNode, e as GraphTopologySnapshot } from '../describe-Ciu8SUnN.cjs';
+export { B as BackoffPolicy, R as RetryPolicy, a as RetryState, b as RetryStatus, c as backoffDelayMs, n as nextRetryDelayMs, d as noBackoff, r as retryPolicy, s as shouldRetry } from '../resilience-Dig3Q7n0.cjs';
+import '../messages-BZqrGGm1.cjs';
+import '../core/index.cjs';
+import '../codec-BB7p8fJc.cjs';
+
+/** Dynamic read-through policy for {@link reactiveCascadingCache}. */
+interface CascadingCachePolicy {
+    readonly promoteTo?: readonly number[] | false;
+}
+type CascadingCacheStatus<K> = {
+    readonly kind: "idle";
+} | {
+    readonly kind: "loading";
+    readonly key: K;
+    readonly requestSeq: number;
+} | {
+    readonly kind: "hit";
+    readonly key: K;
+    readonly requestSeq: number;
+    readonly tier?: ReadThroughLookupTier;
+} | {
+    readonly kind: "miss";
+    readonly key: K;
+    readonly requestSeq: number;
+} | {
+    readonly kind: "error";
+    readonly key: K;
+    readonly requestSeq: number;
+    readonly error: unknown;
+};
+type CascadingCacheEvent<K, V> = {
+    readonly kind: "request";
+    readonly key: K;
+    readonly requestSeq: number;
+} | {
+    readonly kind: "invalidate";
+    readonly key: K;
+    readonly requestSeq: number;
+} | {
+    readonly kind: "lookup";
+    readonly key: K;
+    readonly requestSeq: number;
+    readonly outcome: "hit" | "miss" | "error";
+    readonly tier: ReadThroughLookupTier;
+    readonly value?: V;
+    readonly error?: unknown;
+} | {
+    readonly kind: "promotion";
+    readonly key: K;
+    readonly requestSeq: number;
+    readonly tier: ReadThroughLookupTier;
+    readonly ok: boolean;
+    readonly error?: unknown;
+} | {
+    readonly kind: "fill";
+    readonly key: K;
+    readonly requestSeq: number;
+    readonly status: "hit" | "miss" | "error";
+    readonly value?: V;
+    readonly tier?: ReadThroughLookupTier;
+    readonly error?: unknown;
+} | {
+    readonly kind: "error";
+    readonly key: K;
+    readonly requestSeq: number;
+    readonly stage: "lookup" | "promotion";
+    readonly tier?: ReadThroughLookupTier;
+    readonly error: unknown;
+};
+interface ReactiveCascadingCacheOptions<K extends string, V> {
+    readonly graph: Graph;
+    readonly request: Node<K>;
+    readonly policy?: Node<CascadingCachePolicy>;
+    readonly invalidate?: Node<K>;
+    readonly tiers: readonly KvStorageTier<V>[];
+    readonly load?: (key: K) => Promise<V | undefined> | V | undefined;
+    readonly tierNames?: readonly string[];
+    /**
+     * Storage promotion is explicit for the graph-layer factory. `requestSeq` guards visible graph
+     * value/status updates; without a generation/CAS storage contract, passive tier writes are
+     * best-effort and cannot be made stale-proof once an async `set` has started.
+     *
+     * @default false
+     */
+    readonly promoteTo?: readonly number[] | false;
+    readonly name?: string;
+    readonly meta?: Record<string, unknown>;
+}
+interface ReactiveCascadingCache<K, V> {
+    readonly value: Node<V | undefined>;
+    readonly status: Node<CascadingCacheStatus<K>>;
+    readonly events: Node<CascadingCacheEvent<K, V>>;
+}
+/**
+ * Free-standing graph-layer cascading cache factory (D104/D105/D107).
+ *
+ * Passive tiers stay in `tieredReadThrough`; this factory wraps lookup work at an async pool
+ * boundary and exposes every request, invalidation, lookup, promotion, fill, status, and value
+ * change through declared graph nodes. `requestSeq` is the stale-fill guard for visible graph
+ * nodes: older async fills may still be observable as events, but downstream value/status nodes
+ * ignore them. Storage promotion defaults to `false` here because passive tier writes have no
+ * generation/CAS contract; callers may opt in with `promoteTo` when best-effort promotion is
+ * acceptable.
+ */
+declare function reactiveCascadingCache<K extends string, V>(opts: ReactiveCascadingCacheOptions<K, V>): ReactiveCascadingCache<K, V>;
+
+/**
+ * Pure graph diagnostics over {@link DescribeSnapshot} (D39/R-describe).
+ *
+ * These helpers re-derive the useful frozen pure-ts inspection utilities without restoring
+ * graph methods, path facades, actors, soft edges, or storage coupling. They operate only on the
+ * public JSON-serializable describe shape; the live topology truth remains R-edges-derived.
+ */
+
+type ReachableDirection = "upstream" | "downstream";
+interface ReachableOptions {
+    /** Maximum hop distance to walk. Omit for unbounded. */
+    maxDepth?: number;
+    /** Walk both upstream and downstream, ignoring `direction`. */
+    both?: boolean;
+    /** Return depths/truncation metadata instead of only sorted paths. */
+    withDetail?: boolean;
+}
+interface ReachableResult {
+    /** Reachable node ids, excluding the start id, sorted deterministically. */
+    paths: readonly string[];
+    /** Hop depth by reachable node id. */
+    depths: Readonly<Record<string, number>>;
+    /** True when `maxDepth` cut off at least one still-expandable frontier node. */
+    truncated: boolean;
+}
+type ExplainPathReason = "ok" | "no-such-from" | "no-such-to" | "no-path" | "max-depth-exceeded";
+interface ExplainPathOptions {
+    /** Maximum hop distance to search. Omit for unbounded. */
+    maxDepth?: number;
+    /** When `from === to`, search for a non-trivial cycle before returning the trivial step. */
+    findCycle?: boolean;
+}
+interface CausalStep {
+    /** Mount-aware describe node id. */
+    id: string;
+    /** Operator/verb factory name from describe. */
+    factory: string;
+    /** Status as of the source snapshot. */
+    status: DescribeNode["status"];
+    /** Cached value when present; absence still means SENTINEL. */
+    value?: unknown;
+    /** Hop distance from the `from` node. */
+    hop: number;
+    /** First dep slot in the next step that points at this step, when the edge is dep-derived. */
+    depIndex?: number;
+    /** All matching dep slots when the next step depends on this step more than once. */
+    depIndices?: readonly number[];
+}
+interface CausalChain {
+    from: string;
+    to: string;
+    found: boolean;
+    reason: ExplainPathReason;
+    steps: readonly CausalStep[];
+    text: string;
+    toJSON(): {
+        from: string;
+        to: string;
+        found: boolean;
+        reason: ExplainPathReason;
+        steps: readonly CausalStep[];
+    };
+}
+interface IslandReport {
+    /** Node id from the flattened snapshot. */
+    id: string;
+    /** Factory/kind for quick triage. */
+    factory: string;
+}
+interface ValidateNoIslandsResult {
+    ok: boolean;
+    /** Nodes with zero deps and zero dependents, sorted by id. */
+    orphans: readonly IslandReport[];
+    summary(): string;
+}
+/**
+ * Return node ids reachable from `from` through describe deps/edges.
+ *
+ * `upstream` follows dep edges toward causes; `downstream` follows reverse deps toward effects.
+ * The helper is intentionally pure over `DescribeSnapshot` (D39/D51): it never reads Nodes.
+ */
+declare function reachable(snapshot: DescribeSnapshot, from: string, direction: ReachableDirection, options?: ReachableOptions & {
+    withDetail: true;
+}): ReachableResult;
+declare function reachable(snapshot: DescribeSnapshot, from: string, direction: ReachableDirection, options?: ReachableOptions): readonly string[];
+/**
+ * Explain the shortest describe-edge path from `from` to `to`.
+ *
+ * This is the rich companion to `Graph.describe({ explain })`: it reports found/no-path
+ * status and per-hop metadata, but remains a pure helper over the snapshot.
+ */
+declare function explainPath(snapshot: DescribeSnapshot, from: string, to: string, options?: ExplainPathOptions): CausalChain;
+/** Detect nodes with zero deps and zero dependents in a describe snapshot. */
+declare function validateNoIslands(snapshot: DescribeSnapshot): ValidateNoIslandsResult;
+
+/**
+ * Helper-first worker compute (D138/D148).
+ *
+ * `prepare` runs on the graph thread and returns an owned input. The required
+ * backend receives only that input plus the static compute closure; Ctx/Node/
+ * graph state/live topology never cross the boundary.
+ */
+
+interface WorkerDerivedJob<TInput, TResult> {
+    readonly input: TInput;
+    readonly compute: (input: TInput) => TResult;
+}
+type WorkerDerivedSettlement<TResult> = {
+    readonly ok: true;
+    readonly value: TResult;
+} | {
+    readonly ok: false;
+    readonly error: unknown;
+};
+type WorkerDerivedSettle<TResult> = (settlement: WorkerDerivedSettlement<TResult>) => void;
+type WorkerDerivedCancel = () => void;
+interface WorkerDerivedBackend<TInput, TResult> {
+    run(job: WorkerDerivedJob<TInput, TResult>, settle: WorkerDerivedSettle<TResult>): WorkerDerivedCancel | undefined;
+}
+interface WorkerDerivedOptions<TInput, TResult> {
+    readonly name?: string;
+    prepare(ctx: Ctx): TInput | undefined;
+    compute(input: TInput): TResult;
+    backend: WorkerDerivedBackend<TInput, TResult>;
+}
+/**
+ * D148 backend-required graph helper. No public submit API is exposed; the
+ * backend starts work only after this helper installs the graph-local fence.
+ */
+declare function workerDerived<TInput, TResult>(graph: Graph, deps: readonly Node<unknown>[], opts: WorkerDerivedOptions<TInput, TResult>): Node<TResult>;
+
+export { type CascadingCacheEvent, type CascadingCachePolicy, type CascadingCacheStatus, type CausalChain, type CausalStep, DescribeNode, DescribeSnapshot, type ExplainPathOptions, type ExplainPathReason, Graph, type IslandReport, type ReachableDirection, type ReachableOptions, type ReachableResult, type ReactiveCascadingCache, type ReactiveCascadingCacheOptions, type ValidateNoIslandsResult, type WorkerDerivedBackend, type WorkerDerivedCancel, type WorkerDerivedJob, type WorkerDerivedOptions, type WorkerDerivedSettle, type WorkerDerivedSettlement, explainPath, reachable, reactiveCascadingCache, validateNoIslands, workerDerived };

package/dist/graph/index.d.ts

@@ -0,0 +1,251 @@
+export { DescribeChangeset, DescribeEvent, PipeOperator, Stratified, StratifyOptions, StratifyRule, pipe, stratify, stratifyBranch, topologyDiff } from '../composition/index.js';
+export { C as CapacityPolicy, I as IndexChange, a as IndexRow, L as ListChange, c as LogChange, M as MapChange, O as OrderedCapacityPolicy, j as ReactiveIndex, k as ReactiveIndexCapacityOrder, l as ReactiveIndexCapacityPolicy, m as ReactiveIndexOpt, n as ReactiveIndexOptions, s as ReactiveOpt, t as ReactiveView, u as RetentionPolicy, V as ViewCachePolicy, H as reactiveIndex } from '../reactive-collection-Cb1II1Fi.js';
+export { R as ReactiveList, a as ReactiveListOpt, b as ReactiveListOptions, c as ReactiveLog, d as ReactiveLogOptions, e as ReactiveMap, f as ReactiveMapOpt, g as ReactiveMapOptions, h as ReactiveMapRetentionEntry, i as ReactiveMapRetentionPolicy, m as mergeReactiveLogs, r as reactiveList, j as reactiveLog, k as reactiveMap, s as scanLog } from '../reactive-map-BcB4KsQR.js';
+export { restoreReactiveIndex, restoreReactiveList, restoreReactiveLog, restoreReactiveMap } from '../data-structures/index.js';
+export { DescribeToAsciiOptions, DescribeToD2Options, DescribeToJsonOptions, DescribeToMermaidOptions, DescribeToMermaidUrlOptions, DescribeToPrettyOptions, DiagramDirection, MermaidLiveTheme, MermaidLiveUrlOptions, describeToAscii, describeToD2, describeToJson, describeToMermaid, describeToMermaidUrl, describeToPretty, mermaidLiveUrl } from '../render/index.js';
+import { d as Graph } from '../graph-DfdF9zy4.js';
+export { b as DerivedFn, E as EffectFn, G as GRAPH_BLUEPRINT_VERSION, c as GRAPH_CHECKPOINT_VERSION, e as GraphBlueprint, f as GraphBlueprintDiagnosticCode, g as GraphBlueprintDiagnosticIssue, h as GraphBlueprintDiagnostics, i as GraphBlueprintHash, j as GraphBlueprintHashInput, k as GraphBlueprintHashOptions, l as GraphBlueprintJson, m as GraphBlueprintOptions, n as GraphBlueprintProvenance, o as GraphCheckpoint, p as GraphCheckpointEdge, q as GraphCheckpointFactory, r as GraphCheckpointJson, s as GraphCheckpointMount, t as GraphCheckpointNode, u as GraphCheckpointTerminal, v as GraphCheckpointValue, w as GraphCheckpointVersion, x as GraphOptions, z as GraphRestoreDescriptor, A as GraphRestoreDescriptorContext, C as GraphRestoreRegistry, N as NodeProfile, F as NormalizedGraphTopologyNode, H as NormalizedGraphTopologySnapshot, O as ObserveEvent, I as ObserveEventEquals, J as ObservePredicate, K as ObserveStream, P as Profile, R as RestoreGraphOptions, Q as StateNode, T as SugarOpts, V as TopologyEvent, W as TopologyEventKind, X as TopologyGroup, Y as TopologyGroupOptions, Z as TopologyGroupReleaseOptions, _ as TopologyStream, a0 as canonicalTopologyBytes, a1 as canonicalTopologyJson, a3 as coalesceObserve, a4 as defaultRestoreRegistry, a9 as filterObserve, ac as graph, ad as graphBlueprintDiagnostics, aj as normalizeTopology, ao as restoreGraph, at as stateRestoreDescriptor, av as takeRestoreDescriptor, az as timerRestoreDescriptor, aB as withBlueprintHash, aC as withBlueprintProvenance } from '../graph-DfdF9zy4.js';
+import { N as Node, C as Ctx } from '../types-h12mNYbq.js';
+export { b as DriverCancel, c as DriverResult, E as EnvironmentDrivers, d as EnvironmentDriversInit, F as FetchLike, e as FetchResponseLike, g as HttpRequest, h as HttpResponse, L as LocalHttpDriver, i as LocalProcessDriver, j as LocalSseDriver, k as LocalWebSocketDriver, l as LocalWebhookDriver, w as ProcessCommand, x as ProcessResult, y as SseDriverEvent, z as SseEvent, A as SseRequest, G as WebSocketConstructorLike, I as WebSocketDriverEvent, J as WebSocketEvent, K as WebSocketLike, M as WebSocketRequest, O as WebSocketSend, Q as WebSocketSendResult, U as WebSocketSessionHandle, V as WebhookDriverEvent, X as WebhookEvent, Y as WebhookRegistration, a4 as domWebSocketDriver, a6 as fetchHttpDriver } from '../types-h12mNYbq.js';
+import { f as KvStorageTier } from '../append-log-DzKMmjxx.js';
+import { b as ReadThroughLookupTier } from '../read-through-DwyJhGs1.js';
+import { a as DescribeNode, c as DescribeSnapshot } from '../describe-BZb7AS2y.js';
+export { D as DescribeEdge, b as DescribeOpts, G as GraphTopologyEdge, d as GraphTopologyNode, e as GraphTopologySnapshot } from '../describe-BZb7AS2y.js';
+export { B as BackoffPolicy, R as RetryPolicy, a as RetryState, b as RetryStatus, c as backoffDelayMs, n as nextRetryDelayMs, d as noBackoff, r as retryPolicy, s as shouldRetry } from '../resilience-Dig3Q7n0.js';
+import '../messages-BZqrGGm1.js';
+import '../core/index.js';
+import '../codec-BB7p8fJc.js';
+
+/** Dynamic read-through policy for {@link reactiveCascadingCache}. */
+interface CascadingCachePolicy {
+    readonly promoteTo?: readonly number[] | false;
+}
+type CascadingCacheStatus<K> = {
+    readonly kind: "idle";
+} | {
+    readonly kind: "loading";
+    readonly key: K;
+    readonly requestSeq: number;
+} | {
+    readonly kind: "hit";
+    readonly key: K;
+    readonly requestSeq: number;
+    readonly tier?: ReadThroughLookupTier;
+} | {
+    readonly kind: "miss";
+    readonly key: K;
+    readonly requestSeq: number;
+} | {
+    readonly kind: "error";
+    readonly key: K;
+    readonly requestSeq: number;
+    readonly error: unknown;
+};
+type CascadingCacheEvent<K, V> = {
+    readonly kind: "request";
+    readonly key: K;
+    readonly requestSeq: number;
+} | {
+    readonly kind: "invalidate";
+    readonly key: K;
+    readonly requestSeq: number;
+} | {
+    readonly kind: "lookup";
+    readonly key: K;
+    readonly requestSeq: number;
+    readonly outcome: "hit" | "miss" | "error";
+    readonly tier: ReadThroughLookupTier;
+    readonly value?: V;
+    readonly error?: unknown;
+} | {
+    readonly kind: "promotion";
+    readonly key: K;
+    readonly requestSeq: number;
+    readonly tier: ReadThroughLookupTier;
+    readonly ok: boolean;
+    readonly error?: unknown;
+} | {
+    readonly kind: "fill";
+    readonly key: K;
+    readonly requestSeq: number;
+    readonly status: "hit" | "miss" | "error";
+    readonly value?: V;
+    readonly tier?: ReadThroughLookupTier;
+    readonly error?: unknown;
+} | {
+    readonly kind: "error";
+    readonly key: K;
+    readonly requestSeq: number;
+    readonly stage: "lookup" | "promotion";
+    readonly tier?: ReadThroughLookupTier;
+    readonly error: unknown;
+};
+interface ReactiveCascadingCacheOptions<K extends string, V> {
+    readonly graph: Graph;
+    readonly request: Node<K>;
+    readonly policy?: Node<CascadingCachePolicy>;
+    readonly invalidate?: Node<K>;
+    readonly tiers: readonly KvStorageTier<V>[];
+    readonly load?: (key: K) => Promise<V | undefined> | V | undefined;
+    readonly tierNames?: readonly string[];
+    /**
+     * Storage promotion is explicit for the graph-layer factory. `requestSeq` guards visible graph
+     * value/status updates; without a generation/CAS storage contract, passive tier writes are
+     * best-effort and cannot be made stale-proof once an async `set` has started.
+     *
+     * @default false
+     */
+    readonly promoteTo?: readonly number[] | false;
+    readonly name?: string;
+    readonly meta?: Record<string, unknown>;
+}
+interface ReactiveCascadingCache<K, V> {
+    readonly value: Node<V | undefined>;
+    readonly status: Node<CascadingCacheStatus<K>>;
+    readonly events: Node<CascadingCacheEvent<K, V>>;
+}
+/**
+ * Free-standing graph-layer cascading cache factory (D104/D105/D107).
+ *
+ * Passive tiers stay in `tieredReadThrough`; this factory wraps lookup work at an async pool
+ * boundary and exposes every request, invalidation, lookup, promotion, fill, status, and value
+ * change through declared graph nodes. `requestSeq` is the stale-fill guard for visible graph
+ * nodes: older async fills may still be observable as events, but downstream value/status nodes
+ * ignore them. Storage promotion defaults to `false` here because passive tier writes have no
+ * generation/CAS contract; callers may opt in with `promoteTo` when best-effort promotion is
+ * acceptable.
+ */
+declare function reactiveCascadingCache<K extends string, V>(opts: ReactiveCascadingCacheOptions<K, V>): ReactiveCascadingCache<K, V>;
+
+/**
+ * Pure graph diagnostics over {@link DescribeSnapshot} (D39/R-describe).
+ *
+ * These helpers re-derive the useful frozen pure-ts inspection utilities without restoring
+ * graph methods, path facades, actors, soft edges, or storage coupling. They operate only on the
+ * public JSON-serializable describe shape; the live topology truth remains R-edges-derived.
+ */
+
+type ReachableDirection = "upstream" | "downstream";
+interface ReachableOptions {
+    /** Maximum hop distance to walk. Omit for unbounded. */
+    maxDepth?: number;
+    /** Walk both upstream and downstream, ignoring `direction`. */
+    both?: boolean;
+    /** Return depths/truncation metadata instead of only sorted paths. */
+    withDetail?: boolean;
+}
+interface ReachableResult {
+    /** Reachable node ids, excluding the start id, sorted deterministically. */
+    paths: readonly string[];
+    /** Hop depth by reachable node id. */
+    depths: Readonly<Record<string, number>>;
+    /** True when `maxDepth` cut off at least one still-expandable frontier node. */
+    truncated: boolean;
+}
+type ExplainPathReason = "ok" | "no-such-from" | "no-such-to" | "no-path" | "max-depth-exceeded";
+interface ExplainPathOptions {
+    /** Maximum hop distance to search. Omit for unbounded. */
+    maxDepth?: number;
+    /** When `from === to`, search for a non-trivial cycle before returning the trivial step. */
+    findCycle?: boolean;
+}
+interface CausalStep {
+    /** Mount-aware describe node id. */
+    id: string;
+    /** Operator/verb factory name from describe. */
+    factory: string;
+    /** Status as of the source snapshot. */
+    status: DescribeNode["status"];
+    /** Cached value when present; absence still means SENTINEL. */
+    value?: unknown;
+    /** Hop distance from the `from` node. */
+    hop: number;
+    /** First dep slot in the next step that points at this step, when the edge is dep-derived. */
+    depIndex?: number;
+    /** All matching dep slots when the next step depends on this step more than once. */
+    depIndices?: readonly number[];
+}
+interface CausalChain {
+    from: string;
+    to: string;
+    found: boolean;
+    reason: ExplainPathReason;
+    steps: readonly CausalStep[];
+    text: string;
+    toJSON(): {
+        from: string;
+        to: string;
+        found: boolean;
+        reason: ExplainPathReason;
+        steps: readonly CausalStep[];
+    };
+}
+interface IslandReport {
+    /** Node id from the flattened snapshot. */
+    id: string;
+    /** Factory/kind for quick triage. */
+    factory: string;
+}
+interface ValidateNoIslandsResult {
+    ok: boolean;
+    /** Nodes with zero deps and zero dependents, sorted by id. */
+    orphans: readonly IslandReport[];
+    summary(): string;
+}
+/**
+ * Return node ids reachable from `from` through describe deps/edges.
+ *
+ * `upstream` follows dep edges toward causes; `downstream` follows reverse deps toward effects.
+ * The helper is intentionally pure over `DescribeSnapshot` (D39/D51): it never reads Nodes.
+ */
+declare function reachable(snapshot: DescribeSnapshot, from: string, direction: ReachableDirection, options?: ReachableOptions & {
+    withDetail: true;
+}): ReachableResult;
+declare function reachable(snapshot: DescribeSnapshot, from: string, direction: ReachableDirection, options?: ReachableOptions): readonly string[];
+/**
+ * Explain the shortest describe-edge path from `from` to `to`.
+ *
+ * This is the rich companion to `Graph.describe({ explain })`: it reports found/no-path
+ * status and per-hop metadata, but remains a pure helper over the snapshot.
+ */
+declare function explainPath(snapshot: DescribeSnapshot, from: string, to: string, options?: ExplainPathOptions): CausalChain;
+/** Detect nodes with zero deps and zero dependents in a describe snapshot. */
+declare function validateNoIslands(snapshot: DescribeSnapshot): ValidateNoIslandsResult;
+
+/**
+ * Helper-first worker compute (D138/D148).
+ *
+ * `prepare` runs on the graph thread and returns an owned input. The required
+ * backend receives only that input plus the static compute closure; Ctx/Node/
+ * graph state/live topology never cross the boundary.
+ */
+
+interface WorkerDerivedJob<TInput, TResult> {
+    readonly input: TInput;
+    readonly compute: (input: TInput) => TResult;
+}
+type WorkerDerivedSettlement<TResult> = {
+    readonly ok: true;
+    readonly value: TResult;
+} | {
+    readonly ok: false;
+    readonly error: unknown;
+};
+type WorkerDerivedSettle<TResult> = (settlement: WorkerDerivedSettlement<TResult>) => void;
+type WorkerDerivedCancel = () => void;
+interface WorkerDerivedBackend<TInput, TResult> {
+    run(job: WorkerDerivedJob<TInput, TResult>, settle: WorkerDerivedSettle<TResult>): WorkerDerivedCancel | undefined;
+}
+interface WorkerDerivedOptions<TInput, TResult> {
+    readonly name?: string;
+    prepare(ctx: Ctx): TInput | undefined;
+    compute(input: TInput): TResult;
+    backend: WorkerDerivedBackend<TInput, TResult>;
+}
+/**
+ * D148 backend-required graph helper. No public submit API is exposed; the
+ * backend starts work only after this helper installs the graph-local fence.
+ */
+declare function workerDerived<TInput, TResult>(graph: Graph, deps: readonly Node<unknown>[], opts: WorkerDerivedOptions<TInput, TResult>): Node<TResult>;
+
+export { type CascadingCacheEvent, type CascadingCachePolicy, type CascadingCacheStatus, type CausalChain, type CausalStep, DescribeNode, DescribeSnapshot, type ExplainPathOptions, type ExplainPathReason, Graph, type IslandReport, type ReachableDirection, type ReachableOptions, type ReachableResult, type ReactiveCascadingCache, type ReactiveCascadingCacheOptions, type ValidateNoIslandsResult, type WorkerDerivedBackend, type WorkerDerivedCancel, type WorkerDerivedJob, type WorkerDerivedOptions, type WorkerDerivedSettle, type WorkerDerivedSettlement, explainPath, reachable, reactiveCascadingCache, validateNoIslands, workerDerived };

package/dist/graph/index.js

@@ -0,0 +1,131 @@
+import "../chunk-GAJW5I5P.js";
+import {
+  coalesceObserve,
+  defaultRestoreRegistry,
+  explainPath,
+  filterObserve,
+  reachable,
+  reactiveCascadingCache,
+  restoreGraph,
+  stateRestoreDescriptor,
+  takeRestoreDescriptor,
+  timerRestoreDescriptor,
+  validateNoIslands,
+  workerDerived
+} from "../chunk-Y3ZLRGHC.js";
+import {
+  describeToAscii,
+  describeToD2,
+  describeToJson,
+  describeToMermaid,
+  describeToMermaidUrl,
+  describeToPretty,
+  mermaidLiveUrl
+} from "../chunk-HDRL4VQQ.js";
+import "../chunk-H2HTHFVN.js";
+import {
+  pipe,
+  stratify,
+  stratifyBranch,
+  topologyDiff
+} from "../chunk-D6BG7U6A.js";
+import "../chunk-Z2ANQ6JW.js";
+import {
+  GRAPH_BLUEPRINT_VERSION,
+  Graph,
+  StateNode,
+  canonicalTopologyBytes,
+  canonicalTopologyJson,
+  graph,
+  graphBlueprintDiagnostics,
+  normalizeTopology,
+  withBlueprintHash,
+  withBlueprintProvenance
+} from "../chunk-2ILL7HQI.js";
+import {
+  backoffDelayMs,
+  nextRetryDelayMs,
+  noBackoff,
+  retryPolicy,
+  shouldRetry
+} from "../chunk-OOEN33FB.js";
+import "../chunk-DKP56CSW.js";
+import {
+  mergeReactiveLogs,
+  reactiveIndex,
+  reactiveList,
+  reactiveLog,
+  reactiveMap,
+  restoreReactiveIndex,
+  restoreReactiveList,
+  restoreReactiveLog,
+  restoreReactiveMap,
+  scanLog
+} from "../chunk-RIIOUTGM.js";
+import "../chunk-G4M3NHRJ.js";
+import {
+  GRAPH_CHECKPOINT_VERSION
+} from "../chunk-PKVBHGBM.js";
+import {
+  EnvironmentDrivers,
+  domWebSocketDriver,
+  fetchHttpDriver
+} from "../chunk-I3IHOHCJ.js";
+import "../chunk-4VLAQHZI.js";
+import "../chunk-SWTLEQL6.js";
+import "../chunk-DK554R7P.js";
+export {
+  EnvironmentDrivers,
+  GRAPH_BLUEPRINT_VERSION,
+  GRAPH_CHECKPOINT_VERSION,
+  Graph,
+  StateNode,
+  backoffDelayMs,
+  canonicalTopologyBytes,
+  canonicalTopologyJson,
+  coalesceObserve,
+  defaultRestoreRegistry,
+  describeToAscii,
+  describeToD2,
+  describeToJson,
+  describeToMermaid,
+  describeToMermaidUrl,
+  describeToPretty,
+  domWebSocketDriver,
+  explainPath,
+  fetchHttpDriver,
+  filterObserve,
+  graph,
+  graphBlueprintDiagnostics,
+  mergeReactiveLogs,
+  mermaidLiveUrl,
+  nextRetryDelayMs,
+  noBackoff,
+  normalizeTopology,
+  pipe,
+  reachable,
+  reactiveCascadingCache,
+  reactiveIndex,
+  reactiveList,
+  reactiveLog,
+  reactiveMap,
+  restoreGraph,
+  restoreReactiveIndex,
+  restoreReactiveList,
+  restoreReactiveLog,
+  restoreReactiveMap,
+  retryPolicy,
+  scanLog,
+  shouldRetry,
+  stateRestoreDescriptor,
+  stratify,
+  stratifyBranch,
+  takeRestoreDescriptor,
+  timerRestoreDescriptor,
+  topologyDiff,
+  validateNoIslands,
+  withBlueprintHash,
+  withBlueprintProvenance,
+  workerDerived
+};
+//# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}