@endge/nova 0.13.6 → 0.13.14

package/dist/model/input/NovaCaretBlinkController.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Координирует поведение контроллера NovaCaretBlinkController.
+ */
+export declare class NovaCaretBlinkController {
+    private readonly _onTick;
+    private readonly _interval;
+    private static readonly _instances;
+    private static _timer;
+    private _visible;
+    private _active;
+    /**
+     * Создает экземпляр NovaCaretBlinkController и подготавливает базовое состояние.
+     */
+    constructor(_onTick: (visible: boolean) => void, _interval?: number);
+    /**
+     * Возвращает значение состояния NovaCaretBlinkController.
+     */
+    getVisible(): boolean;
+    /**
+     * Запускает runtime-процесс NovaCaretBlinkController.
+     */
+    start(): void;
+    /**
+     * Останавливает runtime-процесс NovaCaretBlinkController.
+     */
+    stop(): void;
+    /**
+     * Сбрасывает состояние к базовым значениям NovaCaretBlinkController.
+     */
+    reset(): void;
+    /**
+     * Выполняет внутренний шаг ensureTimer для NovaCaretBlinkController.
+     */
+    private static _ensureTimer;
+}

package/dist/model/input/NovaClipboardService.d.ts

@@ -0,0 +1,18 @@
+export interface NovaClipboardResult {
+    ok: boolean;
+    text?: string;
+    error?: unknown;
+}
+/**
+ * Инкапсулирует сервисную логику NovaClipboardService.
+ */
+export declare class NovaClipboardService {
+    /**
+     * Выполняет действие readText в рамках ответственности NovaClipboardService.
+     */
+    readText(proxy?: HTMLTextAreaElement | null): Promise<NovaClipboardResult>;
+    /**
+     * Выполняет действие writeText в рамках ответственности NovaClipboardService.
+     */
+    writeText(text: string, proxy?: HTMLTextAreaElement | null): Promise<NovaClipboardResult>;
+}

package/dist/model/input/NovaInputProxy_Adapter.d.ts

@@ -0,0 +1,61 @@
+import { NovaInputEngine } from './nova-input.types';
+export interface NovaInputProxyOptions {
+    engine?: NovaInputEngine;
+    ownerDocument?: Document;
+    className?: string;
+    onInput?: (value: string, event: Event) => void;
+    onCompositionStart?: (event: CompositionEvent) => void;
+    onCompositionUpdate?: (event: CompositionEvent) => void;
+    onCompositionEnd?: (event: CompositionEvent) => void;
+}
+/**
+ * Инкапсулирует сервисную логику NovaInputProxy_Adapter.
+ */
+export declare class NovaInputProxy_Adapter {
+    /** Browser input element, attachment state и injected options. */
+    private _textarea;
+    private _attached;
+    private readonly _options;
+    /**
+     * ----------------------------------------
+     * PUBLIC
+     * ----------------------------------------
+     */
+    /**
+     * Создает экземпляр NovaInputProxy_Adapter и подготавливает базовое состояние.
+     */
+    constructor(options?: NovaInputProxyOptions);
+    /**
+     * Подключает внешнюю runtime-сущность NovaInputProxy_Adapter.
+     */
+    attach(): HTMLTextAreaElement | null;
+    /**
+     * Отключает внешнюю runtime-сущность NovaInputProxy_Adapter.
+     */
+    detach(): void;
+    /**
+     * Переводит focus в целевое состояние NovaInputProxy_Adapter.
+     */
+    focus(value: string, start: number, end?: number): void;
+    /**
+     * Снимает focus с целевого состояния NovaInputProxy_Adapter.
+     */
+    blur(): void;
+    /**
+     * Синхронизирует состояние между слоями NovaInputProxy_Adapter.
+     */
+    sync(value: string, start: number, end?: number): void;
+    /**
+     * Освобождает runtime-ресурсы и подписки NovaInputProxy_Adapter.
+     */
+    dispose(): void;
+    /**
+     * ----------------------------------------
+     * ACCESS
+     * ----------------------------------------
+     */
+    /** Возвращает hidden textarea для browser input integration. */
+    get element(): HTMLTextAreaElement | null;
+}
+/** @deprecated Используйте NovaInputProxy_Adapter. */
+export { NovaInputProxy_Adapter as NovaInputProxyService };

