@graphrefly/graphrefly 0.43.0 → 0.45.0

package/dist/index-Dgs8zcj7.d.ts

@@ -1,102 +0,0 @@
-import { G as Graph } from './graph-7VguS7a4.js';
-import { M as MeasurementAdapter } from './reactive-layout-v7KPvxoc.js';
-
-/**
- * Three-pane demo shell (roadmap §7.2).
- *
- * A `Graph("demo-shell")` that dogfoods reactive coordination for the
- * main/side split layout with synchronized cross-highlighting.
- *
- * **Zero framework dependency** — framework bindings wrap pane components only.
- * The shell graph is headless and fully testable.
- */
-
-/** Identifies which pane is the source of a hover event. */
-type HoverPaneType = "visual" | "graph" | "code";
-/** Cross-highlighting hover target. `null` means nothing hovered. */
-type HoverTarget = {
-    pane: HoverPaneType;
-    id: string;
-} | null;
-/** Which pane is full-screened (null = normal layout). */
-type FullscreenPane = "main" | "graph" | "code" | null;
-/**
- * Cross-referencing registry: maps node paths to code line numbers and
- * visual element selectors. Provided by each demo's `store.ts`.
- */
-type NodeRegistry = Map<string, {
-    codeLine: number;
-    visualSelector: string;
-}>;
-/** Callbacks for cross-highlighting effect nodes. */
-type HighlightCallbacks = {
-    /** Called when code-scroll highlight target changes. */
-    codeScroll?: (line: number | null) => void;
-    /** Called when visual highlight target changes. */
-    visual?: (selector: string | null) => void;
-    /** Called when graph highlight target changes. */
-    graph?: (nodeId: string | null) => void;
-};
-/** Label dimensions for graph node sizing. */
-type GraphLabelSize = {
-    width: number;
-    height: number;
-};
-/** Options for {@link demoShell}. */
-type DemoShellOptions = {
-    /** Initial main/side split ratio (0–1). Default: `0.65`. */
-    mainRatio?: number;
-    /** Initial graph/code vertical split in the side pane (0–1). Default: `0.5`. */
-    sideSplit?: number;
-    /** Initial viewport width in pixels. Default: `1280`. */
-    viewportWidth?: number;
-    /** Cross-referencing registry for hover→code/visual/graph mapping. */
-    nodeRegistry?: NodeRegistry;
-    /** Measurement adapter for layout engine integration. When provided, enables layout/* derived nodes. */
-    adapter?: MeasurementAdapter;
-    /** Font string for layout measurement. Default: `"14px monospace"`. */
-    layoutFont?: string;
-    /** Callbacks for cross-highlighting effect nodes. When provided, creates effect nodes visible in describe(). */
-    onHighlight?: HighlightCallbacks;
-};
-/** Return type of {@link demoShell}. */
-type DemoShellHandle = {
-    /** The demo-shell graph. */
-    graph: Graph;
-    setMainRatio(ratio: number): void;
-    setSideSplit(ratio: number): void;
-    setFullscreen(pane: FullscreenPane): void;
-    setViewportWidth(width: number): void;
-    setHoverTarget(target: HoverTarget): void;
-    setDemoGraph(g: Graph | null): void;
-    bumpGraphTick(): void;
-    selectNode(path: string | null): void;
-    setMetaDebug(on: boolean): void;
-    /** Set code text for layout/code-lines measurement (requires adapter). */
-    setCodeText(text: string): void;
-    /** Atomic multi-set — wraps core `batch()` for glitch-free updates. */
-    batch(fn: () => void): void;
-    destroy(): void;
-};
-/**
- * Creates the three-pane demo shell graph (roadmap §7.2).
- *
- * All coordination is reactive — no polling, no imperative triggers.
- * Framework bindings subscribe to named nodes and drive `state` inputs.
- */
-declare function demoShell(opts?: DemoShellOptions): DemoShellHandle;
-
-type index_DemoShellHandle = DemoShellHandle;
-type index_DemoShellOptions = DemoShellOptions;
-type index_FullscreenPane = FullscreenPane;
-type index_GraphLabelSize = GraphLabelSize;
-type index_HighlightCallbacks = HighlightCallbacks;
-type index_HoverPaneType = HoverPaneType;
-type index_HoverTarget = HoverTarget;
-type index_NodeRegistry = NodeRegistry;
-declare const index_demoShell: typeof demoShell;
-declare namespace index {
-  export { type index_DemoShellHandle as DemoShellHandle, type index_DemoShellOptions as DemoShellOptions, type index_FullscreenPane as FullscreenPane, type index_GraphLabelSize as GraphLabelSize, type index_HighlightCallbacks as HighlightCallbacks, type index_HoverPaneType as HoverPaneType, type index_HoverTarget as HoverTarget, type index_NodeRegistry as NodeRegistry, index_demoShell as demoShell };
-}
-
-export { type DemoShellHandle as D, type FullscreenPane as F, type GraphLabelSize as G, type HighlightCallbacks as H, type NodeRegistry as N, type DemoShellOptions as a, type HoverPaneType as b, type HoverTarget as c, demoShell as d, index as i };

