@endge/nova 0.13.6 → 0.13.11

package/dist/model/render/backends/canvas2d/NovaRenderer2D.d.ts

@@ -0,0 +1,238 @@
+import { mat3 } from 'gl-matrix';
+import { NovaArc, NovaBorder, NovaCircle, NovaIcon, NovaIconBatch, NovaLine, NovaNineSliceImage, NovaParticleBatch, NovaPatternRect, NovaPolygon, NovaRect, NovaRectBatch, NovaRenderer, NovaRendererStateMark, NovaSchema, NovaStripeRectBatch, NovaText, NovaTextBatch, NovaTimeRangeSegmentBatch, RendererType } from '../../../../domain/types/renderer.types';
+import { NovaRenderFrame, NovaRenderMetrics } from '../../../../domain/types/rendering/index';
+import { NovaCanvas } from '../../../platform/NovaCanvas';
+import { NovaRenderBackend } from '../nova-render-backend';
+import { NovaAssetRegistry } from '../../../runtime/assets/NovaAssetRegistry';
+import { NovaSchemaRegistry } from '../../../runtime/components/NovaSchemaRegistry';
+/**
+ * Рисует compiled Nova render frame через Canvas2D backend.
+ */
+export declare class NovaRenderer2D implements NovaRenderer, NovaRenderBackend {
+    private readonly _assets;
+    readonly id: string;
+    readonly type = RendererType.Web2D;
+    readonly novaCanvas: NovaCanvas;
+    readonly capabilities: {
+        canvas2d: boolean;
+        webgl: boolean;
+        schema: boolean;
+        rect: boolean;
+        border: boolean;
+        line: boolean;
+        circle: boolean;
+        arc: boolean;
+        polygon: boolean;
+        icon: boolean;
+        text: boolean;
+        patternRects: boolean;
+        particles: boolean;
+        rectBatches: boolean;
+        stripeBatches: boolean;
+        iconBatches: boolean;
+        textBatches: boolean;
+        measureText: boolean;
+    };
+    private readonly _measureCanvas;
+    private readonly _schemaRegistry;
+    private readonly _renderTargets;
+    private readonly _targetStack;
+    private readonly _stateMarks;
+    private _activeTargetContext;
+    private _clearTextBackground;
+    private _transformDepth;
+    private _clipDepth;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(canvas: NovaCanvas, schemaRegistry?: NovaSchemaRegistry, _assets?: NovaAssetRegistry);
+    /**
+     * Возвращает ctx.
+     */
+    get ctx(): CanvasRenderingContext2D;
+    /**
+     * Возвращает активную render-state границу.
+     */
+    private get activeStateMark();
+    /**
+     * Очищает внутреннее состояние.
+     */
+    clear(): void;
+    /**
+     * Очищает root render target один раз перед ordered surface replay.
+     */
+    clearRoot(): void;
+    /**
+     * Начинает рисовать в offscreen canvas target.
+     */
+    beginRenderTarget(id: string, width: number, height: number, options?: {
+        dpr?: number;
+    }): void;
+    /**
+     * Завершает offscreen target.
+     */
+    endRenderTarget(): void;
+    /**
+     * Рисует offscreen target обратно в активный canvas.
+     */
+    drawRenderTarget(id: string, x: number, y: number, width: number, height: number): void;
+    /**
+     * Временно включает очистку text bounds перед draw.
+     */
+    withTextBackgroundClearing<T>(enabled: boolean, run: () => T): T;
+    /**
+     * Выполняет render-операцию frame.
+     */
+    renderFrame(frame: NovaRenderFrame): NovaRenderMetrics;
+    /**
+     * Выполняет внутреннюю операцию schema.
+     */
+    schema(schema: NovaSchema<any>): void;
+    /**
+     * Выполняет внутреннюю операцию red box.
+     */
+    redBox(): void;
+    /**
+     * Выполняет внутреннюю операцию save.
+     */
+    save(): void;
+    /**
+     * Выполняет внутреннюю операцию restore.
+     */
+    restore(): void;
+    /**
+     * Выполняет внутреннюю операцию clip.
+     */
+    clip(x: number, y: number, width: number, height: number): void;
+    /**
+     * Очищает clip.
+     */
+    clearClip(): void;
+    /**
+     * Сохраняет границу mutable render-state.
+     */
+    markState(): NovaRendererStateMark;
+    /**
+     * Восстанавливает mutable render-state до сохраненной границы.
+     */
+    restoreState(mark: NovaRendererStateMark): void;
+    /**
+     * Обновляет transform.
+     */
+    setTransform(matrix: mat3): void;
+    /**
+     * Выполняет внутреннюю операцию rect.
+     */
+    rect(p: NovaRect): void;
+    /**
+     * Выполняет внутреннюю операцию text.
+     */
+    text(p: NovaText): void;
+    /**
+     * Возвращает per-item clip для retained text batch.
+     */
+    private resolveTextBatchClip;
+    /**
+     * Выполняет внутреннюю операцию resolve padding.
+     */
+    private _resolvePadding;
+    /**
+     * Выполняет внутреннюю операцию line.
+     */
+    line(p: NovaLine): void;
+    /**
+     * Выполняет внутреннюю операцию circle.
+     */
+    circle(p: NovaCircle): void;
+    /**
+     * Выполняет внутреннюю операцию arc.
+     */
+    arc(p: NovaArc): void;
+    /**
+     * Выполняет внутреннюю операцию polygon.
+     */
+    polygon(p: NovaPolygon): void;
+    /**
+     * Выполняет внутреннюю операцию icon.
+     */
+    icon(p: NovaIcon): void;
+    /**
+     * Рисует процедурный pattern rect через bounded Canvas2D fallback.
+     */
+    patternRect(p: NovaPatternRect): void;
+    /**
+     * Выполняет внутреннюю операцию nine-slice-image.
+     */
+    nineSliceImage(p: NovaNineSliceImage): void;
+    /**
+     * Рисует repeated center для nine-slice-image.
+     */
+    private drawRepeatedNineSliceCenter;
+    /**
+     * Рисует retained particle batch через Canvas2D fallback.
+     */
+    particles(batch: NovaParticleBatch): void;
+    /**
+     * Рисует retained rect batch через Canvas2D fallback.
+     */
+    rects(batch: NovaRectBatch): void;
+    /**
+     * Рисует retained time-range segment batch через Canvas2D fallback.
+     */
+    timeRangeSegments(batch: NovaTimeRangeSegmentBatch): void;
+    /**
+     * Рисует retained stripe batch через Canvas2D fallback.
+     */
+    stripes(batch: NovaStripeRectBatch): void;
+    /**
+     * Рисует retained icon batch через Canvas2D fallback.
+     */
+    icons(batch: NovaIconBatch): void;
+    /**
+     * Рисует retained text batch через Canvas2D fallback.
+     */
+    texts(batch: NovaTextBatch): void;
+    /**
+     * Выполняет внутреннюю операцию cursor.
+     */
+    cursor(value: string): void;
+    /**
+     * Выполняет внутреннюю операцию border.
+     */
+    border(p: NovaBorder): void;
+    /**
+     * Выполняет внутреннюю операцию draw rounded rect.
+     */
+    private _drawRoundedRect;
+    /**
+     * Выполняет внутреннюю операцию text string.
+     */
+    private textString;
+    /**
+     * Выполняет внутреннюю операцию measure text.
+     */
+    measureText(p: NovaText): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Освобождает runtime resources и снимает связанные ссылки.
+     */
+    destroy(): void;
+    /**
+     * Выполняет restore без проверки active state mark.
+     */
+    private restoreUnsafe;
+    /**
+     * Выполняет clearClip без проверки active state mark.
+     */
+    private clearClipUnsafe;
+    /**
+     * Выполняет внутреннюю операцию text markdown.
+     */
+    private textMarkdown;
+    /**
+     * Выполняет внутреннюю операцию parse markdown to chunks.
+     */
+    private _parseMarkdownToChunks;
+}

