@endge/nova 0.13.6 → 0.13.11

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

@@ -0,0 +1,85 @@
+export declare const NodeEventNames: {
+    readonly click: "click";
+    readonly dblclick: "dblclick";
+    readonly contextmenu: "contextmenu";
+    readonly mousemove: "mousemove";
+    readonly mousedown: "mousedown";
+    readonly mouseup: "mouseup";
+    readonly canvasenter: "canvasenter";
+    readonly canvasleave: "canvasleave";
+    readonly wheel: "wheel";
+    readonly keydown: "keydown";
+    readonly keyup: "keyup";
+    readonly focus: "focus";
+    readonly blur: "blur";
+    readonly select: "select";
+    readonly deselect: "deselect";
+    readonly gotpointercapture: "gotpointercapture";
+    readonly lostpointercapture: "lostpointercapture";
+    readonly mouseenter: "mouseenter";
+    readonly mouseleave: "mouseleave";
+    readonly doubleClick: "dblclick";
+    readonly zoom: "zoom";
+    readonly dragStart: "mousedown";
+    readonly dragEnd: "mouseup";
+    readonly dragMove: "mousemove";
+};
+/**
+ * Описывает тип NodeEventName.
+ */
+export type NodeEventName = keyof typeof NodeEventNames;
+/**
+ * Описывает тип DomEventName.
+ */
+export type DomEventName = 'click' | 'dblclick' | 'contextmenu' | 'mousemove' | 'mousedown' | 'mouseup' | 'wheel' | 'zoom' | 'keydown' | 'keyup' | 'mouseenter' | 'mouseleave';
+export declare const CanvasDomEvents: Array<DomEventName>;
+export declare const NovaSupportedNativeEvents: readonly ["click", "dblclick", "contextmenu", "mousemove", "mousedown", "mouseup", "wheel", "keydown", "keyup", "mouseenter", "mouseleave", "canvasenter", "canvasleave", "focus", "blur", "select", "deselect", "gotpointercapture", "lostpointercapture", "hover", "dragstart", "dragmove", "dragend", "dragcancel"];
+/**
+ * Описывает контракт CanvasEventHandlers.
+ */
+export interface CanvasEventHandlers {
+    click?: (e: MouseEvent) => void;
+    dblclick?: (e: MouseEvent) => void;
+    contextmenu?: (e: MouseEvent) => void;
+    mousemove?: (e: MouseEvent) => void;
+    mousedown?: (e: MouseEvent) => void;
+    mouseup?: (e: MouseEvent) => void;
+    wheel?: (e: WheelEvent) => void;
+    keydown?: (e: KeyboardEvent) => void;
+    keyup?: (e: KeyboardEvent) => void;
+}
+/**
+ * Описывает контракт NovaNodeEventHandlers.
+ */
+export interface NovaNodeEventHandlers extends CanvasEventHandlers {
+    mouseenter?: (e: MouseEvent) => void;
+    mouseleave?: (e: MouseEvent) => void;
+    canvasenter?: (e: MouseEvent) => void;
+    canvasleave?: (e: MouseEvent) => void;
+    focus?: (e: Event) => void;
+    blur?: (e: Event) => void;
+    select?: (e: Event) => void;
+    deselect?: (e: Event) => void;
+    gotpointercapture?: (e: MouseEvent) => void;
+    lostpointercapture?: (e: MouseEvent) => void;
+    zoom?: (e: WheelEvent) => void;
+    hover?: (e: MouseEvent, isHover: boolean) => void;
+    dragstart?: (e: MouseEvent, meta: NovaDragEventMeta) => void;
+    dragend?: (e: MouseEvent, meta: NovaDragEventMeta) => void;
+    dragcancel?: (e: MouseEvent, meta: NovaDragEventMeta) => void;
+    dragmove?: (e: MouseEvent, dx: number, dy: number, meta: NovaDragEventMeta) => void;
+}
+/**
+ * Описывает контракт NovaDragEventMeta.
+ */
+export interface NovaDragEventMeta {
+    pointerId: number;
+    startX: number;
+    startY: number;
+    x: number;
+    y: number;
+    dx: number;
+    dy: number;
+    totalDx: number;
+    totalDy: number;
+}

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

@@ -0,0 +1,27 @@
+import { DataRect } from '@endge/utils';
+import { NovaSemanticSnapshot } from './semantic.types';
+export type NovaExportFormat = 'png' | 'webp';
+export interface NovaExportImageOptions {
+    format?: NovaExportFormat;
+    quality?: number;
+    pixelRatio?: number;
+    rect?: DataRect;
+    background?: string;
+    preferBlob?: boolean;
+    includeSemanticSnapshot?: boolean;
+}
+export interface NovaExportImageResult {
+    format: NovaExportFormat;
+    width: number;
+    height: number;
+    pixelRatio: number;
+    dataUrl?: string;
+    blob?: Blob;
+    byteLength?: number;
+    semanticSnapshot?: NovaSemanticSnapshot;
+}
+export type NovaExportErrorCode = 'unsupported-format' | 'tainted-canvas' | 'context-lost' | 'empty-canvas';
+export declare class NovaExportError extends Error {
+    readonly code: NovaExportErrorCode;
+    constructor(code: NovaExportErrorCode, message: string, cause?: unknown);
+}

