@endge/nova 0.13.6 → 0.13.14

package/dist/model/runtime/assets/NovaAssetRegistry.d.ts

@@ -0,0 +1,511 @@
+/**
+ * Описывает kind Nova asset.
+ */
+export type NovaAssetKind = 'icon' | 'image' | 'fill' | 'font';
+/**
+ * Описывает режим заполнения drawable asset внутри rect.
+ */
+export type NovaAssetFillMode = 'stretch' | 'repeat' | 'repeat-x' | 'repeat-y' | 'no-repeat';
+/**
+ * Описывает сторону nine-slice bitmap.
+ */
+export interface NovaNineSliceInsets {
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+    readonly left: number;
+}
+/**
+ * Описывает ref на asset без раскрытия atlas/texture деталей.
+ */
+export interface NovaAssetRef<K extends NovaAssetKind = NovaAssetKind> {
+    readonly __novaAssetRef: true;
+    readonly namespace: string;
+    readonly kind: K;
+    readonly name: string;
+    readonly id: string;
+}
+/**
+ * Описывает SVG asset descriptor.
+ */
+export interface NovaSvgAssetDescriptor {
+    readonly type: 'svg';
+    readonly source: string;
+    readonly width: number;
+    readonly height: number;
+    readonly color?: string;
+    readonly pixelRatio?: NovaSvgAssetPixelRatio;
+}
+export type NovaSvgAssetPixelRatio = number | 'auto';
+/**
+ * Описывает image asset descriptor.
+ */
+export interface NovaImageAssetDescriptor {
+    readonly type: 'image';
+    readonly source: CanvasImageSource | string;
+    readonly width?: number;
+    readonly height?: number;
+}
+/**
+ * Описывает canvas asset descriptor.
+ */
+export interface NovaCanvasAssetDescriptor {
+    readonly type: 'canvas';
+    readonly source: HTMLCanvasElement | OffscreenCanvas;
+    readonly width?: number;
+    readonly height?: number;
+}
+/**
+ * Описывает pattern fill descriptor.
+ */
+export interface NovaPatternAssetDescriptor {
+    readonly type: 'pattern';
+    readonly source: CanvasImageSource | string;
+    readonly repeat: Exclude<NovaAssetFillMode, 'stretch'>;
+    readonly width?: number;
+    readonly height?: number;
+    readonly scale?: number;
+    readonly offsetX?: number;
+    readonly offsetY?: number;
+}
+/**
+ * Описывает stripe fill descriptor.
+ */
+export interface NovaStripeAssetDescriptor {
+    readonly type: 'stripe';
+    readonly bgColor: string;
+    readonly stripeColor: string;
+    readonly stripeWidth: number;
+    readonly angle: number;
+    readonly sizeK: number;
+}
+/**
+ * Описывает stop gradient fill descriptor.
+ */
+export interface NovaGradientStop {
+    readonly offset: number;
+    readonly color: string;
+}
+/**
+ * Описывает stop linear-gradient fill descriptor.
+ */
+export type NovaLinearGradientStop = NovaGradientStop;
+/**
+ * Описывает linear-gradient fill descriptor.
+ */
+export interface NovaLinearGradientAssetDescriptor {
+    readonly type: 'linear-gradient';
+    readonly from: string;
+    readonly to: string;
+    readonly angle: number;
+    readonly stops?: ReadonlyArray<NovaLinearGradientStop>;
+    readonly size?: number;
+}
+/**
+ * Описывает radial-gradient fill descriptor.
+ */
+export interface NovaRadialGradientAssetDescriptor {
+    readonly type: 'radial-gradient';
+    readonly inner: string;
+    readonly outer: string;
+    readonly centerX: number;
+    readonly centerY: number;
+    readonly radiusX: number;
+    readonly radiusY: number;
+    readonly stops?: ReadonlyArray<NovaGradientStop>;
+    readonly size?: number;
+}
+/**
+ * Описывает conic-gradient fill descriptor.
+ */
+export interface NovaConicGradientAssetDescriptor {
+    readonly type: 'conic-gradient';
+    readonly from: string;
+    readonly to: string;
+    readonly centerX: number;
+    readonly centerY: number;
+    readonly startAngle: number;
+    readonly stops?: ReadonlyArray<NovaGradientStop>;
+    readonly size?: number;
+}
+/**
+ * Описывает noise fill descriptor.
+ */
+export interface NovaNoiseAssetDescriptor {
+    readonly type: 'noise';
+    readonly baseColor: string;
+    readonly noiseColor: string;
+    readonly opacity: number;
+    readonly density: number;
+    readonly seed: number;
+    readonly size?: number;
+}
+/**
+ * Описывает точку mesh-gradient.
+ */
+export interface NovaMeshGradientPoint {
+    readonly x: number;
+    readonly y: number;
+    readonly color: string;
+    readonly radius?: number;
+    readonly opacity?: number;
+}
+/**
+ * Описывает mesh-gradient fill descriptor.
+ */
+export interface NovaMeshGradientAssetDescriptor {
+    readonly type: 'mesh-gradient';
+    readonly background: string;
+    readonly points: ReadonlyArray<NovaMeshGradientPoint>;
+    readonly size?: number;
+}
+/**
+ * Описывает nine-slice image descriptor.
+ */
+export interface NovaNineSliceImageAssetDescriptor {
+    readonly type: 'nine-slice-image';
+    readonly source: CanvasImageSource | string;
+    readonly slice: NovaNineSliceInsets;
+    readonly width?: number;
+    readonly height?: number;
+    readonly centerMode: 'stretch' | 'repeat';
+}
+/**
+ * Описывает font descriptor.
+ */
+export interface NovaFontAssetDescriptor {
+    readonly type: 'font';
+    readonly family: string;
+    readonly src: string;
+    readonly weight?: string;
+    readonly style?: string;
+    readonly display?: 'auto' | 'block' | 'swap' | 'fallback' | 'optional';
+}
+/**
+ * Описывает asset descriptor.
+ */
+export type NovaAssetDescriptor = NovaSvgAssetDescriptor | NovaImageAssetDescriptor | NovaCanvasAssetDescriptor | NovaPatternAssetDescriptor | NovaStripeAssetDescriptor | NovaLinearGradientAssetDescriptor | NovaRadialGradientAssetDescriptor | NovaConicGradientAssetDescriptor | NovaNoiseAssetDescriptor | NovaMeshGradientAssetDescriptor | NovaNineSliceImageAssetDescriptor | NovaFontAssetDescriptor;
+/**
+ * Описывает input bundle assets.
+ */
+export interface NovaAssetBundleInput {
+    readonly icons?: Record<string, NovaAssetDescriptor>;
+    readonly images?: Record<string, NovaAssetDescriptor>;
+    readonly fills?: Record<string, NovaAssetDescriptor>;
+    readonly fonts?: Record<string, NovaAssetDescriptor>;
+}
+/**
+ * Описывает нормализованный asset record.
+ */
+export interface NovaAssetRecord<K extends NovaAssetKind = NovaAssetKind> {
+    readonly ref: NovaAssetRef<K>;
+    readonly descriptor: NovaAssetDescriptor;
+}
+/**
+ * Описывает bundle с typed refs.
+ */
+export interface NovaAssetBundle<I extends Record<string, NovaAssetDescriptor> = Record<string, NovaAssetDescriptor>, F extends Record<string, NovaAssetDescriptor> = Record<string, NovaAssetDescriptor>, M extends Record<string, NovaAssetDescriptor> = Record<string, NovaAssetDescriptor>, T extends Record<string, NovaAssetDescriptor> = Record<string, NovaAssetDescriptor>> {
+    readonly namespace: string;
+    readonly icons: {
+        readonly [K in keyof I]: NovaAssetRef<'icon'>;
+    };
+    readonly fills: {
+        readonly [K in keyof F]: NovaAssetRef<'fill'>;
+    };
+    readonly images: {
+        readonly [K in keyof M]: NovaAssetRef<'image'>;
+    };
+    readonly fonts: {
+        readonly [K in keyof T]: NovaAssetRef<'font'>;
+    };
+    readonly records: ReadonlyMap<string, NovaAssetRecord>;
+}
+/**
+ * Описывает resolved drawable asset.
+ */
+export interface NovaResolvedAsset<K extends NovaAssetKind = NovaAssetKind> {
+    readonly ref: NovaAssetRef<K>;
+    readonly descriptor: NovaAssetDescriptor;
+    readonly source?: CanvasImageSource;
+    readonly ready: boolean;
+}
+/**
+ * Описывает drawable asset input.
+ */
+export type NovaAssetDrawableInput = NovaAssetRef | CanvasImageSource | string | undefined | null;
+/**
+ * Проверяет ref Nova asset.
+ */
+export declare function isNovaAssetRef(value: unknown): value is NovaAssetRef;
+/**
+ * Управляет scoped/global Nova assets без exposing atlas internals.
+ */
+export declare class NovaAssetRegistry {
+    private readonly _parent?;
+    private readonly _onUpdate?;
+    private readonly _records;
+    private readonly _materialized;
+    private readonly _recordUseCounts;
+    private readonly _fontFaces;
+    /**
+     * Создает registry.
+     */
+    constructor(_parent?: NovaAssetRegistry | undefined, _onUpdate?: (() => void) | undefined);
+    /**
+     * Подключает bundle в текущий scope.
+     */
+    use(bundle: NovaAssetBundle): void;
+    /**
+     * Удаляет bundle из текущего scope.
+     */
+    unuse(bundle: NovaAssetBundle): void;
+    /**
+     * Возвращает asset record по ref или id.
+     */
+    resolveRecord(input: NovaAssetRef | string | undefined | null): NovaAssetRecord | undefined;
+    /**
+     * Возвращает resolved asset.
+     */
+    resolve(input: NovaAssetRef | string | undefined | null): NovaResolvedAsset | undefined;
+    /**
+     * Возвращает drawable source для ref/source.
+     */
+    resolveDrawable(input: NovaAssetDrawableInput): CanvasImageSource | undefined;
+    /**
+     * Возвращает fill mode для drawable asset.
+     */
+    resolveDrawableFillMode(input: NovaAssetDrawableInput): NovaAssetFillMode;
+    /**
+     * Возвращает stable slice metadata для nine-slice image.
+     */
+    resolveNineSlice(input: NovaAssetRef<'image'> | string | undefined | null): NovaNineSliceImageAssetDescriptor | undefined;
+    /**
+     * Возвращает стабильный drawable key.
+     */
+    resolveDrawableKey(prefix: string, input: NovaAssetDrawableInput, fallback: (source: CanvasImageSource) => string): string;
+    /**
+     * Возвращает materialized asset.
+     */
+    private _resolveMaterialization;
+    /**
+     * Возвращает версию materialized source для invalidation texture caches.
+     */
+    private _resolveMaterializationVersion;
+    /**
+     * Создает canvas с stripe fill.
+     */
+    private _createStripeCanvas;
+    /**
+     * Создает canvas с linear-gradient fill.
+     */
+    private _createLinearGradientCanvas;
+    /**
+     * Создает canvas с radial-gradient fill.
+     */
+    private _createRadialGradientCanvas;
+    /**
+     * Создает canvas с conic-gradient fill.
+     */
+    private _createConicGradientCanvas;
+    /**
+     * Создает canvas с procedural noise fill.
+     */
+    private _createNoiseCanvas;
+    /**
+     * Создает canvas с mesh-gradient fill.
+     */
+    private _createMeshGradientCanvas;
+    /**
+     * Создает materialization для image asset.
+     */
+    private _createImageMaterialization;
+    /**
+     * Создает materialization для pattern fill.
+     */
+    private _createPatternMaterialization;
+    /**
+     * Создает materialization для nine-slice image.
+     */
+    private _createNineSliceMaterialization;
+    /**
+     * Создает materialization для font asset.
+     */
+    private _createFontMaterialization;
+    /**
+     * Создает materialization для SVG asset.
+     */
+    private _createSvgMaterialization;
+    /**
+     * Создает browser-loadable SVG image source из raw svg или data URL.
+     */
+    private _createSvgImageSource;
+    /**
+     * Нормализует raw svg/data URL и применяет currentColor override.
+     */
+    private _resolveSvgSource;
+    /**
+     * Создает canvas pattern source с учетом размера и scale.
+     */
+    private _createPatternCanvas;
+    /**
+     * Создает image-backed materialization для source или url.
+     */
+    private _createImageBackedMaterialization;
+    /**
+     * Снимает зарегистрированный FontFace из document.fonts.
+     */
+    private _unuseFontFace;
+}
+/**
+ * Создает asset bundle.
+ */
+export declare function defineNovaAssets<I extends Record<string, NovaAssetDescriptor> = Record<string, NovaAssetDescriptor>, F extends Record<string, NovaAssetDescriptor> = Record<string, NovaAssetDescriptor>, M extends Record<string, NovaAssetDescriptor> = Record<string, NovaAssetDescriptor>, T extends Record<string, NovaAssetDescriptor> = Record<string, NovaAssetDescriptor>>(namespace: string, input: {
+    readonly icons?: I;
+    readonly fills?: F;
+    readonly images?: M;
+    readonly fonts?: T;
+}): NovaAssetBundle<I, F, M, T>;
+/**
+ * Создает SVG descriptor.
+ */
+export declare function createNovaSvgAsset(source: string, options: {
+    width: number;
+    height: number;
+    color?: string;
+    pixelRatio?: NovaSvgAssetPixelRatio;
+}): NovaSvgAssetDescriptor;
+/**
+ * Создает image descriptor.
+ */
+export declare function createNovaImageAsset(source: CanvasImageSource | string, options?: {
+    width?: number;
+    height?: number;
+}): NovaImageAssetDescriptor;
+/**
+ * Создает canvas descriptor.
+ */
+export declare function createNovaCanvasAsset(source: HTMLCanvasElement | OffscreenCanvas, options?: {
+    width?: number;
+    height?: number;
+}): NovaCanvasAssetDescriptor;
+/**
+ * Создает pattern descriptor.
+ */
+export declare function createNovaPatternAsset(source: CanvasImageSource | string, options?: {
+    repeat?: Exclude<NovaAssetFillMode, 'stretch'>;
+    width?: number;
+    height?: number;
+    scale?: number;
+    offsetX?: number;
+    offsetY?: number;
+}): NovaPatternAssetDescriptor;
+/**
+ * Создает stripe descriptor.
+ */
+export declare function createNovaStripeAsset(options: {
+    bgColor: string;
+    stripeColor: string;
+    stripeWidth: number;
+    angle?: number;
+    sizeK?: number;
+}): NovaStripeAssetDescriptor;
+/**
+ * Создает linear-gradient descriptor.
+ */
+export declare function createNovaLinearGradientAsset(options: {
+    from: string;
+    to: string;
+    angle?: number;
+    stops?: ReadonlyArray<NovaLinearGradientStop>;
+    size?: number;
+}): NovaLinearGradientAssetDescriptor;
+/**
+ * Создает radial-gradient descriptor.
+ */
+export declare function createNovaRadialGradientAsset(options: {
+    inner: string;
+    outer: string;
+    centerX?: number;
+    centerY?: number;
+    radiusX?: number;
+    radiusY?: number;
+    stops?: ReadonlyArray<NovaGradientStop>;
+    size?: number;
+}): NovaRadialGradientAssetDescriptor;
+/**
+ * Создает conic-gradient descriptor.
+ */
+export declare function createNovaConicGradientAsset(options: {
+    from: string;
+    to: string;
+    centerX?: number;
+    centerY?: number;
+    startAngle?: number;
+    stops?: ReadonlyArray<NovaGradientStop>;
+    size?: number;
+}): NovaConicGradientAssetDescriptor;
+/**
+ * Создает noise descriptor.
+ */
+export declare function createNovaNoiseAsset(options?: {
+    baseColor?: string;
+    noiseColor?: string;
+    opacity?: number;
+    density?: number;
+    seed?: number;
+    size?: number;
+}): NovaNoiseAssetDescriptor;
+/**
+ * Создает mesh-gradient descriptor.
+ */
+export declare function createNovaMeshGradientAsset(options: {
+    background?: string;
+    points: ReadonlyArray<NovaMeshGradientPoint>;
+    size?: number;
+}): NovaMeshGradientAssetDescriptor;
+/**
+ * Создает nine-slice image descriptor.
+ */
+export declare function createNovaNineSliceImageAsset(source: CanvasImageSource | string, options: {
+    slice: number | Partial<NovaNineSliceInsets>;
+    width?: number;
+    height?: number;
+    centerMode?: 'stretch' | 'repeat';
+}): NovaNineSliceImageAssetDescriptor;
+/**
+ * Создает font descriptor.
+ */
+export declare function createNovaFontAsset(options: {
+    family: string;
+    src: string;
+    weight?: string;
+    style?: string;
+    display?: NovaFontAssetDescriptor['display'];
+}): NovaFontAssetDescriptor;
+/**
+ * Возвращает fill mode по descriptor.
+ */
+export declare function resolveNovaAssetFillMode(descriptor: NovaAssetDescriptor): NovaAssetFillMode;
+/**
+ * Описывает публичный Nova assets facade.
+ */
+export declare const NovaAssets: Readonly<{
+    global: NovaAssetRegistry;
+    define: typeof defineNovaAssets;
+    svg: typeof createNovaSvgAsset;
+    image: typeof createNovaImageAsset;
+    canvas: typeof createNovaCanvasAsset;
+    pattern: typeof createNovaPatternAsset;
+    stripe: typeof createNovaStripeAsset;
+    linearGradient: typeof createNovaLinearGradientAsset;
+    radialGradient: typeof createNovaRadialGradientAsset;
+    conicGradient: typeof createNovaConicGradientAsset;
+    noise: typeof createNovaNoiseAsset;
+    meshGradient: typeof createNovaMeshGradientAsset;
+    nineSliceImage: typeof createNovaNineSliceImageAsset;
+    font: typeof createNovaFontAsset;
+    /**
+     * Выполняет действие ref в рамках ответственности текущего класса.
+     */
+    ref<K extends NovaAssetKind>(namespace: string, kind: K, name: string): NovaAssetRef<K>;
+}>;

