@graphrefly/graphrefly 0.23.0 → 0.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/dist/{chunk-NZMBRXQV.js → chunk-5DJTTKX3.js} +11 -13
  2. package/dist/chunk-5DJTTKX3.js.map +1 -0
  3. package/dist/{chunk-PNUZM7PC.js → chunk-EVR6UFUV.js} +6 -6
  4. package/dist/{chunk-HVBX5KIW.js → chunk-H4RVA4VE.js} +2 -2
  5. package/dist/{chunk-32N5A454.js → chunk-HWPIFSW2.js} +2 -2
  6. package/dist/chunk-HWPIFSW2.js.map +1 -0
  7. package/dist/{chunk-XTLYW4FR.js → chunk-IAHGTNOZ.js} +6 -4
  8. package/dist/{chunk-XTLYW4FR.js.map → chunk-IAHGTNOZ.js.map} +1 -1
  9. package/dist/{chunk-CWYPA63G.js → chunk-L2GLW2U7.js} +69 -2
  10. package/dist/chunk-L2GLW2U7.js.map +1 -0
  11. package/dist/{chunk-2GQLMQVJ.js → chunk-MW4VAKAO.js} +3 -3
  12. package/dist/{chunk-JFONSPNF.js → chunk-PY4XCDLR.js} +2 -2
  13. package/dist/{chunk-263BEJJO.js → chunk-QOWVNWOC.js} +3 -3
  14. package/dist/{chunk-PX6PDUJ5.js → chunk-TKE3JGOH.js} +491 -19
  15. package/dist/chunk-TKE3JGOH.js.map +1 -0
  16. package/dist/{chunk-XRFJJ2IU.js → chunk-XOFWRC73.js} +3 -3
  17. package/dist/compat/nestjs/index.cjs +10 -12
  18. package/dist/compat/nestjs/index.cjs.map +1 -1
  19. package/dist/compat/nestjs/index.d.cts +6 -6
  20. package/dist/compat/nestjs/index.d.ts +6 -6
  21. package/dist/compat/nestjs/index.js +9 -9
  22. package/dist/core/index.cjs +10 -12
  23. package/dist/core/index.cjs.map +1 -1
  24. package/dist/core/index.d.cts +3 -3
  25. package/dist/core/index.d.ts +3 -3
  26. package/dist/core/index.js +3 -3
  27. package/dist/extra/index.cjs +78 -12
  28. package/dist/extra/index.cjs.map +1 -1
  29. package/dist/extra/index.d.cts +4 -4
  30. package/dist/extra/index.d.ts +4 -4
  31. package/dist/extra/index.js +6 -4
  32. package/dist/graph/index.cjs +10 -12
  33. package/dist/graph/index.cjs.map +1 -1
  34. package/dist/graph/index.d.cts +5 -5
  35. package/dist/graph/index.d.ts +5 -5
  36. package/dist/graph/index.js +4 -4
  37. package/dist/{graph-CEO2FkLY.d.ts → graph-B6NFqv3z.d.ts} +3 -3
  38. package/dist/{graph-BtdSRHUc.d.cts → graph-D-3JIQme.d.cts} +3 -3
  39. package/dist/{index-BFGjXbiP.d.cts → index-AMWewNDe.d.cts} +2 -2
  40. package/dist/{index-BUj3ASVe.d.cts → index-BJB7t9gg.d.cts} +10 -24
  41. package/dist/{index-DSPc5rkv.d.ts → index-C-TXEa7C.d.ts} +10 -24
  42. package/dist/{index-CkElcUY6.d.ts → index-CYkjxu3s.d.ts} +2 -2
  43. package/dist/{index-B0tfuXwV.d.cts → index-Ch0IpIO0.d.cts} +32 -5
  44. package/dist/{index-C59uSJAH.d.cts → index-DKE1EATr.d.cts} +224 -4
  45. package/dist/{index-DgscL7v0.d.ts → index-DiobMNwE.d.ts} +3 -3
  46. package/dist/{index-RXN94sHK.d.ts → index-Ds23Wvou.d.ts} +32 -5
  47. package/dist/{index-BPlWVAKY.d.cts → index-J7Kc0oIQ.d.cts} +3 -3
  48. package/dist/{index-jEtF4N7L.d.ts → index-OXImXMq6.d.ts} +224 -4
  49. package/dist/index.cjs +570 -47
  50. package/dist/index.cjs.map +1 -1
  51. package/dist/index.d.cts +15 -15
  52. package/dist/index.d.ts +15 -15
  53. package/dist/index.js +23 -31
  54. package/dist/index.js.map +1 -1
  55. package/dist/{meta-3QjzotRv.d.ts → meta-CnkLA_43.d.ts} +1 -1
  56. package/dist/{meta-B-Lbs4-O.d.cts → meta-DWbkoq1s.d.cts} +1 -1
  57. package/dist/{node-C7PD3sn9.d.cts → node-B-f-Lu-k.d.cts} +15 -13
  58. package/dist/{node-C7PD3sn9.d.ts → node-B-f-Lu-k.d.ts} +15 -13
  59. package/dist/{observable-axpzv1K2.d.cts → observable-DBnrwcar.d.cts} +1 -1
  60. package/dist/{observable-EyO-moQY.d.ts → observable-uP-wy_uK.d.ts} +1 -1
  61. package/dist/patterns/reactive-layout/index.cjs +498 -28
  62. package/dist/patterns/reactive-layout/index.cjs.map +1 -1
  63. package/dist/patterns/reactive-layout/index.d.cts +5 -5
  64. package/dist/patterns/reactive-layout/index.d.ts +5 -5
  65. package/dist/patterns/reactive-layout/index.js +20 -8
  66. package/dist/{storage-DIgAr7M_.d.cts → storage-BuTdpCI1.d.cts} +1 -1
  67. package/dist/{storage-CHT5WE9m.d.ts → storage-F2X1U1x0.d.ts} +1 -1
  68. package/package.json +2 -2
  69. package/dist/chunk-32N5A454.js.map +0 -1
  70. package/dist/chunk-CWYPA63G.js.map +0 -1
  71. package/dist/chunk-NZMBRXQV.js.map +0 -1
  72. package/dist/chunk-PX6PDUJ5.js.map +0 -1
  73. /package/dist/{chunk-PNUZM7PC.js.map → chunk-EVR6UFUV.js.map} +0 -0
  74. /package/dist/{chunk-HVBX5KIW.js.map → chunk-H4RVA4VE.js.map} +0 -0
  75. /package/dist/{chunk-2GQLMQVJ.js.map → chunk-MW4VAKAO.js.map} +0 -0
  76. /package/dist/{chunk-JFONSPNF.js.map → chunk-PY4XCDLR.js.map} +0 -0
  77. /package/dist/{chunk-263BEJJO.js.map → chunk-QOWVNWOC.js.map} +0 -0
  78. /package/dist/{chunk-XRFJJ2IU.js.map → chunk-XOFWRC73.js.map} +0 -0