package/dist/model/input/NovaInputValidationController.d.ts

@@ -0,0 +1,46 @@
+import { NovaInputValidationResult, NovaInputValidationState } from './nova-input.types';
+export type NovaInputValidateFn<TValue = unknown, TContext = unknown> = (value: TValue, context: TContext) => NovaInputValidationResult | Promise<NovaInputValidationResult>;
+/**
+ * Координирует поведение контроллера NovaInputValidationController.
+ */
+export declare class NovaInputValidationController<TValue = unknown, TContext = unknown> {
+    private readonly _validateFn?;
+    private _token;
+    private _state;
+    /**
+     * Создает экземпляр NovaInputValidationController и подготавливает базовое состояние.
+     */
+    constructor(_validateFn?: NovaInputValidateFn<TValue, TContext> | undefined);
+    /**
+     * Возвращает значение состояния NovaInputValidationController.
+     */
+    getState(): NovaInputValidationState;
+    /**
+     * Выполняет действие markDirty в рамках ответственности NovaInputValidationController.
+     */
+    markDirty(): void;
+    /**
+     * Выполняет действие markTouched в рамках ответственности NovaInputValidationController.
+     */
+    markTouched(): void;
+    /**
+     * Выполняет действие markSubmitted в рамках ответственности NovaInputValidationController.
+     */
+    markSubmitted(): void;
+    /**
+     * Проверяет входное значение NovaInputValidationController.
+     */
+    validate(value: TValue, context: TContext): Promise<NovaInputValidationState>;
+    /**
+     * Обновляет значение состояния NovaInputValidationController.
+     */
+    setResult(result: NovaInputValidationResult): NovaInputValidationState;
+    /**
+     * Сбрасывает состояние к базовым значениям NovaInputValidationController.
+     */
+    reset(): void;
+    /**
+     * Применяет подготовленное состояние NovaInputValidationController.
+     */
+    private _applyResult;
+}

package/dist/model/input/NovaTextInputController.d.ts

