@graphrefly/graphrefly 0.45.0 → 0.46.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// `@graphrefly/graphrefly` is a thin re-export layer over the chosen sibling\n// impl (per PART 13 of `archive/docs/SESSION-rust-port-architecture.md`).\n// Three siblings (D082): `@graphrefly/native` (napi-rs, Node fast path),\n// `@graphrefly/wasm` (wasm-bindgen, browser fast path opt-in subpath),\n// `@graphrefly/pure-ts` (universal fallback, permanent first-class peer per\n// D084). Until the facade build lands (Deferred 1 of PART 13), this shim\n// delegates everything to `@graphrefly/pure-ts` directly.\nexport * from \"@graphrefly/pure-ts\";\n"],"mappings":";AAOA,cAAc;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @graphrefly/graphrefly — presentation layer for the GraphReFly reactive graph protocol.\n *\n * This package composes:\n * 1. Substrate re-export from @graphrefly/pure-ts (ergonomic single-import: node,\n *    state, graph, derived, effect, produce, batch, operators, data-structures,\n *    storage, stratify, fromTimer, fromPromise, fromAsyncIter, fromAny, etc.)\n * 2. Presentation layers (base → utils → presets → solutions) — patterns, IO\n *    adapters, composition helpers, mutation wrappers, render, compat adapters.\n *\n * Peer dependency: @graphrefly/pure-ts.\n *\n * NOTE (2026-05-15): the install-time `@graphrefly/native` drop-in via\n * `overrides` (Q28 = option (c), D198) is NOT functional today and is\n * design-pending. `@graphrefly/native`'s napi surface is irreducibly\n * async (Core on a tokio blocking pool; sync calls deadlock — D070/D077),\n * while this presentation package consumes pure-ts's SYNC public API\n * (sync `node()/state()/map()`, sync `.cache` at construction, sync\n * `.subscribe/.emit/.down`). A `@graphrefly/pure-ts`→`@graphrefly/native`\n * override would therefore break every substrate call. The only\n * documented coherent path is D080 (async-everywhere public API across\n * all siblings), which is itself deferred to near-1.0 and was never\n * reconciled with the Q28/D198 overrides framing. Until that design\n * session lands, `@graphrefly/pure-ts` is the only working substrate\n * provider; `@graphrefly/native` is a parity-test arm, not a consumable\n * drop-in. See `docs/optimizations.md` \"Native substrate contract\n * (D080 ↔ Q28/D198 unreconciled)\".\n *\n * Node-only subpath: @graphrefly/graphrefly/base/sources/node\n * Browser-only subpath: @graphrefly/graphrefly/base/sources/browser\n * Compat per-framework: @graphrefly/graphrefly/compat/<framework>\n *\n * @module\n */\n\n// 1. Substrate — node, state, graph, extra (operators, data-structures, storage, sources)\nexport * from \"@graphrefly/pure-ts\";\n\n// 2. Presentation layers (top-down per 4-layer model; CI-enforced by Biome layer-boundary rule)\nexport * from \"./base/index.js\";\nexport * from \"./presets/index.js\";\nexport * from \"./solutions/index.js\";\nexport * from \"./utils/index.js\";\n// compat is namespaced; import from @graphrefly/graphrefly/compat/<framework>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,cAAc;","names":[]}

package/dist/layout-types-B5aiHYgk.d.cts

