@raphy-js/dom 0.0.0-stage → 1.0.0-dev.88
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/LICENSE +202 -0
- package/README.md +187 -2
- package/dist/DOMBlueprintMaterializer-C-icNhvm.cjs +1 -0
- package/dist/DOMBlueprintMaterializer-CxzM_TX5.js +201 -0
- package/dist/FullDOMOperations-BOlf0_0L.js +2781 -0
- package/dist/FullDOMOperations-Dschwj33.cjs +1 -0
- package/dist/api/renderer.d.ts +12 -0
- package/dist/applicationIdentity-CHbuUlsE.cjs +1 -0
- package/dist/applicationIdentity-DjVgpsQq.js +11 -0
- package/dist/bind-BEmkQdaL.cjs +1 -0
- package/dist/bind-OakIMWpC.js +52 -0
- package/dist/binding/DOMValueWriter.d.ts +59 -0
- package/dist/binding/materializeComponentProps.d.ts +38 -0
- package/dist/binding/mountDOMBinding.d.ts +9 -0
- package/dist/binding/mountDOMProps.d.ts +22 -0
- package/dist/capture.cjs +1 -0
- package/dist/capture.d.ts +7 -0
- package/dist/capture.js +166 -0
- package/dist/channels-Bs8GHVWn.cjs +1 -0
- package/dist/channels-DqAQt-NH.js +33 -0
- package/dist/compact/hydration.cjs +1 -0
- package/dist/compact/hydration.d.ts +9 -0
- package/dist/compact/hydration.js +12 -0
- package/dist/compact/index.d.ts +19 -0
- package/dist/compact/targetRuntime.d.ts +1 -0
- package/dist/compact.cjs +1 -0
- package/dist/compact.js +34 -0
- package/dist/contracts/freezeGeneratedContract.d.ts +5 -0
- package/dist/contracts/manifest.json +25 -0
- package/dist/contracts/node.cjs +1 -0
- package/dist/contracts/node.contract.json +36889 -0
- package/dist/contracts/node.d.ts +6 -0
- package/dist/contracts/node.js +19 -0
- package/dist/contracts/stylesheet.cjs +1 -0
- package/dist/contracts/stylesheet.contract.json +11887 -0
- package/dist/contracts/stylesheet.d.ts +6 -0
- package/dist/contracts/stylesheet.js +22 -0
- package/dist/createDOMDataEventInput-B82pnIav.cjs +1 -0
- package/dist/createDOMDataEventInput-BDX50jhu.js +3010 -0
- package/dist/createDOMNodeRuntime-BHcsbeO1.cjs +1 -0
- package/dist/createDOMNodeRuntime-DIKOUQP7.js +3006 -0
- package/dist/createHydrationRenderer-C7srF-66.js +289 -0
- package/dist/createHydrationRenderer-DKybWTj4.cjs +1 -0
- package/dist/elementRef-D8Ir8tXA.cjs +1 -0
- package/dist/elementRef-YPBBElV9.js +32 -0
- package/dist/event/DOMEventHub.d.ts +303 -0
- package/dist/freezeGeneratedContract-0EZt85o4.js +10 -0
- package/dist/freezeGeneratedContract-g_Op1hGY.cjs +1 -0
- package/dist/hydration/HydrationEvents.d.ts +20 -0
- package/dist/hydration/HydrationSession.d.ts +107 -0
- package/dist/hydration/HydrationStream.d.ts +30 -0
- package/dist/hydration/activateHydration.d.ts +2 -0
- package/dist/hydration/createHydrationRenderer.d.ts +25 -0
- package/dist/hydration/index.d.ts +8 -0
- package/dist/hydration.cjs +1 -0
- package/dist/hydration.js +12 -0
- package/dist/index.cjs +1 -0
- package/dist/index.d.ts +22 -0
- package/dist/index.js +24 -0
- package/dist/interaction/clipboard.d.ts +2 -0
- package/dist/interaction/contextAction.d.ts +3 -0
- package/dist/interaction/contracts/node.cjs +1 -0
- package/dist/interaction/contracts/node.d.ts +15 -0
- package/dist/interaction/contracts/node.js +60 -0
- package/dist/interaction/dragDrop.d.ts +13 -0
- package/dist/interaction/focus.d.ts +4 -0
- package/dist/interaction/geometry.d.ts +39 -0
- package/dist/interaction/hover.d.ts +4 -0
- package/dist/interaction/index.d.ts +2 -0
- package/dist/interaction/interaction.d.ts +4 -0
- package/dist/interaction/internal/DOMInputModality.d.ts +20 -0
- package/dist/interaction/internal/DOMInteraction.types.d.ts +29 -0
- package/dist/interaction/internal/applicationIdentity.d.ts +3 -0
- package/dist/interaction/internal/dragDataTransfer.d.ts +4 -0
- package/dist/interaction/internal/solvePosition.d.ts +5 -0
- package/dist/interaction/keyboard.d.ts +3 -0
- package/dist/interaction/move.d.ts +3 -0
- package/dist/interaction/nativeDragDrop.d.ts +18 -0
- package/dist/interaction/outside.d.ts +3 -0
- package/dist/interaction/press.d.ts +3 -0
- package/dist/interaction/profile.cjs +1 -0
- package/dist/interaction/profile.d.ts +2 -0
- package/dist/interaction/profile.js +48 -0
- package/dist/interaction/rovingFocus.d.ts +4 -0
- package/dist/interaction/runtime.d.ts +7 -0
- package/dist/interaction/textEditing.d.ts +4 -0
- package/dist/interaction.cjs +1 -0
- package/dist/interaction.js +1603 -0
- package/dist/internal/dev.d.ts +20 -0
- package/dist/motion/channels.d.ts +5 -0
- package/dist/motion/index.d.ts +8 -0
- package/dist/motion-scroll/index.d.ts +19 -0
- package/dist/motion-scroll.cjs +1 -0
- package/dist/motion-scroll.js +169 -0
- package/dist/motion.cjs +1 -0
- package/dist/motion.js +187 -0
- package/dist/operations.cjs +1 -0
- package/dist/operations.d.ts +3 -0
- package/dist/operations.js +10 -0
- package/dist/profile/DOMProfile.d.ts +4 -0
- package/dist/profile/index.d.ts +1 -0
- package/dist/profile.cjs +1 -0
- package/dist/profile.js +23 -0
- package/dist/renderer/DOMEffectScope.d.ts +13 -0
- package/dist/renderer/DOMPresentation.d.ts +8 -0
- package/dist/renderer/DOMRenderer.d.ts +35 -0
- package/dist/renderer/DOMRenderer.types.d.ts +12 -0
- package/dist/renderer/DOMRendererExtension.types.d.ts +33 -0
- package/dist/renderer/DOMRuntimeProfile.d.ts +15 -0
- package/dist/renderer/DOMTargetRuntime.d.ts +1 -0
- package/dist/renderer/createDOMTargetRuntime.d.ts +3 -0
- package/dist/renderer/installAuxiliaryViews.d.ts +8 -0
- package/dist/renderer/installDOMRendererExtensions.d.ts +10 -0
- package/dist/renderer/resolveDOMMountTarget.d.ts +7 -0
- package/dist/renderer-4Wbid5nE.js +30 -0
- package/dist/renderer-DHK3lLG-.cjs +1 -0
- package/dist/resolveDOMMountTarget-C75JWc5x.cjs +1 -0
- package/dist/resolveDOMMountTarget-D944H05N.js +19 -0
- package/dist/runtime.cjs +1 -0
- package/dist/runtime.d.ts +21 -0
- package/dist/runtime.js +25 -0
- package/dist/serialization.cjs +1 -0
- package/dist/serialization.d.ts +4 -0
- package/dist/serialization.js +118 -0
- package/dist/stylesheet/DOMStyleManager.d.ts +95 -0
- package/dist/stylesheet/DOMStyleReferenceName.d.ts +2 -0
- package/dist/stylesheet/DOMStylesheetRuntime.d.ts +25 -0
- package/dist/stylesheet/acquireInstanceStylesheets.d.ts +4 -0
- package/dist/stylesheet/scopeDOMSelector.d.ts +2 -0
- package/dist/stylesheet/serializeDOMStyleValue.d.ts +3 -0
- package/dist/targetRuntime-C67QmOgE.cjs +1 -0
- package/dist/targetRuntime-C_OdmS5w.js +5 -0
- package/dist/template/AdvancedDOMMaterializer.d.ts +14 -0
- package/dist/template/AsyncDOMMaterializer.d.ts +4 -0
- package/dist/template/BoundaryDOMMaterializer.d.ts +10 -0
- package/dist/template/DOMHostPlan.d.ts +4 -0
- package/dist/template/DOMNode.types.d.ts +192 -0
- package/dist/template/DOMNodeRuntime.d.ts +1 -0
- package/dist/template/binding/DOMBinding.types.d.ts +44 -0
- package/dist/template/binding/bind.d.ts +16 -0
- package/dist/template/blueprint/DOMBlueprintAddressing.d.ts +23 -0
- package/dist/template/blueprint/DOMBlueprintMaterializer.d.ts +3 -0
- package/dist/template/blueprint/DOMBlueprintMaterializer.types.d.ts +15 -0
- package/dist/template/blueprint/DOMHostBlueprint.d.ts +102 -0
- package/dist/template/blueprint/DOMHostBlueprintCache.d.ts +86 -0
- package/dist/template/blueprint/createDOMDataEventInput.d.ts +5 -0
- package/dist/template/blueprint/mountDOMHostBlueprint.d.ts +45 -0
- package/dist/template/createDOMNodeRuntime.d.ts +3 -0
- package/dist/template/each/mountEach.d.ts +5 -0
- package/dist/template/each/mountPureEach.d.ts +22 -0
- package/dist/template/error/DOMInvocation.d.ts +58 -0
- package/dist/template/error/DOMOperationError.d.ts +25 -0
- package/dist/template/html/DOMRawHtmlNode.types.d.ts +21 -0
- package/dist/template/html/rawHtml.d.ts +5 -0
- package/dist/template/keep-alive/DOMKeepAliveNode.types.d.ts +10 -0
- package/dist/template/keep-alive/keepAlive.d.ts +4 -0
- package/dist/template/mount/DOMMountTransaction.d.ts +63 -0
- package/dist/template/mountNode.d.ts +173 -0
- package/dist/template/normalizeChildren.d.ts +5 -0
- package/dist/template/operations/DOMOperations.d.ts +56 -0
- package/dist/template/operations/FullDOMOperations.d.ts +6 -0
- package/dist/template/page/DOMHead.d.ts +7 -0
- package/dist/template/page/PageNodePlan.d.ts +31 -0
- package/dist/template/ref/DOMElementRef.types.d.ts +7 -0
- package/dist/template/ref/componentRefGuard.d.ts +6 -0
- package/dist/template/ref/elementRef.d.ts +9 -0
- package/dist/template/structural/range/DOMRange.d.ts +145 -0
- package/dist/template/teleport/DOMTeleportNode.types.d.ts +8 -0
- package/dist/template/teleport/teleport.d.ts +4 -0
- package/dist/template/transition/DOMTransitionCoordinator.d.ts +32 -0
- package/dist/template/transition/DOMTransitionNode.types.d.ts +30 -0
- package/dist/template/transition/transition.d.ts +4 -0
- package/dist/template/value/DOMValueDescriptor.types.d.ts +34 -0
- package/dist/template/value/valueDescriptors.d.ts +13 -0
- package/package.json +157 -4
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { Signal } from '@raphy-js/core';
|
|
2
|
+
export declare const domBindingBrand: unique symbol;
|
|
3
|
+
declare const domBindingType: unique symbol;
|
|
4
|
+
/** Native event, после которого text-like binding подтверждает новое значение. */
|
|
5
|
+
export type DOMBindingEvent = 'change' | 'input';
|
|
6
|
+
/** Режим runtime-стратегии одного native DOM binding. */
|
|
7
|
+
export type DOMBindingMode = 'auto' | 'multiple' | 'number' | 'option';
|
|
8
|
+
/** Настройки строкового `value` binding. */
|
|
9
|
+
export interface DOMTextBindingOptions {
|
|
10
|
+
readonly event?: DOMBindingEvent;
|
|
11
|
+
readonly trim?: boolean;
|
|
12
|
+
}
|
|
13
|
+
/** Явно преобразует `input.value` в `number | null`. */
|
|
14
|
+
export interface DOMNumberBindingOptions {
|
|
15
|
+
readonly as: 'number';
|
|
16
|
+
readonly event?: DOMBindingEvent;
|
|
17
|
+
}
|
|
18
|
+
/** Связывает один radio control с конкретным значением общего signal. */
|
|
19
|
+
export interface DOMOptionBindingOptions<Value> {
|
|
20
|
+
readonly option: Value;
|
|
21
|
+
}
|
|
22
|
+
/** Связывает multiple select с immutable списком выбранных значений. */
|
|
23
|
+
export interface DOMMultipleBindingOptions {
|
|
24
|
+
readonly multiple: true;
|
|
25
|
+
}
|
|
26
|
+
/** Все поддерживаемые конфигурации native DOM binding. */
|
|
27
|
+
export type DOMBindingOptions<Value = unknown> = DOMMultipleBindingOptions | DOMNumberBindingOptions | DOMOptionBindingOptions<Value> | DOMTextBindingOptions;
|
|
28
|
+
/**
|
|
29
|
+
* Immutable descriptor двусторонней связи writable signal и native DOM control.
|
|
30
|
+
*
|
|
31
|
+
* Generic `Value` сохраняется только для проверки H-contract и не переносит
|
|
32
|
+
* ownership signal в renderer.
|
|
33
|
+
*/
|
|
34
|
+
export interface DOMBinding<Value, Mode extends DOMBindingMode = DOMBindingMode> {
|
|
35
|
+
readonly [domBindingBrand]: true;
|
|
36
|
+
readonly [domBindingType]?: Value;
|
|
37
|
+
readonly mode: Mode;
|
|
38
|
+
}
|
|
39
|
+
/** Внутренний renderer contract descriptor, созданного `bind()`. */
|
|
40
|
+
export interface DOMBindingDescriptor<Value = unknown> extends DOMBinding<Value> {
|
|
41
|
+
readonly options: Readonly<Record<string, unknown>>;
|
|
42
|
+
readonly source: Signal<Value>;
|
|
43
|
+
}
|
|
44
|
+
export {};
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { Signal } from '@raphy-js/core';
|
|
2
|
+
import { DOMBinding, DOMBindingDescriptor, DOMMultipleBindingOptions, DOMNumberBindingOptions, DOMOptionBindingOptions, DOMTextBindingOptions } from './DOMBinding.types.js';
|
|
3
|
+
/** Связывает строковый signal с text-like value либо boolean signal с checked. */
|
|
4
|
+
export declare function bind(source: Signal<string>, options?: DOMTextBindingOptions): DOMBinding<string, 'auto'>;
|
|
5
|
+
/** Связывает boolean signal с checkbox checked property. */
|
|
6
|
+
export declare function bind(source: Signal<boolean>): DOMBinding<boolean, 'auto'>;
|
|
7
|
+
/** Связывает number signal с явным number conversion native input. */
|
|
8
|
+
export declare function bind(source: Signal<number>, options: DOMNumberBindingOptions): DOMBinding<number, 'number'>;
|
|
9
|
+
/** Связывает nullable number signal с явным number conversion native input. */
|
|
10
|
+
export declare function bind(source: Signal<number | null>, options: DOMNumberBindingOptions): DOMBinding<number | null, 'number'>;
|
|
11
|
+
/** Связывает одно значение общего signal с radio checked property. */
|
|
12
|
+
export declare function bind<Value>(source: Signal<Value>, options: DOMOptionBindingOptions<NoInfer<Value>>): DOMBinding<Value, 'option'>;
|
|
13
|
+
/** Связывает multiple select с immutable списком выбранных option values. */
|
|
14
|
+
export declare function bind(source: Signal<readonly string[]>, options: DOMMultipleBindingOptions): DOMBinding<readonly string[], 'multiple'>;
|
|
15
|
+
/** Отличает DOM binding descriptor от произвольного пользовательского объекта. */
|
|
16
|
+
export declare function isDOMBinding(value: unknown): value is DOMBindingDescriptor;
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
export declare const DOM_BLUEPRINT_ROOT = 0;
|
|
2
|
+
export declare const DOM_BLUEPRINT_FIRST_CHILD = 1;
|
|
3
|
+
export declare const DOM_BLUEPRINT_NEXT_SIBLING = 2;
|
|
4
|
+
export declare const DOM_BLUEPRINT_PARENT = 3;
|
|
5
|
+
export declare const DOM_BLUEPRINT_SAVE_1 = 4;
|
|
6
|
+
export declare const DOM_BLUEPRINT_LOAD_1 = 5;
|
|
7
|
+
export declare const DOM_BLUEPRINT_SAVE_2 = 6;
|
|
8
|
+
export declare const DOM_BLUEPRINT_LOAD_2 = 7;
|
|
9
|
+
/** Шаги адресации всех записей программы и граница шагов каждой записи. */
|
|
10
|
+
export interface DOMBlueprintSteps {
|
|
11
|
+
readonly steps: number[];
|
|
12
|
+
readonly stepEnds: number[];
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Строит шаги адресации для записей, заданных путями из индексов children.
|
|
16
|
+
*
|
|
17
|
+
* Пути идут в порядке обхода формы в глубину. Шаги записи начинаются от node
|
|
18
|
+
* предыдущей записи, от корня клона либо от запомненного предка: выбирается
|
|
19
|
+
* начало с наименьшим числом обращений к DOM. Предок запоминается, только
|
|
20
|
+
* когда от него начинается путь к одной из следующих записей, поэтому переход
|
|
21
|
+
* к соседнему поддереву не поднимается через `parentNode`.
|
|
22
|
+
*/
|
|
23
|
+
export declare function compileDOMBlueprintSteps(paths: readonly (readonly number[])[]): DOMBlueprintSteps;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { HostBlueprintDefinition } from '@raphy-js/core';
|
|
2
|
+
import { DOMEventHub } from '../../event/DOMEventHub.js';
|
|
3
|
+
import { DOM_BLUEPRINT_MOUNT_HOST, MountContext } from '../mountNode.js';
|
|
4
|
+
import { DOMHostBlueprintNodePlan } from './DOMHostBlueprint.js';
|
|
5
|
+
import { PreparedDOMHostBlueprint } from './DOMHostBlueprintCache.js';
|
|
6
|
+
/** Один optional fast path; cache принадлежит создавшему renderer. */
|
|
7
|
+
export interface DOMBlueprintMaterializer {
|
|
8
|
+
readonly materialize: <Props, State, Slots extends object>(plan: DOMHostBlueprintNodePlan, context: MountContext<Props, State, Slots>, host: typeof DOM_BLUEPRINT_MOUNT_HOST) => Element;
|
|
9
|
+
/** Подготовленная форма definition со slots; `undefined` у definition без slots. */
|
|
10
|
+
readonly prepare: (definition: HostBlueprintDefinition, styleScopeId: string | undefined) => PreparedDOMHostBlueprint | undefined;
|
|
11
|
+
readonly dispose: () => void;
|
|
12
|
+
}
|
|
13
|
+
export interface DOMBlueprintMaterializerFactory {
|
|
14
|
+
readonly create: (document: Document, events: DOMEventHub, applicationScopeId: string) => DOMBlueprintMaterializer;
|
|
15
|
+
}
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
import { HostBlueprintDefinition, TextNodePlan } from '@raphy-js/core';
|
|
2
|
+
import { DOMElementNodePlan } from '../DOMNode.types.js';
|
|
3
|
+
export { createDOMDataEventInput } from './createDOMDataEventInput.js';
|
|
4
|
+
export type { DOMDataListenerDescriptor } from './createDOMDataEventInput.js';
|
|
5
|
+
/** Один renderer-specific plan, создаваемый Core facade без DOM allocation. */
|
|
6
|
+
export interface DOMHostBlueprintNodePlan {
|
|
7
|
+
readonly kind: 'host-blueprint';
|
|
8
|
+
readonly definition: HostBlueprintDefinition;
|
|
9
|
+
readonly values: readonly unknown[];
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Хранит результат единственной проверки одной definition: допускает ли её
|
|
13
|
+
* форма cloneNode и какие slots какого вида она читает.
|
|
14
|
+
*
|
|
15
|
+
* Запись не содержит DOM и не зависит от renderer instance: prototypes и
|
|
16
|
+
* программа адресации принадлежат `DOMHostBlueprintCache` каждого renderer.
|
|
17
|
+
*/
|
|
18
|
+
export declare class DOMBlueprintShape {
|
|
19
|
+
readonly definition: HostBlueprintDefinition;
|
|
20
|
+
readonly supported: boolean;
|
|
21
|
+
readonly slots: readonly number[];
|
|
22
|
+
readonly kinds: readonly number[];
|
|
23
|
+
/**
|
|
24
|
+
* Назначает все поля в одном порядке.
|
|
25
|
+
*/
|
|
26
|
+
constructor(definition: HostBlueprintDefinition, supported: boolean, slots: readonly number[], kinds: readonly number[]);
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Один экземпляр blueprint: plan, который `hostBlueprint()` создаёт на каждую
|
|
30
|
+
* строку и который materializer превращает в клон prototype.
|
|
31
|
+
*
|
|
32
|
+
* Engine удерживает форму экземпляров только через живые экземпляры. Plan
|
|
33
|
+
* живёт от render до mount, поэтому между операциями живых экземпляров нет:
|
|
34
|
+
* полная сборка мусора освобождает форму вместе с feedback кода, который её
|
|
35
|
+
* читает. Class владеет одним постоянным экземпляром `_shapeAnchor`.
|
|
36
|
+
*/
|
|
37
|
+
export declare class DOMBlueprintInstance implements DOMHostBlueprintNodePlan {
|
|
38
|
+
static _shapeAnchor: DOMBlueprintInstance;
|
|
39
|
+
readonly definition: HostBlueprintDefinition;
|
|
40
|
+
readonly kind: 'host-blueprint';
|
|
41
|
+
readonly values: readonly unknown[];
|
|
42
|
+
/**
|
|
43
|
+
* Назначает все поля в одном порядке, чтобы экземпляры разделяли одну форму объекта.
|
|
44
|
+
*/
|
|
45
|
+
constructor(definition: HostBlueprintDefinition, values: readonly unknown[]);
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Возвращает результат проверки definition, выполняя проверку при первом обращении.
|
|
49
|
+
*
|
|
50
|
+
* Проверка формы выполняется один раз на definition: `defineHostBlueprint()`
|
|
51
|
+
* отдаёт глубоко замороженную форму, и результат не может устареть.
|
|
52
|
+
*/
|
|
53
|
+
export declare function resolveDOMBlueprintShape(definition: HostBlueprintDefinition): DOMBlueprintShape;
|
|
54
|
+
/**
|
|
55
|
+
* Забывает запись последней проверенной definition.
|
|
56
|
+
*
|
|
57
|
+
* Запись хранится на весь module и удерживает definition последней строки,
|
|
58
|
+
* даже когда ни один renderer её больше не монтирует. Renderer вызывает
|
|
59
|
+
* функцию при освобождении: результат проверки остаётся в WeakMap, пока жива
|
|
60
|
+
* сама definition, и следующий экземпляр находит его одним lookup.
|
|
61
|
+
*/
|
|
62
|
+
export declare function forgetLastDOMBlueprintShape(): void;
|
|
63
|
+
/**
|
|
64
|
+
* Сверяет значения одной строки с вектором видов slots проверенной формы.
|
|
65
|
+
*
|
|
66
|
+
* Это вся проверка, которую production выполняет на строку: форма проверена
|
|
67
|
+
* при первом обращении к definition. Slot с объявленным mode сверяется одним
|
|
68
|
+
* typeof: значение не осматривается как wrapper. Slot без mode осматривается
|
|
69
|
+
* так же, как его осматривает node().
|
|
70
|
+
*/
|
|
71
|
+
export declare function acceptsDOMBlueprintValues(shape: DOMBlueprintShape, values: readonly unknown[]): boolean;
|
|
72
|
+
/**
|
|
73
|
+
* Создаёт plan экземпляра либо возвращает undefined, когда форма или значения
|
|
74
|
+
* не доказывают эквивалентность cloneNode обычному node(): тогда Core
|
|
75
|
+
* повторяет blueprint через createHostNode.
|
|
76
|
+
*/
|
|
77
|
+
export declare function createDOMBlueprintInstance(definition: HostBlueprintDefinition, values: readonly unknown[]): DOMBlueprintInstance | undefined;
|
|
78
|
+
/**
|
|
79
|
+
* Полная проверка формы и значений без сохранённого результата: отсеивает то,
|
|
80
|
+
* для чего cloneNode не доказывает semantics node().
|
|
81
|
+
*
|
|
82
|
+
* Production выполняет её часть о форме один раз на definition, а на строку
|
|
83
|
+
* сверяет только вектор видов slots; development повторяет её целиком. Правило
|
|
84
|
+
* о значениях одно — `acceptsDOMBlueprintValues`; здесь оно применяется к
|
|
85
|
+
* вектору, собранному заново.
|
|
86
|
+
*/
|
|
87
|
+
export declare function supportsDOMHostBlueprint(definition: HostBlueprintDefinition, values: readonly unknown[]): boolean;
|
|
88
|
+
/**
|
|
89
|
+
* Проверяет только форму definition, без значений slots и без сохранённого
|
|
90
|
+
* результата. Renderer вызывает её перед созданием prototype.
|
|
91
|
+
*/
|
|
92
|
+
export declare function supportsDOMHostBlueprintShape(definition: HostBlueprintDefinition): boolean;
|
|
93
|
+
/**
|
|
94
|
+
* Редкий non-HTML context повторяет обычный plan/materializer path.
|
|
95
|
+
*
|
|
96
|
+
* Значение slot с объявленным mode оборачивается в то, что этот mode
|
|
97
|
+
* обозначает: `dynamic(getter)`, `text(getter)` либо `listener(handler, options)`.
|
|
98
|
+
* Slot 'data-event' становится listener descriptor, который несёт data
|
|
99
|
+
* экземпляра рядом с общим handler.
|
|
100
|
+
*/
|
|
101
|
+
export declare function replayDOMHostBlueprint(plan: DOMHostBlueprintNodePlan): DOMElementNodePlan;
|
|
102
|
+
export declare function isTextNodePlan(value: unknown): value is TextNodePlan;
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import { HostBlueprintDefinition } from '@raphy-js/core';
|
|
2
|
+
import { DOMEventHub } from '../../event/DOMEventHub.js';
|
|
3
|
+
import { DOMListenerOptions } from '../value/DOMValueDescriptor.types.js';
|
|
4
|
+
export declare const DOM_BLUEPRINT_TEXT = 0;
|
|
5
|
+
export declare const DOM_BLUEPRINT_CLASS = 1;
|
|
6
|
+
export declare const DOM_BLUEPRINT_EVENT = 2;
|
|
7
|
+
export declare const DOM_BLUEPRINT_VALUE = 3;
|
|
8
|
+
export declare const DOM_BLUEPRINT_MODE_ANY = 0;
|
|
9
|
+
export declare const DOM_BLUEPRINT_MODE_GETTER = 1;
|
|
10
|
+
export declare const DOM_BLUEPRINT_MODE_STATIC = 2;
|
|
11
|
+
/**
|
|
12
|
+
* Подготовленная форма одной definition в одном style scope: prototype для
|
|
13
|
+
* cloneNode и программа slots его клона.
|
|
14
|
+
*
|
|
15
|
+
* Программа содержит только адресацию и типизированные записи. Запись `index`
|
|
16
|
+
* достигает своего node шагами `steps` от конца предыдущей записи до
|
|
17
|
+
* `stepEnds[index]` (см. `DOMBlueprintAddressing`) и пишет значение slot
|
|
18
|
+
* `slots[index]` writer вида `kinds[index]`. `modes[index]` переносит
|
|
19
|
+
* объявленный mode slot: с ним запись не осматривает значение, а сразу
|
|
20
|
+
* связывает getter либо пишет значение. Записи идут в порядке, в котором
|
|
21
|
+
* node() монтирует inputs и children: inputs host раньше его children,
|
|
22
|
+
* children слева направо.
|
|
23
|
+
*/
|
|
24
|
+
export interface PreparedDOMHostBlueprint {
|
|
25
|
+
readonly prototype: Element;
|
|
26
|
+
readonly kinds: readonly number[];
|
|
27
|
+
readonly modes: readonly number[];
|
|
28
|
+
readonly slots: readonly number[];
|
|
29
|
+
readonly names: readonly string[];
|
|
30
|
+
readonly eventNames: readonly string[];
|
|
31
|
+
readonly options: readonly (DOMListenerOptions | undefined)[];
|
|
32
|
+
readonly dataSlots: readonly number[];
|
|
33
|
+
readonly steps: readonly number[];
|
|
34
|
+
readonly stepEnds: readonly number[];
|
|
35
|
+
readonly getters: number;
|
|
36
|
+
readonly undeclared: number;
|
|
37
|
+
}
|
|
38
|
+
/** Подготовленная DOM-форма живёт только в создавшем её renderer instance. */
|
|
39
|
+
export declare class DOMHostBlueprintCache {
|
|
40
|
+
private readonly _document;
|
|
41
|
+
private readonly _eventNames;
|
|
42
|
+
private readonly _applicationScopeId;
|
|
43
|
+
private _prepared;
|
|
44
|
+
private _lastDefinition;
|
|
45
|
+
private _lastStyleScopeId;
|
|
46
|
+
private _lastPrepared;
|
|
47
|
+
/**
|
|
48
|
+
* Создаёт пустой cache одного renderer instance.
|
|
49
|
+
*/
|
|
50
|
+
constructor(document: Document, eventNames: Pick<DOMEventHub, 'resolveEventName'>, applicationScopeId?: string);
|
|
51
|
+
/**
|
|
52
|
+
* Возвращает подготовленную форму, создавая её при первом обращении.
|
|
53
|
+
*/
|
|
54
|
+
get(definition: HostBlueprintDefinition, styleScopeId: string | undefined): PreparedDOMHostBlueprint;
|
|
55
|
+
/** Creates one literal instance directly, without retaining or cloning its DOM. */
|
|
56
|
+
materializeLiteral(definition: HostBlueprintDefinition, styleScopeId: string | undefined): Element;
|
|
57
|
+
/**
|
|
58
|
+
* Освобождает prototypes вместе с renderer, который ими владеет.
|
|
59
|
+
*
|
|
60
|
+
* Вместе с ними забывается и общая для module запись последней проверенной
|
|
61
|
+
* definition: после освобождения renderer его формы ничто не удерживает.
|
|
62
|
+
* Живой renderer держит definition и prototype последней выданной формы до
|
|
63
|
+
* следующей формы либо до собственного освобождения.
|
|
64
|
+
*/
|
|
65
|
+
dispose(): void;
|
|
66
|
+
/**
|
|
67
|
+
* Находит форму в cache renderer либо подготавливает её и запоминает как последнюю.
|
|
68
|
+
*/
|
|
69
|
+
private _resolve;
|
|
70
|
+
/**
|
|
71
|
+
* Создаёт prototype и программу slots проверенной формы и сверяет их между собой.
|
|
72
|
+
*/
|
|
73
|
+
private _prepare;
|
|
74
|
+
/**
|
|
75
|
+
* Создаёт element одного host с literal inputs и добавляет записи его slots.
|
|
76
|
+
*/
|
|
77
|
+
private _prepareHost;
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Находит node по пути из индексов children.
|
|
81
|
+
*
|
|
82
|
+
* Идёт по `firstChild` и `nextSibling`: live `childNodes` создаёт wrapper на
|
|
83
|
+
* каждый шаг и отсутствует в DOM-моделях без NodeList. Программа клона не
|
|
84
|
+
* использует пути: этим обходом подготовка сверяет её адресацию.
|
|
85
|
+
*/
|
|
86
|
+
export declare function findBlueprintNode(root: Element, path: readonly number[]): Node;
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import { DOMListenerDescriptor } from '../value/DOMValueDescriptor.types.js';
|
|
2
|
+
export interface DOMDataListenerDescriptor extends DOMListenerDescriptor {
|
|
3
|
+
readonly data?: unknown;
|
|
4
|
+
}
|
|
5
|
+
export declare function createDOMDataEventInput(handler: unknown, options: Readonly<Record<string, unknown>> | undefined, data: unknown): DOMListenerDescriptor;
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { ComponentInstance } from '@raphy-js/core';
|
|
2
|
+
import { DOMEventHub } from '../../event/DOMEventHub.js';
|
|
3
|
+
import { DOMEffectScope } from '../../renderer/DOMEffectScope.js';
|
|
4
|
+
import { PreparedDOMHostBlueprint } from './DOMHostBlueprintCache.js';
|
|
5
|
+
type HandleError<ErrorContext> = (context: ErrorContext, error: unknown, operation: string) => boolean;
|
|
6
|
+
type RethrowUnhandled<ErrorContext> = (context: ErrorContext, error: unknown, operation: string) => void;
|
|
7
|
+
/**
|
|
8
|
+
* Исполняет программу подготовленной формы на одном клоне prototype: находит
|
|
9
|
+
* node каждой записи и пишет значение её slot типизированным writer.
|
|
10
|
+
*
|
|
11
|
+
* Записи идут в порядке node(): inputs host раньше его children, children
|
|
12
|
+
* слева направо. Запись с объявленным mode не осматривает значение: raw getter
|
|
13
|
+
* связывается с effect как есть и вызывается без receiver, остальное пишется
|
|
14
|
+
* один раз. Запись без mode определяет вид значения здесь и читает dynamic()
|
|
15
|
+
* либо text() plan так же, как node(): вызовом `read` у самого wrapper при
|
|
16
|
+
* каждом исполнении effect.
|
|
17
|
+
*
|
|
18
|
+
* Запись события с data slot (mode 'data-event') регистрирует общий handler
|
|
19
|
+
* вместе со значением этого slot: closure handler на экземпляр не нужна.
|
|
20
|
+
*
|
|
21
|
+
* Events, effects и ownership принадлежат экземпляру. Reactive slots экземпляра
|
|
22
|
+
* делят одну группу effects: одна phase task и один ресурс владельца на
|
|
23
|
+
* экземпляр, а набор зависимостей у каждого slot свой, поэтому изменение
|
|
24
|
+
* перезапускает только тот slot, который его читал. Группа регистрируется на
|
|
25
|
+
* первой reactive записи, и каждый slot запускается на своей записи, поэтому
|
|
26
|
+
* первое чтение getter и первая запись значения происходят там же, где их
|
|
27
|
+
* выполнил бы отдельный binding. Группа не получает task и не имеет disposer и
|
|
28
|
+
* живёт до освобождения владельца экземпляра. Состояние обхода хранится только
|
|
29
|
+
* в локальных переменных: запуск slot выполняет flush, внутри которого может
|
|
30
|
+
* монтироваться другой экземпляр той же формы.
|
|
31
|
+
*
|
|
32
|
+
* Последующие записи отличаются от отдельных bindings порядком: изменившиеся
|
|
33
|
+
* slots экземпляра исполняются подряд в порядке записей программы на месте,
|
|
34
|
+
* которое task экземпляра заняла в очереди phase при первом изменении, а не
|
|
35
|
+
* каждый на месте своей invalidation. Slot, source которого записан в том же
|
|
36
|
+
* проходе phase, пока slot ждал доставки, читает getter заново. Запуск slot
|
|
37
|
+
* на освобождённом владельце бросает `RaphDisposedError` и прерывает mount,
|
|
38
|
+
* как регистрация отдельного binding.
|
|
39
|
+
*
|
|
40
|
+
* `handleError` маршрутизирует сбой записи input и возвращает, обработан ли он;
|
|
41
|
+
* `rethrowUnhandled` маршрутизирует сбой text slot и сам пробрасывает
|
|
42
|
+
* необработанный. Оба получают `errorContext`.
|
|
43
|
+
*/
|
|
44
|
+
export declare function mountDOMHostBlueprintSlots<ErrorContext>(prepared: PreparedDOMHostBlueprint, root: Element, values: readonly unknown[], owner: ComponentInstance<unknown, unknown, Readonly<Record<never, never>>, Readonly<Record<never, never>>, any>['node'], effectScope: DOMEffectScope<any>, eventHub: DOMEventHub, errorContext: ErrorContext, handleError: HandleError<ErrorContext>, rethrowUnhandled: RethrowUnhandled<ErrorContext>): void;
|
|
45
|
+
export {};
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import { NodeAdapter, NodeRuntime } from '@raphy-js/core';
|
|
2
|
+
/** Node Runtime, принадлежащий DOM renderer definition. */
|
|
3
|
+
export declare function createDOMNodeRuntime(createHostBlueprint?: NodeAdapter['createHostBlueprint'], resolveTarget?: NodeAdapter['resolveTarget']): NodeRuntime;
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import { EachNodePlan as DOMEachNodePlan } from '@raphy-js/core';
|
|
2
|
+
import { EACH_MOUNT_HOST, MountContext } from '../mountNode.js';
|
|
3
|
+
import { DOMRange } from '.././structural/range/DOMRange.js';
|
|
4
|
+
export type KeyedRowOutput = ChildNode | DOMRange;
|
|
5
|
+
export declare function createEachMaterializer(host: typeof EACH_MOUNT_HOST): <Props, State, Slots extends object>(plan: DOMEachNodePlan, context: MountContext<Props, State, Slots>) => DOMRange;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { EachNodePlan } from '@raphy-js/core';
|
|
2
|
+
import { EACH_MOUNT_HOST, MountContext } from '../mountNode.js';
|
|
3
|
+
import { DOMRange } from '../structural/range/DOMRange.js';
|
|
4
|
+
type MountEach = <Props, State, Slots extends object>(plan: EachNodePlan, context: MountContext<Props, State, Slots>) => DOMRange;
|
|
5
|
+
/**
|
|
6
|
+
* Keyed-список строк одной формы, которые компилятор описал программой
|
|
7
|
+
* (`EachRowProgram`): строка — клон prototype host blueprint, значения slots
|
|
8
|
+
* считаются программой от item, без factory и без owner строки. Значения пишутся
|
|
9
|
+
* в блок prototype до клонирования, поэтому новая строка не обходит свои nodes.
|
|
10
|
+
* Изменение item перезаписывает только item-записи строки, ответ selector — одна
|
|
11
|
+
* подписка списка на source selector, события строки доставляет router hub на
|
|
12
|
+
* её корне.
|
|
13
|
+
*
|
|
14
|
+
* Программа неприменима при hydration, вне HTML namespace, с веткой `empty`,
|
|
15
|
+
* style value boundary, записью вида, который путь не пишет, событием, которое
|
|
16
|
+
* hub не делегирует, или selector, которого нельзя наблюдать списком. Тогда
|
|
17
|
+
* список монтируется обычным путём. Значения item-записей вычисляются под пробой
|
|
18
|
+
* чтений: строка, которая прочитала отслеживаемый источник, получает owner и
|
|
19
|
+
* effect своих item-записей, и результат тот же, что у обычного пути.
|
|
20
|
+
*/
|
|
21
|
+
export declare function createPureEach(host: typeof EACH_MOUNT_HOST, mountEach: MountEach): MountEach;
|
|
22
|
+
export {};
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { RaphyErrorCapture } from '@raphy-js/core';
|
|
2
|
+
import { RaphEffectOptions, RaphNode, RaphPhaseEffect, RaphWatchOptions, RaphWatchSource } from '@raphy-js/raph/runtime';
|
|
3
|
+
import { DOMEffectScope } from '../../renderer/DOMEffectScope.js';
|
|
4
|
+
import { DOMMountCompletion } from '../mount/DOMMountTransaction.js';
|
|
5
|
+
/**
|
|
6
|
+
* Private результат уже завершённого framework-owned вызова. Никогда не входит
|
|
7
|
+
* в Raph callback, public dispose, user process либо Promise rejection.
|
|
8
|
+
*/
|
|
9
|
+
export declare class DOMInvocationFailure {
|
|
10
|
+
readonly error: unknown;
|
|
11
|
+
/** Сохраняет итог вызова, не создавая Error и не меняя raw payload. */
|
|
12
|
+
constructor(failure: unknown);
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Raph has completed disposal before this continuation runs. A mixed raw
|
|
16
|
+
* aggregate is one new cleanup event, as in initializer plus rollback failure.
|
|
17
|
+
*/
|
|
18
|
+
export declare function completeDOMDisposal(failure: NonNullable<ReturnType<RaphNode<unknown, any>['_disposeForOwner']>>, capture: (error: unknown) => RaphyErrorCapture<any>): void;
|
|
19
|
+
/** Только собственная DOM boundary откладывает recovery до конца content mount. */
|
|
20
|
+
export declare class DOMPendingBoundaryCapture implements RaphyErrorCapture {
|
|
21
|
+
readonly handled = true;
|
|
22
|
+
readonly report: RaphyErrorCapture<any>['report'];
|
|
23
|
+
readonly owner: {
|
|
24
|
+
readonly disposed: boolean;
|
|
25
|
+
};
|
|
26
|
+
/** Marker не попадает в handlers: они уже получили исходный report. */
|
|
27
|
+
constructor(captured: RaphyErrorCapture<any>, owner: {
|
|
28
|
+
readonly disposed: boolean;
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
/** Private отмена уже обработанного mount после завершённого rollback. */
|
|
32
|
+
export declare class DOMHandledInvocationAbort {
|
|
33
|
+
readonly captured: RaphyErrorCapture<any>;
|
|
34
|
+
/** Сохраняет точный report текущего принадлежащего DOM вызова. */
|
|
35
|
+
constructor(captured: RaphyErrorCapture<any>);
|
|
36
|
+
}
|
|
37
|
+
/** Доставляет законченную cleanup-ошибку лишь после commit либо abort владельца. */
|
|
38
|
+
export declare function completeDOMMount(completion: DOMMountCompletion | undefined, routeUnrouted: (error: unknown) => void): void;
|
|
39
|
+
/** Возвращает raw на выходе callback, который Raph показывает пользователю. */
|
|
40
|
+
export declare function runDOMPhaseCallback(callback: () => void): void;
|
|
41
|
+
/** Validation, activation и adoption failures выходят по обычному mount route. */
|
|
42
|
+
export declare function registerDOMEffect(owner: DOMEffectScope<any>, callback: () => void, options: RaphEffectOptions): void;
|
|
43
|
+
/** Taskless body сохраняет прежний effect mode и owner lifetime. */
|
|
44
|
+
export declare function registerDOMBinding(owner: DOMEffectScope<any>, callback: () => void, options: RaphEffectOptions): void;
|
|
45
|
+
/** Source activation завершается до execution continuation этой регистрации. */
|
|
46
|
+
export declare function registerDOMWatch(owner: DOMEffectScope<any>, source: RaphWatchSource, callback: RaphPhaseEffect, options: RaphWatchOptions): void;
|
|
47
|
+
/** Внутренний typed handle получен из owner, без приведения public group. */
|
|
48
|
+
export declare function startDOMGroupSlot(group: ReturnType<DOMEffectScope<any>['_registerEffectGroup']>, slot: number): void;
|
|
49
|
+
/**
|
|
50
|
+
* Только прямые вызовы BranchBlock/KeyedListBlock с private DOM initializer.
|
|
51
|
+
* Raph rollback всегда видит raw: произвольные Aggregate не обходятся.
|
|
52
|
+
* Флаг означает исход этого callback в текущем вызове, а не identity ошибки.
|
|
53
|
+
*/
|
|
54
|
+
export declare function invokeDOMInitializer<Argument extends {
|
|
55
|
+
readonly node: {
|
|
56
|
+
readonly disposed: boolean;
|
|
57
|
+
};
|
|
58
|
+
}, Result>(invoke: (callback: (argument: Argument) => void, rollbackFailed: (error: unknown) => never) => Result, callback: (argument: Argument) => void, capture: (error: unknown, argument: Argument) => RaphyErrorCapture<any>): Result;
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { ComponentParent, RaphyErrorSource } from '@raphy-js/core';
|
|
2
|
+
import { RaphExecution } from '@raphy-js/raph/execution';
|
|
3
|
+
import { RaphRuntime } from '@raphy-js/raph/runtime';
|
|
4
|
+
type ComponentNode<Runtime extends RaphExecution<Runtime>> = ComponentParent<Runtime>['node'];
|
|
5
|
+
/** Сохраняет точный component/owner первоначального renderer exception. */
|
|
6
|
+
export declare class DOMOperationError<Runtime extends RaphExecution<Runtime> = RaphRuntime> extends Error {
|
|
7
|
+
readonly component: ComponentParent<Runtime>;
|
|
8
|
+
readonly owner: ComponentNode<Runtime>;
|
|
9
|
+
readonly cause: unknown;
|
|
10
|
+
readonly source: RaphyErrorSource;
|
|
11
|
+
/**
|
|
12
|
+
* Сохраняет renderer operation context без замены исходного exception.
|
|
13
|
+
*/
|
|
14
|
+
constructor(component: ComponentParent<Runtime>, owner: ComponentNode<Runtime>, cause: unknown, source: RaphyErrorSource);
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Не оборачивает повторно уже нормализованную ошибку дочернего subtree.
|
|
18
|
+
*
|
|
19
|
+
* Откат structural entry освобождает owner упавшего child раньше, чем catch site
|
|
20
|
+
* передаёт сбой в Core. Core ищет renderer boundary подъёмом от owner, поэтому
|
|
21
|
+
* такой сбой переносится на живого owner catch site; component, cause и source
|
|
22
|
+
* упавшего child сохраняются.
|
|
23
|
+
*/
|
|
24
|
+
export declare function normalizeDOMOperationError<Runtime extends RaphExecution<Runtime>>(component: ComponentParent<Runtime>, owner: ComponentNode<Runtime>, error: unknown, source: RaphyErrorSource): DOMOperationError<Runtime>;
|
|
25
|
+
export {};
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { NodeDynamicValue } from '@raphy-js/core';
|
|
2
|
+
declare const approvedHtmlBrand: unique symbol;
|
|
3
|
+
/** Строка, которую внешний sanitizer явно утвердил для safeHtml(). */
|
|
4
|
+
export type DOMApprovedHTML = string & {
|
|
5
|
+
readonly [approvedHtmlBrand]: true;
|
|
6
|
+
};
|
|
7
|
+
/** Минимальный structural contract browser TrustedHTML. */
|
|
8
|
+
export interface DOMTrustedHTML {
|
|
9
|
+
readonly [Symbol.toStringTag]: 'TrustedHTML';
|
|
10
|
+
readonly toString: () => string;
|
|
11
|
+
}
|
|
12
|
+
export type DOMSafeHtmlValue = DOMApprovedHTML | DOMTrustedHTML;
|
|
13
|
+
/** Renderer plan raw HTML; содержимое никогда не компилируется как Raphy template. */
|
|
14
|
+
export interface DOMRawHtmlNodePlan {
|
|
15
|
+
readonly kind: 'raw-html';
|
|
16
|
+
readonly read: () => DOMSafeHtmlValue | string | null | undefined;
|
|
17
|
+
readonly unsafe: boolean;
|
|
18
|
+
}
|
|
19
|
+
export type DOMSafeHtmlSource = DOMSafeHtmlValue | NodeDynamicValue<DOMSafeHtmlValue | null | undefined>;
|
|
20
|
+
export type DOMUnsafeHtmlSource = string | NodeDynamicValue<string | null | undefined>;
|
|
21
|
+
export {};
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import { DOMRawHtmlNodePlan, DOMSafeHtmlSource, DOMUnsafeHtmlSource } from './DOMRawHtmlNode.types.js';
|
|
2
|
+
/** Принимает только TrustedHTML либо compile-time branded результат sanitizer. */
|
|
3
|
+
export declare function safeHtml(value: DOMSafeHtmlSource): DOMRawHtmlNodePlan;
|
|
4
|
+
/** Явно разрешает небезопасную строковую вставку без template compilation. */
|
|
5
|
+
export declare function unsafeHtml(value: DOMUnsafeHtmlSource): DOMRawHtmlNodePlan;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { DynamicComponentNodePlan } from '@raphy-js/core';
|
|
2
|
+
export interface DOMKeepAliveOptions {
|
|
3
|
+
readonly max?: number;
|
|
4
|
+
}
|
|
5
|
+
/** Cache plan одного dynamic component с identity type + key. */
|
|
6
|
+
export interface DOMKeepAliveNodePlan {
|
|
7
|
+
readonly component: DynamicComponentNodePlan;
|
|
8
|
+
readonly kind: 'keep-alive';
|
|
9
|
+
readonly max?: number;
|
|
10
|
+
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import { DynamicComponentNodePlan } from '@raphy-js/core';
|
|
2
|
+
import { DOMKeepAliveNodePlan, DOMKeepAliveOptions } from './DOMKeepAliveNode.types.js';
|
|
3
|
+
/** Создаёт bounded либо unlimited LRU cache для одного dynamic-component plan. */
|
|
4
|
+
export declare function keepAlive(component: DynamicComponentNodePlan, options?: DOMKeepAliveOptions): DOMKeepAliveNodePlan;
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import { ComponentInstance, ComponentRef, RaphyRendererHost, TargetRef } from '@raphy-js/core';
|
|
2
|
+
import { DOMElementRef } from '../ref/DOMElementRef.types.js';
|
|
3
|
+
/** Завершённая очистка опубликованной ветки и возможный более поздний сбой mount. */
|
|
4
|
+
export interface DOMMountCompletion {
|
|
5
|
+
readonly prior: unknown;
|
|
6
|
+
readonly interrupted?: {
|
|
7
|
+
readonly error: unknown;
|
|
8
|
+
};
|
|
9
|
+
}
|
|
10
|
+
/** Собирает DOM refs и components до успешной вставки materialized output. */
|
|
11
|
+
export declare class DOMMountTransaction {
|
|
12
|
+
private readonly _elementRefs;
|
|
13
|
+
private readonly _components;
|
|
14
|
+
private readonly _componentRefs;
|
|
15
|
+
private _completedFailures;
|
|
16
|
+
private _state;
|
|
17
|
+
private _holds;
|
|
18
|
+
private _released;
|
|
19
|
+
/** Показывает, может ли текущая materialization добавлять commit operations. */
|
|
20
|
+
get open(): boolean;
|
|
21
|
+
/** Есть вложенные блоки, ещё не выполнившие первый запуск. */
|
|
22
|
+
get held(): boolean;
|
|
23
|
+
/**
|
|
24
|
+
* Держит commit до первого запуска вложенного блока. Внутри доставки Raph
|
|
25
|
+
* откладывает sync initial до следующего прохода; без hold component mount
|
|
26
|
+
* случился бы раньше, чем блок вставит свои elements и назначит refs.
|
|
27
|
+
*/
|
|
28
|
+
hold(): () => void;
|
|
29
|
+
/** Выполняет finish после снятия последнего hold; без holds — сразу. */
|
|
30
|
+
afterHolds(finish: () => void): void;
|
|
31
|
+
/** Откладывает назначение ref и сразу связывает его cleanup с owner. */
|
|
32
|
+
addElementRef(reference: DOMElementRef<Element> | TargetRef, element: Element, owner: ComponentInstance<unknown, unknown, Readonly<Record<never, never>>, Readonly<Record<never, never>>, any>['node']): void;
|
|
33
|
+
/** Откладывает mount hook component до commit всего output range. */
|
|
34
|
+
addComponent(component: ComponentInstance<unknown, unknown, object, any, any>, handleError: (error: unknown) => boolean): void;
|
|
35
|
+
/** Откладывает назначение public component ref до успешной DOM insertion. */
|
|
36
|
+
addComponentRef(reference: ComponentRef<object>, component: ComponentInstance<unknown, unknown, object, any, any>): void;
|
|
37
|
+
/** Handler уже получил ошибку прежней ветки; доставляем её после commit новой. */
|
|
38
|
+
deferCompletedFailure(error: unknown): void;
|
|
39
|
+
/**
|
|
40
|
+
* Переносит отложенные refs и mount hooks дочерней materialization в текущую transaction.
|
|
41
|
+
*/
|
|
42
|
+
absorb(transaction: DOMMountTransaction): void;
|
|
43
|
+
/** Назначает refs и подтверждает component mounts после platform insertion. */
|
|
44
|
+
commit(host: RaphyRendererHost<any>): DOMMountCompletion | undefined;
|
|
45
|
+
/** Ошибка materialization не запускает refs и mount hooks. */
|
|
46
|
+
abort(error: unknown): DOMMountCompletion;
|
|
47
|
+
/** Закрывает неудавшуюся materialization; caller сам маршрутизирует original. */
|
|
48
|
+
abortAndTakeCompleted(error: unknown): DOMMountCompletion | undefined;
|
|
49
|
+
/** Отменённая async materialization не подтверждает refs/mount hooks. */
|
|
50
|
+
cancelAndTakeCompleted(): DOMMountCompletion | undefined;
|
|
51
|
+
private _takeCompletion;
|
|
52
|
+
/** Отклоняет повторное использование завершённой transaction. */
|
|
53
|
+
private _assertOpen;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Регистрирует реактивный блок, созданный внутри открытой transaction. Внутри
|
|
57
|
+
* доставки Raph откладывает sync initial до следующего прохода: transaction
|
|
58
|
+
* ждёт первый запуск блока, чтобы его elements, refs и components вошли в тот
|
|
59
|
+
* же commit, что и component, который его содержит.
|
|
60
|
+
*/
|
|
61
|
+
export declare function registerHeldBlock(transaction: DOMMountTransaction, owner: {
|
|
62
|
+
own: (cleanup: () => void) => unknown;
|
|
63
|
+
}, callback: () => void, register: (run: () => void) => void): void;
|