@graphrefly/graphrefly 0.43.0 → 0.45.0

package/dist/index-O7fucFrU.d.cts

@@ -1,121 +0,0 @@
-import { i as index$2 } from './index-ChOyVLKm.cjs';
-import { i as index$3 } from './index-C9kSENB4.cjs';
-import { i as index$4 } from './index-BAOD98JD.cjs';
-import { i as index$5 } from './index-z96luz5O.cjs';
-import { N as Node } from './node-ClS5yC-B.cjs';
-import { i as index$6 } from './index-BVpm6noz.cjs';
-import { i as index$7 } from './index-hHcaFlJX.cjs';
-import { i as index$8 } from './index-BJX94aud.cjs';
-import { i as index$9 } from './index-f5IivDUX.cjs';
-
-/**
- * Options for creating signals.
- *
- * @category compat
- */
-interface SignalOptions {
-    /** Optional identifier for the underlying node. */
-    name?: string;
-    /** Custom equality function for change detection. */
-    equals?: (a: any, b: any) => boolean;
-}
-/**
- * Common interface for all reactive signals.
- *
- * @category compat
- */
-interface AnySignal<T> {
-    /** Returns the current value of the signal. */
-    get(): T;
-    /** @internal The underlying GraphReFly node. */
-    _node: Node<T>;
-}
-/**
- * TC39 `Signal.State` — a writable signal backed by a GraphReFly `state` node.
- * Automatically registers itself as a dependency if read inside a `Computed`.
- *
- * @example
- * ```ts
- * const count = new Signal.State(0);
- * count.get(); // 0
- * count.set(1);
- * count.get(); // 1
- * ```
- */
-declare class SignalState<T> implements AnySignal<T> {
-    /** @internal */
-    _node: Node<T>;
-    private readonly _equals;
-    constructor(initial: T, opts?: SignalOptions);
-    get(): T;
-    set(value: T): void;
-}
-/**
- * TC39 `Signal.Computed` — a read-only signal backed by `dynamicNode`.
- * Automatically tracks dependencies when `get()` is called on other signals
- * during its computation.
- *
- * @example
- * ```ts
- * const count = new Signal.State(0);
- * const doubled = new Signal.Computed(() => count.get() * 2);
- * ```
- */
-declare class SignalComputed<T> implements AnySignal<T> {
-    /** @internal */
-    _node: Node<T>;
-    constructor(computation: () => T, opts?: SignalOptions);
-    get(): T;
-}
-/**
- * TC39 Signals-compatible namespace. Wraps GraphReFly primitives.
- * Provides auto-tracking conforming to the TS39 signals proposal.
- *
- * @category compat
- */
-declare const Signal: {
-    readonly State: typeof SignalState;
-    readonly Computed: typeof SignalComputed;
-    /**
-     * Subscribes to changes on a signal.
-     * Returns an unsubscribe callback.
-     *
-     * @example
-     * ```ts
-     * const count = new Signal.State(0);
-     * const unsub = Signal.sub(count, v => console.log(v));
-     * ```
-     */
-    readonly sub: <T>(signal: AnySignal<T>, callback: ((value: T) => void) | {
-        data?: (value: T) => void;
-        error?: (err: unknown) => void;
-        complete?: () => void;
-    }) => (() => void);
-};
-
-type index$1_AnySignal<T> = AnySignal<T>;
-declare const index$1_Signal: typeof Signal;
-type index$1_SignalComputed<T> = SignalComputed<T>;
-declare const index$1_SignalComputed: typeof SignalComputed;
-type index$1_SignalOptions = SignalOptions;
-type index$1_SignalState<T> = SignalState<T>;
-declare const index$1_SignalState: typeof SignalState;
-declare namespace index$1 {
-  export { type index$1_AnySignal as AnySignal, index$1_Signal as Signal, index$1_SignalComputed as SignalComputed, type index$1_SignalOptions as SignalOptions, index$1_SignalState as SignalState };
-}
-
-/**
- * Compat layer: compatibility wrappers for other state management libraries (Phase 5.1b).
- *
- * Framework adapters are optional peers. Install only what you use:
- * - `@graphrefly/graphrefly-ts/compat/react` -> `react`, `react-dom`
- * - `@graphrefly/graphrefly-ts/compat/vue` -> `vue`
- * - `@graphrefly/graphrefly-ts/compat/svelte` -> `svelte`
- * - `@graphrefly/graphrefly-ts/compat/solid` -> `solid-js`
- */
-
-declare namespace index {
-  export { index$2 as jotai, index$3 as nanostores, index$4 as nestjs, index$5 as react, index$1 as signals, index$6 as solid, index$7 as svelte, index$8 as vue, index$9 as zustand };
-}
-
-export { index$1 as a, index as i };