@@ -1,4 +1,4 @@
1
- import { v as NodeDescribeKind, N as Node, A as Actor } from './node-C7PD3sn9.js';
1
+ import { v as NodeDescribeKind, N as Node, A as Actor } from './node-B-f-Lu-k.js';
2
2
 
3
3
  /**
4
4
  * JSON-shaped slice of a node for `Graph.describe()`
@@ -1,4 +1,4 @@
1
- import { v as NodeDescribeKind, N as Node, A as Actor } from './node-C7PD3sn9.cjs';
1
+ import { v as NodeDescribeKind, N as Node, A as Actor } from './node-B-f-Lu-k.cjs';
2
2
 
3
3
  /**
4
4
  * JSON-shaped slice of a node for `Graph.describe()`
@@ -559,7 +559,11 @@ declare function accessHintForGuard(guard: NodeGuard): string;
559
559
  * contract. See SESSION-foundation-redesign.md §§1–10 for design history.
560
560
  */
561
561
 
562
- /** Lifecycle status of a node (GRAPHREFLY-SPEC §2.2). */
562
+ /**
563
+ * Lifecycle status of a node.
564
+ *
565
+ * @see GRAPHREFLY-SPEC.md §2.2
566
+ */
563
567
  type NodeStatus = "sentinel" | "pending" | "dirty" | "settled" | "resolved" | "completed" | "errored";
564
568
  /** Callback that receives downstream message batches. */