package/dist/model/render/backends/nova-render-backend-factory.d.ts

@@ -0,0 +1,10 @@
+import { NovaRendererConfig } from '../../../domain/types/rendering/index';
+import { NovaCanvas } from '../../platform/NovaCanvas';
+import { NovaRenderBackend } from './nova-render-backend';
+import { NovaAssetRegistry } from '../../runtime/assets/NovaAssetRegistry';
+import { NovaSchemaRegistry } from '../../runtime/components/NovaSchemaRegistry';
+import { RendererType } from '../../../domain/types/renderer.types';
+/**
+ * Создает единственный app-level backend executor.
+ */
+export declare function createNovaRenderBackend(type: RendererType, canvas: NovaCanvas, schemaRegistry: NovaSchemaRegistry, rendererConfig: NovaRendererConfig, assets: NovaAssetRegistry): NovaRenderBackend;

package/dist/model/render/backends/nova-render-backend.d.ts

@@ -0,0 +1,16 @@
+import { NovaRendererCanvas, RendererType } from '../../../domain/types/renderer.types';
+import { NovaRendererConfig, NovaRenderFrame, NovaRenderMetrics } from '../../../domain/types/rendering/index';
+/**
+ * Исполнитель backend для скомпилированных Nova frames.
+ */
+export interface NovaRenderBackend {
+    readonly id: string;
+    readonly type: RendererType;
+    readonly novaCanvas: NovaRendererCanvas;
+    readonly diagnostics?: unknown;
+    renderFrame: (frame: NovaRenderFrame) => NovaRenderMetrics;
+    clearRoot: () => void;
+    resize?: () => void;
+    configure?: (config: NovaRendererConfig) => void;
+    destroy: () => void;
+}