package/dist/index-Dh_HJ82K.d.ts

@@ -1,299 +0,0 @@
-import { B as BaseAuditRecord } from './index-CZQXo5tH.js';
-import { a as ReactiveLogBundle } from './reactive-log-BezYsbA_.js';
-import { NodeInput } from './extra/sources.js';
-import { AppendLogStorageTier } from './extra/storage-tiers.js';
-import { C as CqrsEventMap, a as CqrsEvent, b as CqrsGraph } from './index-CQG3D1cp.js';
-
-/**
- * Process Manager pattern (Phase 7 — roadmap §4.6, Audit 3 — locked 2026-04-24).
- *
- * Reactive long-running workflow primitive over CQRS event nodes.
- * Correlates events across aggregates, tracks per-instance state, supports
- * retries with backoff, and runs compensation on failure or explicit cancel.
- *
- * ## Architecture
- *
- * - Per-instance state lives in a `Map<correlationId, TState>` closure (in-memory).
- *   The `_process_<name>_started` synthetic event is dispatched per `start()`
- *   for an event-sourced audit trail using `correlationId` as `aggregateId`.
- *   Future state-snapshot persistence (`_process_<name>_state`) is reserved
- *   under the same `_process_<name>_*` namespace but not yet implemented;
- *   see `docs/optimizations.md` "Deferred follow-ups".
- * - Watched-event subscriptions are imperative (coordinator role) — each
- *   watched CQRS event type is subscribed to via `entries.subscribe(...)`.
- *   These are NOT reactive node edges; the process manager is intentionally
- *   a coordinator that bridges reactive CQRS events into imperative instance logic.
- * - Step execution uses `fromAny` to uniformly handle sync and async handlers.
- * - Retry delays use `setTimeout` (same sanctioned pattern as `extra/resilience.ts`
- *   retry helper — this primitive is a coordinator, not a reactive pipeline stage).
- * - Timer scheduling uses `fromTimer` from `extra/sources.ts` per spec §5.8.
- * - Audit log uses `createAuditLog` per Audit 2.
- *
- * @module
- */
-
-/**
- * Discriminated union returned by each step handler.
- *
- * - `"success"` — step ran cleanly; update state, optionally emit
- *   side-effect events and schedule a future synthetic event. The process
- *   instance stays `"running"`.
- * - `"terminate"` — workflow complete; instance moves to `"terminated"`.
- *   Process-specific extension to the canonical outcome enum.
- * - `"failure"` — triggers compensation; instance moves to `"compensated"` /
- *   `"errored"`.
- *
- * Field name is `outcome` (matching `cqrs.DispatchRecord.outcome` and the
- * canonical Tier 1.6.2 / 2.3 enum). `"success"` and `"failure"` are the
- * canonical values; `"terminate"` is the process-specific extension for
- * "early-return success".
- */
-type ProcessStepResult<TState> = {
-    outcome: "success";
-    state: TState;
-    emit?: readonly {
-        type: string;
-        payload: unknown;
-    }[];
-    schedule?: ProcessSchedule;
-} | {
-    outcome: "terminate";
-    state: TState;
-    emit?: readonly {
-        type: string;
-        payload: unknown;
-    }[];
-    reason?: string;
-} | {
-    outcome: "failure";
-    error: unknown;
-};
-/**
- * Schedule a synthetic timer event after `afterMs` milliseconds.
- * When the timer fires, the synthetic event of `eventType` is routed to the
- * matching step (if one is registered) for this correlationId.
- */
-type ProcessSchedule = {
-    afterMs: number;
-    eventType: string;
-};
-/**
- * Step handler signature.
- *
- * Receives the current instance state and the triggering CQRS event.
- * Returns a {@link ProcessStepResult} — sync value, Promise, or any
- * {@link NodeInput} consumed via `fromAny`.
- */
-type ProcessStep<TState, EM extends CqrsEventMap, K extends keyof EM & string> = (state: TState, event: CqrsEvent<EM[K]>) => NodeInput<ProcessStepResult<TState>>;
-/**
- * Compensation handler. Runs when a step returns `outcome: "failure"`, throws, or
- * when `cancel(correlationId)` is called on a running instance.
- *
- * Should undo any side effects performed by prior steps (refund, cancel
- * reservation, etc.). Errors thrown inside compensate are swallowed and
- * recorded in the audit log with `status: "errored"` to prevent cascading
- * failure loops.
- */
-type ProcessCompensate<TState> = (state: TState, error: unknown) => NodeInput<void>;
-/**
- * Audit record for a single process instance state transition.
- *
- * Every status change (start → running → terminated / errored / compensated)
- * appends one record. `correlationId` is the stable process key.
- *
- * Extends {@link BaseAuditRecord} so records carry `t_ns` / `seq` /
- * `handlerVersion` from the cross-cutting Audit 2 schema.
- */
-interface ProcessInstance<TState> extends BaseAuditRecord {
-    /** Stable correlation key that identifies this process instance. */
-    readonly correlationId: string;
-    /** Most-recent instance state at this transition. */
-    readonly state: TState;
-    /** Current lifecycle status after this transition. */
-    readonly status: "running" | "terminated" | "errored" | "compensated";
-    /** Wall-clock nanoseconds when `start()` was called. */
-    readonly startedAt: number;
-    /** Wall-clock nanoseconds of this transition. */
-    readonly updatedAt: number;
-    /** Handler version stamped at transition time (Audit 5). */
-    readonly handlerVersion?: {
-        id: string;
-        version: string | number;
-    };
-    /** Optional human-readable reason for cancellation. Present only on `"compensated"` records produced by `cancel()`. */
-    readonly reason?: string;
-}
-/**
- * Recommended `keyOf` for storage tiers keyed by correlationId (Audit 2).
- */
-declare const processInstanceKeyOf: <TState>(i: ProcessInstance<TState>) => string;
-/**
- * Options for {@link processManager}.
- */
-interface ProcessManagerOpts<TState, EM extends CqrsEventMap> {
-    /** Initial state value for every new process instance. */
-    readonly initial: TState;
-    /** CQRS event types to watch for correlation routing. */
-    readonly watching: readonly (keyof EM & string)[];
-    /**
-     * Per-event-type step handlers. A step is invoked when a watched event's
-     * `correlationId` matches a running instance and the event type is in
-     * `steps`. Events with no matching step are silently ignored.
-     */
-    readonly steps: {
-        [K in keyof EM & string]?: ProcessStep<TState, EM, K>;
-    };
-    /**
-     * Optional compensation handler. Runs on step `outcome: "failure"` / step throw
-     * and on explicit `cancel()`. If omitted, instances fail silently with
-     * status `"errored"` instead of `"compensated"`.
-     */
-    readonly compensate?: ProcessCompensate<TState>;
-    /**
-     * Optional predicate called after each `"success"` step. When it returns
-     * `true`, the instance is moved to `"terminated"` immediately without
-     * waiting for a `"terminate"` step result.
-     */
-    readonly isTerminal?: (state: TState) => boolean;
-    /**
-     * Maximum number of retry attempts after a step throws (not counting the
-     * first attempt). Default: `0` (no retry — fail immediately on throw).
-     */
-    readonly retryMax?: number;
-    /**
-     * Per-retry backoff delays in milliseconds. `backoffMs[i]` is the delay
-     * before attempt `i + 1`. If fewer entries than `retryMax`, the last entry
-     * is repeated. Default: `[0]` (no delay).
-     *
-     * **Implementation note:** retry delays are implemented with `setTimeout`
-     * (same sanctioned exception as `extra/resilience.ts`). This is a
-     * coordinator-layer primitive — `fromTimer` would require subscribing to
-     * an additional node per attempt, which would leak timer nodes without a
-     * clear disposal scope.
-     */
-    readonly backoffMs?: readonly number[];
-    /** Handler version tag stamped onto audit records (Audit 5). */
-    readonly handlerVersion?: {
-        id: string;
-        version: string | number;
-    };
-    /** Optional persistence wiring (Audit 4). */
-    readonly persistence?: {
-        /**
-         * Wire the per-process synthetic state event stream to append-log tiers.
-         * Reuses `CqrsGraph.attachEventStorage` so events persist across restarts.
-         */
-        eventStorage?: readonly AppendLogStorageTier<CqrsEvent>[];
-    };
-}
-/**
- * Result handle returned by {@link processManager}.
- */
-interface ProcessManagerResult<TState> {
-    /**
-     * Reactive audit log of every process instance state transition.
-     * Every `start()`, step result, retry, cancellation, and compensation
-     * appends a {@link ProcessInstance} record.
-     */
-    readonly instances: ReactiveLogBundle<ProcessInstance<TState>>;
-    /**
-     * Alias for {@link instances} (Audit 2 `.audit` duplication convention).
-     */
-    readonly audit: ReactiveLogBundle<ProcessInstance<TState>>;
-    /**
-     * Start a new process instance identified by `correlationId`.
-     *
-     * Emits a synthetic `_process_<name>_started` event into the CQRS graph
-     * with `correlationId` as `aggregateId` so per-aggregate streams record
-     * the process lifecycle. If the correlationId already has an active
-     * (running) instance, this call is a no-op (idempotent).
-     *
-     * @param correlationId - Stable key for this workflow instance.
-     * @param initialPayload - Optional payload carried on the start event.
-     */
-    start(correlationId: string, initialPayload?: unknown): void;
-    /**
-     * Cancel a running instance by correlationId.
-     *
-     * Triggers the `compensate` handler (if configured), then marks the
-     * instance as `"compensated"`. If the instance is not running, this is
-     * a no-op.
-     *
-     * @param correlationId - Instance to cancel.
-     * @param reason - Optional human-readable reason recorded in the audit log.
-     */
-    cancel(correlationId: string, reason?: string): void;
-    /**
-     * Synchronous read of the current in-memory state for a correlationId.
-     * Returns `undefined` if the instance does not exist or has terminated.
-     */
-    getState(correlationId: string): TState | undefined;
-    /**
-     * Release all watched-event subscriptions and stop processing new events.
-     *
-     * After `dispose()`, subsequent `start()` and `cancel()` calls are no-ops.
-     * In-flight async steps complete naturally; no new steps are dispatched.
-     */
-    dispose(): void;
-}
-/**
- * Create a process manager that coordinates long-running reactive workflows
- * over a {@link CqrsGraph}.
- *
- * Process instances are identified by `correlationId`. Events from the watched
- * event types are routed to per-instance step handlers when the event's
- * `correlationId` matches a running instance.
- *
- * ```ts
- * const app = cqrs<{ orderPlaced: { orderId: string }; paymentReceived: { amount: number } }>("orders");
- *
- * const pm = processManager(app, "fulfillment", {
- *   initial: { step: "awaiting-payment", total: 0 },
- *   watching: ["orderPlaced", "paymentReceived"],
- *   steps: {
- *     orderPlaced(state, event) {
- *       return { outcome: "success", state: { ...state, orderId: event.payload.orderId } };
- *     },
- *     paymentReceived(state, event) {
- *       return { outcome: "terminate", state: { ...state, total: event.payload.amount } };
- *     },
- *   },
- *   compensate(state, _error) {
- *     // undo reservation, issue refund, etc.
- *   },
- *   retryMax: 2,
- *   backoffMs: [100, 500],
- * });
- *
- * pm.start("order-123");
- * app.dispatch("orderPlaced", { orderId: "order-123" }, { correlationId: "order-123" });
- * ```
- *
- * @param cqrsGraph - The CQRS graph whose event streams the manager watches.
- * @param name - Stable identifier for this process type; used for the
- *   synthetic event-type prefix `_process_<name>_*`. Currently emits
- *   `_process_<name>_started` per `start()`; the prefix is reserved for
- *   future `_state` / `_timer` channels.
- * @param opts - Configuration: initial state, watched events, steps, retry,
- *   compensation, and optional persistence.
- * @returns {@link ProcessManagerResult} with `instances` audit log and
- *   `start`, `cancel`, `getState` imperative controls.
- *
- * @category patterns
- */
-declare function processManager<TState, EM extends CqrsEventMap = Record<string, unknown>>(cqrsGraph: CqrsGraph<EM>, name: string, opts: ProcessManagerOpts<TState, EM>): ProcessManagerResult<TState>;
-
-type index_ProcessCompensate<TState> = ProcessCompensate<TState>;
-type index_ProcessInstance<TState> = ProcessInstance<TState>;
-type index_ProcessManagerOpts<TState, EM extends CqrsEventMap> = ProcessManagerOpts<TState, EM>;
-type index_ProcessManagerResult<TState> = ProcessManagerResult<TState>;
-type index_ProcessSchedule = ProcessSchedule;
-type index_ProcessStep<TState, EM extends CqrsEventMap, K extends keyof EM & string> = ProcessStep<TState, EM, K>;
-type index_ProcessStepResult<TState> = ProcessStepResult<TState>;
-declare const index_processInstanceKeyOf: typeof processInstanceKeyOf;
-declare const index_processManager: typeof processManager;
-declare namespace index {
-  export { type index_ProcessCompensate as ProcessCompensate, type index_ProcessInstance as ProcessInstance, type index_ProcessManagerOpts as ProcessManagerOpts, type index_ProcessManagerResult as ProcessManagerResult, type index_ProcessSchedule as ProcessSchedule, type index_ProcessStep as ProcessStep, type index_ProcessStepResult as ProcessStepResult, index_processInstanceKeyOf as processInstanceKeyOf, index_processManager as processManager };
-}
-
-export { type ProcessCompensate as P, type ProcessInstance as a, type ProcessManagerOpts as b, type ProcessManagerResult as c, type ProcessSchedule as d, type ProcessStep as e, type ProcessStepResult as f, processManager as g, index as i, processInstanceKeyOf as p };

