@raphy-js/raph 1.0.1-dev.25 → 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.
- package/README.md +100 -0
- package/dist/api/Raph.d.ts +15 -15
- package/dist/api/RaphFacadeSession.d.ts +4 -4
- package/dist/api/RaphReactivityInstance.d.ts +4 -4
- package/dist/api/types.d.ts +11 -11
- package/dist/compact.cjs +1 -0
- package/dist/compact.js +4 -0
- package/dist/debug/reactivity/engine-core.cjs +1 -0
- package/dist/debug/reactivity/engine-core.js +1760 -0
- package/dist/debug/reactivity/engine.cjs +1 -1
- package/dist/debug/reactivity/engine.js +25 -1689
- package/dist/debug/reactivity/reactive-object.cjs +1 -1
- package/dist/debug/reactivity/reactive-object.js +604 -167
- package/dist/debug/runtime/RaphCompactExecutionRuntime.cjs +1 -0
- package/dist/debug/runtime/RaphCompactExecutionRuntime.js +9 -0
- package/dist/debug/runtime/RaphExecutionRuntime.cjs +1 -0
- package/dist/debug/runtime/RaphExecutionRuntime.js +11 -0
- package/dist/debug/runtime/RaphRuntime.cjs +1 -1
- package/dist/debug/runtime/RaphRuntime.js +115 -1176
- package/dist/debug/runtime/RaphRuntimeBase.cjs +1 -0
- package/dist/debug/runtime/RaphRuntimeBase.js +941 -0
- package/dist/debug/runtime/diagnostics/RaphDebug.cjs +1 -1
- package/dist/debug/runtime/diagnostics/RaphDebug.js +72 -66
- package/dist/debug/runtime/ownership/RaphNode.cjs +1 -1
- package/dist/debug/runtime/ownership/RaphNode.js +11 -0
- package/dist/debug/runtime/ownership/RaphScope.cjs +1 -1
- package/dist/debug/runtime/ownership/RaphScope.js +12 -12
- package/dist/debug/runtime/phases/RaphPhasePipeline.cjs +1 -1
- package/dist/debug/runtime/phases/RaphPhasePipeline.js +361 -242
- package/dist/debug/runtime/phases/RaphPhaseTaskRecord.cjs +1 -1
- package/dist/debug/runtime/phases/RaphPhaseTaskRecord.js +23 -22
- package/dist/debug/runtime/reactivity/RaphSelector.cjs +1 -1
- package/dist/debug/runtime/reactivity/RaphSelector.js +111 -90
- package/dist/debug/runtime/reactivity/RuntimeObjectSupport.cjs +1 -0
- package/dist/debug/runtime/reactivity/RuntimeObjectSupport.js +11 -0
- package/dist/debug/runtime/reactivity/RuntimeReactivity.cjs +1 -1
- package/dist/debug/runtime/reactivity/RuntimeReactivity.js +118 -103
- package/dist/debug/runtime/reactivity/RuntimeSelectorSupport.cjs +1 -0
- package/dist/debug/runtime/reactivity/RuntimeSelectorSupport.js +12 -0
- package/dist/entrypoints/compact.d.ts +2 -0
- package/dist/entrypoints/execution.d.ts +2 -0
- package/dist/entrypoints/machine-testing.d.ts +2 -2
- package/dist/entrypoints/machine.d.ts +5 -5
- package/dist/entrypoints/observable.d.ts +4 -0
- package/dist/entrypoints/path.d.ts +14 -14
- package/dist/entrypoints/reactivity.d.ts +1 -1
- package/dist/entrypoints/runtime.d.ts +19 -18
- package/dist/execution.cjs +1 -0
- package/dist/execution.js +4 -0
- package/dist/index.cjs +1 -1
- package/dist/index.js +23 -21
- package/dist/machine/compiler.d.ts +1 -1
- package/dist/machine/core.d.ts +2 -2
- package/dist/machine/persistence.d.ts +1 -1
- package/dist/machine/runtime.d.ts +3 -3
- package/dist/machine/testing.d.ts +1 -1
- package/dist/machine/types.d.ts +3 -3
- package/dist/main.d.ts +19 -19
- package/dist/observable/buffer.d.ts +6 -0
- package/dist/observable/class-admin.d.ts +63 -0
- package/dist/observable/class-plan.d.ts +46 -0
- package/dist/observable/classes.d.ts +10 -0
- package/dist/observable/context.d.ts +73 -0
- package/dist/observable/native.d.ts +2 -0
- package/dist/observable/observable.d.ts +13 -0
- package/dist/observable/types.d.ts +60 -0
- package/dist/observable.cjs +1 -0
- package/dist/observable.js +1187 -0
- package/dist/path/DataPath.d.ts +2 -2
- package/dist/path/PathRouter.d.ts +1 -1
- package/dist/path/RaphKernel.d.ts +6 -6
- package/dist/path/data-path.types.d.ts +1 -1
- package/dist/path/data-path.utils.d.ts +2 -2
- package/dist/path/derived/DerivedRegistry.d.ts +3 -3
- package/dist/path/derived/RaphDerivedHandle.d.ts +3 -3
- package/dist/path/derived/derived-collection.types.d.ts +1 -1
- package/dist/path/derived/derived-collection.utils.d.ts +3 -3
- package/dist/path/derived/derived-strategy.utils.d.ts +1 -1
- package/dist/path/meta/MetaController.d.ts +5 -5
- package/dist/path/meta/RaphMeta.d.ts +3 -3
- package/dist/path/meta/RaphMetaStore.d.ts +1 -1
- package/dist/path/meta/meta.types.d.ts +2 -2
- package/dist/path/path.types.d.ts +2 -2
- package/dist/path/pathSegmentKey.d.ts +1 -1
- package/dist/path/storage/AdapterPathStore.d.ts +2 -2
- package/dist/path/storage/DefaultDataAdapter.d.ts +2 -2
- package/dist/path/storage/PathEventHub.d.ts +1 -1
- package/dist/path/storage/PathStore.d.ts +2 -2
- package/dist/path/storage/data-adapter.types.d.ts +1 -1
- package/dist/raph.cjs +1 -1
- package/dist/raph.js +23 -21
- package/dist/reactivity/engine-core.d.ts +600 -0
- package/dist/reactivity/engine.d.ts +6 -550
- package/dist/reactivity/reactive-object.d.ts +143 -2
- package/dist/reactivity/scope.d.ts +7 -6
- package/dist/reactivity/types.d.ts +9 -12
- package/dist/reactivity/watch.d.ts +1 -1
- package/dist/runtime/RaphCompactExecutionRuntime.d.ts +7 -0
- package/dist/runtime/RaphExecutionRuntime.d.ts +6 -0
- package/dist/runtime/RaphRuntime.d.ts +19 -403
- package/dist/runtime/RaphRuntimeBase.d.ts +194 -0
- package/dist/runtime/diagnostics/RaphDebug.d.ts +8 -5
- package/dist/runtime/errors.d.ts +1 -1
- package/dist/runtime/ownership/RaphEffectScope.d.ts +13 -12
- package/dist/runtime/ownership/RaphNode.d.ts +28 -21
- package/dist/runtime/ownership/RaphScope.d.ts +32 -19
- package/dist/runtime/ownership/parent-graph.types.d.ts +1 -1
- package/dist/runtime/ownership/parentGraph.d.ts +2 -2
- package/dist/runtime/phases/RaphFrameLoop.d.ts +1 -1
- package/dist/runtime/phases/RaphPhasePipeline.d.ts +80 -29
- package/dist/runtime/phases/RaphPhaseTaskRecord.d.ts +21 -21
- package/dist/runtime/phases/RaphPhaseWatch.d.ts +3 -3
- package/dist/runtime/phases/orderPhaseTasks.d.ts +4 -2
- package/dist/runtime/phases/phase.types.d.ts +36 -35
- package/dist/runtime/reactivity/PathHandle.d.ts +5 -5
- package/dist/runtime/reactivity/RaphMetaSource.d.ts +7 -7
- package/dist/runtime/reactivity/RaphSelector.d.ts +27 -6
- package/dist/runtime/reactivity/RaphWorkGraph.d.ts +40 -39
- package/dist/runtime/reactivity/RuntimeObjectSupport.d.ts +9 -0
- package/dist/runtime/reactivity/RuntimeReactivity.d.ts +27 -19
- package/dist/runtime/reactivity/RuntimeSelectorSupport.d.ts +10 -0
- package/dist/runtime/reactivity/RuntimeWatch.d.ts +1 -1
- package/dist/runtime/reactivity/disposal-sweep.utils.d.ts +1 -1
- package/dist/runtime/reactivity/runtime-reactivity.types.d.ts +3 -3
- package/dist/runtime.cjs +1 -1
- package/dist/runtime.js +13 -11
- package/package.json +22 -62
|
@@ -1,559 +1,15 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
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'];
|