package/dist/index-RV_yDjOX.d.cts

@@ -1,198 +0,0 @@
-import { M as Messages, A as Actor, C as COMPLETE, f as COMPLETE_MSG, g as COMPLETE_ONLY_BATCH, D as DATA, h as DEFAULT_ACTOR, i as DIRTY, j as DIRTY_MSG, k as DIRTY_ONLY_BATCH, l as DepRecord, E as ERROR, F as FnCtx, G as GlobalInspectorEvent, m as GlobalInspectorHook, n as GraphReFlyConfig, o as GuardAction, p as GuardDenied, q as GuardDeniedDetails, H as HashFn, I as INVALIDATE, r as INVALIDATE_MSG, s as INVALIDATE_ONLY_BATCH, t as Message, u as MessageContext, v as MessageTypeRegistration, w as MessageTypeRegistrationInput, N as Node, c as NodeActions, x as NodeCtx, e as NodeDescribeKind, y as NodeFn, d as NodeFnCleanup, b as NodeGuard, z as NodeImpl, B as NodeInspectorHook, J as NodeInspectorHookEvent, a as NodeOptions, K as NodeSink, L as NodeStatus, O as NodeTransportOptions, P as NodeVersionInfo, Q as OnMessageHandler, R as OnSubscribeHandler, S as PAUSE, T as PolicyAllow, U as PolicyDeny, W as PolicyRuleData, X as RESOLVED, Y as RESOLVED_MSG, Z as RESOLVED_ONLY_BATCH, _ as RESUME, $ as RigorRecorder, a0 as START, a1 as START_MSG, a2 as SubscribeContext, a3 as TEARDOWN, a4 as TEARDOWN_MSG, a5 as TEARDOWN_ONLY_BATCH, a6 as V0, a7 as V1, V as VersioningLevel, a8 as VersioningOptions, a9 as accessHintForGuard, aa as advanceVersion, ab as configure, ac as createVersioning, ad as defaultConfig, ae as defaultHash, af as isV1, ag as node, ah as normalizeActor, ai as policy, aj as policyFromRules, ak as registerBuiltins } from './node-ClS5yC-B.cjs';
-import { a as DescribeDetail, b as DescribeField, D as DescribeNodeOutput, f as factoryTag, p as placeholderArgs, r as resolveDescribeFields } from './meta-vE8bxW1E.cjs';
-import { A as AutoTrackOptions, D as DerivedFn, a as DynamicFn, E as EffectFn, P as PipeOperator, b as ProducerFn, T as TrackFn, c as autoTrackNode, d as derived, e as dynamicNode, f as effect, p as pipe, g as producer, s as state } from './sugar-DyVGtczU.cjs';
-
-/**
- * Batch deferral for tier-3+ messages, plus per-node emit coalescing inside
- * explicit `batch()` scopes.
- *
- * **Canonical invariant:** GRAPHREFLY-SPEC.md §1.3.7 — inside a batch,
- * tier 0–2 signals propagate immediately; tier 3 (DATA/RESOLVED), tier 4
- * (COMPLETE/ERROR), and tier 5 (TEARDOWN) are queued and drained in ascending
- * phase order after the outermost `batch()` callback returns.
- *
- * **Per-node emit coalescing (Bug 2 fix, 2026-04-17).** Inside an explicit
- * `batch()` scope, consecutive emissions from the same node accumulate in
- * `NodeImpl._batchPendingMessages` (see JSDoc there) instead of each producing
- * a separate downstream wave. K `.emit()` calls to the same source collapse to
- * one coalesced `downWithBatch` call per child edge at batch end. Outside batch
- * (or during drain), coalescing does NOT apply — each emit produces its own wave.
- *
- * **Phase vocabulary:**
- * - Phase 1 = tiers 0–2 — immediate, never queued.
- * - Phase 2 = tier 3 — {@link drainPhase2}. Value settlements.
- * - Phase 3 = tier 4 — {@link drainPhase3}. Terminal signals.
- * - Phase 4 = tier 5 — {@link drainPhase4}. TEARDOWN (unified deferral).
- *
- * Drain rule: fire any pending flush hooks first, then the lowest non-empty
- * phase. Re-enqueues during drain (and hooks registered by reentrant batches
- * inside subscriber callbacks) bump the loop back to the top so newly-added
- * hooks and closures get processed.
- */
-
-/**
- * Returns whether the current call stack is inside a batch scope **or** while
- * a deferred drain is in progress. Nested `downWithBatch` calls during drain
- * still defer (they bump the drain loop).
- */
-declare function isBatching(): boolean;
-/**
- * Runs `fn` inside a batch scope. Nested `batch()` calls share one deferral
- * queue. If `fn` throws, deferred work for the outer frame is discarded
- * (unless a drain is already in progress — cross-language decision A4).
- */
-declare function batch(fn: () => void): void;
-/**
- * Deliver pre-sorted messages through `sink` with tier-based deferral applied.
- *
- * `messages` MUST be in ascending tier order (produced by `_frameBatch` in
- * `node.ts`); the walker exploits that invariant to find phase cuts in one
- * pass without re-sorting.
- *
- * Behavior:
- * - Tier 0–2 — delivered synchronously.
- * - Tier 3 — deferred to {@link drainPhase2} when batching, else synchronous.
- * - Tier 4 — deferred to {@link drainPhase3} when batching, else synchronous.
- * - Tier 5 — deferred to {@link drainPhase4} when batching, else synchronous.
- *
- * Tier-classification uses the caller-supplied `tierOf` so that batch stays
- * decoupled from `GraphReFlyConfig`. NodeImpl passes `config.tierOf` (a
- * pre-bound closure built once in the config constructor) at the emit site;
- * alternate configs can pass their own lookup.
- */
-declare function downWithBatch(sink: (messages: Messages) => void, messages: Messages, tierOf: (t: symbol) => number): void;
-
-/**
- * Centralised timestamp utilities.
- *
- * Convention: all graphrefly-ts timestamps use nanoseconds (`_ns` suffix).
- *
- * - {@link monotonicNs} — monotonic clock (ordering, durations, timeline events).
- * - {@link wallClockNs} — wall-clock (mutation attribution, cron emission).
- *
- * **Precision limits (JS platform):**
- *
- * - `monotonicNs`: effective ~microsecond precision. `performance.now()` returns
- *   milliseconds with ~5µs resolution; the last 3 digits of the nanosecond value
- *   are always zero. Python's `time.monotonic_ns()` gives true nanoseconds.
- *
- * - `wallClockNs`: ~256ns precision loss at current epoch. `Date.now() * 1e6`
- *   produces values around 1.8×10¹⁸ which exceed IEEE 754's 2⁵³ safe integer
- *   limit. Python's `time.time_ns()` (arbitrary-precision `int`) has no loss.
- *   In practice this is irrelevant — JS is single-threaded, so sub-microsecond
- *   timestamp collisions cannot occur.
- */
-/** Monotonic nanosecond timestamp via `performance.now()`. */
-declare function monotonicNs(): number;
-/** Wall-clock nanosecond timestamp via `Date.now()`. */
-declare function wallClockNs(): number;
-
-/**
- * Core layer: message protocol, node primitive, lifecycle (Phase 0).
- */
-
-declare const index_Actor: typeof Actor;
-declare const index_AutoTrackOptions: typeof AutoTrackOptions;
-declare const index_COMPLETE: typeof COMPLETE;
-declare const index_COMPLETE_MSG: typeof COMPLETE_MSG;
-declare const index_COMPLETE_ONLY_BATCH: typeof COMPLETE_ONLY_BATCH;
-declare const index_DATA: typeof DATA;
-declare const index_DEFAULT_ACTOR: typeof DEFAULT_ACTOR;
-declare const index_DIRTY: typeof DIRTY;
-declare const index_DIRTY_MSG: typeof DIRTY_MSG;
-declare const index_DIRTY_ONLY_BATCH: typeof DIRTY_ONLY_BATCH;
-declare const index_DepRecord: typeof DepRecord;
-declare const index_DerivedFn: typeof DerivedFn;
-declare const index_DescribeDetail: typeof DescribeDetail;
-declare const index_DescribeField: typeof DescribeField;
-declare const index_DescribeNodeOutput: typeof DescribeNodeOutput;
-declare const index_DynamicFn: typeof DynamicFn;
-declare const index_ERROR: typeof ERROR;
-declare const index_EffectFn: typeof EffectFn;
-declare const index_FnCtx: typeof FnCtx;
-declare const index_GlobalInspectorEvent: typeof GlobalInspectorEvent;
-declare const index_GlobalInspectorHook: typeof GlobalInspectorHook;
-declare const index_GraphReFlyConfig: typeof GraphReFlyConfig;
-declare const index_GuardAction: typeof GuardAction;
-declare const index_GuardDenied: typeof GuardDenied;
-declare const index_GuardDeniedDetails: typeof GuardDeniedDetails;
-declare const index_HashFn: typeof HashFn;
-declare const index_INVALIDATE: typeof INVALIDATE;
-declare const index_INVALIDATE_MSG: typeof INVALIDATE_MSG;
-declare const index_INVALIDATE_ONLY_BATCH: typeof INVALIDATE_ONLY_BATCH;
-declare const index_Message: typeof Message;
-declare const index_MessageContext: typeof MessageContext;
-declare const index_MessageTypeRegistration: typeof MessageTypeRegistration;
-declare const index_MessageTypeRegistrationInput: typeof MessageTypeRegistrationInput;
-declare const index_Messages: typeof Messages;
-declare const index_Node: typeof Node;
-declare const index_NodeActions: typeof NodeActions;
-declare const index_NodeCtx: typeof NodeCtx;
-declare const index_NodeDescribeKind: typeof NodeDescribeKind;
-declare const index_NodeFn: typeof NodeFn;
-declare const index_NodeFnCleanup: typeof NodeFnCleanup;
-declare const index_NodeGuard: typeof NodeGuard;
-declare const index_NodeImpl: typeof NodeImpl;
-declare const index_NodeInspectorHook: typeof NodeInspectorHook;
-declare const index_NodeInspectorHookEvent: typeof NodeInspectorHookEvent;
-declare const index_NodeOptions: typeof NodeOptions;
-declare const index_NodeSink: typeof NodeSink;
-declare const index_NodeStatus: typeof NodeStatus;
-declare const index_NodeTransportOptions: typeof NodeTransportOptions;
-declare const index_NodeVersionInfo: typeof NodeVersionInfo;
-declare const index_OnMessageHandler: typeof OnMessageHandler;
-declare const index_OnSubscribeHandler: typeof OnSubscribeHandler;
-declare const index_PAUSE: typeof PAUSE;
-declare const index_PipeOperator: typeof PipeOperator;
-declare const index_PolicyAllow: typeof PolicyAllow;
-declare const index_PolicyDeny: typeof PolicyDeny;
-declare const index_PolicyRuleData: typeof PolicyRuleData;
-declare const index_ProducerFn: typeof ProducerFn;
-declare const index_RESOLVED: typeof RESOLVED;
-declare const index_RESOLVED_MSG: typeof RESOLVED_MSG;
-declare const index_RESOLVED_ONLY_BATCH: typeof RESOLVED_ONLY_BATCH;
-declare const index_RESUME: typeof RESUME;
-declare const index_RigorRecorder: typeof RigorRecorder;
-declare const index_START: typeof START;
-declare const index_START_MSG: typeof START_MSG;
-declare const index_SubscribeContext: typeof SubscribeContext;
-declare const index_TEARDOWN: typeof TEARDOWN;
-declare const index_TEARDOWN_MSG: typeof TEARDOWN_MSG;
-declare const index_TEARDOWN_ONLY_BATCH: typeof TEARDOWN_ONLY_BATCH;
-declare const index_TrackFn: typeof TrackFn;
-declare const index_V0: typeof V0;
-declare const index_V1: typeof V1;
-declare const index_VersioningLevel: typeof VersioningLevel;
-declare const index_VersioningOptions: typeof VersioningOptions;
-declare const index_accessHintForGuard: typeof accessHintForGuard;
-declare const index_advanceVersion: typeof advanceVersion;
-declare const index_autoTrackNode: typeof autoTrackNode;
-declare const index_batch: typeof batch;
-declare const index_configure: typeof configure;
-declare const index_createVersioning: typeof createVersioning;
-declare const index_defaultConfig: typeof defaultConfig;
-declare const index_defaultHash: typeof defaultHash;
-declare const index_derived: typeof derived;
-declare const index_downWithBatch: typeof downWithBatch;
-declare const index_dynamicNode: typeof dynamicNode;
-declare const index_effect: typeof effect;
-declare const index_factoryTag: typeof factoryTag;
-declare const index_isBatching: typeof isBatching;
-declare const index_isV1: typeof isV1;
-declare const index_monotonicNs: typeof monotonicNs;
-declare const index_node: typeof node;
-declare const index_normalizeActor: typeof normalizeActor;
-declare const index_pipe: typeof pipe;
-declare const index_placeholderArgs: typeof placeholderArgs;
-declare const index_policy: typeof policy;
-declare const index_policyFromRules: typeof policyFromRules;
-declare const index_producer: typeof producer;
-declare const index_registerBuiltins: typeof registerBuiltins;
-declare const index_resolveDescribeFields: typeof resolveDescribeFields;
-declare const index_state: typeof state;
-declare const index_wallClockNs: typeof wallClockNs;
-declare namespace index {
-  export { index_Actor as Actor, index_AutoTrackOptions as AutoTrackOptions, index_COMPLETE as COMPLETE, index_COMPLETE_MSG as COMPLETE_MSG, index_COMPLETE_ONLY_BATCH as COMPLETE_ONLY_BATCH, index_DATA as DATA, index_DEFAULT_ACTOR as DEFAULT_ACTOR, index_DIRTY as DIRTY, index_DIRTY_MSG as DIRTY_MSG, index_DIRTY_ONLY_BATCH as DIRTY_ONLY_BATCH, index_DepRecord as DepRecord, index_DerivedFn as DerivedFn, index_DescribeDetail as DescribeDetail, index_DescribeField as DescribeField, index_DescribeNodeOutput as DescribeNodeOutput, index_DynamicFn as DynamicFn, index_ERROR as ERROR, index_EffectFn as EffectFn, index_FnCtx as FnCtx, index_GlobalInspectorEvent as GlobalInspectorEvent, index_GlobalInspectorHook as GlobalInspectorHook, index_GraphReFlyConfig as GraphReFlyConfig, index_GuardAction as GuardAction, index_GuardDenied as GuardDenied, index_GuardDeniedDetails as GuardDeniedDetails, index_HashFn as HashFn, index_INVALIDATE as INVALIDATE, index_INVALIDATE_MSG as INVALIDATE_MSG, index_INVALIDATE_ONLY_BATCH as INVALIDATE_ONLY_BATCH, index_Message as Message, index_MessageContext as MessageContext, index_MessageTypeRegistration as MessageTypeRegistration, index_MessageTypeRegistrationInput as MessageTypeRegistrationInput, index_Messages as Messages, index_Node as Node, index_NodeActions as NodeActions, index_NodeCtx as NodeCtx, index_NodeDescribeKind as NodeDescribeKind, index_NodeFn as NodeFn, index_NodeFnCleanup as NodeFnCleanup, index_NodeGuard as NodeGuard, index_NodeImpl as NodeImpl, index_NodeInspectorHook as NodeInspectorHook, index_NodeInspectorHookEvent as NodeInspectorHookEvent, index_NodeOptions as NodeOptions, index_NodeSink as NodeSink, index_NodeStatus as NodeStatus, index_NodeTransportOptions as NodeTransportOptions, index_NodeVersionInfo as NodeVersionInfo, index_OnMessageHandler as OnMessageHandler, index_OnSubscribeHandler as OnSubscribeHandler, index_PAUSE as PAUSE, index_PipeOperator as PipeOperator, index_PolicyAllow as PolicyAllow, index_PolicyDeny as PolicyDeny, index_PolicyRuleData as PolicyRuleData, index_ProducerFn as ProducerFn, index_RESOLVED as RESOLVED, index_RESOLVED_MSG as RESOLVED_MSG, index_RESOLVED_ONLY_BATCH as RESOLVED_ONLY_BATCH, index_RESUME as RESUME, index_RigorRecorder as RigorRecorder, index_START as START, index_START_MSG as START_MSG, index_SubscribeContext as SubscribeContext, index_TEARDOWN as TEARDOWN, index_TEARDOWN_MSG as TEARDOWN_MSG, index_TEARDOWN_ONLY_BATCH as TEARDOWN_ONLY_BATCH, index_TrackFn as TrackFn, index_V0 as V0, index_V1 as V1, index_VersioningLevel as VersioningLevel, index_VersioningOptions as VersioningOptions, index_accessHintForGuard as accessHintForGuard, index_advanceVersion as advanceVersion, index_autoTrackNode as autoTrackNode, index_batch as batch, index_configure as configure, index_createVersioning as createVersioning, index_defaultConfig as defaultConfig, index_defaultHash as defaultHash, index_derived as derived, index_downWithBatch as downWithBatch, index_dynamicNode as dynamicNode, index_effect as effect, index_factoryTag as factoryTag, index_isBatching as isBatching, index_isV1 as isV1, index_monotonicNs as monotonicNs, index_node as node, index_normalizeActor as normalizeActor, index_pipe as pipe, index_placeholderArgs as placeholderArgs, index_policy as policy, index_policyFromRules as policyFromRules, index_producer as producer, index_registerBuiltins as registerBuiltins, index_resolveDescribeFields as resolveDescribeFields, index_state as state, index_wallClockNs as wallClockNs };
-}
-
-export { isBatching as a, batch as b, downWithBatch as d, index as i, monotonicNs as m, wallClockNs as w };