@@ -0,0 +1,126 @@
+import { NovaTextInputContext, NovaTextInputControllerOptions, NovaTextInputLayoutResult, NovaTextInputSnapshot, NovaTextSelection } from './nova-input.types';
+/**
+ * Координирует поведение контроллера NovaTextInputController.
+ */
+export declare class NovaTextInputController {
+    private readonly _options;
+    private _value;
+    private _draft;
+    private _selectionStart;
+    private _selectionEnd;
+    private _focused;
+    private _composing;
+    private _dirty;
+    private readonly _multiline;
+    private readonly _maxLength?;
+    private readonly _historyLimit;
+    private _history;
+    /**
+     * Создает экземпляр NovaTextInputController и подготавливает базовое состояние.
+     */
+    constructor(_options?: NovaTextInputControllerOptions);
+    /**
+     * Возвращает значение состояния NovaTextInputController.
+     */
+    getState(): NovaTextInputSnapshot;
+    /**
+     * Обновляет значение состояния NovaTextInputController.
+     */
+    setValue(value: string | number, context?: NovaTextInputContext): void;
+    /**
+     * Обновляет значение состояния NovaTextInputController.
+     */
+    setDraft(value: string | number, context?: NovaTextInputContext): void;
+    /**
+     * Переводит focus в целевое состояние NovaTextInputController.
+     */
+    focus(): void;
+    /**
+     * Снимает focus с целевого состояния NovaTextInputController.
+     */
+    blur(): void;
+    /**
+     * Обновляет состояние выбора NovaTextInputController.
+     */
+    select(start?: number, end?: number): void;
+    /**
+     * Обновляет состояние выбора NovaTextInputController.
+     */
+    selectAll(): void;
+    /**
+     * Возвращает значение состояния NovaTextInputController.
+     */
+    getSelection(): NovaTextSelection;
+    /**
+     * Возвращает значение состояния NovaTextInputController.
+     */
+    getSelectedText(): string;
+    /**
+     * Добавляет сущность в runtime-коллекцию NovaTextInputController.
+     */
+    insertText(text: string, context?: NovaTextInputContext): void;
+    /**
+     * Удаляет сущность из runtime-коллекции NovaTextInputController.
+     */
+    deleteBackward(context?: NovaTextInputContext): void;
+    /**
+     * Удаляет сущность из runtime-коллекции NovaTextInputController.
+     */
+    deleteForward(context?: NovaTextInputContext): void;
+    /**
+     * Выполняет действие moveCaret в рамках ответственности NovaTextInputController.
+     */
+    moveCaret(direction: 'left' | 'right' | 'home' | 'end' | 'up' | 'down', options?: {
+        shift?: boolean;
+        word?: boolean;
+        layout?: NovaTextInputLayoutResult;
+    }): void;
+    /**
+     * Обрабатывает runtime-событие NovaTextInputController.
+     */
+    handleKeydown(event: Pick<KeyboardEvent, 'key' | 'metaKey' | 'ctrlKey' | 'altKey' | 'shiftKey' | 'preventDefault'>, context?: NovaTextInputContext): boolean;
+    /**
+     * Фиксирует подготовленные изменения NovaTextInputController.
+     */
+    commit(context?: NovaTextInputContext): void;
+    /**
+     * Выполняет действие cancel в рамках ответственности NovaTextInputController.
+     */
+    cancel(context?: NovaTextInputContext): void;
+    /**
+     * Запускает runtime-процесс NovaTextInputController.
+     */
+    startComposition(): void;
+    /**
+     * Обновляет runtime-состояние NovaTextInputController.
+     */
+    updateComposition(text: string, context?: NovaTextInputContext): void;
+    /**
+     * Выполняет действие endComposition в рамках ответственности NovaTextInputController.
+     */
+    endComposition(): void;
+    /**
+     * Выполняет действие undo в рамках ответственности NovaTextInputController.
+     */
+    undo(): void;
+    /**
+     * Выполняет внутренний шаг replaceRange для NovaTextInputController.
+     */
+    private _replaceRange;
+    /**
+     * Обновляет состояние выбора NovaTextInputController.
+     */
+    private _selectionBounds;
+    /**
+     * Выполняет внутренний шаг canEdit для NovaTextInputController.
+     */
+    private _canEdit;
+    /**
+     * Ограничивает значение допустимым диапазоном NovaTextInputController.
+     */
+    private _clampValue;
+    /**
+     * Выполняет внутренний шаг pushHistory для NovaTextInputController.
+     */
+    private _pushHistory;
+}

package/dist/model/input/NovaTextLayoutEngine.d.ts

