@endge/nova 0.13.6 → 0.13.14

package/dist/model/render/graph/nova-render-culling.d.ts

@@ -0,0 +1,26 @@
+import { NovaBounds } from '../../../domain/types/renderer.types';
+import { NovaRenderGroup, NovaRenderViewport } from '../../../domain/types/rendering/index';
+/**
+ * Описывает контракт NovaRenderCullingResult.
+ */
+export interface NovaRenderCullingResult {
+    testedGroups: number;
+    visibleGroups: Array<NovaRenderGroup>;
+    culledGroupIds: Array<string>;
+}
+/**
+ * Выполняет публичную операцию nova bounds intersects.
+ */
+export declare function novaBoundsIntersects(a: NovaBounds, b: NovaBounds): boolean;
+/**
+ * Выполняет публичную операцию nova viewport to bounds.
+ */
+export declare function novaViewportToBounds(viewport: NovaRenderViewport): NovaBounds;
+/**
+ * Проверяет nova render group visible.
+ */
+export declare function isNovaRenderGroupVisible(group: NovaRenderGroup, viewport: NovaRenderViewport): boolean;
+/**
+ * Выполняет публичную операцию collect visible nova render groups.
+ */
+export declare function collectVisibleNovaRenderGroups(groups: Iterable<NovaRenderGroup>, viewport: NovaRenderViewport): NovaRenderCullingResult;

package/dist/model/render/graph/nova-render-group.d.ts

@@ -0,0 +1,18 @@
+import { NovaInstructionBuffer, NovaRenderGroup, NovaRenderGroupId, NovaRenderLayerId } from '../../../domain/types/rendering/index';
+/**
+ * Описывает контракт CreateNovaRenderGroupOptions.
+ */
+export interface CreateNovaRenderGroupOptions {
+    id: NovaRenderGroupId;
+    layerId: NovaRenderLayerId;
+    ownerNodeId?: string;
+    parentGroupId?: NovaRenderGroupId;
+}
+/**
+ * Создает nova instruction buffer.
+ */
+export declare function createNovaInstructionBuffer(id: string, version?: number): NovaInstructionBuffer;
+/**
+ * Создает nova render group.
+ */
+export declare function createNovaRenderGroup(options: CreateNovaRenderGroupOptions): NovaRenderGroup;

package/dist/model/render/graph/nova-render-item.d.ts

@@ -0,0 +1,35 @@
+import { mat3 } from 'gl-matrix';
+import { NovaBounds, NovaSchemaItem } from '../../../domain/types/renderer.types';
+import { NovaRenderClip, NovaRenderGroupId, NovaRenderItem, NovaRenderItemKind, NovaRenderLayerId, NovaRenderStreamKind } from '../../../domain/types/rendering/index';
+/**
+ * Описывает контракт CreateNovaRenderItemOptions.
+ */
+export interface CreateNovaRenderItemOptions {
+    id: string;
+    groupId: NovaRenderGroupId;
+    layerId: NovaRenderLayerId;
+    kind: NovaRenderItemKind;
+    order: number;
+    batchKey: string;
+    nodeId?: string;
+    schemaItem?: NovaSchemaItem<any>;
+    transform?: mat3;
+    clip?: NovaRenderClip | null;
+    bounds?: NovaBounds;
+}
+/**
+ * Создает nova render item.
+ */
+export declare function createNovaRenderItem(options: CreateNovaRenderItemOptions): NovaRenderItem;
+/**
+ * Вычисляет nova render item kind.
+ */
+export declare function resolveNovaRenderItemKind(item: NovaSchemaItem<any>): NovaRenderItemKind;
+/**
+ * Создает nova render item batch key.
+ */
+export declare function createNovaRenderItemBatchKey(item: NovaSchemaItem<any>): string;
+/**
+ * Вычисляет nova render stream kind.
+ */
+export declare function resolveNovaRenderStreamKind(item: NovaSchemaItem<any>): NovaRenderStreamKind;

package/dist/model/render/graph/nova-render-layer.d.ts