package/dist/domain/types/hit-test.types.d.ts

@@ -0,0 +1,16 @@
+import { NovaBounds } from './renderer.types';
+/**
+ * Описывает контекст shape-level hit-test для Nova node.
+ */
+export interface NovaHitTestContext<TNode = unknown> {
+    node: TNode;
+    worldX: number;
+    worldY: number;
+    localX: number;
+    localY: number;
+    bounds: NovaBounds;
+}
+/**
+ * Описывает пользовательский shape-level hit-test handler.
+ */
+export type NovaHitTestHandler<TNode = unknown> = (context: NovaHitTestContext<TNode>) => boolean;

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

@@ -0,0 +1,118 @@
+import { RaphFrameContext } from '@endge/raph';
+import { NovaComponentNode } from '../../model/runtime/components/NovaComponentNode';
+import { NovaNode } from '../../model/runtime/tree/NovaNode';
+/**
+ * Описывает тип NovaMotionTarget.
+ */
+export type NovaMotionTarget = NovaNode<any> | NovaComponentNode<any, any, any, any, any>;
+/**
+ * Описывает тип NovaMotionValue.
+ */
+export type NovaMotionValue = number | string | boolean | undefined;
+/**
+ * Описывает тип NovaMotionPatch.
+ */
+export type NovaMotionPatch = Record<string, NovaMotionValue>;
+/**
+ * Описывает тип NovaMotionEasingName.
+ */
+export type NovaMotionEasingName = 'linear' | 'inQuad' | 'outQuad' | 'inOutQuad' | 'inCubic' | 'outCubic' | 'inOutCubic';
+/**
+ * Описывает тип NovaMotionPlaybackState.
+ */
+export type NovaMotionPlaybackState = 'idle' | 'running' | 'paused' | 'finished' | 'cancelled';
+/**
+ * Описывает контракт NovaMotionOptions.
+ */
+export interface NovaMotionOptions {
+    duration?: number;
+    delay?: number;
+    easing?: NovaMotionEasingName | ((t: number) => number);
+    repeat?: number;
+    yoyo?: boolean;
+    overwrite?: boolean;
+    autoplay?: boolean;
+    id?: string;
+}
+/**
+ * Описывает контракт NovaMotionTweenOptions.
+ */
+export interface NovaMotionTweenOptions extends NovaMotionOptions {
+    from?: NovaMotionPatch;
+}
+/**
+ * Описывает тип NovaMotionKeyframe.
+ */
+export type NovaMotionKeyframe = NovaMotionPatch & {
+    at?: number;
+    easing?: NovaMotionOptions['easing'];
+};
+/**
+ * Описывает контракт NovaMotionTrack.
+ */
+export interface NovaMotionTrack {
+    target: NovaMotionTarget;
+    at?: number;
+    keyframes: Array<NovaMotionKeyframe>;
+    easing?: NovaMotionOptions['easing'];
+    duration?: number;
+}
+/**
+ * Описывает контракт NovaMotionSequenceItem.
+ */
+export interface NovaMotionSequenceItem {
+    target: NovaMotionTarget;
+    patch: NovaMotionPatch;
+    duration?: number;
+    delay?: number;
+    easing?: NovaMotionOptions['easing'];
+}
+/**
+ * Описывает контракт NovaMotionStaggerOptions.
+ */
+export interface NovaMotionStaggerOptions {
+    targets: Array<NovaMotionTarget>;
+    patch: NovaMotionPatch;
+    each: number;
+    duration?: number;
+    easing?: NovaMotionOptions['easing'];
+}
+/**
+ * Описывает контракт NovaMotionTimelineOptions.
+ */
+export interface NovaMotionTimelineOptions extends NovaMotionOptions {
+    tracks?: Array<NovaMotionTrack>;
+    sequence?: Array<NovaMotionSequenceItem>;
+    stagger?: NovaMotionStaggerOptions;
+}
+/**
+ * Описывает контракт NovaMotionPlayback.
+ */
+export interface NovaMotionPlayback {
+    readonly id?: string;
+    readonly state: NovaMotionPlaybackState;
+    play: () => void;
+    pause: () => void;
+    resume: () => void;
+    cancel: () => void;
+    seek: (time: number) => void;
+}
+/**
+ * Описывает контракт NovaMotionTickContext.
+ */
+export interface NovaMotionTickContext extends RaphFrameContext {
+}
+/**
+ * Описывает контракт NovaMotionSegment.
+ */
+export interface NovaMotionSegment {
+    id?: string;
+    playback: NovaMotionPlayback;
+    target: NovaMotionTarget;
+    key: string;
+    from: NovaMotionValue;
+    to: NovaMotionValue;
+    startAt: number;
+    duration: number;
+    easing: NovaMotionOptions['easing'];
+}