package/dist/model/runtime/commands/NovaCommandBus.d.ts

@@ -0,0 +1,48 @@
+import { NovaNode } from '../tree/NovaNode';
+/**
+ * Описывает обработчик Nova command.
+ */
+export type NovaCommandHandler<TPayload = unknown, TResult = unknown> = (payload: TPayload) => TResult;
+/**
+ * Описывает target команды.
+ */
+export type NovaCommandTarget = NovaNode<any> | {
+    componentId?: string;
+} | string;
+/**
+ * Описывает параметры регистрации команды.
+ */
+export interface NovaCommandRegisterOptions {
+    owner?: NovaCommandTarget;
+    scope?: string;
+}
+/**
+ * Описывает параметры запуска команды.
+ */
+export interface NovaCommandRunOptions {
+    target?: NovaCommandTarget;
+    scope?: string;
+}
+/**
+ * Хранит Nova commands и разрешает scoped/targeted запуск.
+ */
+export declare class NovaCommandBus {
+    private readonly _entries;
+    private _order;
+    /**
+     * Регистрирует command handler.
+     */
+    register<TPayload = unknown, TResult = unknown>(id: string, handler: NovaCommandHandler<TPayload, TResult>, options?: NovaCommandRegisterOptions): () => void;
+    /**
+     * Запускает command handler.
+     */
+    run<TPayload = unknown, TResult = unknown>(id: string, payload?: TPayload, options?: NovaCommandRunOptions): TResult;
+    /**
+     * Возвращает количество handlers для команды.
+     */
+    count(id?: string): number;
+    /**
+     * Выбирает единственный handler для запуска.
+     */
+    private _resolveEntry;
+}