@@ -0,0 +1,5 @@
+import { NovaRenderLayer, NovaRenderLayerId } from '../../../domain/types/rendering/index';
+/**
+ * Создает nova render layer.
+ */
+export declare function createNovaRenderLayer(id: NovaRenderLayerId, zIndex?: number): NovaRenderLayer;

package/dist/model/render/graph/nova-render-stream.d.ts

@@ -0,0 +1,117 @@
+import { NovaBounds, NovaSemanticScopeKind } from '../../../domain/types/renderer.types';
+import { NovaBatchPlan, NovaRenderGroupId, NovaRenderSemanticLayer, NovaRenderStream, NovaRenderStreamId, NovaRenderStreamKind, NovaRenderStreamSlot } from '../../../domain/types/rendering/index';
+/**
+ * Описывает контракт CreateNovaTypedRenderStreamOptions.
+ */
+export interface CreateNovaTypedRenderStreamOptions {
+    id: NovaRenderStreamId;
+    groupId: NovaRenderGroupId;
+    kind: NovaRenderStreamKind;
+    strideFloats?: number;
+    initialCapacity?: number;
+}
+/**
+ * Описывает контракт NovaRenderStreamAllocation.
+ */
+export interface NovaRenderStreamAllocation {
+    slotIndex: number;
+    offset: number;
+    count: number;
+}
+/**
+ * Описывает контракт NovaRenderStreamDirtyRange.
+ */
+export interface NovaRenderStreamDirtyRange {
+    startSlot: number;
+    endSlot: number;
+}
+/**
+ * Хранит typed render stream, slots и dirty ranges для одного primitive kind.
+ */
+export declare class NovaTypedRenderStream implements NovaRenderStream {
+    readonly id: NovaRenderStreamId;
+    readonly groupId: NovaRenderGroupId;
+    readonly kind: NovaRenderStreamKind;
+    readonly strideFloats: number;
+    readonly slots: Array<NovaRenderStreamSlot>;
+    private readonly _slotsByItemId;
+    private readonly _freeSlots;
+    private readonly _dirtyRanges;
+    private _data;
+    private _slotCount;
+    private _version;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(options: CreateNovaTypedRenderStreamOptions);
+    /**
+     * Возвращает slot capacity.
+     */
+    get slotCapacity(): number;
+    /**
+     * Возвращает slot count.
+     */
+    get slotCount(): number;
+    /**
+     * Возвращает version.
+     */
+    get version(): number;
+    /**
+     * Возвращает data.
+     */
+    get data(): Float32Array;
+    /**
+     * Возвращает slots by item id.
+     */
+    get slotsByItemId(): ReadonlyMap<string, NovaRenderStreamSlot>;
+    /**
+     * Выполняет внутреннюю операцию allocate slot.
+     */
+    allocateSlot(options: {
+        itemId: string;
+        count?: number;
+        order: number;
+        batchKey: string;
+        bounds?: NovaBounds;
+    }): NovaRenderStreamAllocation;
+    /**
+     * Записывает slot.
+     */
+    writeSlot(itemId: string, values: ReadonlyArray<number>): boolean;
+    /**
+     * Удаляет slot.
+     */
+    removeSlot(itemId: string): boolean;
+    /**
+     * Помечает slot dirty.
+     */
+    markSlotDirty(slotIndex: number): void;
+    /**
+     * Выполняет внутреннюю операцию consume dirty ranges.
+     */
+    consumeDirtyRanges(): Array<NovaRenderStreamDirtyRange>;
+    /**
+     * Очищает внутреннее состояние.
+     */
+    clear(): void;
+    /**
+     * Выполняет внутреннюю операцию ensure slot capacity.
+     */
+    private _ensureSlotCapacity;
+}
+/**
+ * Создает nova render stream id.
+ */
+export declare function createNovaRenderStreamId(groupId: NovaRenderGroupId, kind: NovaRenderStreamKind): NovaRenderStreamId;
+/**
+ * Вычисляет nova render stream stride.
+ */
+export declare function resolveNovaRenderStreamStride(kind: NovaRenderStreamKind): number;
+/**
+ * Вычисляет nova render semantic layer.
+ */
+export declare function resolveNovaRenderSemanticLayer(kind: NovaRenderStreamKind): NovaRenderSemanticLayer;
+/**
+ * Создает nova batch plan.
+ */
+export declare function createNovaBatchPlan(groupId: NovaRenderGroupId, streams: Iterable<NovaTypedRenderStream>, semanticScope?: NovaSemanticScopeKind, version?: number): NovaBatchPlan;