package/dist/model/render/backends/webgl/NovaGpuBufferArena.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Описывает контракт NovaGpuDirtyByteRange.
+ */
+export interface NovaGpuDirtyByteRange {
+    start: number;
+    end: number;
+}
+/**
+ * Описывает контракт NovaGpuBufferSlot.
+ */
+export interface NovaGpuBufferSlot {
+    index: number;
+    byteOffset: number;
+    byteLength: number;
+}
+/**
+ * Управляет persistent GPU buffer capacity, dirty ranges и upload policy.
+ */
+export declare class NovaGpuBufferArena {
+    private readonly _fullUploadDirtyRatio;
+    private readonly _mergeGapBytes;
+    private _capacityBytes;
+    private _slotByteLength;
+    private _nextSlotIndex;
+    private _nextByteOffset;
+    private readonly _freeSlots;
+    private readonly _dirtyRanges;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(_fullUploadDirtyRatio?: number, _mergeGapBytes?: number);
+    /**
+     * Возвращает capacity bytes.
+     */
+    get capacityBytes(): number;
+    /**
+     * Возвращает allocated slots.
+     */
+    get allocatedSlots(): number;
+    /**
+     * Выполняет внутреннюю операцию configure slot byte length.
+     */
+    configureSlotByteLength(byteLength: number): void;
+    /**
+     * Выполняет внутреннюю операцию ensure capacity.
+     */
+    ensureCapacity(byteLength: number): boolean;
+    /**
+     * Выполняет внутреннюю операцию allocate slot.
+     */
+    allocateSlot(byteLength?: number): NovaGpuBufferSlot;
+    /**
+     * Выполняет внутреннюю операцию free slot.
+     */
+    freeSlot(slot: NovaGpuBufferSlot): void;
+    /**
+     * Помечает slot dirty.
+     */
+    markSlotDirty(slot: NovaGpuBufferSlot): void;
+    /**
+     * Помечает dirty range.
+     */
+    markDirtyRange(start: number, end: number): void;
+    /**
+     * Выполняет внутреннюю операцию consume dirty ranges.
+     */
+    consumeDirtyRanges(): Array<NovaGpuDirtyByteRange>;
+    /**
+     * Проверяет, нужно ли выполнить upload full.
+     */
+    shouldUploadFull(byteLength: number, dirtyRanges: Array<NovaGpuDirtyByteRange>): boolean;
+    /**
+     * Объединяет dirty ranges.
+     */
+    mergeDirtyRanges(ranges: Array<NovaGpuDirtyByteRange>): Array<NovaGpuDirtyByteRange>;
+}

package/dist/model/render/backends/webgl/NovaRendererWebGL.d.ts