@@ -0,0 +1,72 @@
+import { GraphDescribeOutput, GraphChange } from '@graphrefly/pure-ts/graph';
+
+/**
+ * Canonical home for layout types. Lives in `extra/render/` because the SVG
+ * renderer (`layout-frame-to-svg.ts`) consumes them; `patterns/topology-view`
+ * re-exports them through its public types module. Keeping the layering
+ * downward (extra/ → patterns/) avoids the inverted import that flagged in
+ * /qa F-17.
+ *
+ * @module
+ */
+
+/**
+ * One node placement in cell-grid coordinates.
+ *
+ * `id` is the node's qualified path (`::`-delimited). `x`/`y`/`w`/`h` are
+ * direction-agnostic integer cell coordinates produced by the layout; the
+ * default direction is `"LR"` (layers grow along x). Renderers map cells →
+ * pixels (or characters) at draw time.
+ *
+ * `meta` is forwarded from the source describe snapshot (read-only) — useful
+ * for renderers that color/style by `kind`, factory tag, or domain meta.
+ */
+interface LayoutBox {
+    readonly id: string;
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+    readonly meta?: Record<string, unknown>;
+}
+/**
+ * One edge placement. `from`/`to` are qualified node paths. `depIndex` is
+ * the positional dep index on the `to` node (matches `fromDepIndex` on
+ * {@link GraphChange} `data` events). `points` is the polyline of waypoints
+ * (start → corners → end) in cell-grid coordinates.
+ */
+interface LayoutEdge {
+    readonly from: string;
+    readonly to: string;
+    readonly depIndex: number;
+    readonly points: ReadonlyArray<readonly [number, number]>;
+}
+/**
+ * One frame of the live topology view.
+ *
+ * - `boxes` — current node placements (full set, not a delta).
+ * - `edges` — current edge polylines (full set).
+ * - `changes` — the {@link GraphChange} events that flowed in the wave that
+ *   produced this frame. Empty on the initial push-on-subscribe frame
+ *   (consumers seeded from `graph.describe()`); populated on subsequent
+ *   batches. Renderers can highlight changed nodes / animate flowing edges
+ *   per change-event scope.
+ */
+interface LayoutFrame {
+    readonly boxes: readonly LayoutBox[];
+    readonly edges: readonly LayoutEdge[];
+    readonly changes: readonly GraphChange[];
+}
+/**
+ * Pluggable layout function — receives a {@link GraphDescribeOutput} snapshot
+ * and returns the box / edge placements for the current topology. Pure-fn
+ * shape so the default in `_internal.ts` and third-party adapters
+ * (e.g. wrapping `dagre`, `elk`, `cytoscape`) share the same signature.
+ *
+ * `changes` (the per-frame batch) is overlaid on the layout's output by
+ * `topologyView`'s internal `frame` derived — layout fns don't need to
+ * handle batched events themselves.
+ */
+type LayoutFn = (spec: GraphDescribeOutput) => Pick<LayoutFrame, "boxes" | "edges">;
+
+export type { LayoutBox as L, LayoutEdge as a, LayoutFn as b, LayoutFrame as c };

package/dist/layout-types-B5aiHYgk.d.ts

@@ -0,0 +1,72 @@
+import { GraphDescribeOutput, GraphChange } from '@graphrefly/pure-ts/graph';
+
+/**
+ * Canonical home for layout types. Lives in `extra/render/` because the SVG
+ * renderer (`layout-frame-to-svg.ts`) consumes them; `patterns/topology-view`
+ * re-exports them through its public types module. Keeping the layering
+ * downward (extra/ → patterns/) avoids the inverted import that flagged in
+ * /qa F-17.
+ *
+ * @module
+ */
+
+/**
+ * One node placement in cell-grid coordinates.
+ *
+ * `id` is the node's qualified path (`::`-delimited). `x`/`y`/`w`/`h` are
+ * direction-agnostic integer cell coordinates produced by the layout; the
+ * default direction is `"LR"` (layers grow along x). Renderers map cells →
+ * pixels (or characters) at draw time.
+ *
+ * `meta` is forwarded from the source describe snapshot (read-only) — useful
+ * for renderers that color/style by `kind`, factory tag, or domain meta.
+ */
+interface LayoutBox {
+    readonly id: string;
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+    readonly meta?: Record<string, unknown>;
+}
+/**
+ * One edge placement. `from`/`to` are qualified node paths. `depIndex` is
+ * the positional dep index on the `to` node (matches `fromDepIndex` on
+ * {@link GraphChange} `data` events). `points` is the polyline of waypoints
+ * (start → corners → end) in cell-grid coordinates.
+ */
+interface LayoutEdge {
+    readonly from: string;
+    readonly to: string;
+    readonly depIndex: number;
+    readonly points: ReadonlyArray<readonly [number, number]>;
+}
+/**
+ * One frame of the live topology view.
+ *
+ * - `boxes` — current node placements (full set, not a delta).
+ * - `edges` — current edge polylines (full set).
+ * - `changes` — the {@link GraphChange} events that flowed in the wave that
+ *   produced this frame. Empty on the initial push-on-subscribe frame
+ *   (consumers seeded from `graph.describe()`); populated on subsequent
+ *   batches. Renderers can highlight changed nodes / animate flowing edges
+ *   per change-event scope.
+ */
+interface LayoutFrame {
+    readonly boxes: readonly LayoutBox[];
+    readonly edges: readonly LayoutEdge[];
+    readonly changes: readonly GraphChange[];
+}
+/**
+ * Pluggable layout function — receives a {@link GraphDescribeOutput} snapshot
+ * and returns the box / edge placements for the current topology. Pure-fn
+ * shape so the default in `_internal.ts` and third-party adapters
+ * (e.g. wrapping `dagre`, `elk`, `cytoscape`) share the same signature.
+ *
+ * `changes` (the per-frame batch) is overlaid on the layout's output by
+ * `topologyView`'s internal `frame` derived — layout fns don't need to
+ * handle batched events themselves.
+ */
+type LayoutFn = (spec: GraphDescribeOutput) => Pick<LayoutFrame, "boxes" | "edges">;
+
+export type { LayoutBox as L, LayoutEdge as a, LayoutFn as b, LayoutFrame as c };