package/dist/model/render/orchestration/NovaRenderOrchestrator.d.ts

@@ -0,0 +1,73 @@
+import { EventList } from '@endge/utils';
+import { NovaRenderBackend } from '../backends/nova-render-backend';
+import { NovaSurface } from '../../runtime/tree/NovaSurface';
+/**
+ * Координирует compile/replay логических surfaces в один root backend pass.
+ */
+export declare class NovaRenderOrchestrator<E extends EventList = EventList> {
+    private readonly _backend;
+    private readonly _frames;
+    private readonly _surfaceCaches;
+    private _rootClears;
+    private _surfaceTargetSeq;
+    /**
+     * Создает orchestrator для единственного app-level backend.
+     */
+    constructor(_backend: NovaRenderBackend);
+    /**
+     * Рендерит упорядоченные логические surfaces в root target.
+     */
+    render(surfaces: Array<NovaSurface<E>>, _dirtySurfaces: ReadonlySet<NovaSurface<E>>): void;
+    /**
+     * Удаляет retained frame уничтоженного surface.
+     */
+    deleteSurface(surface: NovaSurface<E>): void;
+    /**
+     * Возвращает количество root clear для тестов и diagnostics.
+     */
+    get rootClears(): number;
+    /**
+     * Сохраняет compiler metrics, когда backend возвращает draw metrics.
+     */
+    private _mergeMetrics;
+    /**
+     * WebGL backend может композитить surfaces через cached render targets.
+     */
+    private _shouldCompositeSurfaces;
+    /**
+     * Рендерит dirty surfaces в offscreen targets и собирает root из cached textures.
+     */
+    private _renderWithSurfaceTargets;
+    /**
+     * Рисует cached chunks и direct surfaces в исходном z-order.
+     */
+    private _renderCompositeEntries;
+    /**
+     * Screen-space controls stay direct to avoid texture-target artefacts on UI icons.
+     */
+    private _shouldCacheSurface;
+    /**
+     * Создает или возвращает retained metadata для surface target.
+     */
+    private _ensureSurfaceCache;
+    /**
+     * Создает target под текущий canvas size.
+     */
+    private _createSurfaceTarget;
+    /**
+     * Проверяет, нужно ли repaint-ить cache target из-за resize/DPR.
+     */
+    private _hasTargetChanged;
+    /**
+     * Оборачивает surface frame в begin/end render target.
+     */
+    private _wrapFrameInRenderTarget;
+    /**
+     * Создает frame, который рисует все surface targets в root target.
+     */
+    private _createCompositeFrame;
+    /**
+     * Создает минимальные render metrics для synthetic composite frame.
+     */
+    private _createEmptyMetrics;
+}

package/dist/model/render/policy/nova-render-policy.d.ts

