@raphy-js/raph 1.0.1-dev.26 → 1.0.1-dev.54

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 (127) hide show
  1. package/README.md +100 -0
  2. package/dist/api/Raph.d.ts +15 -15
  3. package/dist/api/RaphFacadeSession.d.ts +4 -4
  4. package/dist/api/RaphReactivityInstance.d.ts +4 -4
  5. package/dist/api/types.d.ts +11 -11
  6. package/dist/compact.cjs +1 -0
  7. package/dist/compact.js +4 -0
  8. package/dist/debug/reactivity/engine-core.cjs +1 -0
  9. package/dist/debug/reactivity/engine-core.js +1760 -0
  10. package/dist/debug/reactivity/engine.cjs +1 -1
  11. package/dist/debug/reactivity/engine.js +25 -1689
  12. package/dist/debug/reactivity/reactive-object.cjs +1 -1
  13. package/dist/debug/reactivity/reactive-object.js +604 -167
  14. package/dist/debug/runtime/RaphCompactExecutionRuntime.cjs +1 -0
  15. package/dist/debug/runtime/RaphCompactExecutionRuntime.js +9 -0
  16. package/dist/debug/runtime/RaphExecutionRuntime.cjs +1 -0
  17. package/dist/debug/runtime/RaphExecutionRuntime.js +11 -0
  18. package/dist/debug/runtime/RaphRuntime.cjs +1 -1
  19. package/dist/debug/runtime/RaphRuntime.js +115 -1176
  20. package/dist/debug/runtime/RaphRuntimeBase.cjs +1 -0
  21. package/dist/debug/runtime/RaphRuntimeBase.js +941 -0
  22. package/dist/debug/runtime/diagnostics/RaphDebug.cjs +1 -1
  23. package/dist/debug/runtime/diagnostics/RaphDebug.js +72 -66
  24. package/dist/debug/runtime/ownership/RaphNode.cjs +1 -1
  25. package/dist/debug/runtime/ownership/RaphNode.js +11 -0
  26. package/dist/debug/runtime/ownership/RaphScope.cjs +1 -1
  27. package/dist/debug/runtime/ownership/RaphScope.js +12 -12
  28. package/dist/debug/runtime/phases/RaphPhasePipeline.cjs +1 -1
  29. package/dist/debug/runtime/phases/RaphPhasePipeline.js +361 -242
  30. package/dist/debug/runtime/phases/RaphPhaseTaskRecord.cjs +1 -1
  31. package/dist/debug/runtime/phases/RaphPhaseTaskRecord.js +23 -22
  32. package/dist/debug/runtime/reactivity/RaphSelector.cjs +1 -1
  33. package/dist/debug/runtime/reactivity/RaphSelector.js +111 -90
  34. package/dist/debug/runtime/reactivity/RuntimeObjectSupport.cjs +1 -0
  35. package/dist/debug/runtime/reactivity/RuntimeObjectSupport.js +11 -0
  36. package/dist/debug/runtime/reactivity/RuntimeReactivity.cjs +1 -1
  37. package/dist/debug/runtime/reactivity/RuntimeReactivity.js +118 -103
  38. package/dist/debug/runtime/reactivity/RuntimeSelectorSupport.cjs +1 -0
  39. package/dist/debug/runtime/reactivity/RuntimeSelectorSupport.js +12 -0
  40. package/dist/entrypoints/compact.d.ts +2 -0
  41. package/dist/entrypoints/execution.d.ts +2 -0
  42. package/dist/entrypoints/machine-testing.d.ts +2 -2
  43. package/dist/entrypoints/machine.d.ts +5 -5
  44. package/dist/entrypoints/observable.d.ts +4 -0
  45. package/dist/entrypoints/path.d.ts +14 -14
  46. package/dist/entrypoints/reactivity.d.ts +1 -1
  47. package/dist/entrypoints/runtime.d.ts +19 -18
  48. package/dist/execution.cjs +1 -0
  49. package/dist/execution.js +4 -0
  50. package/dist/index.cjs +1 -1
  51. package/dist/index.js +23 -21
  52. package/dist/machine/compiler.d.ts +1 -1
  53. package/dist/machine/core.d.ts +2 -2
  54. package/dist/machine/persistence.d.ts +1 -1
  55. package/dist/machine/runtime.d.ts +3 -3
  56. package/dist/machine/testing.d.ts +1 -1
  57. package/dist/machine/types.d.ts +3 -3
  58. package/dist/main.d.ts +19 -19
  59. package/dist/observable/buffer.d.ts +6 -0
  60. package/dist/observable/class-admin.d.ts +63 -0
  61. package/dist/observable/class-plan.d.ts +46 -0
  62. package/dist/observable/classes.d.ts +10 -0
  63. package/dist/observable/context.d.ts +73 -0
  64. package/dist/observable/native.d.ts +2 -0
  65. package/dist/observable/observable.d.ts +13 -0
  66. package/dist/observable/types.d.ts +60 -0
  67. package/dist/observable.cjs +1 -0
  68. package/dist/observable.js +1187 -0
  69. package/dist/path/DataPath.d.ts +2 -2
  70. package/dist/path/PathRouter.d.ts +1 -1
  71. package/dist/path/RaphKernel.d.ts +6 -6
  72. package/dist/path/data-path.types.d.ts +1 -1
  73. package/dist/path/data-path.utils.d.ts +2 -2
  74. package/dist/path/derived/DerivedRegistry.d.ts +3 -3
  75. package/dist/path/derived/RaphDerivedHandle.d.ts +3 -3
  76. package/dist/path/derived/derived-collection.types.d.ts +1 -1
  77. package/dist/path/derived/derived-collection.utils.d.ts +3 -3
  78. package/dist/path/derived/derived-strategy.utils.d.ts +1 -1
  79. package/dist/path/meta/MetaController.d.ts +5 -5
  80. package/dist/path/meta/RaphMeta.d.ts +3 -3
  81. package/dist/path/meta/RaphMetaStore.d.ts +1 -1
  82. package/dist/path/meta/meta.types.d.ts +2 -2
  83. package/dist/path/path.types.d.ts +2 -2
  84. package/dist/path/pathSegmentKey.d.ts +1 -1
  85. package/dist/path/storage/AdapterPathStore.d.ts +2 -2
  86. package/dist/path/storage/DefaultDataAdapter.d.ts +2 -2
  87. package/dist/path/storage/PathEventHub.d.ts +1 -1
  88. package/dist/path/storage/PathStore.d.ts +2 -2
  89. package/dist/path/storage/data-adapter.types.d.ts +1 -1
  90. package/dist/raph.cjs +1 -1
  91. package/dist/raph.js +23 -21
  92. package/dist/reactivity/engine-core.d.ts +600 -0
  93. package/dist/reactivity/engine.d.ts +6 -550
  94. package/dist/reactivity/reactive-object.d.ts +143 -2
  95. package/dist/reactivity/scope.d.ts +7 -6
  96. package/dist/reactivity/types.d.ts +9 -12
  97. package/dist/reactivity/watch.d.ts +1 -1
  98. package/dist/runtime/RaphCompactExecutionRuntime.d.ts +7 -0
  99. package/dist/runtime/RaphExecutionRuntime.d.ts +6 -0
  100. package/dist/runtime/RaphRuntime.d.ts +19 -403
  101. package/dist/runtime/RaphRuntimeBase.d.ts +194 -0
  102. package/dist/runtime/diagnostics/RaphDebug.d.ts +8 -5
  103. package/dist/runtime/errors.d.ts +1 -1
  104. package/dist/runtime/ownership/RaphEffectScope.d.ts +13 -12
  105. package/dist/runtime/ownership/RaphNode.d.ts +28 -21
  106. package/dist/runtime/ownership/RaphScope.d.ts +32 -19
  107. package/dist/runtime/ownership/parent-graph.types.d.ts +1 -1
  108. package/dist/runtime/ownership/parentGraph.d.ts +2 -2
  109. package/dist/runtime/phases/RaphFrameLoop.d.ts +1 -1
  110. package/dist/runtime/phases/RaphPhasePipeline.d.ts +80 -29
  111. package/dist/runtime/phases/RaphPhaseTaskRecord.d.ts +21 -21
  112. package/dist/runtime/phases/RaphPhaseWatch.d.ts +3 -3
  113. package/dist/runtime/phases/orderPhaseTasks.d.ts +4 -2
  114. package/dist/runtime/phases/phase.types.d.ts +36 -35
  115. package/dist/runtime/reactivity/PathHandle.d.ts +5 -5
  116. package/dist/runtime/reactivity/RaphMetaSource.d.ts +7 -7
  117. package/dist/runtime/reactivity/RaphSelector.d.ts +27 -6
  118. package/dist/runtime/reactivity/RaphWorkGraph.d.ts +40 -39
  119. package/dist/runtime/reactivity/RuntimeObjectSupport.d.ts +9 -0
  120. package/dist/runtime/reactivity/RuntimeReactivity.d.ts +27 -19
  121. package/dist/runtime/reactivity/RuntimeSelectorSupport.d.ts +10 -0
  122. package/dist/runtime/reactivity/RuntimeWatch.d.ts +1 -1
  123. package/dist/runtime/reactivity/disposal-sweep.utils.d.ts +1 -1
  124. package/dist/runtime/reactivity/runtime-reactivity.types.d.ts +3 -3
  125. package/dist/runtime.cjs +1 -1
  126. package/dist/runtime.js +13 -11
  127. package/package.json +22 -62