565
569
  type NodeSink = (messages: Messages) => void;
@@ -1083,37 +1087,35 @@ declare class NodeImpl<T = unknown> implements Node<T> {
1083
1087
  private _frameBatch;
1084
1088
  /**
1085
1089
  * @internal The unified dispatch waist — one call = one wave.
1090
+ * See `GRAPHREFLY-SPEC.md` §1.3.1 for protocol context — the stages
1091
+ * below are the implementation order.
1086
1092
  *
1087
1093
  * Pipeline stages, in order:
1088
1094
  *
1089
- * 1. Early-return on empty batch.
1090
- * 2. Terminal filter — post-COMPLETE/ERROR only TEARDOWN/INVALIDATE
1095
+ * 1. Terminal filter — post-COMPLETE/ERROR only TEARDOWN/INVALIDATE
1091
1096
  * still propagate so graph teardown and cache-clear still work.
1092
- * 3. Tier sort (stable) — the batch can be in any order when it
1097
+ * 2. Tier sort (stable) — the batch can be in any order when it
1093
1098
  * arrives; the walker downstream (`downWithBatch`) assumes
1094
1099
  * ascending tier monotone, and so does `_updateState`'s tier-3
1095
1100
  * slice walk. This is the single source of truth for ordering.
1096
- * 4. Synthetic DIRTY prefix — if a tier-3 payload is present, no
1101
+ * 3. Synthetic DIRTY prefix — if a tier-3 payload is present, no
1097
1102
  * DIRTY is already in the batch, and the node isn't already in
1098
1103
  * `"dirty"` status, prepend `[DIRTY]` after any tier-0 START
1099
1104
  * entries. Guarantees spec §1.3.1 (DIRTY precedes DATA within
1100
1105
  * the same batch) uniformly across every entry point.
1101
- * 5. PAUSE/RESUME lock bookkeeping (C0) — update `_pauseLocks`,
1106
+ * 4. PAUSE/RESUME lock bookkeeping (C0) — update `_pauseLocks`,
1102
1107
  * derive `_paused`, filter unknown-lockId RESUME, replay
1103
1108
  * bufferAll buffer on final lock release.
1104
- * 6. Meta TEARDOWN fan-out — notify meta children before
1109
+ * 5. Meta TEARDOWN fan-out — notify meta children before
1105
1110
  * `_updateState`'s TEARDOWN branch calls `_deactivate`. Hoisted
1106
1111
  * out of the walk to keep `_updateState` re-entrance-free.
1107
- * 7. `_updateState` — walk the batch in tier order, advancing
1112
+ * 6. `_updateState` — walk the batch in tier order, advancing
1108
1113
  * `_cached` / `_status` / `_versioning` and running equals
1109
1114
  * substitution on tier-3 DATA (§3.5.1). Returns
1110
1115
  * `{finalMessages, equalsError?}`.
1111
- * 8. `downWithBatch` dispatch (or bufferAll capture if paused with
1116
+ * 7. `downWithBatch` dispatch (or bufferAll capture if paused with
1112
1117
  * `pausable: "resumeAll"`).
1113
- * 9. Recursive ERROR emission if equals threw mid-walk.
1114
- *
1115
- * `node.down` / `node.emit` / `actions.down` / `actions.emit` all
1116
- * converge here — the unified `_emit` waist (spec §1.3.1).
1118
+ * 8. Recursive ERROR emission if equals threw mid-walk.
1117
1119
  */
1118
1120
  _emit(messages: Messages): void;
1119
1121
  /**
@@ -559,7 +559,11 @@ declare function accessHintForGuard(guard: NodeGuard): string;
559
559
  * contract. See SESSION-foundation-redesign.md §§1–10 for design history.
560
560
  */
561
561
 
562
- /** Lifecycle status of a node (GRAPHREFLY-SPEC §2.2). */
562
+ /**
563
+ * Lifecycle status of a node.
564
+ *
565
+ * @see GRAPHREFLY-SPEC.md §2.2
566
+ */
563
567
  type NodeStatus = "sentinel" | "pending" | "dirty" | "settled" | "resolved" | "completed" | "errored";
564
568
  /** Callback that receives downstream message batches. */
565
569
  type NodeSink = (messages: Messages) => void;
@@ -1083,37 +1087,35 @@ declare class NodeImpl<T = unknown> implements Node<T> {
1083
1087
  private _frameBatch;
1084
1088
  /**
1085
1089
  * @internal The unified dispatch waist — one call = one wave.
1090
+ * See `GRAPHREFLY-SPEC.md` §1.3.1 for protocol context — the stages
1091
+ * below are the implementation order.
1086
1092
  *
1087
1093
  * Pipeline stages, in order:
1088
1094
  *
1089
- * 1. Early-return on empty batch.
1090
- * 2. Terminal filter — post-COMPLETE/ERROR only TEARDOWN/INVALIDATE
1095
+ * 1. Terminal filter — post-COMPLETE/ERROR only TEARDOWN/INVALIDATE
1091
1096
  * still propagate so graph teardown and cache-clear still work.
1092
- * 3. Tier sort (stable) — the batch can be in any order when it
1097
+ * 2. Tier sort (stable) — the batch can be in any order when it
1093
1098
  * arrives; the walker downstream (`downWithBatch`) assumes
1094
1099
  * ascending tier monotone, and so does `_updateState`'s tier-3
1095
1100
  * slice walk. This is the single source of truth for ordering.
1096
- * 4. Synthetic DIRTY prefix — if a tier-3 payload is present, no
1101
+ * 3. Synthetic DIRTY prefix — if a tier-3 payload is present, no
1097
1102
  * DIRTY is already in the batch, and the node isn't already in
1098
1103
  * `"dirty"` status, prepend `[DIRTY]` after any tier-0 START
1099
1104
  * entries. Guarantees spec §1.3.1 (DIRTY precedes DATA within
1100
1105
  * the same batch) uniformly across every entry point.
1101
- * 5. PAUSE/RESUME lock bookkeeping (C0) — update `_pauseLocks`,
1106
+ * 4. PAUSE/RESUME lock bookkeeping (C0) — update `_pauseLocks`,
1102
1107
  * derive `_paused`, filter unknown-lockId RESUME, replay
1103
1108
  * bufferAll buffer on final lock release.
1104
- * 6. Meta TEARDOWN fan-out — notify meta children before
1109
+ * 5. Meta TEARDOWN fan-out — notify meta children before
1105
1110
  * `_updateState`'s TEARDOWN branch calls `_deactivate`. Hoisted
1106
1111
  * out of the walk to keep `_updateState` re-entrance-free.
1107
- * 7. `_updateState` — walk the batch in tier order, advancing
1112
+ * 6. `_updateState` — walk the batch in tier order, advancing
1108
1113
  * `_cached` / `_status` / `_versioning` and running equals
1109
1114
  * substitution on tier-3 DATA (§3.5.1). Returns
1110
1115
  * `{finalMessages, equalsError?}`.
1111
- * 8. `downWithBatch` dispatch (or bufferAll capture if paused with
1116
+ * 7. `downWithBatch` dispatch (or bufferAll capture if paused with
1112
1117
  * `pausable: "resumeAll"`).
1113
- * 9. Recursive ERROR emission if equals threw mid-walk.
1114
- *
1115
- * `node.down` / `node.emit` / `actions.down` / `actions.emit` all
1116
- * converge here — the unified `_emit` waist (spec §1.3.1).
1118
+ * 8. Recursive ERROR emission if equals threw mid-walk.
1117
1119
  */
1118
1120
  _emit(messages: Messages): void;
1119
1121
  /**
@@ -1,5 +1,5 @@
1
1
  import { Observable } from 'rxjs';
2
- import { N as Node, t as Messages } from './node-C7PD3sn9.cjs';
2
+ import { N as Node, t as Messages } from './node-B-f-Lu-k.cjs';
3
3
 
4
4
  /** Options for {@link toObservable}. */
5
5
  type ToObservableOptions = {
@@ -1,5 +1,5 @@
1
1
  import { Observable } from 'rxjs';
2
- import { N as Node, t as Messages } from './node-C7PD3sn9.js';
2
+ import { N as Node, t as Messages } from './node-B-f-Lu-k.js';
3
3
 
4
4
  /** Options for {@link toObservable}. */
5
5
  type ToObservableOptions = {