@@ -0,0 +1,45 @@
+import { NovaRenderDirtyFlags, NovaRendererConfig, NovaRendererConfigInput, NovaRendererTextConfig, NovaRenderPolicy, NovaRenderPolicyInput, NovaRenderVersions } from '../../../domain/types/rendering/index';
+/**
+ * Хранит значение DEFAULT_NOVA_RENDER_POLICY, используемое runtime-кодом пакета.
+ */
+export declare const DEFAULT_NOVA_RENDER_POLICY: NovaRenderPolicy;
+/**
+ * Хранит значение DEFAULT_NOVA_RENDERER_CONFIG, используемое runtime-кодом пакета.
+ */
+export declare const DEFAULT_NOVA_RENDERER_CONFIG: NovaRendererConfig;
+/**
+ * Вычисляет nova render policy.
+ */
+export declare function resolveNovaRenderPolicy(input?: NovaRenderPolicyInput): NovaRenderPolicy;
+/**
+ * Вычисляет nova renderer config.
+ */
+export declare function resolveNovaRendererConfig(input?: NovaRendererConfigInput, base?: NovaRendererConfig): NovaRendererConfig;
+/**
+ * Вычисляет bucket растеризации текста для заданного zoom.
+ */
+export declare function resolveNovaTextRasterBucket(config: NovaRendererTextConfig, zoom: number): number;
+/**
+ * Вычисляет итоговый scale растеризации текста с учетом DPR canvas.
+ */
+export declare function resolveNovaTextRasterScale(config: NovaRendererTextConfig, zoom: number, dpr: number): number;
+/**
+ * Создает clean render dirty flags.
+ */
+export declare function createCleanRenderDirtyFlags(): NovaRenderDirtyFlags;
+/**
+ * Создает full render dirty flags.
+ */
+export declare function createFullRenderDirtyFlags(): NovaRenderDirtyFlags;
+/**
+ * Создает render versions.
+ */
+export declare function createRenderVersions(value?: number): NovaRenderVersions;
+/**
+ * Объединяет render dirty flags.
+ */
+export declare function mergeRenderDirtyFlags(target: NovaRenderDirtyFlags, patch: Partial<NovaRenderDirtyFlags>): NovaRenderDirtyFlags;
+/**
+ * Выполняет публичную операцию bump render versions.
+ */
+export declare function bumpRenderVersions(versions: NovaRenderVersions, flags: Partial<NovaRenderDirtyFlags>): NovaRenderVersions;

package/dist/model/render/resources/NovaGlyphAtlasManager.d.ts

@@ -0,0 +1,45 @@
+import { NovaRendererTextConfig } from '../../../domain/types/rendering/index';
+import { NovaTextureAtlasEntry, NovaTextureAtlasPage } from './NovaTextureAtlasManager';
+/**
+ * Описывает контракт NovaGlyphDescriptor.
+ */
+export interface NovaGlyphDescriptor {
+    glyph: string;
+    fontKey: string;
+    color: string;
+}
+/**
+ * Описывает контракт NovaGlyphAtlasResolveResult.
+ */
+export interface NovaGlyphAtlasResolveResult {
+    entry: NovaTextureAtlasEntry<NovaGlyphDescriptor>;
+    cacheHit: boolean;
+    bucket: number;
+}
+/**
+ * Кэширует glyph resources для динамичного text rendering.
+ */
+export declare class NovaGlyphAtlasManager {
+    private readonly _config;
+    private readonly _atlas;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(_config: NovaRendererTextConfig);
+    /**
+     * Возвращает memory mb.
+     */
+    get memoryMB(): number;
+    /**
+     * Возвращает pages.
+     */
+    get pages(): Array<NovaTextureAtlasPage>;
+    /**
+     * Выполняет внутреннюю операцию resolve.
+     */
+    resolve(descriptor: NovaGlyphDescriptor, zoom?: number): NovaGlyphAtlasResolveResult;
+    /**
+     * Вычисляет zoom bucket.
+     */
+    resolveZoomBucket(zoom: number): number;
+}

package/dist/model/render/resources/NovaRenderResourceCache.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Хранит generic render resources с LRU-подобным доступом.
+ */
+export declare class NovaRenderResourceCache<T> {
+    private readonly _cache;
+    /**
+     * Возвращает size.
+     */
+    get size(): number;
+    /**
+     * Выполняет внутреннюю операцию get.
+     */
+    get(key: string): T | undefined;
+    /**
+     * Выполняет внутреннюю операцию set.
+     */
+    set(key: string, value: T): T;
+    /**
+     * Возвращает or create.
+     */
+    getOrCreate(key: string, factory: () => T): T;
+    /**
+     * Выполняет внутреннюю операцию delete.
+     */
+    delete(key: string): boolean;
+    /**
+     * Очищает внутреннее состояние.
+     */
+    clear(): void;
+}