@@ -1,1700 +1,36 @@
1
- import { reactiveObject as O } from "./reactive-object.js";
2
- import { appendScopeChild as W, ScopeNode as U, throwScopeErrors as V, detachScopeChild as q } from "./scope.js";
3
- import { watchWithReactivity as z } from "./watch.js";
4
- const g = 1, f = 2, D = 4, p = 8, _ = 16, d = 32, v = 64, x = 128, k = 256, o = 512, L = 2048, E = 4096, m = 8192, R = L | E, T = 1e4, b = g | f, I = 16, F = 2;
5
- function A(c) {
6
- c.dependencyLookupDebt === void 0 && c.dependencyIndex === void 0 || (c.dependencyIndex = void 0, c.dependencyLookupDebt = void 0, c.dependencyLookupSearches = void 0);
7
- }
8
- function H(c, e) {
9
- if (e <= I || c.flags & x || c.dependencyIndex !== void 0)
10
- return;
11
- const t = (c.dependencyLookupSearches ?? 0) + 1, i = (c.dependencyLookupDebt ?? 0) + e;
12
- if (c.dependencyLookupSearches = t, c.dependencyLookupDebt = i, t < F || i < c.depCount)
13
- return;
14
- const s = /* @__PURE__ */ new Map();
15
- for (let n = c.firstDep; n !== null; n = n.nextDep)
16
- s.set(n.dep, n);
17
- c.dependencyIndex = s, c.dependencyLookupDebt = void 0, c.dependencyLookupSearches = void 0;
18
- }
19
- function Q(c, e, t) {
20
- const i = c.firstSub;
21
- if (i === null)
22
- return;
23
- if (i === c.lastSub)
24
- return i.sub === e ? i : void 0;
25
- const s = c.subSearchCursor ?? i;
26
- let n = 1;
27
- if (s.sub === e)
28
- return c.subSearchCursor = s.nextSub ?? i, s;
29
- if (t) {
30
- const a = e.dependencyIndex?.get(c);
31
- if (a !== void 0)
32
- return c.subSearchCursor = a.nextSub ?? i, a;
33
- if (e.dependencyIndex !== void 0)
34
- return;
35
- }
36
- let r = s.nextSub ?? i;
37
- for (; r !== s; ) {
38
- if (++n, r.sub === e)
39
- return c.subSearchCursor = r.nextSub ?? i, t && H(e, n), r;
40
- r = r.nextSub ?? i;
41
- }
42
- t && H(e, n);
43
- }
44
- class N {
45
- // Opt-in стратегия длинного slow path; не добавляет policy field каждой ноде.
46
- adaptiveDependencyIndex;
47
- // Потребитель текущего синхронного чтения; null отключает отслеживание.
48
- activeSub = null;
49
- // Глубина вложенных синхронных границ группировки.
50
- batchDepth = 0;
51
- // Индекс следующего элемента внутренней очереди эффектов.
52
- effectReadIndex = 0;
53
- // Позиция добавления элемента в текущем проходе очереди.
54
- effectWriteIndex = 0;
55
- // Граница активного префикса переиспользуемого стека invalidation.
56
- invalidationDepth = 0;
57
- // Граница активного префикса стека проверки зависимостей.
58
- dependencyDepth = 0;
59
- // Только активная проверка зависимостей требует дополнительной отметки записей.
60
- checkingDepth = 0;
61
- // Защита внутренней очереди от вложенного повторного прохода.
62
- flushingEffects = !1;
63
- // Переиспользуемый буфер очереди; прочитанная ячейка сразу освобождает ссылку.
64
- effectQueue = new Array(16).fill(void 0);
65
- // Переиспользуемый стек распространения invalidation; исходный способ выделения сохранён.
66
- invalidationStack = new Array(512).fill(null);
67
- // Переиспользуемый стек проверки зависимостей с защитой активного вложенного префикса.
68
- dependencyStack = [];
69
- // Общие адаптеры receiver для handles этого экземпляра.
70
- // Создаются один раз, чтобы computed не хранил дополнительную ссылку на движок
71
- // и не выделял отдельные get/peek closures на каждый источник.
72
- handleReaders = this.createHandleReaders();
73
- // Выбранная внешняя политика; у синхронного экземпляра отсутствует.
74
- effectScheduler;
75
- // Прямой обработчик очереди, выбранный один раз при создании экземпляра.
76
- flushEffects;
77
- /**
78
- * Синхронная регистрация эффекта для Runtime и watch независимо от внешней политики.
79
- * Это связанная ссылка на реализацию effect(), а не делегирующая функция.
80
- * @internal
81
- */
82
- _effectImmediate;
83
- /**
84
- * Выбирает политику исполнения и сохраняет совместимость извлечённых методов.
85
- * Тела методов находятся на прототипе; bind() выполняется только при создании
86
- * экземпляра, чтобы Runtime и глобальный API могли передавать методы как callbacks.
87
- * @param options Необязательная внешняя политика эффектов.
88
- */
89
- constructor(e = {}) {
90
- this.adaptiveDependencyIndex = e.adaptiveDependencyIndex ?? !1, this.effectScheduler = e.effectScheduler, this._effectImmediate = this.effect.bind(this), this.signal = this.signal.bind(this), this.computed = this.computed.bind(this), this.reactive = this.reactive.bind(this), this.watch = this.watch.bind(this), this.batch = this.batch.bind(this), this.untracked = this.untracked.bind(this), this.scope = this.scope.bind(this), this._signalAccess = this._signalAccess.bind(this), this._computedAccess = this._computedAccess.bind(this), this._ownedSignal = this._ownedSignal.bind(this), this._ownedComputed = this._ownedComputed.bind(this), this._isTracking = this._isTracking.bind(this), this._isFlushingEffects = this._isFlushingEffects.bind(this), this._startBatch = this._startBatch.bind(this), this._endBatch = this._endBatch.bind(this), this.effect = this.effectScheduler === void 0 ? this._effectImmediate : this.createScheduledEffect.bind(this), this.flushEffects = this.effectScheduler === void 0 ? this.flushSyncEffects : this.flushExternalEffects;
91
- }
92
- // ---------------------------------------------
93
- // PUBLIC API
94
- // ---------------------------------------------
95
- /**
96
- * Создаёт объектный signal с get/peek/set.
97
- * get() регистрирует зависимость только при активном потребителе,
98
- * а peek() выполняет чтение с временно отключённым отслеживанием.
99
- */
100
- signal(e) {
101
- let t = e, i;
102
- const s = () => {
103
- const r = i;
104
- if (r !== void 0)
105
- return this.readSignalValue(r);
106
- const a = this.activeSub;
107
- return a === null || (i = this.materializeSignal(
108
- t,
109
- a
110
- )), t;
111
- }, n = (r) => {
112
- const a = i;
113
- if (a !== void 0) {
114
- this.writeSignalValue(a, r);
115
- return;
116
- }
117
- t !== r && (t = r);
118
- };
119
- return {
120
- get: s,
121
- peek: this.handleReaders.peek,
122
- set: n
123
- };
1
+ import { ReactivityEngine as r } from "./engine-core.js";
2
+ import { reactiveObject as i } from "./reactive-object.js";
3
+ import { ScopeNode as b } from "./scope.js";
4
+ class a extends r {
5
+ constructor(c = {}) {
6
+ super(c), this.reactive = this.reactive.bind(this);
124
7
  }
125
8
  /**
126
9
  * Возвращает стабильный глубокий Proxy для plain object или array.
127
10
  * Object context и per-property sources создаются лениво внутри этого engine.
128
11
  */
129
- reactive(e) {
130
- return O(this, e, () => this.createReactivePropertySourceBridge());
131
- }
132
- computed(e) {
133
- if (typeof e == "function")
134
- return this.createComputedHandle(e);
135
- const t = this.createComputedHandle(e.get);
136
- return t.set = e.set, t;
137
- }
138
- /**
139
- * Создаёт эффект согласно политике экземпляра и возвращает disposer.
140
- * Прототип содержит синхронную реализацию; при наличии scheduler конструктор
141
- * подставляет createScheduledEffect, сохраняя этот путь как _effectImmediate.
142
- * Вложенный эффект включается в список ресурсов активного эффекта.
143
- * При ошибке регистрации удаляет созданные ресурсы, сохраняя обе причины сбоя.
144
- * @param fn Синхронное тело с необязательным cleanup очередного запуска.
145
- * @param onStop Однократная окончательная очистка, независимая от повторных запусков.
146
- */
147
- effect(e, t) {
148
- const i = this.allocateGraphRecord(void 0, e, f | g | d);
149
- t !== void 0 && (i.onStop = t);
150
- const s = this.activeSub;
151
- s !== null && s.flags & d && W(s, i);
152
- try {
153
- this.executeEffect(i);
154
- } catch (n) {
155
- try {
156
- this.disposeEffect(i);
157
- } catch (r) {
158
- throw new AggregateError([n, r], "Effect registration and cleanup failed.");
159
- }
160
- throw n;
161
- }
162
- return this.effectReadIndex !== this.effectWriteIndex && this.flushEffects(), () => this.disposeEffect(i);
163
- }
164
- /**
165
- * Наблюдает за источниками; callback и cleanup не создают зависимостей.
166
- */
167
- watch(e, t, i) {
168
- return z(this.effect, this.untracked, e, t, i);
169
- }
170
- /**
171
- * Группирует синхронные записи и обрабатывает эффекты после внешней границы.
172
- * Возвращает результат операции. Если тело и очередь завершаются с ошибками,
173
- * передаёт обе ошибки в AggregateError вместо потери первой. Не является откатом данных.
174
- */
175
- batch(e) {
176
- ++this.batchDepth;
177
- let t;
178
- try {
179
- t = e();
180
- } catch (i) {
181
- if (!--this.batchDepth && this.effectReadIndex !== this.effectWriteIndex)
182
- try {
183
- this.flushEffects();
184
- } catch (s) {
185
- throw new AggregateError(
186
- [i, s],
187
- "Batch operation and effect queue processing failed."
188
- );
189
- }
190
- throw i;
191
- }
192
- return !--this.batchDepth && this.effectReadIndex !== this.effectWriteIndex && this.flushEffects(), t;
193
- }
194
- /**
195
- * Выполняет синхронную операцию без добавления зависимостей текущему потребителю.
196
- * Восстанавливает прежний контекст и при исключении. Асинхронное продолжение
197
- * операции этим контекстом не охватывается.
198
- */
199
- untracked(e) {
200
- if (this.activeSub === null)
201
- return e();
202
- const t = this.activeSub;
203
- this.activeSub = null;
204
- try {
205
- return e();
206
- } finally {
207
- this.activeSub = t;
208
- }
209
- }
210
- /**
211
- * Создаёт владельца ресурсов в текущем графе без Runtime и фаз.
212
- */
213
- scope() {
214
- return new U(this);
215
- }
216
- // ---------------------------------------------
217
- // PRIVATE
218
- // ---------------------------------------------
219
- /**
220
- * Создаёт запись графа с одинаковым порядком основных полей.
221
- * Значение служит кешем signal/computed либо хранит cleanup эффекта.
222
- * Поля внешней задачи и окончательной очистки добавляются только при необходимости.
223
- */
224
- allocateGraphRecord(e, t, i) {
225
- return {
226
- flags: i,
227
- firstSub: null,
228
- lastSub: null,
229
- firstDep: null,
230
- tailDep: null,
231
- depCount: 0,
232
- evaluate: t,
233
- cachedValue: e
234
- };
235
- }
236
- /** Creates a narrow Proxy adapter over the existing intrusive graph. */
237
- createReactivePropertySourceBridge() {
238
- return {
239
- batch: this.batch,
240
- create: () => {
241
- if (this.activeSub === null)
242
- throw new Error("[Raph] Reactive property source requires a tracked read.");
243
- return { firstSub: null, lastSub: null };
244
- },
245
- isTracking: this._isTracking,
246
- track: (e) => {
247
- const t = this.activeSub;
248
- t !== null && this.trackDependency(e, t);
249
- },
250
- trigger: (e) => {
251
- const t = e.firstSub;
252
- t !== null && (this.propagateInvalidation(t), !this.batchDepth && this.effectReadIndex !== this.effectWriteIndex && this.flushEffects());
253
- }
254
- };
255
- }
256
- /**
257
- * Материализует signal в графе при первом отслеживаемом чтении
258
- * и связывает его с активным потребителем.
259
- *
260
- * До этого момента signal может хранить значение только в замыкании
261
- * и вообще не создавать `ReactiveNode`.
262
- */
263
- materializeSignal(e, t, i) {
264
- const s = this.allocateGraphRecord(
265
- e,
266
- void 0,
267
- 0
268
- );
269
- return i !== void 0 && (s.sourceHooks = i, s.flags |= o), t.flags & x ? this.appendInitialDependency(s, t) : this.trackDependency(s, t), s;
270
- }
271
- /**
272
- * Создаёт минимальный handle computed без преждевременного выделения полей графа.
273
- * Первый get() материализует запись на этом же объекте и заменяет метод чтения.
274
- */
275
- createComputedHandle(e, t) {
276
- const i = {
277
- evaluate: e,
278
- get: this.handleReaders.initializeComputed,
279
- peek: this.handleReaders.peek
280
- };
281
- return t !== void 0 && (i.sourceHooks = t), i;
282
- }
283
- /**
284
- * Создаёт эффект с одной постоянной задачей внешнего scheduler.
285
- * Первый и последующие запуски проходят через задачу; устаревший runner после stop
286
- * ничего не выполняет. При синхронной ошибке runner обрабатывает независимую очередь.
287
- * @param fn Тело эффекта.
288
- * @param onStop Однократная окончательная очистка.
289
- */
290
- createScheduledEffect(e, t) {
291
- const i = this.allocateGraphRecord(void 0, e, f | g | d);
292
- let s = !1;
293
- t !== void 0 && (i.onStop = t);
294
- const n = this.activeSub;
295
- n !== null && n.flags & d && W(n, i);
296
- const r = () => {
297
- if (!(!(i.flags & v) || i.evaluate === void 0)) {
298
- i.flags &= ~v, s = !0;
299
- try {
300
- this.executeEffect(i);
301
- } catch (a) {
302
- if (!this.batchDepth && this.effectReadIndex !== this.effectWriteIndex)
303
- try {
304
- this.flushEffects();
305
- } catch (l) {
306
- throw new AggregateError(
307
- [a, l],
308
- "Effect execution and queue processing failed."
309
- );
310
- }
311
- throw a;
312
- }
313
- !this.batchDepth && this.effectReadIndex !== this.effectWriteIndex && this.flushEffects();
314
- }
315
- };
316
- try {
317
- const a = this.effectScheduler.bind(r);
318
- a.cancelPending = () => i.evaluate === void 0 || !s ? !1 : (this.settleCancelledDependencies(i), i.flags &= ~(v | b | D), !this.batchDepth && this.effectReadIndex !== this.effectWriteIndex && this.flushEffects(), !0), a.rearmPending = () => {
319
- i.evaluate !== void 0 && (i.flags |= f | v, a.schedule());
320
- }, i.effectTask = a, this.requestEffectTask(i);
321
- } catch (a) {
322
- try {
323
- this.disposeEffect(i);
324
- } catch (l) {
325
- throw new AggregateError([a, l], "Effect registration and cleanup failed.");
326
- }
327
- throw a;
328
- }
329
- return !this.batchDepth && this.effectReadIndex !== this.effectWriteIndex && this.flushEffects(), () => this.disposeEffect(i);
330
- }
331
- /**
332
- * Регистрирует чтение signal и при необходимости фиксирует pending-значение.
333
- * Текущая связь передаётся фиксации, чтобы не уведомлять читающего потребителя повторно.
334
- */
335
- readSignalValue(e) {
336
- const t = this.activeSub;
337
- let i = null;
338
- return t !== null && (i = this.trackDependency(e, t)), e.flags & f && this.commitSignalValue(e, i), e.cachedValue;
339
- }
340
- /**
341
- * Записывает новое значение или откладывает его фиксацию до чтения в batch.
342
- * Сохраняет исходное сравнение через === и учёт автора pending-записи.
343
- * Без batch и внешней политики очередь эффектов завершается до возврата из set().
344
- */
345
- writeSignalValue(e, t) {
346
- if (e.flags & f || this.batchDepth) {
347
- const s = !!(e.flags & f);
348
- if ((e.flags & f ? e.pendingValue : e.cachedValue) === t)
349
- return;
350
- if (e.pendingValue = t, e.cachedValue === t)
351
- e.flags &= ~f, e.pendingAuthor = void 0;
352
- else {
353
- e.flags |= f;
354
- const a = this.activeSub !== null && this.activeSub.flags & p ? this.activeSub : null;
355
- s ? e.pendingAuthor !== a && (e.pendingAuthor = null) : e.pendingAuthor = a;
356
- }
357
- const r = e.firstSub;
358
- r != null && (!s || this.activeSub !== null && this.activeSub.flags & p || e.flags & o) && this.propagateInvalidation(r, !0);
359
- return;
360
- }
361
- if (e.cachedValue === t)
362
- return;
363
- e.cachedValue = t;
364
- const i = e.firstSub;
365
- i != null && (this.propagateInvalidation(i), !this.batchDepth && this.effectReadIndex !== this.effectWriteIndex && this.flushEffects());
366
- }
367
- /**
368
- * Возвращает кеш либо синхронно актуализирует вычисляемое значение.
369
- * Неуспешное вычисление не считается значением. Ошибка getter сохраняет связь
370
- * с активным потребителем для восстановления. Повторное чтение во время
371
- * первого сбора зависимостей отклоняется до регистрации связи и чтения кеша.
372
- */
373
- readComputedValue(e) {
374
- const t = e.flags;
375
- if ((t & (p | x)) === (p | x))
376
- throw new Error("Computed value is already being evaluated.");
377
- const i = t & (_ | b | k), s = i === 0 ? e.cachedValue : i & _ ? this.evaluateFirstValue(e) : this.refreshComputedValue(e, t);
378
- if (e.evaluate === void 0)
379
- return s;
380
- const n = this.activeSub;
381
- if (n !== null) {
382
- const r = n.tailDep;
383
- n.flags & x ? (r === null || r.dep !== e) && this.appendInitialDependency(e, n) : this.trackDependency(e, n);
384
- }
385
- return s;
386
- }
387
- /**
388
- * Выполняет первый сбор зависимостей и кеширует только успешный результат.
389
- * При исключении оставляет состояние повторяемой ошибки, а не чистый undefined.
390
- * Уже прочитанные зависимости сохраняются для последующего уведомления.
391
- */
392
- evaluateFirstValue(e) {
393
- const t = e.flags & o, i = e.evaluate;
394
- e.flags = t | p | x;
395
- const s = this.activeSub;
396
- this.activeSub = e;
397
- let n;
398
- try {
399
- if (n = i(), e.evaluate !== i)
400
- return e.cachedValue = void 0, e.flags = 0, n;
401
- e.flags = t | (e.flags & D ? f : 0);
402
- } catch (r) {
403
- throw e.evaluate !== i ? (e.cachedValue = void 0, e.flags = 0, r) : (e.flags = t | k, s !== null && this.trackDependency(e, s), r);
404
- } finally {
405
- this.activeSub = s;
406
- }
407
- return e.flags & f ? this.refreshComputedValue(e, e.flags) : (e.cachedValue = n, n);
408
- }
409
- /**
410
- * Актуализирует computed: выполняет прямой пересчёт либо проверяет зависимости.
411
- * После ошибки getter разрешён повторный пересчёт даже без новой записи источника.
412
- */
413
- refreshComputedValue(e, t, i = null) {
414
- try {
415
- if (t & (f | D | k))
416
- return this.recomputeValue(e, i), e.cachedValue;
417
- const s = e.firstDep;
418
- return s !== null && this.refreshDependencies(e, s) ? this.recomputeValue(e, i) : e.flags &= ~b, e.cachedValue;
419
- } catch (s) {
420
- throw this.activeSub !== null && this.trackDependency(e, this.activeSub), s;
421
- }
422
- }
423
- /**
424
- * Фиксирует pending-значение и уведомляет непосредственных потребителей.
425
- * Пропускает указанную связь и автора записи, чтобы не дублировать текущую работу.
426
- * @returns Изменилось ли зафиксированное значение.
427
- */
428
- commitSignalValue(e, t) {
429
- const i = e.cachedValue;
430
- e.cachedValue = e.pendingValue, e.flags &= ~f;
431
- const s = e.pendingAuthor;
432
- return e.pendingAuthor = void 0, i === e.cachedValue ? !1 : (e.firstSub !== null && this.confirmSubUpdates(e.firstSub, t, s ?? null), !0);
433
- }
434
- /**
435
- * Обрабатывает чтение производителя активным потребителем.
436
- * Сначала проверяет текущую и следующую связи; более дорогой поиск вынесен отдельно.
437
- */
438
- trackDependency(e, t) {
439
- const i = t.tailDep;
440
- if (i !== null) {
441
- const n = i.nextDep;
442
- return n !== null && n.dep === e ? (t.tailDep = n, n) : i.dep === e ? i : this.reconcileDependency(e, t, i, n);
443
- }
444
- const s = t.firstDep;
445
- return s === null ? t.tailDep = this.insertDependency(e, t, null) : s.dep === e ? (t.tailDep = s, s) : this.reconcileDependency(e, t, null, s);
446
- }
447
- /**
448
- * Согласует чтение с существующим списком зависимостей при несовпадении порядка.
449
- * Использует ограниченный линейный поиск, затем поиск среди потребителей производителя.
450
- * Существующую связь перемещает или переиспользует; новую создаёт только при необходимости.
451
- */
452
- reconcileDependency(e, t, i, s) {
453
- if (t.depCount <= I) {
454
- for (let l = s; l !== null; l = l.nextDep)
455
- if (l.dep === e)
456
- return this.reorderDependency(t, l, i), t.tailDep = l, l;
457
- for (let l = i; l !== null; l = l.prevDep)
458
- if (l.dep === e)
459
- return l;
460
- return s !== null ? (t.tailDep = this.reuseDepLink(s, e), s) : t.tailDep = this.insertDependency(e, t, i);
461
- }
462
- let n = 0, r = s;
463
- for (; r !== null && n < I; ) {
464
- const l = r;
465
- if (l.dep === e)
466
- return this.reorderDependency(t, l, i), t.tailDep = l, l;
467
- r = l.nextDep, ++n;
468
- }
469
- let a = i;
470
- for (; a !== null && n < I; ) {
471
- const l = a;
472
- if (l.dep === e)
473
- return l;
474
- a = l.prevDep, ++n;
475
- }
476
- if (r !== null || a !== null) {
477
- const l = Q(e, t, this.adaptiveDependencyIndex);
478
- if (l !== void 0)
479
- return this.reorderDependency(t, l, i), t.tailDep = l, l;
480
- }
481
- return s !== null ? (t.tailDep = this.reuseDepLink(s, e), s) : t.tailDep = this.insertDependency(e, t, i);
482
- }
483
- /**
484
- * Добавляет связь при первоначальном сборе зависимостей.
485
- * Предусловие: after является хвостом собранного префикса нового списка.
486
- * Связь одновременно включается в список потребителей производителя.
487
- */
488
- appendInitialDependency(e, t) {
489
- const i = t.tailDep, s = e.lastSub, n = {
490
- dep: e,
491
- sub: t,
492
- prevSub: s,
493
- nextSub: null,
494
- prevDep: i,
495
- nextDep: null
496
- };
497
- return s === null ? e.firstSub = n : s.nextSub = n, e.lastSub = n, i === null ? t.firstDep = n : i.nextDep = n, t.tailDep = n, ++t.depCount, t.dependencyIndex?.set(e, n), e.flags & o && this.attachDependencyCleanup(n), n;
498
- }
499
- /**
500
- * Вставляет связь после заданного курсора зависимостей потребителя.
501
- * Сохраняет ещё не прочитанный хвост списка и увеличивает dependencyCount.
502
- */
503
- insertDependency(e, t, i) {
504
- const s = e.lastSub, n = {
505
- dep: e,
506
- sub: t,
507
- prevSub: s,
508
- nextSub: null,
509
- prevDep: i,
510
- nextDep: null
511
- };
512
- s === null ? e.firstSub = n : s.nextSub = n, e.lastSub = n;
513
- const r = i === null ? t.firstDep : i.nextDep;
514
- return n.nextDep = r, r !== null && (r.prevDep = n), i === null ? t.firstDep = n : i.nextDep = n, ++t.depCount, t.dependencyIndex?.set(e, n), e.flags & o && this.attachDependencyCleanup(n), n;
515
- }
516
- /**
517
- * Переназначает существующую связь другому производителю.
518
- * Положение в списке зависимостей потребителя и число его связей сохраняются.
519
- */
520
- reuseDepLink(e, t) {
521
- const i = e.sub.dependencyIndex;
522
- this.detachSubLink(e);
523
- const s = t.lastSub;
524
- return e.dep = t, e.prevSub = s, e.nextSub = null, s === null ? t.firstSub = e : s.nextSub = e, t.lastSub = e, i?.set(t, e), t.flags & o && this.attachDependencyCleanup(e), e;
525
- }
526
- /**
527
- * Перемещает существующую зависимость после курсора текущего чтения.
528
- * Список потребителей производителя и количество зависимостей не изменяет.
529
- */
530
- reorderDependency(e, t, i) {
531
- if (t.prevDep === i)
532
- return;
533
- const s = t.prevDep, n = t.nextDep;
534
- s === null ? e.firstDep = n : s.nextDep = n, n !== null && (n.prevDep = s);
535
- const r = i === null ? e.firstDep : i.nextDep;
536
- t.prevDep = i, t.nextDep = r, r !== null && (r.prevDep = t), i === null ? e.firstDep = t : i.nextDep = t;
537
- }
538
- /**
539
- * Удаляет непрочитанный хвост зависимостей завершившегося запуска.
540
- * trackedTail обозначает границу прочитанного префикса, а не неизменный конец списка.
541
- * Ошибка cleanup не прерывает освобождение оставшегося хвоста зависимостей.
542
- */
543
- pruneUnreadDependencies(e) {
544
- const t = e.tailDep;
545
- let i = t === null ? e.firstDep : t.nextDep;
546
- if (i === null)
547
- return;
548
- t === null ? e.firstDep = null : t.nextDep = null;
549
- for (let n = i; n !== null; n = n.nextDep)
550
- n.prevDep = null, --e.depCount;
551
- e.depCount <= I && A(e);
552
- let s;
553
- for (; i !== null; ) {
554
- const n = i.nextDep;
555
- try {
556
- this.detachSubLink(i, !0);
557
- } catch (r) {
558
- this.unlinkSubLink(i, !0), s ??= [], s.push(r);
559
- }
560
- i = n;
561
- }
562
- s !== void 0 && V(s, "Dependency cleanup failed.");
563
- }
564
- /**
565
- * Удаляет связь только из списка потребителей производителя.
566
- * Список зависимостей потребителя и его счётчик здесь не изменяются.
567
- * Также исправляет курсор поиска, если он указывал на удаляемую связь.
568
- */
569
- detachSubLink(e, t = !1) {
570
- e.sub.dependencyIndex?.delete(e.dep);
571
- let i;
572
- e.dep.flags & o && (i = e.dependencyCleanup, e.dependencyCleanup = void 0, i?.()), this.unlinkSubLink(e, t || i !== void 0);
573
- }
574
- /** Завершает удаление producer-связи без вызова source cleanup. */
575
- unlinkSubLink(e, t) {
576
- t && ((e.prevSub === null ? e.dep.firstSub !== e : e.prevSub.nextSub !== e) || (e.nextSub === null ? e.dep.lastSub !== e : e.nextSub.prevSub !== e)) || (e.dep.subSearchCursor === e && (e.dep.subSearchCursor = e.nextSub ?? (e.dep.firstSub === e ? void 0 : e.dep.firstSub ?? void 0)), e.prevSub === null ? e.dep.firstSub = e.nextSub : e.prevSub.nextSub = e.nextSub, e.nextSub === null ? e.dep.lastSub = e.prevSub : e.nextSub.prevSub = e.prevSub);
577
- }
578
- /** Connects Runtime ownership metadata only for edges whose producer opted in. */
579
- attachDependencyCleanup(e) {
580
- const i = e.dep.sourceHooks?.onDependency;
581
- if (i === void 0)
582
- return;
583
- const s = e.sub.sourceHooks?.dependencyOwner ?? e.sub.effectTask?.dependencyOwner;
584
- s !== void 0 && (e.dependencyCleanup = i(s));
585
- }
586
- /**
587
- * Отсоединяет owned-источник сразу с обеих сторон каждой связи.
588
- * Вызывается на границе lifetime, а не при обычных чтениях и записях.
589
- * Переводит ожидавших проверку потребителей к повторному вычислению при необходимости.
590
- */
591
- releaseSourceSubs(e) {
592
- if (!(e.flags & o)) {
593
- let s = e.firstSub;
594
- for (; s != null; ) {
595
- const n = s.nextSub, r = s.sub;
596
- this.detachDependencyLink(s), this.detachSubLink(s);
597
- const a = r.flags;
598
- (a & (b | p)) === g && (r.flags = a & ~g | f, a & d && this.enqueueEffect(r, e)), s = n;
599
- }
600
- e.firstSub = e.lastSub = null, e.subSearchCursor = void 0;
601
- return;
602
- }
603
- let t = e.firstSub, i;
604
- for (; t != null; ) {
605
- const s = t.nextSub;
606
- this.detachDependencyLink(t);
607
- try {
608
- this.detachSubLink(t, !0);
609
- } catch (n) {
610
- this.unlinkSubLink(t, !0), i ??= [], i.push(n);
611
- }
612
- t = s;
613
- }
614
- e.firstSub = e.lastSub = null, e.subSearchCursor = void 0, i !== void 0 && V(i, "Source dependency cleanup failed.");
615
- }
616
- /**
617
- * Удаляет связь только из списка зависимостей потребителя.
618
- * Исправляет курсор прочитанного префикса и dependencyCount; список производителя
619
- * должен быть обновлён отдельной операцией.
620
- */
621
- detachDependencyLink(e) {
622
- const t = e.sub, i = e.prevDep, s = e.nextDep;
623
- (i === null ? t.firstDep !== e : i.nextDep !== e) || (i === null ? t.firstDep = s : i.nextDep = s, s !== null && (s.prevDep = i), t.tailDep === e && (t.tailDep = i), --t.depCount, t.depCount <= I && A(t));
624
- }
625
- /**
626
- * Добавляет эффект во внутреннюю очередь один раз до обработки текущей записи.
627
- * Флаг SCHEDULED предотвращает повторное добавление без создания task-объекта.
628
- */
629
- enqueueEffect(e, t) {
630
- const i = t !== void 0 && t.flags & o ? t.sourceHooks.token : void 0;
631
- i !== void 0 && e.effectTask?.notify?.(i), !(e.flags & v) && (e.flags |= v, this.effectQueue[this.effectWriteIndex] = e, ++this.effectWriteIndex);
632
- }
633
- /**
634
- * Распространяет invalidation от непосредственных к транзитивным потребителям.
635
- * Сохраняет исходный итеративный обход с переиспользуемым стеком; callbacks
636
- * не выполняет. Непосредственное и потенциальное изменения отмечает разными флагами.
637
- */
638
- propagateInvalidation(e, t = !1) {
639
- this.checkingDepth !== 0 && this.markActiveChecks(e);
640
- const i = this.invalidationDepth;
641
- let s = i;
642
- for (let n = e; n !== null; n = n.nextSub) {
643
- const r = n.sub, a = r.flags;
644
- let l = 0;
645
- if (a & (b | p) ? a & p ? l = this.invalidateReadDependency(n, r, a) : !t && !(a & f) && (r.flags = a & ~g | f) : (l = a & ~D | (t ? g : f), r.flags = l), l === 0) {
646
- if (a & d && a & v) {
647
- const u = n.dep.flags & o ? n.dep.sourceHooks.token : void 0;
648
- u !== void 0 && r.effectTask?.notify?.(u);
649
- } else r.flags & (o | m) && (r.flags & o && r.sourceHooks.onInvalidate?.(r.firstSub !== null), r.flags &= ~m, r.firstSub !== null && (this.invalidationStack[s++] = r.firstSub));
650
- continue;
651
- }
652
- l & d ? (!(l & p) || r.effectTask?.allowScheduleDuringRun === !0) && this.enqueueEffect(r, n.dep) : (!(a & b) && r.flags & o && r.sourceHooks.onInvalidate?.(r.firstSub !== null), r.firstSub !== null && (this.invalidationStack[s++] = r.firstSub));
653
- }
654
- for (; s !== i; ) {
655
- let n = this.invalidationStack[--s];
656
- do {
657
- const r = n.sub, a = r.flags;
658
- let l = 0;
659
- if (a & (b | p) ? a & p && (l = this.invalidateReadDependency(n, r, a)) : (l = a & ~D | g, r.flags = l), l === 0) {
660
- if (a & d && a & v) {
661
- const u = n.dep.flags & o ? n.dep.sourceHooks.token : void 0;
662
- u !== void 0 && r.effectTask?.notify?.(u);
663
- } else if (r.flags & (o | m) && (r.flags & o && r.sourceHooks.onInvalidate?.(r.firstSub !== null), r.flags &= ~m, r.firstSub !== null)) {
664
- n.nextSub !== null && (this.invalidationStack[s++] = n.nextSub), n = r.firstSub;
665
- continue;
666
- }
667
- } else if (l & d)
668
- this.enqueueEffect(r, n.dep);
669
- else if (!(a & b) && r.flags & o && r.sourceHooks.onInvalidate?.(r.firstSub !== null), r.firstSub !== null) {
670
- n.nextSub !== null && (this.invalidationStack[s++] = n.nextSub), n = r.firstSub;
671
- continue;
672
- }
673
- n = n.nextSub;
674
- } while (n !== null);
675
- }
676
- this.invalidationDepth = i;
677
- }
678
- // Дополнительный обход не вызывает callbacks и проходит уже dirty computed:
679
- // флаги обычной invalidation не показывают, какую связь check уже прошёл.
680
- markActiveChecks(e) {
681
- const t = [e], i = /* @__PURE__ */ new Set();
682
- for (; t.length !== 0; )
683
- for (let s = t.pop(); s !== null; s = s.nextSub) {
684
- const n = s.sub;
685
- i.has(n) || (i.add(n), n.flags & L && (n.flags |= E), !(n.flags & d) && n.firstSub !== null && t.push(n.firstSub));
686
- }
687
- }
688
- /**
689
- * Помечает работающего потребителя, только если затронута уже прочитанная связь.
690
- * Связи за trackedTail принадлежат прошлому запуску и не означают повторную invalidation.
691
- * @returns Новое состояние либо ноль, если уведомление не требуется.
692
- */
693
- invalidateReadDependency(e, t, i) {
694
- const s = t.tailDep;
695
- if (s === null)
696
- return 0;
697
- if (e !== s) {
698
- for (let r = e.prevDep; r !== null; r = r.prevDep)
699
- if (r === s)
700
- return 0;
701
- }
702
- const n = i | D | g;
703
- return t.flags = n, n;
704
- }
705
- /**
706
- * Подтверждает необходимость пересчёта непосредственных потребителей.
707
- * Применяется после фиксации реально изменившегося значения; позволяет исключить
708
- * текущую связь и автора записи.
709
- */
710
- confirmSubUpdates(e, t, i = null) {
711
- for (let s = e; s !== null; s = s.nextSub) {
712
- if (s === t || s.sub === i)
713
- continue;
714
- const n = s.sub, r = n.flags;
715
- r & f || (n.flags = r & ~g | f, r & d ? this.enqueueEffect(n, s.dep) : r & b || n.flags & o && n.sourceHooks.onInvalidate?.(n.firstSub !== null));
716
- }
717
- }
718
- /**
719
- * Повторно вычисляет узел, согласует зависимости и сравнивает результат с кешем.
720
- * При ошибке восстанавливает контекст, удаляет непрочитанный хвост и оставляет
721
- * повторяемое состояние ошибки. Также восстанавливает непосредственного потребителя
722
- * skipSub: при разворачивании стека его связь могла быть уже извлечена из буфера.
723
- * Неверное значение в кеш не записывается.
724
- */
725
- recomputeValue(e, t = null) {
726
- const i = e.cachedValue;
727
- for (let s = 0; s < T; s++) {
728
- const n = e.evaluate;
729
- e.tailDep = null;
730
- const r = e.flags & -6149 | p;
731
- e.flags = r;
732
- const a = this.activeSub;
733
- this.activeSub = e;
734
- let l;
735
- try {
736
- l = n();
737
- } catch (h) {
738
- if (e.evaluate !== n)
739
- throw e.cachedValue = void 0, e.flags = 0, h;
740
- this.failComputedValue(e, t, h);
741
- } finally {
742
- this.activeSub = a;
743
- }
744
- if (e.evaluate !== n)
745
- return e.cachedValue = void 0, e.flags = 0, !1;
746
- const u = e.tailDep;
747
- if ((u === null ? e.firstDep : u.nextDep) !== null)
748
- try {
749
- this.pruneUnreadDependencies(e);
750
- } catch (h) {
751
- this.failComputedValue(e, t, h);
752
- }
753
- if (e.evaluate !== n)
754
- return e.cachedValue = void 0, e.flags = 0, !1;
755
- const w = e.flags & D;
756
- if (e.flags = r & -8460, w) {
757
- e.flags |= f;
758
- continue;
759
- }
760
- return e.cachedValue = l, i === l ? !1 : (e.firstSub !== null && this.confirmSubUpdates(e.firstSub, t), !0);
761
- }
762
- return this.failComputedValue(e, t, new Error(`Computed settlement exceeded ${T} attempts.`));
763
- }
764
- /** Сохраняет первичную ошибку и отдельные ошибки cleanup при восстановлении. */
765
- failComputedValue(e, t, i) {
766
- try {
767
- this.restoreComputedFailure(e, t);
768
- } catch (s) {
769
- throw new AggregateError([i, s], "Computed evaluation and dependency cleanup failed.");
770
- }
771
- throw i;
772
- }
773
- /**
774
- * Восстанавливает связи и состояния после неудачного getter.
775
- * Отдельная функция удерживает обработку исключений вне обычной части пересчёта.
776
- * Потребитель исключаемой связи мог уже покинуть активный префикс стека.
777
- */
778
- restoreComputedFailure(e, t) {
779
- e.evaluate !== void 0 && (e.flags = e.flags & -6288 | k);
780
- try {
781
- e.evaluate !== void 0 && this.pruneUnreadDependencies(e);
782
- } finally {
783
- e.evaluate === void 0 && (e.cachedValue = void 0, e.flags = 0), t !== null && this.restoreFailedDependency(t.sub);
784
- }
785
- }
786
- /**
787
- * Итеративно проверяет зависимые computed и pending-сигналы перед запуском потребителя.
788
- * Использует общий стек с сохранением активного префикса вложенного обхода.
789
- * При исключении восстанавливает высоту стека и состояния всех незавершённых
790
- * узлов текущего прохода; порядок успешного обхода не меняется.
791
- */
792
- refreshDependencies(e, t) {
793
- const i = this.dependencyDepth;
794
- try {
795
- return this.walkDependencyChain(e, t);
796
- } catch (s) {
797
- this.markRecoveryDependencies(e), this.restoreFailedDependency(e);
798
- for (let n = i; n < this.dependencyDepth; n++)
799
- this.restoreFailedDependency(this.dependencyStack[n].sub);
800
- throw this.dependencyDepth = i, this.dependencyStack.length = i, s;
801
- }
802
- }
803
- /** Settles every direct dependency so a cancelled external delivery can be re-armed. */
804
- settleCancelledDependencies(e) {
805
- for (let t = e.firstDep; t !== null; t = t.nextDep) {
806
- const i = t.dep, s = i.flags;
807
- s & (_ | b | k) && (i.evaluate === void 0 ? s & f && this.commitSignalValue(i, t) : this.refreshComputedValue(i, s, t));
808
- }
809
- }
810
- /**
811
- * Выполняет исходный итеративный обход зависимостей без обработки ошибок внутри цикла.
812
- * Перед пользовательским вычислением публикует активную высоту стека; оболочка
813
- * refreshDependencies() использует этот префикс для восстановления после сбоя.
814
- */
815
- walkDependencyChain(e, t) {
816
- const i = this.dependencyDepth;
817
- let s = i, n = !1, r;
818
- e.flags = e.flags & ~E | L, ++this.checkingDepth;
819
- try {
820
- e: for (; ; ) {
821
- if (e.flags & E) {
822
- r ??= /* @__PURE__ */ new Map();
823
- const a = (r.get(e) ?? 0) + 1;
824
- if (r.set(e, a), a > T)
825
- throw new Error(`Dependency check exceeded ${T} restarts.`);
826
- e.flags &= ~E, e.firstDep !== null && (t = e.firstDep);
827
- }
828
- if (e.flags & f)
829
- n = !0;
830
- else {
831
- const a = t.dep, l = a.flags;
832
- if (l & (f | k))
833
- this.dependencyDepth = s, n = a.evaluate === void 0 ? this.commitSignalValue(a, t) : this.recomputeValue(a, t);
834
- else if (l & g) {
835
- if (a.firstDep !== null) {
836
- this.dependencyStack[s++] = t, e = a, e.flags = e.flags & ~E | L, t = a.firstDep;
837
- continue e;
838
- }
839
- this.dependencyDepth = s, n = this.recomputeValue(a, t);
840
- } else
841
- n = !1;
842
- }
843
- if (!n && t.nextDep !== null) {
844
- t = t.nextDep;
845
- continue;
846
- }
847
- if (n) {
848
- for (; s !== i; ) {
849
- this.dependencyDepth = --s;
850
- const a = this.dependencyStack[s];
851
- if (e.flags &= ~R, n = this.recomputeValue(e, a), e = a.sub, !n) {
852
- if (a.nextDep !== null) {
853
- t = a.nextDep;
854
- continue e;
855
- }
856
- break;
857
- }
858
- }
859
- if (n)
860
- return this.dependencyDepth = i, !0;
861
- }
862
- for (; s !== i; ) {
863
- if (e.flags & (f | E))
864
- continue e;
865
- this.dependencyDepth = --s;
866
- const a = this.dependencyStack[s];
867
- if (e.flags &= ~(g | R), e = a.sub, a.nextDep !== null) {
868
- t = a.nextDep;
869
- continue e;
870
- }
871
- }
872
- if (e.flags & (f | E))
873
- continue e;
874
- return e.flags &= ~(g | R), this.dependencyDepth = i, !1;
875
- }
876
- } finally {
877
- e.flags &= ~R;
878
- for (let a = i; a < s; a++)
879
- this.dependencyStack[a].sub.flags &= ~R;
880
- --this.checkingDepth;
881
- }
882
- }
883
- /**
884
- * Восстанавливает незавершённую запись после прерванной проверки зависимостей.
885
- * Computed получает повторяемое состояние ошибки, effect остаётся доступным
886
- * для следующей invalidation. Вызывается только на ошибочном пути.
887
- */
888
- restoreFailedDependency(e) {
889
- if (e.evaluate === void 0) {
890
- e.cachedValue = void 0, e.flags = 0;
891
- return;
892
- }
893
- e.flags &= -6160, e.flags & d || (e.flags |= k);
894
- }
895
- /**
896
- * Проверяет необходимость запуска, очищает прошлые ресурсы и выполняет тело эффекта.
897
- * Ошибка cleanup останавливает эффект до создания ресурсов следующего запуска.
898
- * При ошибке тела сохраняет фактически прочитанные зависимости, останавливает
899
- * созданных детей и разрешает повторный запуск после следующей записи.
900
- * Cleanup, возвращённый после собственного stop, освобождается сразу.
901
- */
902
- executeEffect(e) {
903
- const t = e.flags;
904
- if (!(t & b))
905
- return;
906
- if (!(t & (f | D))) {
907
- const u = e.firstDep;
908
- try {
909
- if (u === null || !this.refreshDependencies(e, u)) {
910
- e.flags &= ~b;
911
- return;
912
- }
913
- } catch (w) {
914
- throw e.flags &= -80, w;
915
- }
916
- }
917
- const i = e.evaluate;
918
- if (i === void 0) {
919
- e.flags &= ~b;
920
- return;
921
- }
922
- let s;
923
- if (e.scopeLastChild !== void 0)
924
- try {
925
- this.disposeNestedEffects(e);
926
- } catch (u) {
927
- s = [u];
928
- }
929
- const n = typeof e.cachedValue == "function" ? e.cachedValue : void 0;
930
- if (e.cachedValue = void 0, e.flags &= ~D, n !== void 0)
931
- try {
932
- this.untracked(n);
933
- } catch (u) {
934
- s ??= [], s.push(u);
935
- }
936
- if (s !== void 0) {
937
- try {
938
- this.disposeEffect(e);
939
- } catch (u) {
940
- s.push(u);
941
- }
942
- V(s, "Effect cleanup failed.");
943
- }
944
- if (e.evaluate === void 0)
945
- return;
946
- e.tailDep = null, e.flags = e.flags & ~D | p;
947
- const r = this.activeSub;
948
- this.activeSub = e;
949
- let a;
950
- try {
951
- a = i();
952
- } catch (u) {
953
- this.activeSub = r, e.flags &= ~p, this.failEffectRun(e, u, s);
954
- } finally {
955
- this.activeSub = r, e.flags &= ~p;
956
- }
957
- const l = e.tailDep;
958
- if ((l === null ? e.firstDep : l.nextDep) !== null && this.pruneUnreadDependencies(e), typeof a == "function")
959
- if (e.evaluate === void 0)
960
- try {
961
- this.untracked(a);
962
- } catch (u) {
963
- s ??= [], s.push(u);
964
- }
965
- else
966
- e.cachedValue = a;
967
- e.flags & v ? e.flags = e.flags & -7 | g : e.flags &= -8;
968
- }
969
- /**
970
- * Завершает неудачный запуск эффекта, не затрагивая успешный путь исполнения.
971
- * Сохраняет прочитанные зависимости для следующей invalidation, освобождает
972
- * детей неудачного запуска и объединяет ошибки с предыдущими ошибками cleanup.
973
- */
974
- failEffectRun(e, t, i) {
975
- const s = i ?? [];
976
- s.push(t), this.pruneUnreadDependencies(e);
977
- try {
978
- this.disposeNestedEffects(e);
979
- } catch (n) {
980
- s.push(n);
981
- }
982
- throw e.flags &= -72, s.length === 1 ? s[0] : new AggregateError(s, "Effect execution failed.");
983
- }
984
- /**
985
- * Обрабатывает синхронную очередь до исчерпания, включая добавленную во время прохода работу.
986
- * Ошибки отдельных эффектов не блокируют соседей и передаются после обработки.
987
- * Путь не проверяет наличие внешней задачи у каждого узла.
988
- */
989
- flushSyncEffects() {
990
- if (!(this.flushingEffects || this.activeSub !== null && (this.activeSub.flags & (d | p)) === (d | p))) {
991
- this.flushingEffects = !0;
992
- try {
993
- for (; this.effectReadIndex !== this.effectWriteIndex; ) {
994
- const e = this.effectReadIndex, t = this.effectQueue[e];
995
- this.effectQueue[e] = void 0, ++this.effectReadIndex, t.flags &= ~v, this.executeEffect(t);
996
- }
997
- } catch (e) {
998
- this.drainQueueAfterError(e, !1);
999
- } finally {
1000
- this.effectReadIndex = 0, this.effectWriteIndex = 0, this.flushingEffects = !1;
1001
- }
1002
- }
1003
- }
1004
- /**
1005
- * Обрабатывает очередь экземпляра с внешней политикой выполнения.
1006
- * Обычные внутренние эффекты выполняет сразу, остальные передаёт постоянной задаче.
1007
- * Ошибка одного элемента не оставляет необработанные записи со старым SCHEDULED.
1008
- */
1009
- flushExternalEffects() {
1010
- if (!(this.flushingEffects || this.activeSub !== null && (this.activeSub.flags & (d | p)) === (d | p))) {
1011
- this.flushingEffects = !0;
1012
- try {
1013
- for (; this.effectReadIndex !== this.effectWriteIndex; ) {
1014
- const e = this.effectReadIndex, t = this.effectQueue[e];
1015
- this.effectQueue[e] = void 0, ++this.effectReadIndex;
1016
- const i = t.effectTask;
1017
- i === void 0 ? (t.flags &= ~v, this.executeEffect(t)) : t.evaluate !== void 0 ? this.scheduleEffectTask(t, i) : t.flags &= ~v;
1018
- }
1019
- } catch (e) {
1020
- this.drainQueueAfterError(e, !0);
1021
- } finally {
1022
- this.effectReadIndex = 0, this.effectWriteIndex = 0, this.flushingEffects = !1;
1023
- }
1024
- }
1025
- }
1026
- // Только ошибочный путь; новые fields/ссылки в graph records не добавляются.
1027
- markRecoveryDependencies(e) {
1028
- const t = [e], i = /* @__PURE__ */ new Set();
1029
- for (; t.length !== 0; ) {
1030
- const s = t.pop();
1031
- if (!i.has(s)) {
1032
- i.add(s);
1033
- for (let n = s.firstDep; n !== null; n = n.nextDep) {
1034
- const r = n.dep;
1035
- r.evaluate !== void 0 && !(r.flags & d) && (r.flags |= m, t.push(r));
1036
- }
1037
- }
1038
- }
1039
- }
1040
- /**
1041
- * Завершает очередь после первой ошибки, собирая последующие причины сбоя.
1042
- * Вызывается только на ошибочном пути; успешный проход не создаёт массив ошибок
1043
- * и не устанавливает отдельный catch для каждого элемента.
1044
- */
1045
- drainQueueAfterError(e, t) {
1046
- const i = [e];
1047
- for (; this.effectReadIndex !== this.effectWriteIndex; ) {
1048
- const s = this.effectReadIndex++, n = this.effectQueue[s];
1049
- this.effectQueue[s] = void 0;
1050
- try {
1051
- const r = t ? n.effectTask : void 0;
1052
- r !== void 0 && n.evaluate !== void 0 ? this.scheduleEffectTask(n, r) : (n.flags &= ~v, this.executeEffect(n));
1053
- } catch (r) {
1054
- i.push(r);
1055
- }
1056
- }
1057
- throw i.length === 1 ? e : new AggregateError(i, "Effect queue processing failed.");
1058
- }
1059
- /**
1060
- * Передаёт эффект его постоянной внешней задаче.
1061
- * Если schedule() бросает исключение, снимает незавершённую invalidation,
1062
- * чтобы последующая запись могла снова запросить выполнение.
1063
- */
1064
- requestEffectTask(e) {
1065
- const t = e.effectTask;
1066
- t === void 0 || e.evaluate === void 0 || (e.flags |= v, this.scheduleEffectTask(e, t));
1067
- }
1068
- // Передаёт уже запланированный эффект его постоянной внешней задаче.
1069
- scheduleEffectTask(e, t) {
1070
- try {
1071
- t.schedule();
1072
- } catch (i) {
1073
- throw e.flags &= -72, i;
1074
- }
1075
- }
1076
- /**
1077
- * Окончательно останавливает эффект и освобождает все принадлежащие ему ресурсы.
1078
- * Сначала делает узел неактивным и отсоединяет связи, затем отменяет задачу,
1079
- * останавливает детей, выполняет cleanup и onStop. Каждая стадия завершается
1080
- * несмотря на ошибки соседних стадий; повторный или вложенный stop безопасен.
1081
- */
1082
- disposeEffect(e) {
1083
- if (e.evaluate === void 0)
1084
- return;
1085
- this.activeSub === e && (this.activeSub = null);
1086
- const t = e.effectTask, i = e.onStop, s = typeof e.cachedValue == "function" ? e.cachedValue : void 0;
1087
- e.evaluate = void 0, e.flags = 0, e.cachedValue = void 0, e.effectTask = void 0, i !== void 0 && (e.onStop = void 0), q(e);
1088
- let n;
1089
- e.tailDep = null;
1090
- try {
1091
- this.pruneUnreadDependencies(e);
1092
- } catch (r) {
1093
- n = [r];
1094
- }
1095
- if (e.firstDep = e.tailDep = null, e.depCount = 0, A(e), t !== void 0)
1096
- try {
1097
- t.dispose();
1098
- } catch (r) {
1099
- n ??= [], n.push(r);
1100
- }
1101
- try {
1102
- this.disposeNestedEffects(e);
1103
- } catch (r) {
1104
- n ??= [], n.push(r);
1105
- }
1106
- if (s !== void 0)
1107
- try {
1108
- this.untracked(s);
1109
- } catch (r) {
1110
- n ??= [], n.push(r);
1111
- }
1112
- if (i !== void 0)
1113
- try {
1114
- this.untracked(i);
1115
- } catch (r) {
1116
- n ??= [], n.push(r);
1117
- }
1118
- this.invalidationStack.length !== this.invalidationDepth && (this.invalidationStack.length = this.invalidationDepth), this.dependencyStack.length !== this.dependencyDepth && (this.dependencyStack.length = this.dependencyDepth), n !== void 0 && V(n, "Effect disposal failed.");
1119
- }
1120
- /**
1121
- * Останавливает все вложенные эффекты в обратном порядке регистрации.
1122
- * Всегда берёт актуальный хвост: cleanup может удалить другого ребёнка.
1123
- * Передаёт собранные ошибки только после освобождения всех детей.
1124
- */
1125
- disposeNestedEffects(e) {
1126
- let t;
1127
- for (; e.scopeLastChild !== void 0; )
1128
- try {
1129
- this.disposeEffect(e.scopeLastChild);
1130
- } catch (i) {
1131
- t ??= [], t.push(i);
1132
- }
1133
- t !== void 0 && V(t, "Nested effect disposal failed.");
1134
- }
1135
- /**
1136
- * Задаёт обязательные поля графа перед первым вычислением.
1137
- * Вызывается только для нематериализованного handle; getter и контекст сохраняются.
1138
- */
1139
- static materializeComputed(e) {
1140
- e.flags = _ | (e.sourceHooks === void 0 ? 0 : o), e.firstSub = null, e.lastSub = null, e.firstDep = null, e.tailDep = null, e.depCount = 0, e.cachedValue = void 0;
1141
- }
1142
- /**
1143
- * Связывает два разных receiver: движок-владелец и читаемый handle.
1144
- * Эти четыре общие функции адаптируют this; алгоритмы чтения остаются методами
1145
- * RaphReactivity. Адаптеры создаются один раз на граф, а не на каждое вычисление.
1146
- */
1147
- createHandleReaders() {
1148
- const e = this;
1149
- function t() {
1150
- return e.readComputedValue(this);
1151
- }
1152
- return {
1153
- /**
1154
- * Материализует computed на месте и заменяет первоначальный get общим reader.
1155
- */
1156
- initializeComputed() {
1157
- const i = this;
1158
- return N.materializeComputed(i), this.get = t, e.readComputedValue(i);
1159
- },
1160
- /**
1161
- * Материализует raw computed, сохраняя извлечение read после первого вызова.
1162
- */
1163
- initializeRaw() {
1164
- const i = this;
1165
- N.materializeComputed(i);
1166
- const s = () => e.readComputedValue(i);
1167
- return this.read = s, s();
1168
- },
1169
- /**
1170
- * Передаёт handle как аргумент; this самого движка берётся из замыкания.
1171
- */
1172
- peek() {
1173
- return e.peekHandle(this);
1174
- }
1175
- };
1176
- }
1177
- /**
1178
- * Читает handle без подписки текущего потребителя, сохраняя receiver get().
1179
- * Прежний контекст восстанавливается и после исключения getter.
1180
- */
1181
- peekHandle(e) {
1182
- const t = this.activeSub;
1183
- if (t === null)
1184
- return e.get();
1185
- this.activeSub = null;
1186
- try {
1187
- return e.get();
1188
- } finally {
1189
- this.activeSub = t;
1190
- }
1191
- }
1192
- // ---------------------------------------------
1193
- // INTERNAL
1194
- // ---------------------------------------------
1195
- /**
1196
- * Создаёт единый низкоуровневый read/write accessor для core-дорожки Bench Lab.
1197
- * Публичный объектный API остаётся отдельным и измеряется в API-tax.
1198
- * @internal
1199
- */
1200
- _signalAccess(e) {
1201
- const t = this;
1202
- let i = e, s;
1203
- function n(r) {
1204
- if (arguments.length !== 0) {
1205
- const u = s;
1206
- u !== void 0 ? t.writeSignalValue(u, r) : i !== r && (i = r);
1207
- return;
1208
- }
1209
- const a = s;
1210
- if (a !== void 0)
1211
- return t.readSignalValue(a);
1212
- const l = t.activeSub;
1213
- return l === null || (s = t.materializeSignal(i, l)), i;
1214
- }
1215
- return {
1216
- read: n,
1217
- write: n
1218
- };
1219
- }
1220
- /**
1221
- * Создаёт нематериализованный computed для низкоуровневого read API.
1222
- * Графовые поля появляются при первом чтении; тип описывает обе стадии.
1223
- * @internal
1224
- */
1225
- _computedAccess(e) {
1226
- return {
1227
- evaluate: e,
1228
- read: this.handleReaders.initializeRaw
1229
- };
1230
- }
1231
- /**
1232
- * Создаёт signal, жизненным циклом которого управляет `ScopeNode`.
1233
- *
1234
- * Реактивная логика совпадает с обычным `signal()`, но disposer
1235
- * дополнительно отсоединяет материализованный источник от графа.
1236
- *
1237
- * @internal
1238
- */
1239
- _ownedSignal(e, t) {
1240
- const i = this;
1241
- let s = e, n, r = !1;
1242
- const a = () => {
1243
- const h = n;
1244
- if (h !== void 0)
1245
- return this.readSignalValue(h);
1246
- const S = this.activeSub;
1247
- if (S === null)
1248
- return s;
1249
- const C = s;
1250
- return n = this.materializeSignal(
1251
- C,
1252
- S,
1253
- t
1254
- ), s = void 0, C;
1255
- }, l = t === void 0 ? (h) => {
1256
- const S = n;
1257
- S !== void 0 ? this.writeSignalValue(S, h) : s !== h && (s = h);
1258
- } : (h) => {
1259
- const S = n;
1260
- if (S !== void 0) {
1261
- const C = S.flags & f ? S.pendingValue : S.cachedValue;
1262
- C !== h && t.onChange?.(C, h, S.firstSub !== null), this.writeSignalValue(S, h);
1263
- return;
1264
- }
1265
- s !== h && (t.onChange?.(s, h, !1), s = h);
1266
- }, w = {
1267
- source: {
1268
- get: a,
1269
- peek: this.handleReaders.peek,
1270
- set: l
1271
- },
1272
- /**
1273
- * Освобождает источник и отсоединяет его от реактивного графа.
1274
- */
1275
- dispose() {
1276
- if (r)
1277
- return !0;
1278
- r = !0, s = void 0;
1279
- let h;
1280
- try {
1281
- t?.onDispose?.(n?.firstSub != null);
1282
- } catch (S) {
1283
- (h ??= []).push(S);
1284
- }
1285
- if (n !== void 0) {
1286
- try {
1287
- i.releaseSourceSubs(n);
1288
- } catch (S) {
1289
- (h ??= []).push(S);
1290
- }
1291
- n.cachedValue = void 0, n.pendingValue = void 0, n.pendingAuthor = void 0, n.flags = 0;
1292
- }
1293
- if (n = void 0, h?.length === 1)
1294
- throw h[0];
1295
- if (h !== void 0 && h.length > 1)
1296
- throw new AggregateError(h, "Owned signal disposal failed.");
1297
- return !0;
1298
- }
1299
- };
1300
- return t !== void 0 && (w.hasSubscribers = () => n?.firstSub != null), w;
1301
- }
1302
- /**
1303
- * Создаёт ленивый computed с финализатором исходящих и входящих связей.
1304
- * Финализатор работает и до первого вычисления, не материализуя узел ради очистки.
1305
- * @internal
1306
- */
1307
- _ownedComputed(e, t) {
1308
- const i = this, s = this.createComputedHandle(e, t);
1309
- let n = !1;
1310
- const r = {
1311
- source: s,
1312
- /**
1313
- * Отсоединяет принадлежащий источник и освобождает его ссылки.
1314
- * Повторный вызов возвращает true без повторной очистки.
1315
- */
1316
- dispose() {
1317
- if (n)
1318
- return !0;
1319
- n = !0, i.activeSub === s && (i.activeSub = null);
1320
- const a = [];
1321
- try {
1322
- t?.onDispose?.(s.firstSub != null);
1323
- } catch (u) {
1324
- a.push(u);
1325
- }
1326
- if (s.flags !== void 0)
1327
- try {
1328
- i.releaseSourceSubs(s);
1329
- } catch (u) {
1330
- a.push(u);
1331
- }
1332
- const l = s.flags !== void 0;
1333
- if (s.evaluate = void 0, s.cachedValue = void 0, s.flags = 0, s.tailDep = null, l)
1334
- try {
1335
- i.pruneUnreadDependencies(s);
1336
- } catch (u) {
1337
- a.push(u);
1338
- }
1339
- if (s.firstDep = s.tailDep = null, s.depCount = 0, A(s), a.length === 1)
1340
- throw a[0];
1341
- if (a.length > 1)
1342
- throw new AggregateError(a, "Owned computed disposal failed.");
1343
- return !0;
1344
- }
1345
- };
1346
- return t !== void 0 && (r.hasSubscribers = () => s.firstSub != null), r;
1347
- }
1348
- /**
1349
- * Открывает вложенную синхронную границу группировки.
1350
- * Внутренний вызывающий код обязан выполнить соответствующий endBatch().
1351
- * @internal
1352
- */
1353
- _startBatch() {
1354
- ++this.batchDepth;
1355
- }
1356
- /**
1357
- * Закрывает ранее открытую границу и обрабатывает очередь на внешнем уровне.
1358
- * Предусловие: число закрытий не должно превышать число открытий.
1359
- * @internal
1360
- */
1361
- _endBatch() {
1362
- !--this.batchDepth && this.effectReadIndex !== this.effectWriteIndex && this.flushEffects();
1363
- }
1364
- /**
1365
- * Проверяет наличие активного потребителя в текущем синхронном стеке чтения.
1366
- * @internal
1367
- */
1368
- _isTracking() {
1369
- return this.activeSub !== null;
1370
- }
1371
- /**
1372
- * Показывает, обрабатывает ли экземпляр внутреннюю очередь эффектов.
1373
- * @internal
1374
- */
1375
- _isFlushingEffects() {
1376
- return this.flushingEffects;
1377
- }
1378
- // ---------------------------------------------
1379
- // TASK EFFECT GLUE
1380
- // ---------------------------------------------
1381
- //
1382
- // Аналог createScheduledEffect() без closures для вызывающего слоя, который
1383
- // владеет одним постоянным объектом задачи на эффект. Вызывающий слой хранит
1384
- // состояние запусков и управляет записью графа через методы ниже; engine не
1385
- // создаёт closures runner, cancel и re-arm. Такие эффекты требуют экземпляр
1386
- // с внешним effect scheduler, как и эффекты, связанные через scheduler.
1387
- /**
1388
- * Создаёт запись графа для эффекта с внешним планированием и подключает его
1389
- * постоянную задачу. Запуск ещё не запрошен: вызывающий слой сохраняет запись
1390
- * и затем вызывает _requestTaskEffect(). Запись, созданная во время работы
1391
- * другого эффекта, становится его вложенным ресурсом.
1392
- * @internal
1393
- */
1394
- _allocateTaskEffect(e, t) {
1395
- const i = this.allocateGraphRecord(void 0, e, f | g | d), s = this.activeSub;
1396
- return s !== null && s.flags & d && W(s, i), i.effectTask = t, i;
1397
- }
1398
- /**
1399
- * Запрашивает первый запуск эффекта с задачей. При `schedule` задача получает
1400
- * schedule(), как на пути scheduler bind; без него вызывающий слой уже сам
1401
- * поставил задачу в очередь, и запись только помечается запланированной.
1402
- * Если метод бросает исключение, запись освобождает вызывающий слой.
1403
- * @internal
1404
- */
1405
- _requestTaskEffect(e, t) {
1406
- t ? this.requestEffectTask(e) : e.effectTask !== void 0 && e.evaluate !== void 0 && (e.flags |= v), !this.batchDepth && this.effectReadIndex !== this.effectWriteIndex && this.flushEffects();
1407
- }
1408
- /**
1409
- * Открывает одну доставку эффекта с задачей. Возвращает false для устаревшей
1410
- * доставки: запись остановлена или запуск больше не запланирован.
1411
- * @internal
1412
- */
1413
- _beginTaskEffectRun(e) {
1414
- return !(e.flags & v) || e.evaluate === void 0 ? !1 : (e.flags &= ~v, !0);
1415
- }
1416
- /**
1417
- * Выполняет доставку, открытую через _beginTaskEffectRun(), вне активного
1418
- * потребителя и затем обрабатывает очередь эффектов, в том числе после
1419
- * неудачного запуска; при двух сбоях передаёт обе причины.
1420
- * @internal
1421
- */
1422
- _finishTaskEffectRun(e) {
1423
- const t = this.activeSub;
1424
- this.activeSub = null;
1425
- try {
1426
- try {
1427
- this.executeEffect(e);
1428
- } catch (i) {
1429
- if (!this.batchDepth && this.effectReadIndex !== this.effectWriteIndex)
1430
- try {
1431
- this.flushEffects();
1432
- } catch (s) {
1433
- throw new AggregateError(
1434
- [i, s],
1435
- "Effect execution and queue processing failed."
1436
- );
1437
- }
1438
- throw i;
1439
- }
1440
- !this.batchDepth && this.effectReadIndex !== this.effectWriteIndex && this.flushEffects();
1441
- } finally {
1442
- this.activeSub = t;
1443
- }
1444
- }
1445
- /**
1446
- * Гасит ожидающую доставку, от которой отказывается задача. Вызывающий слой
1447
- * не должен отменять доставку до первого запуска: зависимости до него ещё не
1448
- * собраны. Возвращает false, если запись уже остановлена.
1449
- * @internal
1450
- */
1451
- _cancelTaskEffect(e) {
1452
- return e.evaluate === void 0 ? !1 : (this.settleCancelledDependencies(e), e.flags &= -72, !this.batchDepth && this.effectReadIndex !== this.effectWriteIndex && this.flushEffects(), !0);
1453
- }
1454
- /**
1455
- * Делает следующую доставку исполняемой и снова планирует задачу. Нужен,
1456
- * когда invalidation пришла после снимка текущей доставки: её запуск
1457
- * расходует предыдущее dirty-состояние.
1458
- * @internal
1459
- */
1460
- _rearmTaskEffect(e) {
1461
- const t = e.effectTask;
1462
- t === void 0 || e.evaluate === void 0 || (e.flags |= f | v, t.schedule());
1463
- }
1464
- /**
1465
- * Окончательно останавливает эффект с задачей. Engine один раз вызывает
1466
- * task.dispose() изнутри, поэтому задача может направлять собственное
1467
- * освобождение через этот метод.
1468
- * @internal
1469
- */
1470
- _disposeTaskEffect(e) {
1471
- this.disposeEffect(e);
1472
- }
1473
- // ---------------------------------------------
1474
- // SIGNAL NODE GLUE
1475
- // ---------------------------------------------
1476
- //
1477
- // Аналог _ownedSignal() без closures для вызывающего слоя, который хранит
1478
- // значение, запись графа и source hooks одного signal в одном постоянном
1479
- // объекте. Вызывающий слой сам держит значение до материализации и ссылку на
1480
- // запись после неё; engine не создаёт handle, closures чтения и записи и
1481
- // объект финализатора. Методы повторяют шаги _ownedSignal() по одному.
1482
- /**
1483
- * Материализует signal для активного потребителя и связывает их. Без
1484
- * потребителя возвращает undefined: signal остаётся значением у вызывающего
1485
- * слоя. После материализации значением владеет запись.
1486
- * @internal
1487
- */
1488
- _trackSignalNode(e, t) {
1489
- const i = this.activeSub;
1490
- if (i !== null)
1491
- return this.materializeSignal(e, i, t);
1492
- }
1493
- /**
1494
- * Читает материализованный signal и регистрирует зависимость активного
1495
- * потребителя.
1496
- * @internal
1497
- */
1498
- _readSignalNode(e) {
1499
- return this.readSignalValue(e);
1500
- }
1501
- /**
1502
- * Читает материализованный signal без подписки текущего потребителя;
1503
- * pending-значение фиксируется так же, как при обычном чтении.
1504
- * @internal
1505
- */
1506
- _peekSignalNode(e) {
1507
- const t = this.activeSub;
1508
- if (t === null)
1509
- return this.readSignalValue(e);
1510
- this.activeSub = null;
1511
- try {
1512
- return this.readSignalValue(e);
1513
- } finally {
1514
- this.activeSub = t;
1515
- }
1516
- }
1517
- /**
1518
- * Возвращает значение, которое увидит следующее чтение: pending-значение
1519
- * незавершённой группировки либо зафиксированное. Ничего не фиксирует.
1520
- * @internal
1521
- */
1522
- _visibleSignalValue(e) {
1523
- return e.flags & f ? e.pendingValue : e.cachedValue;
1524
- }
1525
- /**
1526
- * Записывает значение материализованного signal с обычной семантикой batch.
1527
- * @internal
1528
- */
1529
- _writeSignalNode(e, t) {
1530
- this.writeSignalValue(e, t);
1531
- }
1532
- /**
1533
- * Сообщает, есть ли у материализованного signal потребители в графе.
1534
- * @internal
1535
- */
1536
- _signalNodeHasSubscribers(e) {
1537
- return e.firstSub !== null;
1538
- }
1539
- /**
1540
- * Отсоединяет материализованный signal от потребителей и освобождает его
1541
- * значения. Значения освобождаются и при сбое отсоединения. Поля pending
1542
- * сбрасываются, только если запись их получала: запись без группировок не
1543
- * меняет набор своих полей при освобождении.
1544
- * @internal
1545
- */
1546
- _releaseSignalNode(e) {
1547
- try {
1548
- this.releaseSourceSubs(e);
1549
- } finally {
1550
- e.cachedValue = void 0, e.pendingValue !== void 0 && (e.pendingValue = void 0), e.pendingAuthor != null && (e.pendingAuthor = void 0), e.flags = 0;
1551
- }
1552
- }
1553
- // ---------------------------------------------
1554
- // SUBSCRIBER OWNER GLUE
1555
- // ---------------------------------------------
1556
- //
1557
- // Чтение живых связей производителя для вызывающего слоя, которому нужен
1558
- // ответ о владельцах потребителей только по запросу. Слой не ведёт своего
1559
- // учёта рёбер: связь, снятая графом, перестаёт быть видимой сразу, без
1560
- // отдельного cleanup на ребро.
1561
- /**
1562
- * Ищет среди текущих потребителей записи первого, чьего владельца принимает
1563
- * accept, и возвращает этого владельца. Владелец потребителя определяется
1564
- * так же, как при привязке ребра через onDependency: у computed это
1565
- * dependencyOwner его source hooks, у эффекта — dependencyOwner его задачи.
1566
- * Потребители без владельца пропускаются. Обход идёт в порядке списка
1567
- * потребителей, ничего не выделяет и не меняет граф; accept не должен менять
1568
- * связи этой записи.
1569
- * @param node Материализованная запись производителя.
1570
- * @param accept Проверка владельца потребителя; context передаётся ей без closure.
1571
- * @param context Произвольное значение вызывающего слоя для accept.
1572
- * @internal
1573
- */
1574
- _findSubscriberOwner(e, t, i) {
1575
- for (let s = e.firstSub; s !== null; s = s.nextSub) {
1576
- const n = s.sub, r = n.sourceHooks?.dependencyOwner ?? n.effectTask?.dependencyOwner;
1577
- if (r !== void 0 && t(r, i))
1578
- return r;
1579
- }
1580
- }
1581
- /**
1582
- * Возвращает владельца активного потребителя: того, кому engine привязал бы
1583
- * ребро следующего отслеживаемого чтения. Владелец определяется так же, как
1584
- * в _findSubscriberOwner(). Без активного потребителя и у потребителя без
1585
- * владельца результат undefined. Метод ничего не выделяет и не меняет граф.
1586
- *
1587
- * Вызывающий слой проверяет по этому владельцу допустимость чтения, когда
1588
- * его собственный контекст снят, а потребитель engine остался активным.
1589
- * @internal
1590
- */
1591
- _activeSubscriberOwner() {
1592
- const e = this.activeSub;
1593
- if (e !== null)
1594
- return e.sourceHooks?.dependencyOwner ?? e.effectTask?.dependencyOwner;
1595
- }
1596
- // ---------------------------------------------
1597
- // COUNTER NODE GLUE
1598
- // ---------------------------------------------
1599
- //
1600
- // Запись графа со счётчиком вместо значения: вызывающий слой будит через неё
1601
- // потребителей, которым важен сам факт изменения. Значение счётчика только
1602
- // растёт, поэтому одну запись нельзя отменить следующей.
1603
- /**
1604
- * Увеличивает счётчик материализованного signal и уведомляет его
1605
- * потребителей. Без потребителей ничего не пишет и возвращает false.
1606
- *
1607
- * Сдвиг — обычная запись signal. Вне группировки она прямая: счётчик
1608
- * фиксируется сразу, а потребитель становится обязательным к пересчёту, в
1609
- * том числе тот, кто ждал только проверки зависимостей или стоит на стеке
1610
- * идущей проверки. Внутри группировки и у записи с ещё не прочитанным
1611
- * отложенным сдвигом запись откладывается до первого чтения, как любая запись
1612
- * внутри batch().
1613
- *
1614
- * Потребитель, который выполняется в момент прямого сдвига, получает его по
1615
- * общему правилу записи во время запуска: у записи не остаётся отложенного
1616
- * сдвига, который позже подтвердил бы ему изменение.
1617
- *
1618
- * Очередь эффектов обрабатывается на выходе, если группировки нет: отложенная
1619
- * запись сама её не обрабатывает, а потребитель, которого она поставила в
1620
- * очередь, не должен ждать следующей записи.
1621
- * @internal
1622
- */
1623
- _bumpSignalNode(e) {
1624
- return e.firstSub === null ? !1 : (this.writeSignalValue(
1625
- e,
1626
- (e.flags & f ? e.pendingValue : e.cachedValue) + 1
1627
- ), !this.batchDepth && this.effectReadIndex !== this.effectWriteIndex && this.flushEffects(), !0);
1628
- }
1629
- /**
1630
- * Создаёт запись-счётчик для активного потребителя и связывает их; без
1631
- * потребителя возвращает undefined. Счётчик начинается с нуля и сдвигается
1632
- * через _bumpSignalNode().
1633
- *
1634
- * Счётчик — производитель без собственных зависимостей. Граф читает у него
1635
- * то же, что у записи signal в роли производителя: признаки, список
1636
- * потребителей, отсутствие getter, значение и source hooks. Полей списка
1637
- * зависимостей у записи нет, а hooks лежат в ней самой: счётчик стоит одной
1638
- * аллокации из шести полей, а запись signal с hooks — двух. Поля отложенной
1639
- * записи появляются у счётчика с первым сдвигом.
1640
- * @internal
1641
- */
1642
- _trackCounterNode(e) {
1643
- const t = this.activeSub;
1644
- if (t === null)
1645
- return;
1646
- const i = {
1647
- flags: o,
1648
- firstSub: null,
1649
- lastSub: null,
1650
- evaluate: void 0,
1651
- cachedValue: 0,
1652
- sourceHooks: e
1653
- };
1654
- return t.flags & x ? this.appendInitialDependency(i, t) : this.trackDependency(i, t), i;
1655
- }
1656
- // ---------------------------------------------
1657
- // ACTIVE TASK GLUE
1658
- // ---------------------------------------------
1659
- //
1660
- // Тело эффекта с задачей engine вызывает без аргументов и без receiver.
1661
- // Вызывающий слой, который даёт всем своим эффектам одно общее тело, находит
1662
- // через метод ниже эффект, ради которого тело вызвано: записи графа не нужна
1663
- // собственная closure тела.
1664
- /**
1665
- * Возвращает постоянную задачу активного потребителя. Engine делает запись
1666
- * эффекта активным потребителем непосредственно перед вызовом её тела,
1667
- * поэтому первое обращение из тела возвращает задачу именно этого эффекта,
1668
- * какие бы доставки ни выполнил cleanup его прошлого запуска.
1669
- *
1670
- * Без активного потребителя и у потребителя без задачи — computed либо
1671
- * эффекта, созданного без внешнего планирования, — результат undefined.
1672
- * Метод ничего не выделяет и не меняет граф.
1673
- * @internal
1674
- */
1675
- _activeEffectTask() {
1676
- const e = this.activeSub;
1677
- return e === null ? void 0 : e.effectTask;
12
+ reactive(c) {
13
+ return i(this, c, () => this._createReactivePropertySourceBridge());
1678
14
  }
1679
15
  }
1680
- let P;
1681
- function y() {
1682
- return P ??= new N();
16
+ let n;
17
+ function e() {
18
+ return n ??= new a();
1683
19
  }
1684
- const K = (c) => y().signal(c), Y = (c) => y().reactive(c);
1685
- function X(c) {
1686
- return y().computed(c);
20
+ const f = (t) => e().signal(t), p = (t) => e().reactive(t);
21
+ function v(t) {
22
+ return e().computed(t);
1687
23
  }
1688
- const $ = (c, e) => y().effect(c, e), j = (c, e, t) => y().watch(c, e, t), Z = (c) => y().batch(c), J = (c) => y().untracked(c), ee = () => y().scope();
24
+ const d = (t, c) => e().effect(t, c), h = (t, c, o) => e().watch(t, c, o), m = (t) => e().batch(t), l = (t) => e().untracked(t), y = () => e().scope();
1689
25
  export {
1690
- N as RaphReactivity,
1691
- U as ScopeNode,
1692
- Z as batch,
1693
- X as computed,
1694
- $ as effect,
1695
- Y as reactive,
1696
- ee as scope,
1697
- K as signal,
1698
- J as untracked,
1699
- j as watch
26
+ a as RaphReactivity,
27
+ b as ScopeNode,
28
+ m as batch,
29
+ v as computed,
30
+ d as effect,
31
+ p as reactive,
32
+ y as scope,
33
+ f as signal,
34
+ l as untracked,
35
+ h as watch
1700
36
  };