package/dist/model/runtime/components/NovaComponentNode.d.ts

@@ -0,0 +1,109 @@
+import { EventList } from '@endge/utils';
+import { NovaComponentDescriptor } from '../../../domain/types/component.types';
+import { NovaMotionOptions, NovaMotionPlayback } from '../../../domain/types/motion.types';
+import { NovaApp } from '../app/NovaApp';
+import { NovaSyncPortMap } from '../sync/nova-sync.types';
+import { NovaSurface } from '../tree/NovaSurface';
+import { NovaNode } from '../tree/NovaNode';
+/**
+ * Описывает runtime-сущность NovaComponentNode.
+ */
+export declare abstract class NovaComponentNode<TProps extends Record<string, any> = Record<string, any>, TApi = unknown, TEvents extends Record<string, unknown> = Record<string, unknown>, TSchema = TProps, E extends EventList = Record<string, any>> extends NovaNode<E> {
+    readonly descriptor: NovaComponentDescriptor<TProps, TApi, TEvents, TSchema>;
+    readonly componentId: string;
+    protected props: TProps;
+    private _unregisterSyncPorts?;
+    private _commandDisposers;
+    private _pendingWatcherChanges;
+    /**
+     * Создает instance и подготавливает внутреннее состояние.
+     */
+    constructor(app: NovaApp<E>, surface: NovaSurface<E>, descriptor: NovaComponentDescriptor<TProps, TApi, TEvents, TSchema>, props: TProps, options?: {
+        componentId?: string;
+    });
+    /**
+     * Обновляет props.
+     */
+    setProps(patch: Partial<TProps>): this;
+    /**
+     * Возвращает props.
+     */
+    getProps(): Readonly<TProps>;
+    /**
+     * Возвращает api.
+     */
+    getApi(): TApi;
+    /**
+     * Выполняет внутреннюю операцию dispose.
+     */
+    dispose(): void;
+    /**
+     * Возвращает sync-порты runtime component. По умолчанию descriptor fields
+     * становятся безопасными prop-портами.
+     */
+    getSyncPorts(): NovaSyncPortMap;
+    /**
+     * Регистрирует component ports в app-level sync scope после mount.
+     */
+    protected onMount(): void;
+    /**
+     * Снимает component ports при unmount.
+     */
+    protected onUnmount(): void;
+    /**
+     * Выполняет watchers update-фазы перед пользовательским update.
+     */
+    update(): void;
+    /**
+     * Выполняет watchers render-фазы перед пользовательским render.
+     */
+    render(): void;
+    /**
+     * Уведомляет sync scope об изменении конкретного порта.
+     */
+    notifySyncPortChanged(name: string, value?: unknown): void;
+    /**
+     * Обрабатывает событие props changed.
+     */
+    protected onPropsChanged(_changedKeys: Array<keyof TProps>): void;
+    /**
+     * Выполняет внутренний шаг notifySyncPortsChanged для NovaComponentNode.
+     */
+    private _notifySyncPortsChanged;
+    /**
+     * Выполняет внутреннюю операцию transition to.
+     */
+    protected transitionTo(patch: Partial<TProps>, options?: NovaMotionOptions): NovaMotionPlayback;
+    /**
+     * Вычисляет dirty.
+     */
+    private _resolveDirty;
+    /**
+     * Читает watched paths перед изменением props.
+     */
+    private _readWatcherValues;
+    /**
+     * Собирает changed watched paths после изменения props.
+     */
+    private _collectWatcherChanges;
+    /**
+     * Выполняет immediate watchers.
+     */
+    private _runImmediateWatchers;
+    /**
+     * Выполняет watchers указанной фазы.
+     */
+    private _runWatchers;
+    /**
+     * Вызывает watcher method.
+     */
+    private _callWatcher;
+    /**
+     * Регистрирует command handlers.
+     */
+    private _registerCommands;
+    /**
+     * Снимает command handlers.
+     */
+    private _disposeCommands;
+}