package/dist/model/render/resources/NovaRenderScheduler.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Описывает контракт NovaRenderScheduledTask.
+ */
+export interface NovaRenderScheduledTask {
+    id: string;
+    run: () => void;
+}
+/**
+ * Описывает контракт NovaRenderSchedulerResult.
+ */
+export interface NovaRenderSchedulerResult {
+    executed: number;
+    remaining: number;
+    elapsedMs: number;
+}
+/**
+ * Планирует ограниченные по бюджету render/resource задачи.
+ */
+export declare class NovaRenderScheduler {
+    private readonly _queue;
+    /**
+     * Выполняет внутреннюю операцию enqueue.
+     */
+    enqueue(task: NovaRenderScheduledTask): void;
+    /**
+     * Выполняет внутреннюю операцию run budgeted.
+     */
+    runBudgeted(budgetMs: number): NovaRenderSchedulerResult;
+    /**
+     * Очищает внутреннее состояние.
+     */
+    clear(): void;
+}

package/dist/model/render/resources/NovaTextAtlasManager.d.ts

@@ -0,0 +1,44 @@
+import { NovaText } from '../../../domain/types/renderer.types';
+import { NovaRendererTextConfig } from '../../../domain/types/rendering/index';
+import { NovaTextureAtlasEntry, NovaTextureAtlasPage } from './NovaTextureAtlasManager';
+/**
+ * Описывает контракт NovaTextAtlasResolveResult.
+ */
+export interface NovaTextAtlasResolveResult {
+    entry: NovaTextureAtlasEntry<NovaText>;
+    cacheHit: boolean;
+    bucket: number;
+    rasterized: boolean;
+}
+/**
+ * Кэширует rasterized text runs и управляет их memory budget.
+ */
+export declare class NovaTextAtlasManager {
+    private readonly _config;
+    private readonly _atlas;
+    private readonly _layout;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(_config: NovaRendererTextConfig);
+    /**
+     * Возвращает memory mb.
+     */
+    get memoryMB(): number;
+    /**
+     * Возвращает pages.
+     */
+    get pages(): Array<NovaTextureAtlasPage>;
+    /**
+     * Выполняет внутреннюю операцию resolve.
+     */
+    resolve(text: NovaText, zoom?: number): NovaTextAtlasResolveResult;
+    /**
+     * Вычисляет zoom bucket.
+     */
+    resolveZoomBucket(zoom: number): number;
+    /**
+     * Выполняет внутреннюю операцию evict to budget.
+     */
+    evictToBudget(): void;
+}

package/dist/model/render/resources/NovaTextLayoutEngine.d.ts

@@ -0,0 +1,23 @@
+import { NovaText } from '../../../domain/types/renderer.types';
+/**
+ * Описывает контракт NovaTextLayoutMeasure.
+ */
+export interface NovaTextLayoutMeasure {
+    width: number;
+    height: number;
+    fontKey: string;
+}
+/**
+ * Выполняет layout text runs перед rasterization и batching.
+ */
+export declare class NovaTextLayoutEngine {
+    private readonly _canvas;
+    /**
+     * Выполняет внутреннюю операцию measure.
+     */
+    measure(text: NovaText, scale?: number): NovaTextLayoutMeasure;
+    /**
+     * Возвращает context2 d.
+     */
+    private _getContext2D;
+}

