@endge/nova 0.13.6 → 0.13.14

package/dist/model/motion/nova-motion-presets.d.ts

@@ -0,0 +1,288 @@
+import { NovaMotionOptions, NovaMotionPlayback, NovaMotionTarget } from '../../domain/types/motion.types';
+import { NovaMotionEngine } from './NovaMotionEngine';
+/**
+ * Описывает тип NovaMotionPresetCategory.
+ */
+export type NovaMotionPresetCategory = 'Fade' | 'Slide' | 'Scale' | 'Rotate' | 'Attention' | 'Gesture' | 'Visual';
+/**
+ * Описывает тип NovaMotionPatternCategory.
+ */
+export type NovaMotionPatternCategory = 'Stagger' | 'Timeline' | 'Sequence' | 'Repeat';
+/**
+ * Описывает контракт NovaMotionPresetMeta.
+ */
+export interface NovaMotionPresetMeta {
+    title: string;
+    category: NovaMotionPresetCategory;
+    description: string;
+    duration: number;
+}
+/**
+ * Описывает контракт NovaMotionPatternMeta.
+ */
+export interface NovaMotionPatternMeta {
+    title: string;
+    category: NovaMotionPatternCategory;
+    description: string;
+    duration: number;
+}
+/**
+ * Описывает контракт NovaMotionPresetOptions.
+ */
+export interface NovaMotionPresetOptions extends NovaMotionOptions {
+    distance?: number;
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+}
+/**
+ * Описывает контракт NovaMotionPatternOptions.
+ */
+export interface NovaMotionPatternOptions extends NovaMotionOptions {
+    each?: number;
+    distance?: number;
+    columns?: number;
+    fill?: string;
+}
+/**
+ * Хранит значение NOVA_MOTION_PRESETS, используемое runtime-кодом пакета.
+ */
+export declare const NOVA_MOTION_PRESETS: {
+    readonly fadeIn: {
+        readonly title: "Fade In";
+        readonly category: "Fade";
+        readonly description: "Плавно проявляет элемент через opacity.";
+        readonly duration: 220;
+    };
+    readonly fadeOut: {
+        readonly title: "Fade Out";
+        readonly category: "Fade";
+        readonly description: "Плавно скрывает элемент через opacity.";
+        readonly duration: 220;
+    };
+    readonly fadeUp: {
+        readonly title: "Fade Up";
+        readonly category: "Fade";
+        readonly description: "Проявляет элемент со смещением вверх.";
+        readonly duration: 280;
+    };
+    readonly fadeDown: {
+        readonly title: "Fade Down";
+        readonly category: "Fade";
+        readonly description: "Проявляет элемент со смещением вниз.";
+        readonly duration: 280;
+    };
+    readonly fadeLeft: {
+        readonly title: "Fade Left";
+        readonly category: "Fade";
+        readonly description: "Проявляет элемент со смещением влево.";
+        readonly duration: 280;
+    };
+    readonly fadeRight: {
+        readonly title: "Fade Right";
+        readonly category: "Fade";
+        readonly description: "Проявляет элемент со смещением вправо.";
+        readonly duration: 280;
+    };
+    readonly slideInLeft: {
+        readonly title: "Slide In Left";
+        readonly category: "Slide";
+        readonly description: "Вводит элемент слева без изменения layout.";
+        readonly duration: 320;
+    };
+    readonly slideInRight: {
+        readonly title: "Slide In Right";
+        readonly category: "Slide";
+        readonly description: "Вводит элемент справа без изменения layout.";
+        readonly duration: 320;
+    };
+    readonly slideInUp: {
+        readonly title: "Slide In Up";
+        readonly category: "Slide";
+        readonly description: "Вводит элемент снизу вверх.";
+        readonly duration: 320;
+    };
+    readonly slideInDown: {
+        readonly title: "Slide In Down";
+        readonly category: "Slide";
+        readonly description: "Вводит элемент сверху вниз.";
+        readonly duration: 320;
+    };
+    readonly scaleIn: {
+        readonly title: "Scale In";
+        readonly category: "Scale";
+        readonly description: "Увеличивает элемент до базового размера.";
+        readonly duration: 260;
+    };
+    readonly scaleOut: {
+        readonly title: "Scale Out";
+        readonly category: "Scale";
+        readonly description: "Уменьшает элемент и скрывает его.";
+        readonly duration: 240;
+    };
+    readonly zoomIn: {
+        readonly title: "Zoom In";
+        readonly category: "Scale";
+        readonly description: "Быстро приближает элемент с проявлением.";
+        readonly duration: 280;
+    };
+    readonly zoomOut: {
+        readonly title: "Zoom Out";
+        readonly category: "Scale";
+        readonly description: "Отдаляет элемент и скрывает его.";
+        readonly duration: 240;
+    };
+    readonly rotateIn: {
+        readonly title: "Rotate In";
+        readonly category: "Rotate";
+        readonly description: "Проявляет элемент через небольшой поворот.";
+        readonly duration: 320;
+    };
+    readonly spin: {
+        readonly title: "Spin";
+        readonly category: "Rotate";
+        readonly description: "Поворачивает элемент на полный оборот.";
+        readonly duration: 640;
+    };
+    readonly pulse: {
+        readonly title: "Pulse";
+        readonly category: "Attention";
+        readonly description: "Дает мягкий импульс масштаба.";
+        readonly duration: 420;
+    };
+    readonly heartbeat: {
+        readonly title: "Heartbeat";
+        readonly category: "Attention";
+        readonly description: "Дает два коротких импульса масштаба.";
+        readonly duration: 560;
+    };
+    readonly bounce: {
+        readonly title: "Bounce";
+        readonly category: "Attention";
+        readonly description: "Подбрасывает элемент по оси y.";
+        readonly duration: 620;
+    };
+    readonly shakeX: {
+        readonly title: "Shake X";
+        readonly category: "Attention";
+        readonly description: "Качает элемент по горизонтали.";
+        readonly duration: 520;
+    };
+    readonly shakeY: {
+        readonly title: "Shake Y";
+        readonly category: "Attention";
+        readonly description: "Качает элемент по вертикали.";
+        readonly duration: 520;
+    };
+    readonly wobble: {
+        readonly title: "Wobble";
+        readonly category: "Attention";
+        readonly description: "Качает элемент смещением и поворотом.";
+        readonly duration: 620;
+    };
+    readonly swing: {
+        readonly title: "Swing";
+        readonly category: "Attention";
+        readonly description: "Раскачивает элемент вокруг базового угла.";
+        readonly duration: 620;
+    };
+    readonly rubberBand: {
+        readonly title: "Rubber Band";
+        readonly category: "Attention";
+        readonly description: "Сжимает и растягивает элемент по двум осям.";
+        readonly duration: 620;
+    };
+    readonly press: {
+        readonly title: "Press";
+        readonly category: "Gesture";
+        readonly description: "Имитирует короткий отклик на нажатие.";
+        readonly duration: 180;
+    };
+    readonly hoverLift: {
+        readonly title: "Hover Lift";
+        readonly category: "Gesture";
+        readonly description: "Слегка приподнимает элемент вверх.";
+        readonly duration: 180;
+    };
+    readonly highlight: {
+        readonly title: "Highlight";
+        readonly category: "Visual";
+        readonly description: "Подсвечивает заливку и возвращает исходный цвет.";
+        readonly duration: 520;
+    };
+    readonly borderPulse: {
+        readonly title: "Border Pulse";
+        readonly category: "Visual";
+        readonly description: "Усиливает обводку и возвращает исходное состояние.";
+        readonly duration: 520;
+    };
+};
+/**
+ * Хранит значение NOVA_MOTION_PATTERNS, используемое runtime-кодом пакета.
+ */
+export declare const NOVA_MOTION_PATTERNS: {
+    readonly staggerFade: {
+        readonly title: "Stagger Fade";
+        readonly category: "Stagger";
+        readonly description: "Проявляет группу с задержкой по индексу.";
+        readonly duration: 520;
+    };
+    readonly staggerRise: {
+        readonly title: "Stagger Rise";
+        readonly category: "Stagger";
+        readonly description: "Поднимает группу с задержкой по индексу.";
+        readonly duration: 560;
+    };
+    readonly staggerScale: {
+        readonly title: "Stagger Scale";
+        readonly category: "Stagger";
+        readonly description: "Увеличивает группу с задержкой по индексу.";
+        readonly duration: 520;
+    };
+    readonly timelineWave: {
+        readonly title: "Timeline Wave";
+        readonly category: "Timeline";
+        readonly description: "Запускает волну масштаба по группе targets.";
+        readonly duration: 720;
+    };
+    readonly cascade: {
+        readonly title: "Cascade";
+        readonly category: "Timeline";
+        readonly description: "Вводит элементы каскадом слева направо.";
+        readonly duration: 640;
+    };
+    readonly sequenceChain: {
+        readonly title: "Sequence Chain";
+        readonly category: "Sequence";
+        readonly description: "Последовательно проявляет элементы через sequence.";
+        readonly duration: 720;
+    };
+    readonly repeatYoyo: {
+        readonly title: "Repeat Yoyo";
+        readonly category: "Repeat";
+        readonly description: "Повторяет движение вперед и назад.";
+        readonly duration: 620;
+    };
+    readonly gridWave: {
+        readonly title: "Grid Wave";
+        readonly category: "Stagger";
+        readonly description: "Запускает волну по сетке с учетом строки и колонки.";
+        readonly duration: 760;
+    };
+};
+/**
+ * Описывает тип NovaMotionPresetName.
+ */
+export type NovaMotionPresetName = keyof typeof NOVA_MOTION_PRESETS;
+/**
+ * Описывает тип NovaMotionPatternName.
+ */
+export type NovaMotionPatternName = keyof typeof NOVA_MOTION_PATTERNS;
+/**
+ * Выполняет публичную операцию run nova motion preset.
+ */
+export declare function runNovaMotionPreset(engine: NovaMotionEngine, target: NovaMotionTarget, name: NovaMotionPresetName, options?: NovaMotionPresetOptions): NovaMotionPlayback;
+/**
+ * Выполняет публичную операцию run nova motion pattern.
+ */
+export declare function runNovaMotionPattern(engine: NovaMotionEngine, targets: Array<NovaMotionTarget>, name: NovaMotionPatternName, options?: NovaMotionPatternOptions): NovaMotionPlayback;

