@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,559 +1,15 @@
1
- import { ComputedAccessHandle, Disposer, EffectCallback, EffectFactory, EffectTask, OwnedSource, OwnedSourceHooks, ReactiveNode, ReactivityOptions, ReadonlySignal, Signal, SignalAccess, WatchCallback, WatchOptions, WatchSource, WritableComputedOptions } from './types';
2
- import { ScopeNode } from './scope';
3
- export { ScopeNode } from './scope';
4
- export type { Disposer, EffectCallback, EffectScheduler, EffectTask, ReactivityOptions, ReadonlySignal, Signal, WatchCallback, WatchOptions, WatchSource, WatchValue, WritableComputedOptions, } from './types';
5
- /**
6
- * Изолированный граф реактивности с синхронным исполнением по умолчанию.
7
- * Состояние принадлежит полям экземпляра, алгоритмы - обычным методам прототипа.
8
- * Только передаваемые наружу методы связаны с экземпляром один раз; очередь
9
- * синхронного движка не проверяет внешнюю политику на каждом эффекте.
10
- */
11
- export declare class RaphReactivity {
12
- private readonly adaptiveDependencyIndex;
13
- private activeSub;
14
- private batchDepth;
15
- private effectReadIndex;
16
- private effectWriteIndex;
17
- private invalidationDepth;
18
- private dependencyDepth;
19
- private checkingDepth;
20
- private flushingEffects;
21
- private readonly effectQueue;
22
- private readonly invalidationStack;
23
- private readonly dependencyStack;
24
- private readonly handleReaders;
25
- private readonly effectScheduler;
26
- private readonly flushEffects;
27
- /**
28
- * Синхронная регистрация эффекта для Runtime и watch независимо от внешней политики.
29
- * Это связанная ссылка на реализацию effect(), а не делегирующая функция.
30
- * @internal
31
- */
32
- readonly _effectImmediate: EffectFactory;
33
- /**
34
- * Выбирает политику исполнения и сохраняет совместимость извлечённых методов.
35
- * Тела методов находятся на прототипе; bind() выполняется только при создании
36
- * экземпляра, чтобы Runtime и глобальный API могли передавать методы как callbacks.
37
- * @param options Необязательная внешняя политика эффектов.
38
- */
1
+ import { ReactivityOptions, ReadonlySignal, Signal, WritableComputedOptions } from './types.js';
2
+ import { ReactivityEngine } from './engine-core.js';
3
+ export { ScopeNode } from './scope.js';
4
+ export type { Disposer, EffectCallback, EffectScheduler, EffectTask, ReactivityOptions, ReadonlySignal, Signal, WatchCallback, WatchOptions, WatchSource, WatchValue, WritableComputedOptions, } from './types.js';
5
+ /** Прежний standalone API; общий signal graph не зависит от Proxy adapter. */
6
+ export declare class RaphReactivity extends ReactivityEngine {
39
7
  constructor(options?: ReactivityOptions);
40
- /**
41
- * Создаёт объектный signal с get/peek/set.
42
- * get() регистрирует зависимость только при активном потребителе,
43
- * а peek() выполняет чтение с временно отключённым отслеживанием.
44
- */
45
- signal<T>(initialValue: T): Signal<T>;
46
8
  /**
47
9
  * Возвращает стабильный глубокий Proxy для plain object или array.
48
10
  * Object context и per-property sources создаются лениво внутри этого engine.
49
11
  */
50
12
  reactive<T extends object>(value: T): T;
51
- /**
52
- * - `(1)` Создаёт ленивое вычисляемое значение только для чтения;
53
- * - `(2)` Создаёт writable computed, сохраняя исходную функцию setter;
54
- * - `(3)` Создаёт ленивое вычисляемое значение; для объекта get/set сохраняет;
55
- * исходную функцию записи без дополнительной обёртки.
56
- */
57
- computed<T>(getter: () => T): ReadonlySignal<T>;
58
- computed<T>(options: WritableComputedOptions<T>): Signal<T>;
59
- /**
60
- * Создаёт эффект согласно политике экземпляра и возвращает disposer.
61
- * Прототип содержит синхронную реализацию; при наличии scheduler конструктор
62
- * подставляет createScheduledEffect, сохраняя этот путь как _effectImmediate.
63
- * Вложенный эффект включается в список ресурсов активного эффекта.
64
- * При ошибке регистрации удаляет созданные ресурсы, сохраняя обе причины сбоя.
65
- * @param fn Синхронное тело с необязательным cleanup очередного запуска.
66
- * @param onStop Однократная окончательная очистка, независимая от повторных запусков.
67
- */
68
- effect(fn: EffectCallback, onStop?: Disposer): Disposer;
69
- /**
70
- * Наблюдает за источниками; callback и cleanup не создают зависимостей.
71
- */
72
- watch<S extends WatchSource | readonly WatchSource[]>(source: S, callback: WatchCallback<S>, options?: WatchOptions): Disposer;
73
- /**
74
- * Группирует синхронные записи и обрабатывает эффекты после внешней границы.
75
- * Возвращает результат операции. Если тело и очередь завершаются с ошибками,
76
- * передаёт обе ошибки в AggregateError вместо потери первой. Не является откатом данных.
77
- */
78
- batch<T>(fn: () => T): T;
79
- /**
80
- * Выполняет синхронную операцию без добавления зависимостей текущему потребителю.
81
- * Восстанавливает прежний контекст и при исключении. Асинхронное продолжение
82
- * операции этим контекстом не охватывается.
83
- */
84
- untracked<T>(fn: () => T): T;
85
- /**
86
- * Создаёт владельца ресурсов в текущем графе без Runtime и фаз.
87
- */
88
- scope(): ScopeNode;
89
- /**
90
- * Создаёт запись графа с одинаковым порядком основных полей.
91
- * Значение служит кешем signal/computed либо хранит cleanup эффекта.
92
- * Поля внешней задачи и окончательной очистки добавляются только при необходимости.
93
- */
94
- private allocateGraphRecord;
95
- /** Creates a narrow Proxy adapter over the existing intrusive graph. */
96
- private createReactivePropertySourceBridge;
97
- /**
98
- * Материализует signal в графе при первом отслеживаемом чтении
99
- * и связывает его с активным потребителем.
100
- *
101
- * До этого момента signal может хранить значение только в замыкании
102
- * и вообще не создавать `ReactiveNode`.
103
- */
104
- private materializeSignal;
105
- /**
106
- * Создаёт минимальный handle computed без преждевременного выделения полей графа.
107
- * Первый get() материализует запись на этом же объекте и заменяет метод чтения.
108
- */
109
- private createComputedHandle;
110
- /**
111
- * Создаёт эффект с одной постоянной задачей внешнего scheduler.
112
- * Первый и последующие запуски проходят через задачу; устаревший runner после stop
113
- * ничего не выполняет. При синхронной ошибке runner обрабатывает независимую очередь.
114
- * @param fn Тело эффекта.
115
- * @param onStop Однократная окончательная очистка.
116
- */
117
- private createScheduledEffect;
118
- /**
119
- * Регистрирует чтение signal и при необходимости фиксирует pending-значение.
120
- * Текущая связь передаётся фиксации, чтобы не уведомлять читающего потребителя повторно.
121
- */
122
- private readSignalValue;
123
- /**
124
- * Записывает новое значение или откладывает его фиксацию до чтения в batch.
125
- * Сохраняет исходное сравнение через === и учёт автора pending-записи.
126
- * Без batch и внешней политики очередь эффектов завершается до возврата из set().
127
- */
128
- private writeSignalValue;
129
- /**
130
- * Возвращает кеш либо синхронно актуализирует вычисляемое значение.
131
- * Неуспешное вычисление не считается значением. Ошибка getter сохраняет связь
132
- * с активным потребителем для восстановления. Повторное чтение во время
133
- * первого сбора зависимостей отклоняется до регистрации связи и чтения кеша.
134
- */
135
- private readComputedValue;
136
- /**
137
- * Выполняет первый сбор зависимостей и кеширует только успешный результат.
138
- * При исключении оставляет состояние повторяемой ошибки, а не чистый undefined.
139
- * Уже прочитанные зависимости сохраняются для последующего уведомления.
140
- */
141
- private evaluateFirstValue;
142
- /**
143
- * Актуализирует computed: выполняет прямой пересчёт либо проверяет зависимости.
144
- * После ошибки getter разрешён повторный пересчёт даже без новой записи источника.
145
- */
146
- private refreshComputedValue;
147
- /**
148
- * Фиксирует pending-значение и уведомляет непосредственных потребителей.
149
- * Пропускает указанную связь и автора записи, чтобы не дублировать текущую работу.
150
- * @returns Изменилось ли зафиксированное значение.
151
- */
152
- private commitSignalValue;
153
- /**
154
- * Обрабатывает чтение производителя активным потребителем.
155
- * Сначала проверяет текущую и следующую связи; более дорогой поиск вынесен отдельно.
156
- */
157
- private trackDependency;
158
- /**
159
- * Согласует чтение с существующим списком зависимостей при несовпадении порядка.
160
- * Использует ограниченный линейный поиск, затем поиск среди потребителей производителя.
161
- * Существующую связь перемещает или переиспользует; новую создаёт только при необходимости.
162
- */
163
- private reconcileDependency;
164
- /**
165
- * Добавляет связь при первоначальном сборе зависимостей.
166
- * Предусловие: after является хвостом собранного префикса нового списка.
167
- * Связь одновременно включается в список потребителей производителя.
168
- */
169
- private appendInitialDependency;
170
- /**
171
- * Вставляет связь после заданного курсора зависимостей потребителя.
172
- * Сохраняет ещё не прочитанный хвост списка и увеличивает dependencyCount.
173
- */
174
- private insertDependency;
175
- /**
176
- * Переназначает существующую связь другому производителю.
177
- * Положение в списке зависимостей потребителя и число его связей сохраняются.
178
- */
179
- private reuseDepLink;
180
- /**
181
- * Перемещает существующую зависимость после курсора текущего чтения.
182
- * Список потребителей производителя и количество зависимостей не изменяет.
183
- */
184
- private reorderDependency;
185
- /**
186
- * Удаляет непрочитанный хвост зависимостей завершившегося запуска.
187
- * trackedTail обозначает границу прочитанного префикса, а не неизменный конец списка.
188
- * Ошибка cleanup не прерывает освобождение оставшегося хвоста зависимостей.
189
- */
190
- private pruneUnreadDependencies;
191
- /**
192
- * Удаляет связь только из списка потребителей производителя.
193
- * Список зависимостей потребителя и его счётчик здесь не изменяются.
194
- * Также исправляет курсор поиска, если он указывал на удаляемую связь.
195
- */
196
- private detachSubLink;
197
- /** Завершает удаление producer-связи без вызова source cleanup. */
198
- private unlinkSubLink;
199
- /** Connects Runtime ownership metadata only for edges whose producer opted in. */
200
- private attachDependencyCleanup;
201
- /**
202
- * Отсоединяет owned-источник сразу с обеих сторон каждой связи.
203
- * Вызывается на границе lifetime, а не при обычных чтениях и записях.
204
- * Переводит ожидавших проверку потребителей к повторному вычислению при необходимости.
205
- */
206
- private releaseSourceSubs;
207
- /**
208
- * Удаляет связь только из списка зависимостей потребителя.
209
- * Исправляет курсор прочитанного префикса и dependencyCount; список производителя
210
- * должен быть обновлён отдельной операцией.
211
- */
212
- private detachDependencyLink;
213
- /**
214
- * Добавляет эффект во внутреннюю очередь один раз до обработки текущей записи.
215
- * Флаг SCHEDULED предотвращает повторное добавление без создания task-объекта.
216
- */
217
- private enqueueEffect;
218
- /**
219
- * Распространяет invalidation от непосредственных к транзитивным потребителям.
220
- * Сохраняет исходный итеративный обход с переиспользуемым стеком; callbacks
221
- * не выполняет. Непосредственное и потенциальное изменения отмечает разными флагами.
222
- */
223
- private propagateInvalidation;
224
- private markActiveChecks;
225
- /**
226
- * Помечает работающего потребителя, только если затронута уже прочитанная связь.
227
- * Связи за trackedTail принадлежат прошлому запуску и не означают повторную invalidation.
228
- * @returns Новое состояние либо ноль, если уведомление не требуется.
229
- */
230
- private invalidateReadDependency;
231
- /**
232
- * Подтверждает необходимость пересчёта непосредственных потребителей.
233
- * Применяется после фиксации реально изменившегося значения; позволяет исключить
234
- * текущую связь и автора записи.
235
- */
236
- private confirmSubUpdates;
237
- /**
238
- * Повторно вычисляет узел, согласует зависимости и сравнивает результат с кешем.
239
- * При ошибке восстанавливает контекст, удаляет непрочитанный хвост и оставляет
240
- * повторяемое состояние ошибки. Также восстанавливает непосредственного потребителя
241
- * skipSub: при разворачивании стека его связь могла быть уже извлечена из буфера.
242
- * Неверное значение в кеш не записывается.
243
- */
244
- private recomputeValue;
245
- /** Сохраняет первичную ошибку и отдельные ошибки cleanup при восстановлении. */
246
- private failComputedValue;
247
- /**
248
- * Восстанавливает связи и состояния после неудачного getter.
249
- * Отдельная функция удерживает обработку исключений вне обычной части пересчёта.
250
- * Потребитель исключаемой связи мог уже покинуть активный префикс стека.
251
- */
252
- private restoreComputedFailure;
253
- /**
254
- * Итеративно проверяет зависимые computed и pending-сигналы перед запуском потребителя.
255
- * Использует общий стек с сохранением активного префикса вложенного обхода.
256
- * При исключении восстанавливает высоту стека и состояния всех незавершённых
257
- * узлов текущего прохода; порядок успешного обхода не меняется.
258
- */
259
- private refreshDependencies;
260
- /** Settles every direct dependency so a cancelled external delivery can be re-armed. */
261
- private settleCancelledDependencies;
262
- /**
263
- * Выполняет исходный итеративный обход зависимостей без обработки ошибок внутри цикла.
264
- * Перед пользовательским вычислением публикует активную высоту стека; оболочка
265
- * refreshDependencies() использует этот префикс для восстановления после сбоя.
266
- */
267
- private walkDependencyChain;
268
- /**
269
- * Восстанавливает незавершённую запись после прерванной проверки зависимостей.
270
- * Computed получает повторяемое состояние ошибки, effect остаётся доступным
271
- * для следующей invalidation. Вызывается только на ошибочном пути.
272
- */
273
- private restoreFailedDependency;
274
- /**
275
- * Проверяет необходимость запуска, очищает прошлые ресурсы и выполняет тело эффекта.
276
- * Ошибка cleanup останавливает эффект до создания ресурсов следующего запуска.
277
- * При ошибке тела сохраняет фактически прочитанные зависимости, останавливает
278
- * созданных детей и разрешает повторный запуск после следующей записи.
279
- * Cleanup, возвращённый после собственного stop, освобождается сразу.
280
- */
281
- private executeEffect;
282
- /**
283
- * Завершает неудачный запуск эффекта, не затрагивая успешный путь исполнения.
284
- * Сохраняет прочитанные зависимости для следующей invalidation, освобождает
285
- * детей неудачного запуска и объединяет ошибки с предыдущими ошибками cleanup.
286
- */
287
- private failEffectRun;
288
- /**
289
- * Обрабатывает синхронную очередь до исчерпания, включая добавленную во время прохода работу.
290
- * Ошибки отдельных эффектов не блокируют соседей и передаются после обработки.
291
- * Путь не проверяет наличие внешней задачи у каждого узла.
292
- */
293
- private flushSyncEffects;
294
- /**
295
- * Обрабатывает очередь экземпляра с внешней политикой выполнения.
296
- * Обычные внутренние эффекты выполняет сразу, остальные передаёт постоянной задаче.
297
- * Ошибка одного элемента не оставляет необработанные записи со старым SCHEDULED.
298
- */
299
- private flushExternalEffects;
300
- private markRecoveryDependencies;
301
- /**
302
- * Завершает очередь после первой ошибки, собирая последующие причины сбоя.
303
- * Вызывается только на ошибочном пути; успешный проход не создаёт массив ошибок
304
- * и не устанавливает отдельный catch для каждого элемента.
305
- */
306
- private drainQueueAfterError;
307
- /**
308
- * Передаёт эффект его постоянной внешней задаче.
309
- * Если schedule() бросает исключение, снимает незавершённую invalidation,
310
- * чтобы последующая запись могла снова запросить выполнение.
311
- */
312
- private requestEffectTask;
313
- private scheduleEffectTask;
314
- /**
315
- * Окончательно останавливает эффект и освобождает все принадлежащие ему ресурсы.
316
- * Сначала делает узел неактивным и отсоединяет связи, затем отменяет задачу,
317
- * останавливает детей, выполняет cleanup и onStop. Каждая стадия завершается
318
- * несмотря на ошибки соседних стадий; повторный или вложенный stop безопасен.
319
- */
320
- private disposeEffect;
321
- /**
322
- * Останавливает все вложенные эффекты в обратном порядке регистрации.
323
- * Всегда берёт актуальный хвост: cleanup может удалить другого ребёнка.
324
- * Передаёт собранные ошибки только после освобождения всех детей.
325
- */
326
- private disposeNestedEffects;
327
- /**
328
- * Задаёт обязательные поля графа перед первым вычислением.
329
- * Вызывается только для нематериализованного handle; getter и контекст сохраняются.
330
- */
331
- private static materializeComputed;
332
- /**
333
- * Связывает два разных receiver: движок-владелец и читаемый handle.
334
- * Эти четыре общие функции адаптируют this; алгоритмы чтения остаются методами
335
- * RaphReactivity. Адаптеры создаются один раз на граф, а не на каждое вычисление.
336
- */
337
- private createHandleReaders;
338
- /**
339
- * Читает handle без подписки текущего потребителя, сохраняя receiver get().
340
- * Прежний контекст восстанавливается и после исключения getter.
341
- */
342
- private peekHandle;
343
- /**
344
- * Создаёт единый низкоуровневый read/write accessor для core-дорожки Bench Lab.
345
- * Публичный объектный API остаётся отдельным и измеряется в API-tax.
346
- * @internal
347
- */
348
- _signalAccess<T>(initialValue: T): SignalAccess<T>;
349
- /**
350
- * Создаёт нематериализованный computed для низкоуровневого read API.
351
- * Графовые поля появляются при первом чтении; тип описывает обе стадии.
352
- * @internal
353
- */
354
- _computedAccess<T>(fn: () => T): ComputedAccessHandle<T>;
355
- /**
356
- * Создаёт signal, жизненным циклом которого управляет `ScopeNode`.
357
- *
358
- * Реактивная логика совпадает с обычным `signal()`, но disposer
359
- * дополнительно отсоединяет материализованный источник от графа.
360
- *
361
- * @internal
362
- */
363
- _ownedSignal<T>(initialValue: T, sourceHooks?: OwnedSourceHooks): OwnedSource<Signal<T>>;
364
- /**
365
- * Создаёт ленивый computed с финализатором исходящих и входящих связей.
366
- * Финализатор работает и до первого вычисления, не материализуя узел ради очистки.
367
- * @internal
368
- */
369
- _ownedComputed<T>(fn: () => T, sourceHooks?: OwnedSourceHooks): OwnedSource<ReadonlySignal<T>>;
370
- /**
371
- * Открывает вложенную синхронную границу группировки.
372
- * Внутренний вызывающий код обязан выполнить соответствующий endBatch().
373
- * @internal
374
- */
375
- _startBatch(): void;
376
- /**
377
- * Закрывает ранее открытую границу и обрабатывает очередь на внешнем уровне.
378
- * Предусловие: число закрытий не должно превышать число открытий.
379
- * @internal
380
- */
381
- _endBatch(): void;
382
- /**
383
- * Проверяет наличие активного потребителя в текущем синхронном стеке чтения.
384
- * @internal
385
- */
386
- _isTracking(): boolean;
387
- /**
388
- * Показывает, обрабатывает ли экземпляр внутреннюю очередь эффектов.
389
- * @internal
390
- */
391
- _isFlushingEffects(): boolean;
392
- /**
393
- * Создаёт запись графа для эффекта с внешним планированием и подключает его
394
- * постоянную задачу. Запуск ещё не запрошен: вызывающий слой сохраняет запись
395
- * и затем вызывает _requestTaskEffect(). Запись, созданная во время работы
396
- * другого эффекта, становится его вложенным ресурсом.
397
- * @internal
398
- */
399
- _allocateTaskEffect(fn: EffectCallback, task: EffectTask): ReactiveNode;
400
- /**
401
- * Запрашивает первый запуск эффекта с задачей. При `schedule` задача получает
402
- * schedule(), как на пути scheduler bind; без него вызывающий слой уже сам
403
- * поставил задачу в очередь, и запись только помечается запланированной.
404
- * Если метод бросает исключение, запись освобождает вызывающий слой.
405
- * @internal
406
- */
407
- _requestTaskEffect(node: ReactiveNode, schedule: boolean): void;
408
- /**
409
- * Открывает одну доставку эффекта с задачей. Возвращает false для устаревшей
410
- * доставки: запись остановлена или запуск больше не запланирован.
411
- * @internal
412
- */
413
- _beginTaskEffectRun(node: ReactiveNode): boolean;
414
- /**
415
- * Выполняет доставку, открытую через _beginTaskEffectRun(), вне активного
416
- * потребителя и затем обрабатывает очередь эффектов, в том числе после
417
- * неудачного запуска; при двух сбоях передаёт обе причины.
418
- * @internal
419
- */
420
- _finishTaskEffectRun(node: ReactiveNode): void;
421
- /**
422
- * Гасит ожидающую доставку, от которой отказывается задача. Вызывающий слой
423
- * не должен отменять доставку до первого запуска: зависимости до него ещё не
424
- * собраны. Возвращает false, если запись уже остановлена.
425
- * @internal
426
- */
427
- _cancelTaskEffect(node: ReactiveNode): boolean;
428
- /**
429
- * Делает следующую доставку исполняемой и снова планирует задачу. Нужен,
430
- * когда invalidation пришла после снимка текущей доставки: её запуск
431
- * расходует предыдущее dirty-состояние.
432
- * @internal
433
- */
434
- _rearmTaskEffect(node: ReactiveNode): void;
435
- /**
436
- * Окончательно останавливает эффект с задачей. Engine один раз вызывает
437
- * task.dispose() изнутри, поэтому задача может направлять собственное
438
- * освобождение через этот метод.
439
- * @internal
440
- */
441
- _disposeTaskEffect(node: ReactiveNode): void;
442
- /**
443
- * Материализует signal для активного потребителя и связывает их. Без
444
- * потребителя возвращает undefined: signal остаётся значением у вызывающего
445
- * слоя. После материализации значением владеет запись.
446
- * @internal
447
- */
448
- _trackSignalNode<T>(value: T, sourceHooks: OwnedSourceHooks): ReactiveNode<T> | undefined;
449
- /**
450
- * Читает материализованный signal и регистрирует зависимость активного
451
- * потребителя.
452
- * @internal
453
- */
454
- _readSignalNode<T>(node: ReactiveNode<T>): T;
455
- /**
456
- * Читает материализованный signal без подписки текущего потребителя;
457
- * pending-значение фиксируется так же, как при обычном чтении.
458
- * @internal
459
- */
460
- _peekSignalNode<T>(node: ReactiveNode<T>): T;
461
- /**
462
- * Возвращает значение, которое увидит следующее чтение: pending-значение
463
- * незавершённой группировки либо зафиксированное. Ничего не фиксирует.
464
- * @internal
465
- */
466
- _visibleSignalValue<T>(node: ReactiveNode<T>): T;
467
- /**
468
- * Записывает значение материализованного signal с обычной семантикой batch.
469
- * @internal
470
- */
471
- _writeSignalNode<T>(node: ReactiveNode<T>, value: T): void;
472
- /**
473
- * Сообщает, есть ли у материализованного signal потребители в графе.
474
- * @internal
475
- */
476
- _signalNodeHasSubscribers(node: ReactiveNode): boolean;
477
- /**
478
- * Отсоединяет материализованный signal от потребителей и освобождает его
479
- * значения. Значения освобождаются и при сбое отсоединения. Поля pending
480
- * сбрасываются, только если запись их получала: запись без группировок не
481
- * меняет набор своих полей при освобождении.
482
- * @internal
483
- */
484
- _releaseSignalNode(node: ReactiveNode): void;
485
- /**
486
- * Ищет среди текущих потребителей записи первого, чьего владельца принимает
487
- * accept, и возвращает этого владельца. Владелец потребителя определяется
488
- * так же, как при привязке ребра через onDependency: у computed это
489
- * dependencyOwner его source hooks, у эффекта — dependencyOwner его задачи.
490
- * Потребители без владельца пропускаются. Обход идёт в порядке списка
491
- * потребителей, ничего не выделяет и не меняет граф; accept не должен менять
492
- * связи этой записи.
493
- * @param node Материализованная запись производителя.
494
- * @param accept Проверка владельца потребителя; context передаётся ей без closure.
495
- * @param context Произвольное значение вызывающего слоя для accept.
496
- * @internal
497
- */
498
- _findSubscriberOwner<Context>(node: ReactiveNode, accept: (owner: object, context: Context) => boolean, context: Context): object | undefined;
499
- /**
500
- * Возвращает владельца активного потребителя: того, кому engine привязал бы
501
- * ребро следующего отслеживаемого чтения. Владелец определяется так же, как
502
- * в _findSubscriberOwner(). Без активного потребителя и у потребителя без
503
- * владельца результат undefined. Метод ничего не выделяет и не меняет граф.
504
- *
505
- * Вызывающий слой проверяет по этому владельцу допустимость чтения, когда
506
- * его собственный контекст снят, а потребитель engine остался активным.
507
- * @internal
508
- */
509
- _activeSubscriberOwner(): object | undefined;
510
- /**
511
- * Увеличивает счётчик материализованного signal и уведомляет его
512
- * потребителей. Без потребителей ничего не пишет и возвращает false.
513
- *
514
- * Сдвиг — обычная запись signal. Вне группировки она прямая: счётчик
515
- * фиксируется сразу, а потребитель становится обязательным к пересчёту, в
516
- * том числе тот, кто ждал только проверки зависимостей или стоит на стеке
517
- * идущей проверки. Внутри группировки и у записи с ещё не прочитанным
518
- * отложенным сдвигом запись откладывается до первого чтения, как любая запись
519
- * внутри batch().
520
- *
521
- * Потребитель, который выполняется в момент прямого сдвига, получает его по
522
- * общему правилу записи во время запуска: у записи не остаётся отложенного
523
- * сдвига, который позже подтвердил бы ему изменение.
524
- *
525
- * Очередь эффектов обрабатывается на выходе, если группировки нет: отложенная
526
- * запись сама её не обрабатывает, а потребитель, которого она поставила в
527
- * очередь, не должен ждать следующей записи.
528
- * @internal
529
- */
530
- _bumpSignalNode(node: ReactiveNode<number>): boolean;
531
- /**
532
- * Создаёт запись-счётчик для активного потребителя и связывает их; без
533
- * потребителя возвращает undefined. Счётчик начинается с нуля и сдвигается
534
- * через _bumpSignalNode().
535
- *
536
- * Счётчик — производитель без собственных зависимостей. Граф читает у него
537
- * то же, что у записи signal в роли производителя: признаки, список
538
- * потребителей, отсутствие getter, значение и source hooks. Полей списка
539
- * зависимостей у записи нет, а hooks лежат в ней самой: счётчик стоит одной
540
- * аллокации из шести полей, а запись signal с hooks — двух. Поля отложенной
541
- * записи появляются у счётчика с первым сдвигом.
542
- * @internal
543
- */
544
- _trackCounterNode(sourceHooks: OwnedSourceHooks): ReactiveNode<number> | undefined;
545
- /**
546
- * Возвращает постоянную задачу активного потребителя. Engine делает запись
547
- * эффекта активным потребителем непосредственно перед вызовом её тела,
548
- * поэтому первое обращение из тела возвращает задачу именно этого эффекта,
549
- * какие бы доставки ни выполнил cleanup его прошлого запуска.
550
- *
551
- * Без активного потребителя и у потребителя без задачи — computed либо
552
- * эффекта, созданного без внешнего планирования, — результат undefined.
553
- * Метод ничего не выделяет и не меняет граф.
554
- * @internal
555
- */
556
- _activeEffectTask(): EffectTask | undefined;
557
13
  }
558
14
  export declare const signal: RaphReactivity['signal'];
559
15
  export declare const reactive: RaphReactivity['reactive'];