package/dist/model/render/resources/NovaTextureAtlasManager.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Описывает контракт NovaTextureAtlasEntry.
+ */
+export interface NovaTextureAtlasEntry<T = unknown> {
+    id: string;
+    key: string;
+    width: number;
+    height: number;
+    scale: number;
+    bytes: number;
+    pageId?: string;
+    x?: number;
+    y?: number;
+    payload?: T;
+    lastUsed: number;
+}
+/**
+ * Описывает контракт NovaTextureAtlasManagerOptions.
+ */
+export interface NovaTextureAtlasManagerOptions {
+    maxMemoryMB: number;
+    pageSize?: number;
+}
+/**
+ * Описывает контракт NovaTextureAtlasPage.
+ */
+export interface NovaTextureAtlasPage {
+    id: string;
+    width: number;
+    height: number;
+    cursorX: number;
+    cursorY: number;
+    rowHeight: number;
+    entries: Set<string>;
+}
+/**
+ * Кэширует texture regions и управляет atlas entries для image/icon resources.
+ */
+export declare class NovaTextureAtlasManager<T = unknown> {
+    private readonly _options;
+    private readonly _entries;
+    private readonly _pages;
+    private _bytes;
+    private _tick;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(_options: NovaTextureAtlasManagerOptions);
+    /**
+     * Возвращает memory bytes.
+     */
+    get memoryBytes(): number;
+    /**
+     * Возвращает memory mb.
+     */
+    get memoryMB(): number;
+    /**
+     * Возвращает entries.
+     */
+    get entries(): Array<NovaTextureAtlasEntry<T>>;
+    /**
+     * Возвращает pages.
+     */
+    get pages(): Array<NovaTextureAtlasPage>;
+    /**
+     * Выполняет внутреннюю операцию get.
+     */
+    get(key: string): NovaTextureAtlasEntry<T> | undefined;
+    /**
+     * Выполняет внутреннюю операцию set.
+     */
+    set(entry: Omit<NovaTextureAtlasEntry<T>, 'lastUsed' | 'bytes'> & {
+        bytes?: number;
+    }): NovaTextureAtlasEntry<T>;
+    /**
+     * Выполняет внутреннюю операцию evict to budget.
+     */
+    evictToBudget(): Array<NovaTextureAtlasEntry<T>>;
+    /**
+     * Очищает внутреннее состояние.
+     */
+    clear(): void;
+    /**
+     * Выполняет внутреннюю операцию allocate region.
+     */
+    private _allocateRegion;
+    /**
+     * Выполняет внутреннюю операцию try allocate on page.
+     */
+    private _tryAllocateOnPage;
+    /**
+     * Удаляет from page.
+     */
+    private _removeFromPage;
+}

package/dist/model/render/schema/NovaRenderContext.d.ts

@@ -0,0 +1,74 @@
+import { NovaArc, NovaBorder, NovaBounds, NovaCircle, NovaIcon, NovaLine, NovaPatternRect, NovaPolygon, NovaRect, NovaRectBatch, NovaSchema, NovaSchemaItem, NovaText, NovaTimeRangeSegmentBatch } from '../../../domain/types/renderer.types';
+import { NovaRenderCommandWriter } from '../compiler/NovaRenderCommandWriter';
+import { NovaSchemaRegistry } from '../../runtime/components/NovaSchemaRegistry';
+/**
+ * Предоставляет renderer-facing API для записи schema и primitive intents.
+ */
+export declare class NovaRenderContext {
+    private readonly _writer;
+    private readonly _schemaRegistry;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(_writer: NovaRenderCommandWriter, _schemaRegistry: NovaSchemaRegistry);
+    /**
+     * Выполняет внутреннюю операцию schema.
+     */
+    schema(schema: NovaSchema<any> | NovaSchemaItem<any>): void;
+    /**
+     * Выполняет внутреннюю операцию rect.
+     */
+    rect(params: NovaRect): void;
+    /**
+     * Выполняет внутреннюю операцию border.
+     */
+    border(params: NovaBorder): void;
+    /**
+     * Выполняет внутреннюю операцию text.
+     */
+    text(params: NovaText): void;
+    /**
+     * Выполняет внутреннюю операцию line.
+     */
+    line(params: NovaLine): void;
+    /**
+     * Выполняет внутреннюю операцию circle.
+     */
+    circle(params: NovaCircle): void;
+    /**
+     * Выполняет внутреннюю операцию arc.
+     */
+    arc(params: NovaArc): void;
+    /**
+     * Выполняет внутреннюю операцию polygon.
+     */
+    polygon(params: NovaPolygon): void;
+    /**
+     * Выполняет внутреннюю операцию icon.
+     */
+    icon(params: NovaIcon): void;
+    /**
+     * Выполняет внутреннюю операцию pattern rect.
+     */
+    patternRect(params: NovaPatternRect): void;
+    /**
+     * Записывает retained rect batch.
+     */
+    rects(batch: NovaRectBatch): void;
+    /**
+     * Записывает retained time-range segment batch.
+     */
+    timeRangeSegments(batch: NovaTimeRangeSegmentBatch): void;
+    /**
+     * Выполняет внутреннюю операцию push clip.
+     */
+    pushClip(rect: NovaBounds): void;
+    /**
+     * Выполняет внутреннюю операцию pop clip.
+     */
+    popClip(): void;
+    /**
+     * Выполняет внутреннюю операцию schema item.
+     */
+    private _schemaItem;
+}