@graphrefly/ts 0.0.0 → 0.0.2

package/dist/{graph-DfdF9zy4.d.ts → graph-ho5sotHP.d.ts}

@@ -1,8 +1,8 @@
 import { BatchCtx } from './core/index.js';
-import { q as NodeVersionJson, B as Status, N as Node, m as NodeFn, D as Dispatcher, u as NodeVersioningPolicy, C as Ctx, n as NodeOptions, E as EnvironmentDrivers } from './types-h12mNYbq.js';
+import { q as NodeVersionJson, D as Dispatcher, u as NodeVersioningPolicy, E as EnvironmentDrivers, n as NodeOptions, N as Node, m as NodeFn, C as Ctx, B as Status } from './types-C9NOgNJw.js';
 import { S as StrictJsonObject, b as StrictJsonValue } from './codec-BB7p8fJc.js';
-import { G as GraphTopologyEdge, e as GraphTopologySnapshot, b as DescribeOpts, c as DescribeSnapshot } from './describe-BZb7AS2y.js';
-import { M as Message } from './messages-BZqrGGm1.js';
+import { G as GraphTopologyEdge, e as GraphTopologySnapshot, b as DescribeOpts, c as DescribeSnapshot } from './describe-B_A5fbXH.js';
+import { M as Message } from './messages-CAzUPPJM.js';
 
 /**
  * GraphBlueprint first slice (D173/D177).
@@ -143,78 +143,43 @@ interface GraphCheckpoint {
     mounts?: GraphCheckpointMount[];
 }
 
-/**
- * observe / profile inspection shapes (R-observe, R-profile / D39).
- *
- * observe = a read-only enveloped EGRESS (not a graph node). profile = an opt-in
- * accumulated-counter snapshot backed by the dispatcher recorder (counters never live on
- * the thin node, R-node-thin). Per-language (D24, never in parity).
- */
-
-/** One item of an observe() stream. The envelope carries node identity + ordering. */
-interface ObserveEvent {
-    /** Mount-aware `::` path of the emitting node (shared key with describe/profile). */
-    path: string;
-    /** The protocol message observed at that node. */
-    msg: Message;
-    /** messageTier(msg[0]). */
-    tier: number;
-    /** Graph-local monotonic sequence (D26) — orders events across nodes. */
-    seq: number;
-}
-/** A read-only egress: subscribe to the live ObserveEvent stream; call the returned fn to stop. */
-interface ObserveStream {
-    subscribe(sink: (e: ObserveEvent) => void): () => void;
-}
-type TopologyEventKind = "node-registered" | "deps-changed" | "node-released" | "mount-changed";
-interface TopologyEvent {
-    /** D145 graph inspection/lifecycle event kind. Not a protocol message. */
-    readonly kind: TopologyEventKind;
-    /** Mount-aware `::` path of the affected registered node. */
-    readonly path: string;
-    /** Current dep ids after the event, matching describe().nodes[].deps. */
-    readonly deps: readonly string[];
-    /** Previous dep ids for deps-changed events. */
-    readonly prevDeps?: readonly string[];
-    /** Factory name for node-registered and node-released events. */
-    readonly factory?: string;
-    /** Graph-local monotonic sequence shared with observe() ordering. */
-    readonly seq: number;
-}
-/** A read-only topology egress stream. It does not activate nodes or emit DATA. */
-interface TopologyStream {
-    subscribe(sink: (e: TopologyEvent) => void): () => void;
-}
-/** Predicate used by filterObserve(). */
-type ObservePredicate = (event: ObserveEvent) => boolean;
-/** Equality used by coalesceObserve() for adjacent observe-event suppression. */
-type ObserveEventEquals = (prev: ObserveEvent, next: ObserveEvent) => boolean;
-/**
- * Filter a read-only observe egress stream without turning it into a graph node.
- *
- * The source stream owns ordering and lifecycle; this helper only decides whether to forward each
- * ObserveEvent and returns the source unsubscribe unchanged.
- */
-declare function filterObserve(stream: ObserveStream, predicate: ObservePredicate): ObserveStream;
-/**
- * Suppress adjacent duplicate ObserveEvents while preserving the source stream order.
- *
- * This is egress-side coalescing only: it does not batch, delay, reorder, alter seq values, or add
- * topology to describe(). Pass a custom equality when the caller wants a narrower or wider
- * definition of "duplicate".
- */
-declare function coalesceObserve(stream: ObserveStream, equals?: ObserveEventEquals): ObserveStream;
-/** Per-node profile counters (D39). invokes/duration are dispatcher-backed (R-profile). */
-interface NodeProfile {
-    invokes: number;
-    totalDurationNs: number;
-    lastDurationNs: number;
-    status: Status;
+/** Map a tuple of Nodes to the tuple of their value types (typed value-level fn args). */
+type DepValues<D extends readonly Node<unknown>[]> = {
+    [K in keyof D]: D[K] extends Node<infer V> ? V : never;
+};
+/** Value-level derived fn: receives dep values, returns the next value (undefined = no emit). */
+type DerivedFn<D extends readonly Node<unknown>[], T> = (...values: DepValues<D>) => T | undefined;
+/** Value-level effect fn: receives dep values, optionally returns a deactivation cleanup. */
+type EffectFn<D extends readonly Node<unknown>[]> = (...values: DepValues<D>) => void | (() => void);
+/** Sugar options — node options minus graph-owned dispatcher plus naming/meta. */
+interface SugarOpts<T = unknown> extends Omit<NodeOptions<T>, "dispatcher"> {
+    name?: string;
+    meta?: Record<string, unknown>;
+    /**
+     * D95: explicit restorable factory metadata. Static JSON-compatible config may live here;
+     * reactive options must remain graph deps. Without this, function-backed nodes are local-only.
+     */
+    restore?: {
+        ref: string;
+        config?: unknown;
+        configVersion?: unknown;
+    };
 }
-/** profile() snapshot. Shares the mount-aware `::` path key with describe/observe. */
-interface Profile {
-    totalInvokes: number;
-    nodes: Record<string, NodeProfile>;
+interface GraphOptions {
+    name?: string;
+    /** Bind to a dispatcher (default = process-global, D26). */
+    dispatcher?: Dispatcher;
+    /** D109 default node runtime versioning policy for graph-owned nodes. Default is nodev0. */
+    versioning?: NodeVersioningPolicy;
+    /** Graph-owned environment drivers for source/adapter boundaries (D130/D131). */
+    environment?: EnvironmentDrivers;
+    /**
+     * Turn on the dispatcher profile recorder (D39 / F-PERF default off). NOTE: this
+     * switches recording on for the WHOLE bound dispatcher (the default is process-global,
+     * D26) — every graph sharing it then pays the recorder cost. For isolated profiling
+     * use a dedicated dispatcher: `graph({ dispatcher: new Dispatcher(), profile: true })`.
+     */
+    profile?: boolean;
 }
 
 interface GraphRestoreDefinition<S = never, T = unknown> {
@@ -469,64 +434,6 @@ interface ValveOpts {
  */
 declare function valve<S>(opts?: ValveOpts): Operator<S, S>;
 
-/**
- * The Graph layer (CSP-2): convenience + inspection entry (D5 / R-graph-role).
- *
- * g.* sugar desugars to dispatcher.register + Node and auto-registers into the graph
- * inspection index (D27: sugar→ctx-fn conversion lives strictly here; the substrate node
- * only ever sees `(ctx)=>void`). The Graph owns naming, describe, mount, and the D30
- * value-level throw→ERROR boundary. The bare node()/dispatcher stay inspection-free
- * (R-node-thin).
- *
- * Canonical authority: ~/src/graphrefly — D3/D5/D27/D30/D36/D37/D39, R-graph-role,
- * R-describe, R-fn-contract, R-edges-derived, R-meta-presentation.
- */
-
-/** Map a tuple of Nodes to the tuple of their value types (typed value-level fn args). */
-type DepValues<D extends readonly Node<unknown>[]> = {
-    [K in keyof D]: D[K] extends Node<infer V> ? V : never;
-};
-/** Value-level derived fn: receives dep values, returns the next value (undefined = no emit). */
-type DerivedFn<D extends readonly Node<unknown>[], T> = (...values: DepValues<D>) => T | undefined;
-/** Value-level effect fn: receives dep values, optionally returns a deactivation cleanup. */
-type EffectFn<D extends readonly Node<unknown>[]> = (...values: DepValues<D>) => void | (() => void);
-/** Sugar options — node options minus graph-owned dispatcher plus naming/meta. */
-interface SugarOpts<T = unknown> extends Omit<NodeOptions<T>, "dispatcher"> {
-    name?: string;
-    meta?: Record<string, unknown>;
-    /**
-     * D95: explicit restorable factory metadata. Static JSON-compatible config may live here;
-     * reactive options must remain graph deps. Without this, function-backed nodes are local-only.
-     */
-    restore?: {
-        ref: string;
-        config?: unknown;
-        configVersion?: unknown;
-    };
-}
-interface GraphOptions {
-    name?: string;
-    /** Bind to a dispatcher (default = process-global, D26). */
-    dispatcher?: Dispatcher;
-    /** D109 default node runtime versioning policy for graph-owned nodes. Default is nodev0. */
-    versioning?: NodeVersioningPolicy;
-    /** Graph-owned environment drivers for source/adapter boundaries (D130/D131). */
-    environment?: EnvironmentDrivers;
-    /**
-     * Turn on the dispatcher profile recorder (D39 / F-PERF default off). NOTE: this
-     * switches recording on for the WHOLE bound dispatcher (the default is process-global,
-     * D26) — every graph sharing it then pays the recorder cost. For isolated profiling
-     * use a dedicated dispatcher: `graph({ dispatcher: new Dispatcher(), profile: true })`.
-     */
-    profile?: boolean;
-}
-/**
- * A state node (L4-Q1): a manual source whose `.set(v)` is `node.down([[DATA, v]])` sugar.
- * Extends the substrate Node so it is usable as a dep AND carries the graph-layer `.set`.
- */
-declare class StateNode<T> extends Node<T> {
-    set(v: T): void;
-}
 interface TopologyGroupOptions {
     /** Optional inspection/release reason label for this graph-owned topology group. */
     name?: string;
@@ -552,6 +459,101 @@ interface TopologyGroup {
     initNode<TIn, TOut>(op: Operator<TIn, TOut>, deps: readonly Node<TIn>[], opts?: SugarOpts<TOut>): Node<TOut>;
     release(opts?: TopologyGroupReleaseOptions): void;
 }
+
+/**
+ * observe / profile inspection shapes (R-observe, R-profile / D39).
+ *
+ * observe = a read-only enveloped EGRESS (not a graph node). profile = an opt-in
+ * accumulated-counter snapshot backed by the dispatcher recorder (counters never live on
+ * the thin node, R-node-thin). Per-language (D24, never in parity).
+ */
+
+/** One item of an observe() stream. The envelope carries node identity + ordering. */
+interface ObserveEvent {
+    /** Mount-aware `::` path of the emitting node (shared key with describe/profile). */
+    path: string;
+    /** The protocol message observed at that node. */
+    msg: Message;
+    /** messageTier(msg[0]). */
+    tier: number;
+    /** Graph-local monotonic sequence (D26) — orders events across nodes. */
+    seq: number;
+}
+/** A read-only egress: subscribe to the live ObserveEvent stream; call the returned fn to stop. */
+interface ObserveStream {
+    subscribe(sink: (e: ObserveEvent) => void): () => void;
+}
+type TopologyEventKind = "node-registered" | "deps-changed" | "node-released" | "mount-changed";
+interface TopologyEvent {
+    /** D145 graph inspection/lifecycle event kind. Not a protocol message. */
+    readonly kind: TopologyEventKind;
+    /** Mount-aware `::` path of the affected registered node. */
+    readonly path: string;
+    /** Current dep ids after the event, matching describe().nodes[].deps. */
+    readonly deps: readonly string[];
+    /** Previous dep ids for deps-changed events. */
+    readonly prevDeps?: readonly string[];
+    /** Factory name for node-registered and node-released events. */
+    readonly factory?: string;
+    /** Graph-local monotonic sequence shared with observe() ordering. */
+    readonly seq: number;
+}
+/** A read-only topology egress stream. It does not activate nodes or emit DATA. */
+interface TopologyStream {
+    subscribe(sink: (e: TopologyEvent) => void): () => void;
+}
+/** Predicate used by filterObserve(). */
+type ObservePredicate = (event: ObserveEvent) => boolean;
+/** Equality used by coalesceObserve() for adjacent observe-event suppression. */
+type ObserveEventEquals = (prev: ObserveEvent, next: ObserveEvent) => boolean;
+/**
+ * Filter a read-only observe egress stream without turning it into a graph node.
+ *
+ * The source stream owns ordering and lifecycle; this helper only decides whether to forward each
+ * ObserveEvent and returns the source unsubscribe unchanged.
+ */
+declare function filterObserve(stream: ObserveStream, predicate: ObservePredicate): ObserveStream;
+/**
+ * Suppress adjacent duplicate ObserveEvents while preserving the source stream order.
+ *
+ * This is egress-side coalescing only: it does not batch, delay, reorder, alter seq values, or add
+ * topology to describe(). Pass a custom equality when the caller wants a narrower or wider
+ * definition of "duplicate".
+ */
+declare function coalesceObserve(stream: ObserveStream, equals?: ObserveEventEquals): ObserveStream;
+/** Per-node profile counters (D39). invokes/duration are dispatcher-backed (R-profile). */
+interface NodeProfile {
+    invokes: number;
+    totalDurationNs: number;
+    lastDurationNs: number;
+    status: Status;
+}
+/** profile() snapshot. Shares the mount-aware `::` path key with describe/observe. */
+interface Profile {
+    totalInvokes: number;
+    nodes: Record<string, NodeProfile>;
+}
+
+/**
+ * The Graph layer (CSP-2): convenience + inspection entry (D5 / R-graph-role).
+ *
+ * g.* sugar desugars to dispatcher.register + Node and auto-registers into the graph
+ * inspection index (D27: sugar→ctx-fn conversion lives strictly here; the substrate node
+ * only ever sees `(ctx)=>void`). The Graph owns naming, describe, mount, and the D30
+ * value-level throw→ERROR boundary. The bare node()/dispatcher stay inspection-free
+ * (R-node-thin).
+ *
+ * Canonical authority: ~/src/graphrefly — D3/D5/D27/D30/D36/D37/D39, R-graph-role,
+ * R-describe, R-fn-contract, R-edges-derived, R-meta-presentation.
+ */
+
+/**
+ * A state node (L4-Q1): a manual source whose `.set(v)` is `node.down([[DATA, v]])` sugar.
+ * Extends the substrate Node so it is usable as a dep AND carries the graph-layer `.set`.
+ */
+declare class StateNode<T> extends Node<T> {
+    set(v: T): void;
+}
 declare class Graph {
     readonly name?: string;
     private readonly _dispatcher;

package/dist/{index-SnzZu3x7.d.ts → index-CQWcE0Dw.d.ts}

@@ -1,5 +1,5 @@
-import { N as Node, n as NodeOptions, h as HttpResponse, g as HttpRequest, x as ProcessResult, z as SseEvent, A as SseRequest, J as WebSocketEvent, M as WebSocketRequest, X as WebhookEvent, Y as WebhookRegistration, w as ProcessCommand } from './types-h12mNYbq.js';
-import { L as Operator } from './graph-DfdF9zy4.js';
+import { N as Node, n as NodeOptions, h as HttpResponse, g as HttpRequest, x as ProcessResult, z as SseEvent, A as SseRequest, J as WebSocketEvent, M as WebSocketRequest, X as WebhookEvent, Y as WebhookRegistration, w as ProcessCommand } from './types-C9NOgNJw.js';
+import { L as Operator } from './graph-ho5sotHP.js';
 
 /**
  * Async + sync sources (binding-layer sugar, D43 / D40 / feedback_async_sources_binding_layer).
@@ -44,6 +44,16 @@ interface TimerSourceOpts extends AsyncSourceOpts {
 interface FromCronOptions extends AsyncSourceOpts {
     /** Cron matcher polling interval in milliseconds. Default: 60_000. */
     tickMs?: number;
+    /** IANA timezone used for wall-clock cron matching. Defaults to the host-local timezone. */
+    timezone?: string;
+    /**
+     * DST policy for timezone-aware matching. Current D484 defaults are explicit: nonexistent
+     * wall-clock minutes are skipped, and repeated wall-clock minutes fire at most once.
+     */
+    dst?: {
+        readonly nonexistent?: "skip";
+        readonly repeated?: "once";
+    };
     /**
      * Emitted value shape. `timestamp_ns` is a decimal string so it cannot lose precision as a
      * JavaScript number; use `timestamp_ms` when numeric millisecond precision is enough.
@@ -74,8 +84,12 @@ type PushUnsubscribe = () => void;
 type PushRegister<T> = (deliver: (payload: T) => void) => PushUnsubscribe | undefined;
 /** Parse a standard five-field cron expression. */
 declare function parseCron(expr: string): CronSchedule;
-/** Test whether a local Date matches a parsed cron schedule. */
-declare function matchesCron(schedule: CronSchedule, date: Date): boolean;
+interface CronMatchOptions {
+    /** IANA timezone used for wall-clock projection. Defaults to the host-local timezone. */
+    timezone?: string;
+}
+/** Test whether a Date matches a parsed cron schedule in host-local time or an IANA timezone. */
+declare function matchesCron(schedule: CronSchedule, date: Date, opts?: CronMatchOptions): boolean;
 declare function fromCron(expr: string, opts: FromCronOptions & {
     output: "date";
 }): Operator<never, Date>;

package/dist/{index-CAEmLCYF.d.cts → index-DHA1i67c.d.cts}

@@ -1,5 +1,5 @@
-import { N as Node, n as NodeOptions, h as HttpResponse, g as HttpRequest, x as ProcessResult, z as SseEvent, A as SseRequest, J as WebSocketEvent, M as WebSocketRequest, X as WebhookEvent, Y as WebhookRegistration, w as ProcessCommand } from './types-bNMSWKqF.cjs';
-import { L as Operator } from './graph-s23RbbFO.cjs';
+import { N as Node, n as NodeOptions, h as HttpResponse, g as HttpRequest, x as ProcessResult, z as SseEvent, A as SseRequest, J as WebSocketEvent, M as WebSocketRequest, X as WebhookEvent, Y as WebhookRegistration, w as ProcessCommand } from './types-BS6CyR-x.cjs';
+import { L as Operator } from './graph-CWK3HLPB.cjs';
 
 /**
  * Async + sync sources (binding-layer sugar, D43 / D40 / feedback_async_sources_binding_layer).
@@ -44,6 +44,16 @@ interface TimerSourceOpts extends AsyncSourceOpts {
 interface FromCronOptions extends AsyncSourceOpts {
     /** Cron matcher polling interval in milliseconds. Default: 60_000. */
     tickMs?: number;
+    /** IANA timezone used for wall-clock cron matching. Defaults to the host-local timezone. */
+    timezone?: string;
+    /**
+     * DST policy for timezone-aware matching. Current D484 defaults are explicit: nonexistent
+     * wall-clock minutes are skipped, and repeated wall-clock minutes fire at most once.
+     */
+    dst?: {
+        readonly nonexistent?: "skip";
+        readonly repeated?: "once";
+    };
     /**
      * Emitted value shape. `timestamp_ns` is a decimal string so it cannot lose precision as a
      * JavaScript number; use `timestamp_ms` when numeric millisecond precision is enough.
@@ -74,8 +84,12 @@ type PushUnsubscribe = () => void;
 type PushRegister<T> = (deliver: (payload: T) => void) => PushUnsubscribe | undefined;
 /** Parse a standard five-field cron expression. */
 declare function parseCron(expr: string): CronSchedule;
-/** Test whether a local Date matches a parsed cron schedule. */
-declare function matchesCron(schedule: CronSchedule, date: Date): boolean;
+interface CronMatchOptions {
+    /** IANA timezone used for wall-clock projection. Defaults to the host-local timezone. */
+    timezone?: string;
+}
+/** Test whether a Date matches a parsed cron schedule in host-local time or an IANA timezone. */
+declare function matchesCron(schedule: CronSchedule, date: Date, opts?: CronMatchOptions): boolean;
 declare function fromCron(expr: string, opts: FromCronOptions & {
     output: "date";
 }): Operator<never, Date>;