package/dist/model/motion/nova-motion-timeline.d.ts

@@ -0,0 +1,5 @@
+import { NovaMotionPlayback, NovaMotionSegment, NovaMotionTimelineOptions, NovaMotionValue } from '../../domain/types/motion.types';
+/**
+ * Компилирует nova motion timeline.
+ */
+export declare function compileNovaMotionTimeline(playback: NovaMotionPlayback, options: NovaMotionTimelineOptions, readValue: (target: NovaMotionSegment['target'], key: string) => NovaMotionValue): Array<NovaMotionSegment>;

package/dist/model/platform/NovaCanvas.d.ts

@@ -0,0 +1,112 @@
+import { NovaCanvasCreateOptions, NovaSizeOptions } from '../../domain/types/base.types';
+import { NovaExportImageOptions, NovaExportImageResult } from '../../domain/types/export.types';
+import { RendererType } from '../../domain/types/renderer.types';
+/**
+ * Оборачивает HTMLCanvasElement и управляет context, DPR и ownership.
+ */
+export declare class NovaCanvas {
+    private readonly _element;
+    private readonly _ownership;
+    private _ctx2D?;
+    private _cachedRect?;
+    private _dpr;
+    private _maxDpr;
+    private _webglAttributes?;
+    private _handlersInited;
+    private _destroyed;
+    private _glId?;
+    private _isContextLost;
+    private _onContextLostCallback?;
+    private _onContextRestoredCallback?;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    private constructor();
+    /**
+     * Возвращает element.
+     */
+    get element(): HTMLCanvasElement;
+    /**
+     * Возвращает width.
+     */
+    get width(): number;
+    /**
+     * Возвращает height.
+     */
+    get height(): number;
+    /**
+     * Возвращает pixel width.
+     */
+    get pixelWidth(): number;
+    /**
+     * Возвращает pixel height.
+     */
+    get pixelHeight(): number;
+    /**
+     * Возвращает dpr.
+     */
+    get dpr(): number;
+    /**
+     * Возвращает max dpr.
+     */
+    get maxDpr(): number;
+    /**
+     * Возвращает webgl attributes.
+     */
+    get webglAttributes(): WebGLContextAttributes | undefined;
+    /**
+     * Возвращает bounding client rect.
+     */
+    getBoundingClientRect(): DOMRectReadOnly;
+    /**
+     * Выполняет внутреннюю операцию invalidate.
+     */
+    invalidate(): void;
+    /**
+     * Выполняет внутреннюю операцию resize.
+     */
+    resize(width: number, height: number, options?: Partial<NovaSizeOptions>): void;
+    /**
+     * Возвращает context2 d.
+     */
+    getContext2D(): CanvasRenderingContext2D;
+    /**
+     * Освобождает runtime resources и снимает связанные ссылки.
+     */
+    destroy(): void;
+    /**
+     * Обрабатывает событие context lost.
+     */
+    onContextLost(callback: () => void): void;
+    /**
+     * Обрабатывает событие context restored.
+     */
+    onContextRestored(callback: () => void): void;
+    /**
+     * Проверяет context lost.
+     */
+    isContextLost(): boolean;
+    /**
+     * Экспортирует текущий canvas frame без изменения layout/render state.
+     */
+    exportImage(options?: NovaExportImageOptions): Promise<NovaExportImageResult>;
+    /**
+     * Выполняет внутреннюю операцию create.
+     */
+    static create(width: number, height: number, contextType: RendererType, options?: NovaCanvasCreateOptions): NovaCanvas;
+    /**
+     * Выполняет внутреннюю операцию attach.
+     */
+    static attach(canvas: HTMLCanvasElement, options?: NovaCanvasCreateOptions): NovaCanvas;
+    /**
+     * Вычисляет dpr.
+     */
+    private _resolveDpr;
+    private _createExportCanvas;
+    /**
+     * Выполняет внутреннюю операцию init context loss handlers.
+     */
+    private _initContextLossHandlers;
+    private _handleContextLost;
+    private _handleContextRestored;
+}