package/dist/index-Dhc7a7Xo.d.cts

@@ -1,102 +0,0 @@
-import { G as Graph } from './graph-C4SHb3Ly.cjs';
-import { M as MeasurementAdapter } from './reactive-layout-Dsvob4zD.cjs';
-
-/**
- * Three-pane demo shell (roadmap §7.2).
- *
- * A `Graph("demo-shell")` that dogfoods reactive coordination for the
- * main/side split layout with synchronized cross-highlighting.
- *
- * **Zero framework dependency** — framework bindings wrap pane components only.
- * The shell graph is headless and fully testable.
- */
-
-/** Identifies which pane is the source of a hover event. */
-type HoverPaneType = "visual" | "graph" | "code";
-/** Cross-highlighting hover target. `null` means nothing hovered. */
-type HoverTarget = {
-    pane: HoverPaneType;
-    id: string;
-} | null;
-/** Which pane is full-screened (null = normal layout). */
-type FullscreenPane = "main" | "graph" | "code" | null;
-/**
- * Cross-referencing registry: maps node paths to code line numbers and
- * visual element selectors. Provided by each demo's `store.ts`.
- */
-type NodeRegistry = Map<string, {
-    codeLine: number;
-    visualSelector: string;
-}>;
-/** Callbacks for cross-highlighting effect nodes. */
-type HighlightCallbacks = {
-    /** Called when code-scroll highlight target changes. */
-    codeScroll?: (line: number | null) => void;
-    /** Called when visual highlight target changes. */
-    visual?: (selector: string | null) => void;
-    /** Called when graph highlight target changes. */
-    graph?: (nodeId: string | null) => void;
-};
-/** Label dimensions for graph node sizing. */
-type GraphLabelSize = {
-    width: number;
-    height: number;
-};
-/** Options for {@link demoShell}. */
-type DemoShellOptions = {
-    /** Initial main/side split ratio (0–1). Default: `0.65`. */
-    mainRatio?: number;
-    /** Initial graph/code vertical split in the side pane (0–1). Default: `0.5`. */
-    sideSplit?: number;
-    /** Initial viewport width in pixels. Default: `1280`. */
-    viewportWidth?: number;
-    /** Cross-referencing registry for hover→code/visual/graph mapping. */
-    nodeRegistry?: NodeRegistry;
-    /** Measurement adapter for layout engine integration. When provided, enables layout/* derived nodes. */
-    adapter?: MeasurementAdapter;
-    /** Font string for layout measurement. Default: `"14px monospace"`. */
-    layoutFont?: string;
-    /** Callbacks for cross-highlighting effect nodes. When provided, creates effect nodes visible in describe(). */
-    onHighlight?: HighlightCallbacks;
-};
-/** Return type of {@link demoShell}. */
-type DemoShellHandle = {
-    /** The demo-shell graph. */
-    graph: Graph;
-    setMainRatio(ratio: number): void;
-    setSideSplit(ratio: number): void;
-    setFullscreen(pane: FullscreenPane): void;
-    setViewportWidth(width: number): void;
-    setHoverTarget(target: HoverTarget): void;
-    setDemoGraph(g: Graph | null): void;
-    bumpGraphTick(): void;
-    selectNode(path: string | null): void;
-    setMetaDebug(on: boolean): void;
-    /** Set code text for layout/code-lines measurement (requires adapter). */
-    setCodeText(text: string): void;
-    /** Atomic multi-set — wraps core `batch()` for glitch-free updates. */
-    batch(fn: () => void): void;
-    destroy(): void;
-};
-/**
- * Creates the three-pane demo shell graph (roadmap §7.2).
- *
- * All coordination is reactive — no polling, no imperative triggers.
- * Framework bindings subscribe to named nodes and drive `state` inputs.
- */
-declare function demoShell(opts?: DemoShellOptions): DemoShellHandle;
-
-type index_DemoShellHandle = DemoShellHandle;
-type index_DemoShellOptions = DemoShellOptions;
-type index_FullscreenPane = FullscreenPane;
-type index_GraphLabelSize = GraphLabelSize;
-type index_HighlightCallbacks = HighlightCallbacks;
-type index_HoverPaneType = HoverPaneType;
-type index_HoverTarget = HoverTarget;
-type index_NodeRegistry = NodeRegistry;
-declare const index_demoShell: typeof demoShell;
-declare namespace index {
-  export { type index_DemoShellHandle as DemoShellHandle, type index_DemoShellOptions as DemoShellOptions, type index_FullscreenPane as FullscreenPane, type index_GraphLabelSize as GraphLabelSize, type index_HighlightCallbacks as HighlightCallbacks, type index_HoverPaneType as HoverPaneType, type index_HoverTarget as HoverTarget, type index_NodeRegistry as NodeRegistry, index_demoShell as demoShell };
-}
-
-export { type DemoShellHandle as D, type FullscreenPane as F, type GraphLabelSize as G, type HighlightCallbacks as H, type NodeRegistry as N, type DemoShellOptions as a, type HoverPaneType as b, type HoverTarget as c, demoShell as d, index as i };

