@endge/nova 0.13.6 → 0.13.14

package/dist/model/runtime/tree/NovaNode.d.ts

@@ -0,0 +1,626 @@
+import { DataPathDef, RaphApp, RaphNode } from '@endge/raph';
+import { EventList, OneOrMany } from '@endge/utils';
+import { NovaNodeProperties } from '../../../domain/types/base.types';
+import { NovaAddChildOptions, NovaContextToken, NovaObserveDataOptions } from '../../../domain/types/context.types';
+import { NovaCursorContext, NovaCursorDeclaration } from '../../../domain/types/cursor.types';
+import { NovaNodeEventHandlers } from '../../../domain/types/events.types';
+import { NovaHitTestHandler } from '../../../domain/types/hit-test.types';
+import { NovaBounds, NovaLifecycleState, NovaRenderer, NovaSchema } from '../../../domain/types/renderer.types';
+import { NovaRenderDirtyFlags, NovaRenderPolicy, NovaRenderPolicyInput, NovaRenderVersions } from '../../../domain/types/rendering/index';
+import { NovaSemanticRegion, NovaSemanticRegisterOptions } from '../../../domain/types/semantic.types';
+import { NovaNodeSoundMap } from '../../../domain/types/sound.types';
+import { NovaCanvas } from '../../platform/NovaCanvas';
+import { NovaApp } from '../app/NovaApp';
+import { NovaDebug } from '../debug/NovaDebug';
+import { NovaEvents } from '../interaction/NovaEvents';
+import { NovaStoreReadMap, NovaStoreTrackingPhase } from '../state/nova-store-tracking';
+import { NovaSurface } from './NovaSurface';
+import { mat3 } from 'gl-matrix';
+/**
+ * Описывает базовый узел Nova tree с состоянием, transform, lifecycle и rendering hooks.
+ */
+export declare class NovaNode<E extends EventList> extends RaphNode<NovaNodeProperties> {
+    protected readonly _nova: NovaApp<E>;
+    protected readonly _surface?: NovaSurface<E>;
+    readonly eventHandlers: Partial<NovaNodeEventHandlers>;
+    readonly captureEventHandlers: Partial<NovaNodeEventHandlers>;
+    __type: string;
+    private readonly _inverseMatrix;
+    private _inverseMatrixSource?;
+    private readonly _renderOrder;
+    private readonly _orderedChildren;
+    private readonly _localRenderBounds;
+    private _renderOrderCounter;
+    private _renderFrameDirty;
+    private _lifecycleState;
+    private _hasLocalRenderBounds;
+    private _renderPolicy;
+    private readonly _renderDirtyFlags;
+    private readonly _renderVersions;
+    private _layoutReady;
+    private _provides?;
+    private _injectCache?;
+    private _providerVersion;
+    private _reactiveStoreObservers?;
+    private _nodeContext?;
+    private _hasNodeContext;
+    private _semanticId?;
+    private _schemaSemanticSourceKey?;
+    private _hitTest;
+    private readonly _disposers;
+    private readonly _soundHandles;
+    private readonly _soundUserHandlers;
+    private _soundEventBindings?;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(app: NovaApp<E>, surface?: NovaSurface<E>);
+    /**
+     * Регистрирует scoped dependency для потомков этой ноды.
+     */
+    provide<T>(token: NovaContextToken<T>, value: T): this;
+    /**
+     * Возвращает scoped dependency из ближайшего ancestor provider.
+     */
+    inject<T>(token: NovaContextToken<T>): T;
+    /**
+     * Возвращает scoped dependency или fallback, если provider не найден.
+     */
+    injectOptional<T>(token: NovaContextToken<T>, fallback?: T): T | undefined;
+    /**
+     * Проверяет, зарегистрирован ли provider на этой ноде.
+     */
+    hasProvider<T>(token: NovaContextToken<T>): boolean;
+    /**
+     * Устанавливает явный runtime context этой ноды.
+     */
+    setContext<T>(context: T): this;
+    /**
+     * Возвращает явный runtime context этой ноды.
+     */
+    getContext<T>(): T;
+    /**
+     * Возвращает явный runtime context или fallback.
+     */
+    getContextOptional<T>(fallback?: T): T | undefined;
+    /**
+     * Добавляет disposer, который будет вызван при dispose ноды.
+     */
+    addDisposer(disposer: () => void): () => void;
+    /**
+     * Подписывает ноду на business data path и dirty-ит указанную Nova phase.
+     */
+    observeData(path: DataPathDef, options?: NovaObserveDataOptions): () => void;
+    /**
+     * Синхронизирует автоматические подписки ноды на reactive store reads.
+     */
+    syncReactiveStoreReads(reads: NovaStoreReadMap, touchedPhases: Set<NovaStoreTrackingPhase>): void;
+    /**
+     * Создает data observer для автоматически прочитанного store path.
+     */
+    private _createReactiveStoreObserver;
+    /**
+     * Возвращает active.
+     */
+    get active(): boolean;
+    /**
+     * Обновляет active.
+     */
+    set active(v: boolean);
+    /**
+     * Возвращает visible.
+     */
+    get visible(): boolean;
+    /**
+     * Обновляет visible.
+     */
+    set visible(v: boolean);
+    /**
+     * Возвращает opacity.
+     */
+    get opacity(): number;
+    /**
+     * Обновляет opacity.
+     */
+    set opacity(v: number);
+    /**
+     * Возвращает x.
+     */
+    get x(): number;
+    /**
+     * Обновляет x.
+     */
+    set x(v: number);
+    /**
+     * Возвращает y.
+     */
+    get y(): number;
+    /**
+     * Обновляет y.
+     */
+    set y(v: number);
+    /**
+     * Возвращает width.
+     */
+    get width(): number;
+    /**
+     * Обновляет width.
+     */
+    set width(v: number);
+    /**
+     * Возвращает height.
+     */
+    get height(): number;
+    /**
+     * Обновляет height.
+     */
+    set height(v: number);
+    /**
+     * Возвращает scale x.
+     */
+    get scaleX(): number;
+    /**
+     * Обновляет scale x.
+     */
+    set scaleX(v: number);
+    /**
+     * Возвращает scale y.
+     */
+    get scaleY(): number;
+    /**
+     * Обновляет scale y.
+     */
+    set scaleY(v: number);
+    /**
+     * Возвращает rotation.
+     */
+    get rotation(): number;
+    /**
+     * Обновляет rotation.
+     */
+    set rotation(v: number);
+    /**
+     * Возвращает matrix.
+     */
+    get matrix(): mat3;
+    /**
+     * Возвращает interactive.
+     */
+    get interactive(): boolean;
+    /**
+     * Обновляет interactive.
+     */
+    set interactive(v: boolean);
+    /**
+     * Возвращает cursor declaration.
+     */
+    get cursor(): NovaCursorDeclaration | null;
+    /**
+     * Обновляет cursor declaration.
+     */
+    set cursor(v: NovaCursorDeclaration | null);
+    /**
+     * Возвращает cursor context.
+     */
+    get cursorContext(): NovaCursorContext | null;
+    /**
+     * Обновляет cursor context.
+     */
+    set cursorContext(v: NovaCursorContext | null);
+    /**
+     * Возвращает propagate update.
+     */
+    get propagateUpdate(): boolean;
+    /**
+     * Обновляет propagate update.
+     */
+    set propagateUpdate(v: boolean);
+    /**
+     * Выполняет внутреннюю операцию do update.
+     */
+    doUpdate(): void;
+    /**
+     * Выполняет внутреннюю операцию do matrix.
+     */
+    doMatrix(): void;
+    /**
+     * Выполняет внутреннюю операцию do render.
+     */
+    doRender(): void;
+    /**
+     * Возвращает готовность node к первому paint после layout.
+     */
+    get layoutReady(): boolean;
+    /**
+     * Управляет участием node в render frame до завершения layout.
+     */
+    set layoutReady(value: boolean);
+    /**
+     * Выполняет внутреннюю операцию options.
+     */
+    options(opts: Partial<NovaNodeProperties> & {
+        zIndex?: number;
+    }): this;
+    /**
+     * Выполняет внутреннюю операцию dirty.
+     */
+    dirty(opts: {
+        matrix?: boolean;
+        update?: boolean;
+        render?: boolean;
+    } | string | Array<string>): void;
+    /**
+     * Помечает retained paint/resource update without rebuilding node render commands.
+     */
+    dirtyRetainedRender(): void;
+    /**
+     * Возвращает local bounds.
+     */
+    getLocalBounds(): NovaBounds;
+    /**
+     * Возвращает world bounds.
+     */
+    getWorldBounds(): NovaBounds;
+    /**
+     * Возвращает render bounds.
+     */
+    getRenderBounds(): NovaBounds;
+    /**
+     * Возвращает local render bounds.
+     */
+    getLocalRenderBounds(): NovaBounds;
+    /**
+     * Обновляет local render bounds.
+     */
+    setLocalRenderBounds(bounds: NovaBounds): this;
+    /**
+     * Обновляет render bounds from schema.
+     */
+    setRenderBoundsFromSchema(schema: NovaSchema<any>): this;
+    /**
+     * Регистрирует semantic region, связанную с этой нодой.
+     */
+    setSemantic(options: NovaSemanticRegisterOptions): NovaSemanticRegion;
+    /**
+     * Снимает semantic region этой ноды.
+     */
+    clearSemantic(): void;
+    /**
+     * Возвращает semantic region этой ноды.
+     */
+    getSemantic(): NovaSemanticRegion | undefined;
+    /**
+     * Очищает local render bounds.
+     */
+    clearLocalRenderBounds(): this;
+    /**
+     * Выполняет внутреннюю операцию contains point.
+     */
+    containsPoint(x: number, y: number): boolean;
+    /**
+     * Обновляет shape-level hit-test handler.
+     */
+    setHitTest(handler: NovaHitTestHandler | null): this;
+    /**
+     * Выполняет внутреннюю операцию to local.
+     */
+    toLocal(gx: number, gy: number): [number, number];
+    /**
+     * Выполняет внутреннюю операцию on.
+     */
+    on<K extends keyof NovaNodeEventHandlers>(type: OneOrMany<K>, handler: NonNullable<NovaNodeEventHandlers[K]>): void;
+    /**
+     * Привязывает sound cues к событиям node без замены пользовательских handlers.
+     */
+    withSound(map: NovaNodeSoundMap): this;
+    /**
+     * Обрабатывает событие capture.
+     */
+    onCapture<K extends keyof NovaNodeEventHandlers>(type: OneOrMany<K>, handler: NonNullable<NovaNodeEventHandlers[K]>): void;
+    /**
+     * Выполняет внутреннюю операцию off.
+     */
+    off<K extends keyof NovaNodeEventHandlers>(type: K): void;
+    /**
+     * Выполняет внутреннюю операцию off capture.
+     */
+    offCapture<K extends keyof NovaNodeEventHandlers>(type: K): void;
+    /**
+     * Выполняет внутреннюю операцию off all.
+     */
+    offAll(): void;
+    /**
+     * Устанавливает event handler с optional sound wrapper.
+     */
+    private _installEventHandler;
+    /**
+     * Отслеживает node-scoped sound handle.
+     */
+    private _trackSoundHandle;
+    /**
+     * Останавливает node-scoped sounds.
+     */
+    private _stopSoundHandles;
+    /**
+     * Выполняет внутреннюю операцию capture pointer.
+     */
+    capturePointer(event?: MouseEvent): void;
+    /**
+     * Выполняет внутреннюю операцию release pointer capture.
+     */
+    releasePointerCapture(event?: MouseEvent): void;
+    /**
+     * Проверяет наличие pointer capture.
+     */
+    hasPointerCapture(event?: MouseEvent): boolean;
+    /**
+     * Выполняет внутреннюю операцию focus.
+     */
+    focus(event?: Event, scope?: string): void;
+    /**
+     * Выполняет внутреннюю операцию blur.
+     */
+    blur(event?: Event, scope?: string): void;
+    /**
+     * Выполняет внутреннюю операцию select.
+     */
+    select(options?: {
+        append?: boolean;
+        toggle?: boolean;
+        scope?: string;
+    }, event?: Event): void;
+    /**
+     * Выполняет внутреннюю операцию deselect.
+     */
+    deselect(event?: Event, scope?: string): void;
+    /**
+     * Возвращает focused.
+     */
+    get focused(): boolean;
+    /**
+     * Выполняет внутреннюю операцию focused in.
+     */
+    focusedIn(scope: string): boolean;
+    /**
+     * Возвращает selected.
+     */
+    get selected(): boolean;
+    /**
+     * Выполняет внутреннюю операцию selected in.
+     */
+    selectedIn(scope: string): boolean;
+    /**
+     * Возвращает raph.
+     */
+    get raph(): RaphApp<NovaNodeProperties>;
+    /**
+     * Возвращает nova.
+     */
+    get nova(): NovaApp<E>;
+    /**
+     * Возвращает canvas.
+     */
+    get canvas(): NovaCanvas;
+    /**
+     * Возвращает surface.
+     */
+    get surface(): NovaSurface<E>;
+    /**
+     * Возвращает renderer.
+     */
+    get renderer(): NovaRenderer;
+    /**
+     * Возвращает events.
+     */
+    get events(): NovaEvents<E>;
+    /**
+     * Возвращает debugger.
+     */
+    get debugger(): NovaDebug;
+    /**
+     * Возвращает local active.
+     */
+    get localActive(): boolean;
+    /**
+     * Возвращает local visible.
+     */
+    get localVisible(): boolean;
+    /**
+     * Возвращает render frame dirty.
+     */
+    get renderFrameDirty(): boolean;
+    /**
+     * Возвращает render policy.
+     */
+    get renderPolicy(): NovaRenderPolicy;
+    /**
+     * Обновляет render policy.
+     */
+    set renderPolicy(value: NovaRenderPolicyInput);
+    /**
+     * Возвращает render dirty flags.
+     */
+    get renderDirtyFlags(): NovaRenderDirtyFlags;
+    /**
+     * Возвращает render versions.
+     */
+    get renderVersions(): NovaRenderVersions;
+    /**
+     * Возвращает render node id.
+     */
+    get renderNodeId(): string;
+    /**
+     * Возвращает transform version.
+     */
+    get transformVersion(): number;
+    /**
+     * Возвращает layout version.
+     */
+    get layoutVersion(): number;
+    /**
+     * Возвращает paint version.
+     */
+    get paintVersion(): number;
+    /**
+     * Возвращает children version.
+     */
+    get childrenVersion(): number;
+    /**
+     * Возвращает resource version.
+     */
+    get resourceVersion(): number;
+    /**
+     * Выполняет внутреннюю операцию configure render policy.
+     */
+    configureRenderPolicy(value: NovaRenderPolicyInput): this;
+    /**
+     * Помечает render dirty flags.
+     */
+    markRenderDirtyFlags(flags: Partial<NovaRenderDirtyFlags>): void;
+    /**
+     * Очищает render dirty flags.
+     */
+    clearRenderDirtyFlags(): void;
+    /**
+     * Возвращает lifecycle state.
+     */
+    get lifecycleState(): NovaLifecycleState;
+    /**
+     * Помечает render frame dirty.
+     */
+    markRenderFrameDirty(includeChildren?: boolean): void;
+    /**
+     * Помечает render frame clean.
+     */
+    markRenderFrameClean(includeChildren?: boolean): void;
+    /**
+     * Обновляет scale.
+     */
+    setScale(x: number, y: number): void;
+    /**
+     * Обновляет rotation.
+     */
+    setRotation(angle: number): void;
+    /**
+     * Возвращает inverse matrix.
+     */
+    private _getInverseMatrix;
+    /**
+     * Обновляет position.
+     */
+    setPosition(x: number, y: number): void;
+    /**
+     * Обновляет size.
+     */
+    setSize(width: number, height: number): void;
+    /**
+     * Выполняет поиск scoped dependency по ancestor chain.
+     */
+    private _resolveInjectedValue;
+    /**
+     * Сохраняет найденный scoped dependency в локальном inject-cache.
+     */
+    private _cacheInjectedValue;
+    /**
+     * Сбрасывает inject-cache у этой ноды и ее потомков.
+     */
+    private _clearInjectCacheDeep;
+    /**
+     * Выполняет dispose callbacks текущей ноды.
+     */
+    private _runDisposers;
+    /**
+     * Снимает автоматические reactive store observers.
+     */
+    private _disposeReactiveStoreObservers;
+    /**
+     * Выполняет внутреннюю операцию dispose.
+     */
+    dispose(): void;
+    /**
+     * Выполняет render-операцию schema.
+     */
+    protected renderSchema(schema: NovaSchema<any>): void;
+    /**
+     * Выполняет render-операцию schema ordered.
+     */
+    protected renderSchemaOrdered(schema: NovaSchema<any>): void;
+    private _syncSchemaSemantics;
+    private _clearSchemaSemantics;
+    /**
+     * Помечает spatial dirty for options.
+     */
+    private _markSpatialDirtyForOptions;
+    /**
+     * Синхронизирует регистрацию node в cursor index.
+     */
+    private _syncCursorRegistration;
+    /**
+     * Выполняет внутреннюю операцию remove.
+     */
+    remove(): void;
+    /**
+     * Выполняет render-операцию children.
+     */
+    protected renderChildren(): void;
+    /**
+     * Вычисляет node aware renderer.
+     */
+    private _resolveNodeAwareRenderer;
+    /**
+     * Добавляет child.
+     */
+    addChild(node: RaphNode<any>, options?: NovaAddChildOptions): boolean;
+    /**
+     * Выполняет внутреннюю операцию ensure render order.
+     */
+    private _ensureRenderOrder;
+    /**
+     * Выполняет render-операцию order of.
+     */
+    private _renderOrderOf;
+    /**
+     * Выполняет render-операцию order index of.
+     */
+    renderOrderIndexOf(node: NovaNode<E>): number;
+    /**
+     * Выполняет внутреннюю операцию mount subtree.
+     */
+    mountSubtree(): void;
+    /**
+     * Выполняет внутреннюю операцию pause.
+     */
+    pause(): this;
+    /**
+     * Выполняет внутреннюю операцию resume.
+     */
+    resume(): this;
+    /**
+     * Выполняет внутреннюю операцию unmount subtree.
+     */
+    private _unmountSubtree;
+    /**
+     * Обрабатывает событие mount.
+     */
+    protected onMount(): void;
+    /**
+     * Обрабатывает событие unmount.
+     */
+    protected onUnmount(): void;
+    /**
+     * Обрабатывает событие pause.
+     */
+    protected onPause(): void;
+    /**
+     * Обрабатывает событие resume.
+     */
+    protected onResume(): void;
+    /**
+     * Выполняет render-операцию .
+     */
+    render(): void;
+    /**
+     * Выполняет внутреннюю операцию update.
+     */
+    update(): void;
+}