package/dist/model/platform/NovaGraphics.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Содержит вспомогательные drawing helpers для Canvas2D primitives.
+ */
+export declare class NovaGraphics {
+    private static _assetsMap;
+    /**
+     * Получение канваса с графическим активом по имени.
+     */
+    static getAsset(name: string): HTMLCanvasElement | undefined;
+    /**
+     * Возвращает DPR (device pixel ratio).
+     */
+    static dpr(): number;
+    /**
+     * Утемняет цвет (hex) на указанный коэффициент.
+     */
+    static darkenColor(hex: string, factor: number): string;
+    /**
+     * Создает паттерн с диагональными линиями.
+     */
+    static createStripePattern(name: string, params: {
+        stripeColor: string;
+        bgColor: string;
+        stripeWidth: number;
+        angle?: number;
+        sizeK?: number;
+    }): HTMLCanvasElement | null;
+    /**
+     * Создает icon.
+     */
+    static createIcon(name: string, svgContent: string, fillColor?: string, w?: number, h?: number): Promise<HTMLCanvasElement>;
+}

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

@@ -0,0 +1,29 @@
+import { NovaRenderTarget } from '../../../../domain/types/rendering/index';
+import { NovaRenderTargetResource } from '../../targets/nova-render-target-resource';
+import { CreateNovaRenderTargetOptions, NovaRenderTargetManager } from '../../targets/NovaRenderTargetManager';
+/**
+ * Выделяет Canvas2D resources для offscreen render targets.
+ */
+export declare class NovaCanvas2DTargetManager extends NovaRenderTargetManager {
+    private readonly _resources;
+    /**
+     * Создает или обновляет logical target и соответствующий Canvas2D backing resource.
+     */
+    ensure(options: CreateNovaRenderTargetOptions): NovaRenderTarget;
+    /**
+     * Возвращает physical resource по target id.
+     */
+    resource(id: string): NovaRenderTargetResource | undefined;
+    /**
+     * Удаляет logical target и его backing resource.
+     */
+    delete(id: string): boolean;
+    /**
+     * Очищает все targets и resources.
+     */
+    clear(): void;
+    /**
+     * Создает Canvas2D resource.
+     */
+    private _createResource;
+}