@@ -0,0 +1,31 @@
+import { NovaRectLike, NovaTextInputLayoutOptions, NovaTextInputLayoutResult } from './nova-input.types';
+/**
+ * Описывает ответственность NovaTextLayoutEngine в архитектуре проекта.
+ */
+export declare class NovaTextLayoutEngine {
+    /**
+     * Выполняет действие layout в рамках ответственности NovaTextLayoutEngine.
+     */
+    layout(options: NovaTextInputLayoutOptions): NovaTextInputLayoutResult;
+    /**
+     * Выполняет действие coordinateToIndex в рамках ответственности NovaTextLayoutEngine.
+     */
+    coordinateToIndex(layout: NovaTextInputLayoutResult, x: number, y: number): number;
+    /**
+     * Выполняет действие caretRect в рамках ответственности NovaTextLayoutEngine.
+     */
+    caretRect(layout: NovaTextInputLayoutResult, index: number): NovaRectLike;
+    /**
+     * Обновляет состояние выбора NovaTextLayoutEngine.
+     */
+    selectionRects(layout: NovaTextInputLayoutResult, start: number, end: number): Array<NovaRectLike>;
+}
+export declare function layoutNovaTextInput(options: NovaTextInputLayoutOptions): NovaTextInputLayoutResult;
+export declare function novaTextIndexAtPoint(layout: NovaTextInputLayoutResult, x: number, y: number): number;
+export declare function novaCaretRectAtIndex(layout: NovaTextInputLayoutResult, index: number): NovaRectLike;
+export declare function novaSelectionRects(layout: NovaTextInputLayoutResult, start: number, end: number): Array<NovaRectLike>;
+export declare function splitGraphemes(text: string): Array<{
+    value: string;
+    index: number;
+    end: number;
+}>;

package/dist/model/input/index.d.ts

@@ -0,0 +1,7 @@
+export * from './nova-input.types';
+export * from './NovaCaretBlinkController';
+export * from './NovaClipboardService';
+export * from './NovaInputProxy_Adapter';
+export * from './NovaInputValidationController';
+export * from './NovaTextInputController';
+export { layoutNovaTextInput, novaCaretRectAtIndex, NovaTextLayoutEngine as NovaInputTextLayoutEngine, novaSelectionRects, novaTextIndexAtPoint, splitGraphemes, } from './NovaTextLayoutEngine';

package/dist/model/input/nova-input.types.d.ts

