@endge/nova 0.13.6 → 0.13.11

package/dist/domain/types/rendering/index.d.ts

@@ -0,0 +1,559 @@
+import { mat3 } from 'gl-matrix';
+import { NovaBounds, NovaIconBatch, NovaParticleBatch, NovaRectBatch, NovaSchemaItem, NovaSemanticScopeKind, NovaStripeRectBatch, NovaTextBatch, NovaTextRenderMode, NovaTimeRangeSegmentBatch, RendererType } from '../renderer.types';
+/**
+ * Описывает тип NovaRenderLayerId.
+ */
+export type NovaRenderLayerId = 'main' | 'overlay' | 'selection' | 'drag-preview' | 'debug' | string;
+/**
+ * Описывает тип NovaRenderTargetId.
+ */
+export type NovaRenderTargetId = string;
+/**
+ * Описывает тип NovaRenderGroupId.
+ */
+export type NovaRenderGroupId = string;
+/**
+ * Описывает тип NovaRenderItemId.
+ */
+export type NovaRenderItemId = string;
+/**
+ * Описывает тип NovaRenderHandleId.
+ */
+export type NovaRenderHandleId = string;
+/**
+ * Описывает тип NovaRenderStreamId.
+ */
+export type NovaRenderStreamId = string;
+/**
+ * Описывает тип NovaRenderPolicyGroup.
+ */
+export type NovaRenderPolicyGroup = 'auto' | 'always' | 'never';
+/**
+ * Описывает тип NovaRenderPolicyCache.
+ */
+export type NovaRenderPolicyCache = 'auto' | 'texture' | 'none';
+/**
+ * Описывает тип NovaRenderPolicyTextQuality.
+ */
+export type NovaRenderPolicyTextQuality = 'auto' | 'crisp' | 'performance';
+/**
+ * Описывает тип NovaRenderPolicyUpdateMode.
+ */
+export type NovaRenderPolicyUpdateMode = 'static' | 'dynamic' | 'stream';
+/**
+ * Описывает тип NovaRenderPolicyLayer.
+ */
+export type NovaRenderPolicyLayer = 'auto' | 'main' | 'overlay' | 'debug' | NovaRenderLayerId;
+/**
+ * Описывает контракт NovaRenderPolicy.
+ */
+export interface NovaRenderPolicy {
+    group: NovaRenderPolicyGroup;
+    cache: NovaRenderPolicyCache;
+    textQuality: NovaRenderPolicyTextQuality;
+    updateMode: NovaRenderPolicyUpdateMode;
+    layer: NovaRenderPolicyLayer;
+}
+/**
+ * Описывает тип NovaRenderPolicyInput.
+ */
+export type NovaRenderPolicyInput = Partial<NovaRenderPolicy>;
+/**
+ * Описывает контракт NovaRendererBatchingConfig.
+ */
+export interface NovaRendererBatchingConfig {
+    maxBatchSize: number;
+    semanticScopes: 'off' | 'safe' | 'manual';
+    maxDrawCallsWarning: number;
+    plainRectStream: boolean;
+    roundedRectStream: boolean;
+    fullUploadDirtyRatio: number;
+}
+/**
+ * Описывает контракт NovaRendererTextConfig.
+ */
+export interface NovaRendererTextConfig {
+    quality: 'performance' | 'balanced' | 'quality';
+    mode: NovaTextRenderMode;
+    modes: NovaRendererTextZoneModes;
+    interaction: NovaRendererTextInteractionConfig;
+    lod: NovaRendererTextLodConfig;
+    glyphs: NovaRendererTextGlyphConfig;
+    sdf: NovaRendererTextSdfConfig;
+    maxAtlasMemoryMB: number;
+    maxGlyphAtlasMemoryMB: number;
+    zoomBuckets: Array<number>;
+    dynamicBuckets: boolean;
+    prewarmAdjacentBuckets: boolean;
+    rasterBudgetMs: number;
+    bucketThrottleMs: number;
+    visibleOnlyRaster: boolean;
+    fallbackPreviousScale: boolean;
+    tightRunAtlas: boolean;
+    minRasterScale: number;
+    maxRasterScale: number;
+}
+/**
+ * Описывает режимы качества текста во время пользовательского interaction.
+ */
+export interface NovaRendererTextInteractionConfig {
+    mode: 'stable-quality' | 'balanced' | 'performance';
+    idleMs: number;
+    rasterBudgetMs: number;
+    maxRasterScale: number;
+    freezeBuckets: boolean;
+    prewarm: boolean;
+}
+/**
+ * Описывает screen-space LOD для массового текста.
+ */
+export interface NovaRendererTextLodConfig {
+    enabled: boolean;
+    minScreenWidthPx: number;
+    minScreenHeightPx: number;
+    maxVisibleRuns: number;
+    hysteresisPx: number;
+}
+/**
+ * Описывает кэши retained glyph pipeline.
+ */
+export interface NovaRendererTextGlyphConfig {
+    retainedBatches: boolean;
+    shapeCacheEntries: number;
+    runCacheEntries: number;
+}
+/**
+ * Описывает SDF/MSDF-путь для zoom-stable текста.
+ */
+export interface NovaRendererTextSdfConfig {
+    enabled: boolean;
+    pxRange: number;
+    source: 'runtime-sdf' | 'prebuilt-msdf';
+    minPaddingPx: number;
+    edgeSoftness: number;
+    prebuiltAtlas?: NovaMsdfFontAtlasConfig;
+}
+/**
+ * Описывает glyph metrics внутри prebuilt MSDF atlas.
+ */
+export interface NovaMsdfGlyphMetrics {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    advance: number;
+    bearingX?: number;
+    bearingY?: number;
+    drawWidth?: number;
+    drawHeight?: number;
+}
+/**
+ * Описывает внешний MSDF font atlas.
+ */
+export interface NovaMsdfFontAtlasConfig {
+    texture?: unknown;
+    glyphs: Record<string, NovaMsdfGlyphMetrics>;
+    pxRange?: number;
+    fontKey?: string;
+    scale?: number;
+}
+/**
+ * Описывает зональные режимы текста для продуктовых canvas.
+ */
+export interface NovaRendererTextZoneModes {
+    timeScale: NovaTextRenderMode;
+    taskLabels: NovaTextRenderMode;
+    uiLabels: NovaTextRenderMode;
+}
+/**
+ * Описывает контракт NovaRendererCacheConfig.
+ */
+export interface NovaRendererCacheConfig {
+    maxTextureMemoryMB: number;
+    maxTextAtlasMemoryMB: number;
+    maxGlyphAtlasMemoryMB: number;
+    groupCache: 'auto' | 'off' | 'aggressive';
+}
+/**
+ * Описывает контракт NovaRendererDiagnosticsConfig.
+ */
+export interface NovaRendererDiagnosticsConfig {
+    showBatches: boolean;
+    showDirtyRegions: boolean;
+    showAtlas: boolean;
+}
+/**
+ * Описывает контракт NovaRendererConfig.
+ */
+export interface NovaRendererConfig {
+    batching: NovaRendererBatchingConfig;
+    text: NovaRendererTextConfig;
+    cache: NovaRendererCacheConfig;
+    diagnostics: NovaRendererDiagnosticsConfig;
+}
+/**
+ * Описывает тип NovaRendererConfigInput.
+ */
+export interface NovaRendererConfigInput {
+    batching?: Partial<NovaRendererBatchingConfig>;
+    text?: Partial<Omit<NovaRendererTextConfig, 'modes' | 'interaction' | 'lod' | 'glyphs' | 'sdf'>> & {
+        modes?: Partial<NovaRendererTextZoneModes>;
+        interaction?: Partial<NovaRendererTextInteractionConfig>;
+        lod?: Partial<NovaRendererTextLodConfig>;
+        glyphs?: Partial<NovaRendererTextGlyphConfig>;
+        sdf?: Partial<NovaRendererTextSdfConfig>;
+    };
+    cache?: Partial<NovaRendererCacheConfig>;
+    diagnostics?: Partial<NovaRendererDiagnosticsConfig>;
+}
+/**
+ * Описывает контракт NovaRenderDirtyFlags.
+ */
+export interface NovaRenderDirtyFlags {
+    transform: boolean;
+    layout: boolean;
+    paint: boolean;
+    children: boolean;
+    resource: boolean;
+    cache: boolean;
+    visibility: boolean;
+}
+/**
+ * Описывает контракт NovaRenderVersions.
+ */
+export interface NovaRenderVersions {
+    transform: number;
+    layout: number;
+    paint: number;
+    children: number;
+    resource: number;
+    cache: number;
+    visibility: number;
+}
+/**
+ * Описывает контракт NovaRenderViewport.
+ */
+export interface NovaRenderViewport {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    dpr: number;
+}
+/**
+ * Описывает контракт NovaRenderClip.
+ */
+export interface NovaRenderClip {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Описывает контракт NovaRenderCachePolicy.
+ */
+export interface NovaRenderCachePolicy {
+    enabled: boolean;
+    mode: 'auto' | 'texture';
+    reason?: string;
+}
+/**
+ * Описывает тип NovaRenderTargetKind.
+ */
+export type NovaRenderTargetKind = 'screen' | 'texture' | 'cache' | 'effect' | 'picking' | 'debug';
+/**
+ * Описывает контракт NovaRenderTarget.
+ */
+export interface NovaRenderTarget {
+    id: NovaRenderTargetId;
+    kind: NovaRenderTargetKind;
+    width: number;
+    height: number;
+    dpr: number;
+    ownerGroupId?: NovaRenderGroupId;
+    textureId?: string;
+    framebufferId?: string;
+}
+/**
+ * Описывает тип NovaRenderItemKind.
+ */
+export type NovaRenderItemKind = 'rect' | 'border' | 'line' | 'circle' | 'arc' | 'polygon' | 'text' | 'icon' | 'image' | 'nine-slice-image' | 'pattern-rect' | 'texture' | 'cached-group' | 'particle-circle' | 'particle-sprite' | 'rect-batch' | 'time-range-segment-batch' | 'stripe-batch' | 'icon-batch' | 'text-batch' | 'custom';
+/**
+ * Описывает контракт NovaRenderItem.
+ */
+export interface NovaRenderItem {
+    id: NovaRenderItemId;
+    nodeId?: string;
+    groupId: NovaRenderGroupId;
+    layerId: NovaRenderLayerId;
+    kind: NovaRenderItemKind;
+    order: number;
+    batchKey: string;
+    schemaItem?: NovaSchemaItem<any>;
+    transform?: mat3;
+    clip?: NovaRenderClip | null;
+    bounds?: NovaBounds;
+    dirtyFlags?: Partial<NovaRenderDirtyFlags>;
+}
+/**
+ * Описывает тип NovaRenderStreamKind.
+ */
+export type NovaRenderStreamKind = 'plain-rect' | 'rounded-rect' | 'motion-rect' | 'border' | 'line' | 'circle' | 'arc' | 'polygon' | 'texture-quad' | 'text-run' | 'icon' | 'nine-slice-image' | 'pattern-rect' | 'cached-group' | 'particle-circle' | 'particle-sprite' | 'rect-batch' | 'time-range-segment-batch' | 'stripe-batch' | 'icon-batch' | 'text-batch';
+/**
+ * Описывает тип NovaRenderSemanticLayer.
+ */
+export type NovaRenderSemanticLayer = 'background' | 'border' | 'texture' | 'text' | 'selection' | 'overlay' | 'strict';
+/**
+ * Описывает контракт NovaRenderStreamSlot.
+ */
+export interface NovaRenderStreamSlot {
+    itemId: NovaRenderItemId;
+    offset: number;
+    count: number;
+    order: number;
+    batchKey: string;
+    bounds?: NovaBounds;
+}
+/**
+ * Описывает контракт NovaRenderStream.
+ */
+export interface NovaRenderStream {
+    id: NovaRenderStreamId;
+    groupId: NovaRenderGroupId;
+    kind: NovaRenderStreamKind;
+    strideFloats: number;
+    slotCapacity: number;
+    slotCount: number;
+    version: number;
+    slots: Array<NovaRenderStreamSlot>;
+}
+/**
+ * Описывает контракт NovaRenderBatch.
+ */
+export interface NovaRenderBatch {
+    id: string;
+    groupId: NovaRenderGroupId;
+    streamId: NovaRenderStreamId;
+    streamKind: NovaRenderStreamKind;
+    semanticLayer: NovaRenderSemanticLayer;
+    batchKey: string;
+    startSlot: number;
+    slotCount: number;
+    orderStart: number;
+    orderEnd: number;
+}
+/**
+ * Описывает контракт NovaBatchPlan.
+ */
+export interface NovaBatchPlan {
+    id: string;
+    groupId: NovaRenderGroupId;
+    semanticScope?: NovaSemanticScopeKind;
+    version: number;
+    batches: Array<NovaRenderBatch>;
+}
+/**
+ * Описывает контракт NovaRenderHandle.
+ */
+export interface NovaRenderHandle {
+    id: NovaRenderHandleId;
+    nodeId: string;
+    itemId: NovaRenderItemId;
+    groupId: NovaRenderGroupId;
+    layerId: NovaRenderLayerId;
+    streamId: NovaRenderStreamId;
+    streamKind: NovaRenderStreamKind;
+    offset: number;
+    count: number;
+    slotOffset?: number;
+    slotCount?: number;
+    batchKey: string;
+    versions: NovaRenderVersions;
+    resourceKey?: string;
+    localBounds?: NovaBounds;
+}
+/**
+ * Описывает тип NovaRenderCommandType.
+ */
+export type NovaRenderCommandType = 'clear' | 'save' | 'restore' | 'setTransform' | 'clip' | 'clearClip' | 'beginRenderTarget' | 'endRenderTarget' | 'drawRenderTarget' | 'drawItem' | 'drawSchemaBatch' | 'drawParticles' | 'drawRectBatch' | 'drawTimeRangeSegmentBatch' | 'drawStripeBatch' | 'drawIconBatch' | 'drawTextBatch' | 'cursor' | 'beginGroup' | 'endGroup';
+/**
+ * Описывает контракт NovaRenderCommand.
+ */
+export interface NovaRenderCommand {
+    id: string;
+    type: NovaRenderCommandType;
+    order: number;
+    nodeId?: string;
+    groupId?: NovaRenderGroupId;
+    layerId?: NovaRenderLayerId;
+    itemId?: NovaRenderItemId;
+    schemaItems?: Array<NovaSchemaItem<any>>;
+    schemaMode?: 'batched' | 'ordered';
+    schemaSemanticScope?: NovaSemanticScopeKind;
+    schemaContentVersion?: number;
+    particleBatch?: NovaParticleBatch;
+    rectBatch?: NovaRectBatch;
+    timeRangeSegmentBatch?: NovaTimeRangeSegmentBatch;
+    stripeBatch?: NovaStripeRectBatch;
+    iconBatch?: NovaIconBatch;
+    textBatch?: NovaTextBatch;
+    transform?: mat3;
+    clip?: NovaRenderClip;
+    target?: NovaRenderTarget;
+    targetId?: NovaRenderTargetId;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    cursor?: string;
+}
+/**
+ * Описывает контракт NovaInstructionBuffer.
+ */
+export interface NovaInstructionBuffer {
+    id: string;
+    version: number;
+    commands: Array<NovaRenderCommand>;
+    items: Array<NovaRenderItem>;
+    reused: boolean;
+}
+/**
+ * Описывает контракт NovaRenderGroup.
+ */
+export interface NovaRenderGroup {
+    id: NovaRenderGroupId;
+    ownerNodeId?: string;
+    parentGroupId?: NovaRenderGroupId;
+    layerId: NovaRenderLayerId;
+    transform?: mat3;
+    opacity: number;
+    clip?: NovaRenderClip;
+    cachePolicy?: NovaRenderCachePolicy;
+    dirtyFlags: NovaRenderDirtyFlags;
+    versions: NovaRenderVersions;
+    instructionBuffer: NovaInstructionBuffer;
+    renderHandlesByNodeId?: Map<string, Array<NovaRenderHandle>>;
+    streams?: Map<NovaRenderStreamId, NovaRenderStream>;
+    batchPlan?: NovaBatchPlan;
+    chunkBounds?: NovaBounds;
+    semanticScope?: NovaSemanticScopeKind;
+    cacheTargetId?: NovaRenderTargetId;
+    visible?: boolean;
+    childGroupIds: Array<NovaRenderGroupId>;
+    bounds?: NovaBounds;
+    lastCompiledVersion: number;
+    lastRenderedVersion: number;
+}
+/**
+ * Описывает контракт NovaRenderLayer.
+ */
+export interface NovaRenderLayer {
+    id: NovaRenderLayerId;
+    zIndex: number;
+    rootGroup: NovaRenderGroup;
+    targetId?: NovaRenderTargetId;
+}
+/**
+ * Описывает контракт NovaRenderResourceDelta.
+ */
+export interface NovaRenderResourceDelta {
+    texturesCreated: number;
+    texturesUpdated: number;
+    texturesEvicted: number;
+    textRunsRasterized: number;
+    bytesUploaded: number;
+}
+/**
+ * Описывает контракт NovaRenderMetrics.
+ */
+export interface NovaRenderMetrics {
+    compilerMs: number;
+    backendMs: number;
+    uploadMs: number;
+    drawMs: number;
+    drawCalls: number;
+    batches: number;
+    instances?: number;
+    uploadBytes?: number;
+    bufferDataCalls?: number;
+    bufferSubDataCalls?: number;
+    schemaResidentBatchHits?: number;
+    schemaResidentBatchMisses?: number;
+    schemaResidentBatchUploads?: number;
+    fullUploads?: number;
+    dirtyRangeCount?: number;
+    gpuBufferCapacityBytes?: number;
+    nodeRenderCalls?: number;
+    compiledGroups?: number;
+    reusedGroups?: number;
+    updatedHandles?: number;
+    dirtyStreamRanges?: number;
+    textRasterCount?: number;
+    textRasterPixels?: number;
+    textRasterBytes?: number;
+    textRasterBoxPixels?: number;
+    textRasterSavedPixels?: number;
+    textCacheHits?: number;
+    textCacheMisses?: number;
+    textRasterDeferred?: number;
+    textAtlasPages?: number;
+    effectiveTextRasterScale?: number;
+    visibleTextRuns?: number;
+    culledTextRuns?: number;
+    glyphCacheHits?: number;
+    glyphCacheMisses?: number;
+    glyphRasterCount?: number;
+    glyphAtlasPages?: number;
+    glyphQuads?: number;
+    msdfGlyphCount?: number;
+    sdfGlyphCount?: number;
+    distanceFieldGlyphQuads?: number;
+    distanceFieldDrawCalls?: number;
+    runtimeSdfGlyphCount?: number;
+    prebuiltMsdfGlyphCount?: number;
+    textRunCacheHits?: number;
+    textRunCacheMisses?: number;
+    textShapeMs?: number;
+    glyphGeometryUploads?: number;
+    textAtlasEvictions?: number;
+    glyphAtlasEvictions?: number;
+    pinnedAtlasPages?: number;
+    interactionTextMode?: 'stable-quality' | 'balanced' | 'performance';
+    lodDroppedTextRuns?: number;
+    textModeFallbacks?: number;
+    textureBatchFallbacks?: number;
+    textBucketChanges?: number;
+    textBudgetExhausted?: number;
+    visibleRectItems?: number;
+    culledRectItems?: number;
+    atlasUploads?: number;
+    renderTargetRepaints?: number;
+    renderTargetDraws?: number;
+    renderTargetAllocations?: number;
+    renderTargetBytes?: number;
+    renderTargetUploadMs?: number;
+    renderTargetTextureCount?: number;
+    uniformOnlyFrames?: number;
+    commands: number;
+    items: number;
+    groups: number;
+    textRasterMs: number;
+    atlasMemoryMB: number;
+    cachedTextureMemoryMB: number;
+}
+/**
+ * Описывает контракт NovaRenderFrame.
+ */
+export interface NovaRenderFrame {
+    id: number;
+    surfaceId: string;
+    rendererType: RendererType;
+    viewport: NovaRenderViewport;
+    layers: Array<NovaRenderLayer>;
+    targets: Array<NovaRenderTarget>;
+    groups: Array<NovaRenderGroup>;
+    items: Array<NovaRenderItem>;
+    commands: Array<NovaRenderCommand>;
+    resourceDelta: NovaRenderResourceDelta;
+    metrics: NovaRenderMetrics;
+}

package/dist/domain/types/semantic.types.d.ts

@@ -0,0 +1,69 @@
+import { DataRect } from '@endge/utils';
+export type NovaSemanticRole = 'application' | 'region' | 'group' | 'button' | 'chart' | 'axis' | 'grid' | 'series' | 'mark' | 'legend' | 'tooltip' | 'viewport' | 'custom';
+export interface NovaSemanticState {
+    hovered?: boolean;
+    selected?: boolean;
+    focused?: boolean;
+    disabled?: boolean;
+    hidden?: boolean;
+    expanded?: boolean;
+    checked?: boolean;
+    muted?: boolean;
+    current?: boolean;
+    valueText?: string;
+}
+export interface NovaSemanticSource {
+    type?: 'node' | 'schema' | 'synthetic' | 'plugin' | 'custom';
+    nodeId?: string;
+    componentId?: string;
+    part?: string;
+}
+export interface NovaSemanticRegion {
+    id: string;
+    role: NovaSemanticRole;
+    label?: string;
+    description?: string;
+    scope?: string;
+    bounds?: DataRect;
+    focusable?: boolean;
+    order: number;
+    state?: NovaSemanticState;
+    source?: NovaSemanticSource;
+    data?: Record<string, unknown>;
+}
+export interface NovaSemanticRegisterOptions {
+    id?: string;
+    role: NovaSemanticRole;
+    label?: string;
+    description?: string;
+    scope?: string;
+    bounds?: DataRect;
+    focusable?: boolean;
+    order?: number;
+    state?: NovaSemanticState;
+    source?: NovaSemanticSource;
+    data?: Record<string, unknown>;
+}
+export interface NovaSemanticQueryOptions {
+    id?: string;
+    scope?: string;
+    role?: NovaSemanticRole;
+    roles?: Array<NovaSemanticRole>;
+    focusable?: boolean;
+    includeHidden?: boolean;
+    includeDisabled?: boolean;
+    maxRegions?: number;
+}
+export interface NovaSemanticSnapshotOptions extends NovaSemanticQueryOptions {
+    includeData?: boolean;
+}
+export interface NovaSemanticSnapshot {
+    generatedAt: number;
+    regionCount: number;
+    focusedId?: string;
+    scope?: string;
+    regions: Array<NovaSemanticRegion>;
+}
+export interface NovaSemanticSchemaItem extends Omit<NovaSemanticRegisterOptions, 'bounds'> {
+    bounds?: DataRect;
+}

package/dist/domain/types/sound.types.d.ts

@@ -0,0 +1,84 @@
+import { NovaNodeEventHandlers } from './events.types';
+/**
+ * Описывает режим unlock для браузерного audio context.
+ */
+export type NovaSoundUnlockMode = 'first-input' | 'manual' | 'immediate';
+/**
+ * Описывает состояние одного sound handle.
+ */
+export type NovaSoundHandleState = 'idle' | 'playing' | 'stopped' | 'ended';
+/**
+ * Описывает настройки Nova Sound Engine.
+ */
+export interface NovaSoundOptions {
+    enabled?: boolean;
+    muted?: boolean;
+    volume?: number;
+    maxVoices?: number;
+    unlock?: NovaSoundUnlockMode;
+    formats?: Array<string>;
+}
+/**
+ * Описывает загружаемый sound asset.
+ */
+export interface NovaSoundDescriptor {
+    id: string;
+    src: string | Array<string>;
+    category?: string;
+    volume?: number;
+    loop?: boolean;
+    preload?: boolean;
+    cooldownMs?: number;
+    maxInstances?: number;
+    priority?: number;
+}
+/**
+ * Описывает runtime-настройки одного playback.
+ */
+export interface NovaSoundPlayOptions {
+    volume?: number;
+    rate?: number;
+    pan?: number;
+    loop?: boolean;
+    dedupeKey?: string;
+    cooldownMs?: number;
+    category?: string;
+    priority?: number;
+}
+/**
+ * Описывает play/stop handle конкретного воспроизведения.
+ */
+export interface NovaSoundHandle {
+    readonly id: string;
+    readonly state: NovaSoundHandleState;
+    readonly ended: Promise<void>;
+    stop: () => void;
+    fadeTo: (volume: number, durationMs?: number) => void;
+}
+/**
+ * Описывает sound cue для привязки к событиям node или UI Kit.
+ */
+export interface NovaSoundCueOptions extends NovaSoundPlayOptions {
+    id: string;
+}
+/**
+ * Описывает входной формат sound cue.
+ */
+export type NovaSoundCueInput = string | NovaSoundCueOptions;
+/**
+ * Описывает карту событий node к sound cue.
+ */
+export type NovaNodeSoundMap = Partial<Record<keyof NovaNodeEventHandlers, NovaSoundCueInput>>;
+/**
+ * Описывает статистику Sound Engine.
+ */
+export interface NovaSoundStats {
+    loaded: number;
+    active: number;
+    played: number;
+    skipped: number;
+    decoded: number;
+    unlocked: boolean;
+    muted: boolean;
+    volume: number;
+}