package/dist/index-Dmqp7KjD.d.ts

@@ -1,86 +0,0 @@
-import { N as Node } from './node-ClS5yC-B.js';
-
-/**
- * Options for creating an atom.
- *
- * @category compat
- */
-interface AtomOptions {
-    /** Optional identifier for the underlying node. */
-    name?: string;
-    /** Optional companion meta nodes. */
-    meta?: Record<string, unknown>;
-}
-/**
- * A read-only Jotai-compatible atom.
- *
- * @category compat
- */
-interface ReadableAtom<T> {
-    /** Returns the current cached value. */
-    get(): T;
-    /** Subscribes to value changes. Returns an unsubscribe function. */
-    subscribe(callback: (value: T) => void): () => void;
-    /** Access to companion meta nodes. */
-    readonly meta: Record<string, Node>;
-    /** @internal The underlying GraphReFly node. */
-    _node: Node<T>;
-}
-/**
- * A writable Jotai-compatible atom.
- *
- * @category compat
- */
-interface WritableAtom<T> extends ReadableAtom<T> {
-    /** Sets a new value. */
-    set(value: T): void;
-    /** Updates the value using a transformation function. */
-    update(fn: (current: T) => T): void;
-}
-/** Function type for reading other atoms inside a derived atom. */
-type GetFn = <V>(a: ReadableAtom<V>) => V;
-/** Function type for writing to other atoms inside a writable derived atom. */
-type SetFn = <V>(a: WritableAtom<V>, value: V) => void;
-/** Function that computes the atom's value. */
-type ReadFn<T> = (get: GetFn) => T;
-/** Function that handles writes to the atom. */
-type WriteFn<T> = (get: GetFn, set: SetFn, value: T) => void;
-/**
- * Creates a Jotai-compatible atom built on GraphReFly primitives.
- *
- * Supports three overloads:
- * 1. `atom(initial)` — Writable primitive atom (wraps `state()`).
- * 2. `atom(read)` — Read-only derived atom (wraps `dynamicNode()`).
- * 3. `atom(read, write)` — Writable derived atom.
- *
- * @param initialOrRead - Initial value or a read function.
- * @param writeOrOptions - Write function or options object.
- * @param options - Optional configuration.
- * @returns WritableAtom or ReadableAtom.
- *
- * @example
- * ```ts
- * const count = atom(0);
- * count.set(1);
- * const doubled = atom((get) => get(count)! * 2);
- * ```
- *
- * @category compat
- */
-declare function atom<T>(initial: T, options?: AtomOptions): WritableAtom<T>;
-declare function atom<T>(read: ReadFn<T>, options?: AtomOptions): ReadableAtom<T>;
-declare function atom<T>(read: ReadFn<T>, write: WriteFn<T>, options?: AtomOptions): WritableAtom<T>;
-
-type index_AtomOptions = AtomOptions;
-type index_GetFn = GetFn;
-type index_ReadFn<T> = ReadFn<T>;
-type index_ReadableAtom<T> = ReadableAtom<T>;
-type index_SetFn = SetFn;
-type index_WritableAtom<T> = WritableAtom<T>;
-type index_WriteFn<T> = WriteFn<T>;
-declare const index_atom: typeof atom;
-declare namespace index {
-  export { type index_AtomOptions as AtomOptions, type index_GetFn as GetFn, type index_ReadFn as ReadFn, type index_ReadableAtom as ReadableAtom, type index_SetFn as SetFn, type index_WritableAtom as WritableAtom, type index_WriteFn as WriteFn, index_atom as atom };
-}
-
-export { type AtomOptions as A, type GetFn as G, type ReadFn as R, type SetFn as S, type WritableAtom as W, type ReadableAtom as a, type WriteFn as b, atom as c, index as i };