@@ -0,0 +1,137 @@
+import { NovaTextFont } from '../../domain/types/renderer.types';
+type NovaResolvedTextFont = NonNullable<NovaTextFont>;
+export type NovaInputEngine = 'canvas' | 'proxy' | 'auto';
+export type NovaInputState = 'idle' | 'hovered' | 'focused' | 'disabled' | 'invalid' | 'readonly';
+export type NovaInputValidationResult = true | string | {
+    message: string;
+    code?: string;
+};
+export interface NovaTextSelection {
+    start: number;
+    end: number;
+    direction?: 'forward' | 'backward' | 'none';
+}
+export interface NovaTextRange {
+    start: number;
+    end: number;
+}
+export interface NovaRectLike {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface NovaTextInputContext {
+    reason?: string;
+    event?: Event;
+}
+export interface NovaTextInputSnapshot {
+    value: string;
+    draft: string;
+    selectionStart: number;
+    selectionEnd: number;
+    focused: boolean;
+    composing: boolean;
+    dirty: boolean;
+    readonly: boolean;
+    disabled: boolean;
+}
+export interface NovaTextInputControllerOptions {
+    value?: string | number;
+    defaultValue?: string | number;
+    multiline?: boolean;
+    readonly?: boolean;
+    disabled?: boolean;
+    maxLength?: number;
+    historyLimit?: number;
+    onValueChange?: (value: string, context: NovaTextInputContext) => void;
+    onCommit?: (value: string, context: NovaTextInputContext) => void;
+    onCancel?: (context: NovaTextInputContext) => void;
+}
+export interface NovaTextMeasureOptions {
+    fontSize?: number;
+    lineHeight?: number;
+    fontFamily?: string;
+    fontWeight?: NovaResolvedTextFont['weight'];
+    fontStyle?: NovaResolvedTextFont['style'];
+    charWidth?: number;
+    tabSize?: number;
+    padding?: number | {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+        horizontal?: number;
+        vertical?: number;
+    };
+    measureText?: NovaTextMeasureFn;
+}
+export type NovaTextInputAlign = 'left' | 'center' | 'right';
+export interface NovaTextMeasureContext {
+    fontSize: number;
+    lineHeight: number;
+    fontFamily: string;
+    fontWeight: NovaResolvedTextFont['weight'];
+    fontStyle: NovaResolvedTextFont['style'];
+    charWidth: number;
+    tabSize: number;
+}
+export type NovaTextMeasureFn = (text: string, context: NovaTextMeasureContext) => number;
+export interface NovaTextInputLayoutOptions extends NovaTextMeasureOptions {
+    text: string;
+    width: number;
+    height: number;
+    multiline?: boolean;
+    wrap?: boolean;
+    align?: NovaTextInputAlign;
+    scrollX?: number;
+    scrollY?: number;
+}
+export interface NovaTextLayoutGlyph {
+    value: string;
+    index: number;
+    end: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    line: number;
+}
+export interface NovaTextLayoutLine {
+    index: number;
+    start: number;
+    end: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    text: string;
+}
+export interface NovaTextInputLayoutResult {
+    text: string;
+    width: number;
+    height: number;
+    contentX: number;
+    contentY: number;
+    contentWidth: number;
+    contentHeight: number;
+    scrollX: number;
+    scrollY: number;
+    fontSize: number;
+    lineHeight: number;
+    charWidth: number;
+    multiline: boolean;
+    wrap: boolean;
+    lines: Array<NovaTextLayoutLine>;
+    glyphs: Array<NovaTextLayoutGlyph>;
+}
+export interface NovaInputValidationState {
+    result: NovaInputValidationResult;
+    pending: boolean;
+    dirty: boolean;
+    touched: boolean;
+    submitted: boolean;
+    message?: string;
+    code?: string;
+}
+export {};

package/dist/model/motion/NovaMotionEngine.d.ts

@@ -0,0 +1,152 @@
+import { NovaMotionOptions, NovaMotionPatch, NovaMotionPlayback, NovaMotionPlaybackState, NovaMotionSegment, NovaMotionTarget, NovaMotionTickContext, NovaMotionTimelineOptions, NovaMotionTweenOptions } from '../../domain/types/motion.types';
+import { NovaMotionPatternName, NovaMotionPatternOptions, NovaMotionPresetName, NovaMotionPresetOptions } from './nova-motion-presets';
+import { NovaApp } from '../runtime/app/NovaApp';
+/**
+ * Управляет playback state одного motion timeline или tween.
+ */
+declare class NovaMotionPlaybackController implements NovaMotionPlayback {
+    private readonly _engine;
+    private readonly _options;
+    private _segments;
+    private _startedAt;
+    private _pausedAt;
+    private _seekOffset;
+    private _state;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(_engine: NovaMotionEngine, _options: NovaMotionOptions);
+    /**
+     * Возвращает id.
+     */
+    get id(): string | undefined;
+    /**
+     * Возвращает state.
+     */
+    get state(): NovaMotionPlaybackState;
+    /**
+     * Возвращает empty.
+     */
+    get empty(): boolean;
+    /**
+     * Обновляет segments.
+     */
+    setSegments(segments: Array<NovaMotionSegment>): void;
+    /**
+     * Проверяет наличие target.
+     */
+    hasTarget(target: NovaMotionTarget): boolean;
+    /**
+     * Удаляет segments.
+     */
+    removeSegments(predicate: (segment: NovaMotionSegment) => boolean): void;
+    /**
+     * Выполняет внутреннюю операцию play.
+     */
+    play(): void;
+    /**
+     * Выполняет внутреннюю операцию pause.
+     */
+    pause(): void;
+    /**
+     * Выполняет внутреннюю операцию resume.
+     */
+    resume(): void;
+    /**
+     * Выполняет внутреннюю операцию cancel.
+     */
+    cancel(): void;
+    /**
+     * Выполняет внутреннюю операцию seek.
+     */
+    seek(time: number): void;
+    /**
+     * Выполняет один tick runtime-обработки.
+     */
+    tick(now: number, patches: Map<NovaMotionTarget, NovaMotionPatch>): void;
+    /**
+     * Выполняет внутреннюю операцию apply at.
+     */
+    private _applyAt;
+    /**
+     * Возвращает duration.
+     */
+    private get _duration();
+}
+/**
+ * Управляет motion segments, timelines и playback в Nova runtime.
+ */
+export declare class NovaMotionEngine {
+    private readonly _app;
+    private readonly _playbacks;
+    private _lease;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(_app: NovaApp<any>);
+    /**
+     * Выполняет внутреннюю операцию to.
+     */
+    to(target: NovaMotionTarget, patch: NovaMotionPatch, options?: NovaMotionTweenOptions): NovaMotionPlayback;
+    /**
+     * Выполняет внутреннюю операцию timeline.
+     */
+    timeline(options: NovaMotionTimelineOptions): NovaMotionPlayback;
+    /**
+     * Выполняет внутреннюю операцию preset.
+     */
+    preset(target: NovaMotionTarget, name: NovaMotionPresetName, options?: NovaMotionPresetOptions): NovaMotionPlayback;
+    /**
+     * Выполняет внутреннюю операцию pattern.
+     */
+    pattern(targets: Array<NovaMotionTarget>, name: NovaMotionPatternName, options?: NovaMotionPatternOptions): NovaMotionPlayback;
+    /**
+     * Выполняет внутреннюю операцию cancel.
+     */
+    cancel(target?: NovaMotionTarget): void;
+    /**
+     * Выполняет внутреннюю операцию pause all.
+     */
+    pauseAll(): void;
+    /**
+     * Выполняет внутреннюю операцию resume all.
+     */
+    resumeAll(): void;
+    /**
+     * Выполняет один tick runtime-обработки.
+     */
+    tick(frame: NovaMotionTickContext): void;
+    /**
+     * Освобождает runtime resources и снимает связанные ссылки.
+     */
+    destroy(): void;
+    /**
+     * Выполняет внутреннюю операцию activate.
+     */
+    _activate(playback: NovaMotionPlaybackController): void;
+    /**
+     * Выполняет внутреннюю операцию deactivate.
+     */
+    _deactivate(playback: NovaMotionPlaybackController): void;
+    /**
+     * Добавляет playback.
+     */
+    private _addPlayback;
+    /**
+     * Выполняет внутреннюю операцию overwrite segments.
+     */
+    private _overwriteSegments;
+    /**
+     * Читает value.
+     */
+    private _readValue;
+    /**
+     * Выполняет внутреннюю операцию apply patch.
+     */
+    private _applyPatch;
+    /**
+     * Выполняет внутреннюю операцию sync loop lease.
+     */
+    private _syncLoopLease;
+}
+export {};

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

@@ -0,0 +1,13 @@
+import { NovaMotionEasingName, NovaMotionOptions } from '../../domain/types/motion.types';
+/**
+ * Хранит значение NOVA_MOTION_EASING, используемое runtime-кодом пакета.
+ */
+export declare const NOVA_MOTION_EASING: Record<NovaMotionEasingName, (t: number) => number>;
+/**
+ * Вычисляет nova motion easing.
+ */
+export declare function resolveNovaMotionEasing(easing: NovaMotionOptions['easing']): (t: number) => number;
+/**
+ * Выполняет публичную операцию clamp motion progress.
+ */
+export declare function clampMotionProgress(value: number): number;

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

@@ -0,0 +1,19 @@
+import { NovaMotionValue } from '../../domain/types/motion.types';
+/**
+ * Описывает контракт RgbaColor.
+ */
+interface RgbaColor {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/**
+ * Выполняет публичную операцию interpolate nova motion value.
+ */
+export declare function interpolateNovaMotionValue(from: NovaMotionValue, to: NovaMotionValue, progress: number): NovaMotionValue;
+/**
+ * Парсит color.
+ */
+export declare function parseColor(value: unknown): RgbaColor | null;
+export {};