@@ -0,0 +1,154 @@
+import { mat3 } from 'gl-matrix';
+import { NovaArc, NovaBorder, NovaCircle, NovaIcon, NovaIconBatch, NovaLine, NovaParticleBatch, NovaPatternRect, NovaPolygon, NovaRect, NovaRectBatch, NovaRenderer, NovaRendererCapabilities, NovaRendererStateMark, NovaSchema, NovaStripeRectBatch, NovaText, NovaTextBatch, NovaTimeRangeSegmentBatch, RendererType } from '../../../../domain/types/renderer.types';
+import { NovaRendererConfig, NovaRenderFrame, NovaRenderMetrics } from '../../../../domain/types/rendering/index';
+import { NovaCanvas } from '../../../platform/NovaCanvas';
+import { NovaRenderBackend } from '../nova-render-backend';
+import { NovaAssetRegistry } from '../../../runtime/assets/NovaAssetRegistry';
+import { NovaSchemaRegistry } from '../../../runtime/components/NovaSchemaRegistry';
+import { NovaWebGLDevice } from './NovaWebGLDevice';
+import { NovaWebGLDiagnostics } from './NovaWebGLDiagnostics';
+import { NovaWebGLTargetManager } from './NovaWebGLTargetManager';
+import { NovaWebGLTextRenderer } from './NovaWebGLTextRenderer';
+import { NovaWebGLTextureManager } from './NovaWebGLTextureManager';
+/**
+ * Реализует WebGL renderer для compiled Nova render frames.
+ */
+export declare class NovaRendererWebGL implements NovaRenderer, NovaRenderBackend {
+    readonly novaCanvas: NovaCanvas;
+    readonly id: string;
+    readonly type = RendererType.WebGL;
+    readonly capabilities: NovaRendererCapabilities;
+    readonly device: NovaWebGLDevice;
+    readonly diagnostics: NovaWebGLDiagnostics;
+    readonly targets: NovaWebGLTargetManager;
+    readonly textures: NovaWebGLTextureManager;
+    readonly textRenderer: NovaWebGLTextRenderer;
+    private readonly _frameRenderer;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(novaCanvas: NovaCanvas, _schemaRegistry: NovaSchemaRegistry, rendererConfig?: NovaRendererConfig, assets?: NovaAssetRegistry);
+    /**
+     * Выполняет render-операцию frame.
+     */
+    renderFrame(frame: NovaRenderFrame): NovaRenderMetrics;
+    /**
+     * Очищает root render target один раз перед ordered surface replay.
+     */
+    clearRoot(): void;
+    /**
+     * Выполняет внутреннюю операцию schema.
+     */
+    schema(_schema: NovaSchema<any>): void;
+    /**
+     * Выполняет внутреннюю операцию save.
+     */
+    save(): void;
+    /**
+     * Выполняет внутреннюю операцию restore.
+     */
+    restore(): void;
+    /**
+     * Очищает внутреннее состояние.
+     */
+    clear(): void;
+    /**
+     * Выполняет внутреннюю операцию clip.
+     */
+    clip(_x: number, _y: number, _width: number, _height: number): void;
+    /**
+     * Очищает clip.
+     */
+    clearClip(): void;
+    /**
+     * Сохраняет границу mutable render-state.
+     */
+    markState(): NovaRendererStateMark;
+    /**
+     * Восстанавливает mutable render-state до сохраненной границы.
+     */
+    restoreState(_mark: NovaRendererStateMark): void;
+    /**
+     * Обновляет transform.
+     */
+    setTransform(_matrix: mat3): void;
+    /**
+     * Выполняет внутреннюю операцию text.
+     */
+    text(_params: NovaText): void;
+    /**
+     * Выполняет внутреннюю операцию rect.
+     */
+    rect(_params: NovaRect): void;
+    /**
+     * Выполняет внутреннюю операцию border.
+     */
+    border(_params: NovaBorder): 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;
+    /**
+     * Выполняет внутреннюю операцию patternRect.
+     */
+    patternRect(_params: NovaPatternRect): void;
+    /**
+     * Выполняет внутреннюю операцию particles.
+     */
+    particles(_batch: NovaParticleBatch): void;
+    /**
+     * Выполняет внутреннюю операцию rects.
+     */
+    rects(_batch: NovaRectBatch): void;
+    /**
+     * Выполняет внутреннюю операцию timeRangeSegments.
+     */
+    timeRangeSegments(_batch: NovaTimeRangeSegmentBatch): void;
+    /**
+     * Выполняет внутреннюю операцию stripes.
+     */
+    stripes(_batch: NovaStripeRectBatch): void;
+    /**
+     * Выполняет внутреннюю операцию icons.
+     */
+    icons(_batch: NovaIconBatch): void;
+    /**
+     * Выполняет внутреннюю операцию texts.
+     */
+    texts(_batch: NovaTextBatch): void;
+    /**
+     * Выполняет внутреннюю операцию measure text.
+     */
+    measureText(params: NovaText): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Выполняет внутреннюю операцию cursor.
+     */
+    cursor(type: string): void;
+    /**
+     * Освобождает runtime resources и снимает связанные ссылки.
+     */
+    destroy(): void;
+    /**
+     * Выполняет внутреннюю операцию throw immediate api error.
+     */
+    private throwImmediateApiError;
+}