package/dist/model/runtime/components/NovaComponentRegistry.d.ts

@@ -0,0 +1,35 @@
+import { NovaRuntimeComponentNode } from '../../../domain/types/component.types';
+/**
+ * Хранит node components и schema components, доступные runtime Nova.
+ */
+export declare class NovaComponentRegistry {
+    private readonly _nodes;
+    /**
+     * Выполняет внутреннюю операцию register.
+     */
+    register(node: NovaRuntimeComponentNode): void;
+    /**
+     * Выполняет внутреннюю операцию unregister.
+     */
+    unregister(node: NovaRuntimeComponentNode): void;
+    /**
+     * Выполняет внутреннюю операцию get.
+     */
+    get<TNode extends NovaRuntimeComponentNode = NovaRuntimeComponentNode>(id: string): TNode | undefined;
+    /**
+     * Выполняет внутреннюю операцию require.
+     */
+    require<TNode extends NovaRuntimeComponentNode = NovaRuntimeComponentNode>(id: string): TNode;
+    /**
+     * Выполняет внутреннюю операцию api.
+     */
+    api<TApi>(id: string): TApi | undefined;
+    /**
+     * Выполняет внутреннюю операцию require api.
+     */
+    requireApi<TApi>(id: string): TApi;
+    /**
+     * Очищает внутреннее состояние.
+     */
+    clear(): void;
+}