package/dist/model/render/backends/webgl/NovaWebGLBatcher.d.ts

@@ -0,0 +1,17 @@
+import { NovaRenderItem } from '../../../../domain/types/rendering/index';
+/**
+ * Описывает контракт NovaWebGLRenderBatch.
+ */
+export interface NovaWebGLRenderBatch {
+    key: string;
+    items: Array<NovaRenderItem>;
+}
+/**
+ * Группирует WebGL render items в batches с учетом painter order и ключей batching.
+ */
+export declare class NovaWebGLBatcher {
+    /**
+     * Выполняет внутреннюю операцию build display order batches.
+     */
+    buildDisplayOrderBatches(items: Array<NovaRenderItem>): Array<NovaWebGLRenderBatch>;
+}

package/dist/model/render/backends/webgl/NovaWebGLBuffer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Оборачивает WebGLBuffer и операции загрузки данных в GPU.
+ */
+export declare class NovaWebGLBuffer {
+    private readonly _gl;
+    readonly buffer: WebGLBuffer;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(_gl: WebGLRenderingContext);
+    /**
+     * Выполняет внутреннюю операцию bind.
+     */
+    bind(target?: 34962): void;
+    /**
+     * Освобождает runtime resources и снимает связанные ссылки.
+     */
+    destroy(): void;
+}

package/dist/model/render/backends/webgl/NovaWebGLDevice.d.ts

@@ -0,0 +1,24 @@
+import { NovaCanvas } from '../../../platform/NovaCanvas';
+/**
+ * Инкапсулирует WebGL2 context и базовые операции frame lifecycle.
+ */
+export declare class NovaWebGLDevice {
+    readonly canvas: NovaCanvas;
+    readonly gl: WebGL2RenderingContext;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(canvas: NovaCanvas, attributes?: WebGLContextAttributes);
+    /**
+     * Выполняет внутреннюю операцию resize.
+     */
+    resize(): void;
+    /**
+     * Очищает внутреннее состояние.
+     */
+    clear(): void;
+    /**
+     * Выполняет внутреннюю операцию configure.
+     */
+    private configure;
+}

package/dist/model/render/backends/webgl/NovaWebGLDiagnostics.d.ts

@@ -0,0 +1,29 @@
+import { NovaRenderFrame, NovaRenderMetrics } from '../../../../domain/types/rendering/index';
+/**
+ * Рисует diagnostic overlays и debug-визуализацию WebGL renderer.
+ */
+export declare class NovaWebGLDiagnostics {
+    private _enabled;
+    private _lastFrame?;
+    private _lastMetrics?;
+    /**
+     * Возвращает enabled.
+     */
+    get enabled(): boolean;
+    /**
+     * Обновляет enabled и сбрасывает retained diagnostics при выключении.
+     */
+    set enabled(value: boolean);
+    /**
+     * Возвращает last frame.
+     */
+    get lastFrame(): NovaRenderFrame | undefined;
+    /**
+     * Возвращает last metrics.
+     */
+    get lastMetrics(): NovaRenderMetrics | undefined;
+    /**
+     * Выполняет внутреннюю операцию capture.
+     */
+    capture(frame: NovaRenderFrame, metrics: NovaRenderMetrics): void;
+}