@vvfx/sdk 0.1.19-alpha.8 → 0.2.0

package/dist/src/gesture-handler/src/gesture-handler.d.ts

@@ -0,0 +1,143 @@
+import { Application } from '@pixi/app';
+import { ControlGizmo, GestureCursorResult, GestureHandlerInteractType, ItemCreateType, SelectorGizmo, SpriteTextInitParam, TransformGizmo, type Gizmo } from '../gizmo';
+import type { PageDataUtils } from '../../utils/page-data-utils';
+import { PreferenceGizmo } from '../gizmo/preference-gizmo';
+import { PictureCutGizmo } from '../gizmo/picture-cut-gizmo';
+import { Box2, Vector2 } from '../../math';
+import { EventEmitter } from '../../shared';
+import { SDKEvents } from '../../sdk';
+import { TextGizmo } from '../gizmo/text-gizmo';
+import { MaskGizmo } from '../gizmo/mask-gizmo';
+import { LoadingGizmo, LoadingGizmoTip } from '../gizmo/loading-gizmo';
+import { MaskGizmoConfig } from '../../config';
+import { PictureExpandGizmo } from '../gizmo/picture-expand-gizmo';
+import { SpriteTextEditGizmo } from '../gizmo/sprite-text-edit-gizmo';
+import { IconGizmo } from '../gizmo/icon-gizmo';
+import { ItemCreateGizmo } from '../gizmo/item-create-gizmo';
+export declare class GestureHandler {
+    wireframeApplication: Application;
+    gizmos: Gizmo[];
+    activeGizmo?: Gizmo;
+    selectorGizmo?: SelectorGizmo;
+    transformGizmo?: TransformGizmo;
+    controlGizmo?: ControlGizmo;
+    preferenceGizmo?: PreferenceGizmo;
+    pictureCutGizmo?: PictureCutGizmo;
+    pictureExpandGizmo?: PictureExpandGizmo;
+    textGizmo?: TextGizmo;
+    maskGizmo?: MaskGizmo;
+    loadingGizmo?: LoadingGizmo;
+    spriteTextEditGizmo?: SpriteTextEditGizmo;
+    iconGizmo?: IconGizmo;
+    itemCreateGizmo?: ItemCreateGizmo;
+    private _ignoreInteraction;
+    clickButtons: number;
+    container: HTMLElement;
+    private _emitter?;
+    /**
+     * @description Current time when mouse down is first trigger.
+     */
+    private clickTime;
+    /**
+     * @description Is first click.
+     */
+    private firstClick;
+    /**
+     * @description The maximum span duration a double click interact. - 500ms 操作是 windows 默认的双击时间间隔
+     */
+    private readonly dblclickTimeSpan;
+    /**
+     * @description 是否按下空格键
+     */
+    spaceEmit: boolean;
+    /**
+     * @description 辅助面板交互状态
+     */
+    interactType: GestureHandlerInteractType;
+    constructor(container: HTMLElement);
+    set ignoreInteraction(state: boolean);
+    get ignoreInteraction(): boolean;
+    resize(): void;
+    refresh(): void;
+    render(): void;
+    init(pageDataUtils: PageDataUtils, emitter: EventEmitter<SDKEvents>): Promise<void>;
+    initEvents(): void;
+    registerViewEvent(): void;
+    /**
+     * 鼠标按下事件
+     * @param event 鼠标事件
+     */
+    onMouseDown(event: MouseEvent): void;
+    /**
+     * 鼠标移动事件
+     * @param event 鼠标事件
+     */
+    onMouseMove(event: MouseEvent): void;
+    /**
+     * 鼠标滚轮事件
+     * @param event 鼠标事件
+     */
+    onWheel(event: WheelEvent): void;
+    /**
+     * 鼠标松开事件
+     * @param event 鼠标事件
+     */
+    onMouseUp(event: MouseEvent): void;
+    onKeyDown(keyCode: KeyboardEvent): void;
+    onKeyUp(keyCode: KeyboardEvent): void;
+    dispose(): void;
+    setCursor(result?: GestureCursorResult): void;
+    openPictureCutGizmo(): void;
+    closePictureCutGizmo(): void;
+    setInteractType(type: GestureHandlerInteractType): void;
+    getCutInfo(): {
+        cutBox: Box2;
+        itemBox: Box2;
+    } | undefined;
+    setCutBox(min: Vector2, max: Vector2): Box2 | undefined;
+    openPictureExpandGizmo(): void;
+    closePictureExpandGizmo(): void;
+    getExpandInfo(): {
+        expandBox: Box2;
+        itemBox: Box2;
+    } | undefined;
+    setExpandBox(min: Vector2, max: Vector2): Box2 | undefined;
+    openMaskGizmo(brushSize: number): void;
+    clearMaskGizmo(): void;
+    closeMaskGizmo(): void;
+    setMaskGizmoConfig(config: Partial<MaskGizmoConfig>): void;
+    getMask(): string | null | undefined;
+    setMaskGizmoMode(mode: 'paint' | 'erase'): void;
+    openLoadingGizmo(id: string, options?: {
+        loadingBox?: Box2;
+        clearSelected?: boolean;
+        tip?: LoadingGizmoTip;
+    }): void;
+    updateLoadingGizmo(id: string, options: {
+        tip?: LoadingGizmoTip;
+    }): void;
+    closeLoadingGizmo(id: string): void;
+    setPictureCutGizmoLockScale(state: boolean): void;
+    setPictureExpandGizmoLockScale(state: boolean): void;
+    setTransformGizmoLockScale(state: boolean): void;
+    maskGizmoUndo(): boolean;
+    maskGizmoRedo(): boolean;
+    get maskGizmoCanUndo(): boolean;
+    get maskGizmoCanRedo(): boolean;
+    clearMaskGizmoUndoRedo(): void;
+    pictureCutGizmoUndo(): boolean;
+    pictureCutGizmoRedo(): boolean;
+    get pictureCutGizmoCanUndo(): boolean;
+    get pictureCutGizmoCanRedo(): boolean;
+    clearPictureCutGizmoUndoRedo(): void;
+    openSpriteTextGizmo(initParam: SpriteTextInitParam[]): void;
+    closeSpriteTextEditGizmo(): void;
+    setSpriteTextSelectedIndex(id: string, index: number): void;
+    setSpriteTextSelectedText(id: string, index: number, text: string): void;
+    setSpriteTextChangedState(id: string, index: number, hasChanged: boolean): void;
+    setSpriteTextEditState(id: string, index: number, isEditing: boolean): void;
+    openItemCreateGizmo(type: ItemCreateType): void;
+    closeItemCreateGizmo(): void;
+    openTextGizmo(textItemId?: string, mode?: 'select' | 'focus'): void;
+    closeTextGizmo(): void;
+}

package/dist/src/gesture-handler/src/icons.d.ts

@@ -0,0 +1,7 @@
+import { GestureCursorType } from '../gizmo';
+export declare const cursorMap: Record<GestureCursorType, {
+    type: 'svg' | 'preset';
+    content: string;
+    url?: string;
+}>;
+export declare function loadCursorIcons(): Promise<void>;

package/dist/src/gesture-handler/utils.d.ts

@@ -0,0 +1,2 @@
+import { TextStyle } from '../wireframe';
+export declare function processText(textContent: string, style: Partial<TextStyle>, width: number, maxLines: number): string;

package/dist/src/html-overlay/auto-height-runtime.d.ts

@@ -0,0 +1,13 @@
+import type { CardHTMLRenderCleanup } from '../types';
+export type CardHTMLAutoHeightMessage = {
+    source: 'vvfx-card-html-auto-height';
+    id: string;
+    height: number;
+};
+export type CardHTMLAutoHeightOptions = {
+    autoHeightId?: string;
+    onAutoHeight?: (height: number) => void;
+};
+export declare function createAutoHeightMessageListener(iframe: HTMLIFrameElement, options?: CardHTMLAutoHeightOptions): CardHTMLRenderCleanup;
+export declare function isCardHTMLAutoHeightMessage(data: unknown, id: string): data is CardHTMLAutoHeightMessage;
+export declare function withCardHTMLAutoHeightBridge(html: string, id?: string): string;

package/dist/src/html-overlay/document-runtime.d.ts

@@ -0,0 +1,4 @@
+import type { CardHTMLContentCleanup, CardHTMLDocumentContent, CardHTMLDOMRenderer, CardHTMLRenderCleanup } from '../types';
+import { type CardHTMLAutoHeightOptions } from './auto-height-runtime';
+export declare function renderDocumentContent(overlay: HTMLElement, content: CardHTMLDocumentContent, options?: CardHTMLAutoHeightOptions): CardHTMLRenderCleanup;
+export declare function renderDOMContentInIframe(overlay: HTMLElement, render: CardHTMLDOMRenderer, cleanup?: CardHTMLContentCleanup): CardHTMLRenderCleanup;

package/dist/src/html-overlay/document-transform.d.ts

@@ -0,0 +1,7 @@
+export type DocumentFileUrlFactory = (rawPath: string, fromPath: string) => string;
+export declare function normalizeDocumentFiles(files: Record<string, string>): Map<string, string>;
+export declare function createDocumentFileUrlFactory(files: Map<string, string>): DocumentFileUrlFactory;
+export declare function transformDocumentFile(path: string, source: string, createFileUrl: DocumentFileUrlFactory, resolving?: Set<string>): string;
+export declare function transformHTMLDocument(path: string, source: string, createFileUrl: DocumentFileUrlFactory): string;
+export declare function transformCSSDocument(path: string, source: string, createFileUrl: DocumentFileUrlFactory): string;
+export declare function transformJSDocument(path: string, source: string, createFileUrl: DocumentFileUrlFactory): string;

package/dist/src/html-overlay/dom-order.d.ts

@@ -0,0 +1 @@
+export declare function syncElementStackOrder(_container: HTMLElement, elements: HTMLElement[]): void;

package/dist/src/html-overlay/host-message-runtime.d.ts

@@ -0,0 +1,3 @@
+import type { CardHTMLDocumentContent, CardHTMLDocumentMessage, CardHTMLRenderCleanup } from '../types';
+export declare function createHostMessageListener(iframe: HTMLIFrameElement, content: CardHTMLDocumentContent): CardHTMLRenderCleanup;
+export declare function isCardHTMLDocumentMessage(data: unknown): data is CardHTMLDocumentMessage;

package/dist/src/html-overlay/html-viewport-style.d.ts

@@ -0,0 +1 @@
+export declare function withCardHTMLViewportStyle(html: string): string;

package/dist/src/html-overlay/index.d.ts

@@ -0,0 +1 @@
+export { HTMLOverlayManager } from './manager';

package/dist/src/html-overlay/manager.d.ts

@@ -0,0 +1,77 @@
+import type { Box2 } from '../math';
+import { type SnapdomOptions } from '@zumer/snapdom';
+import type { EventEmitter } from '../shared';
+import type { SDKEvents } from '../sdk';
+import { type SDKItem } from '../sdk-item';
+type CardRasterizeOptions = {
+    width: number;
+    height: number;
+    pixelRatio?: number;
+    snapdomOptions?: SnapdomOptions;
+};
+type HTMLOverlayManagerOptions = {
+    container: HTMLElement;
+    emitter: EventEmitter<SDKEvents>;
+    getItems: () => SDKItem[];
+    getViewBoxById: (id: string) => Box2;
+    getViewport: () => {
+        zoom: number;
+        translation: [number, number];
+    };
+    setViewport: (viewport: {
+        zoom: number;
+        translation: [number, number];
+    }) => void;
+    viewportFit: (box: Box2) => void;
+    setCardItemHeight: (id: string, height: number) => void;
+};
+export declare class HTMLOverlayManager {
+    private options;
+    private eventCleanups;
+    private state;
+    constructor(options: HTMLOverlayManagerOptions);
+    attach(): void;
+    dispose(): void;
+    scheduleRender(): void;
+    rasterizeCard(id: string, options: CardRasterizeOptions): Promise<string | undefined>;
+    private initEvents;
+    private initDOMEvents;
+    private handleContainerDoubleClick;
+    private handleContainerMouseDown;
+    private handleContainerMouseMove;
+    private handleContainerMouseLeave;
+    private handleViewportTransform;
+    private render;
+    private syncOverlayOrder;
+    private renderFrameOverlays;
+    private getOrCreateFrameOverlay;
+    private getOrCreateOverlay;
+    private getHTMLCardIdByEvent;
+    private getHoverShellInteractiveIdByEvent;
+    private getLayerPoint;
+    private getOrCreateContentOverlay;
+    private createContentScaleOverlay;
+    private syncContentScale;
+    private syncContentInteraction;
+    private syncShellInteraction;
+    private enterEditing;
+    private exitEditing;
+    private getEditingFitZoom;
+    private isEventInsideOverlay;
+    private renderOverlayHTML;
+    private renderOverlayContent;
+    private chainCleanups;
+    private cleanupOverlayContent;
+    private removeOverlay;
+    private syncAutoHeight;
+    private createAutoHeightObserver;
+    private scheduleAutoHeightMeasure;
+    private measureAutoHeight;
+    private getNaturalContentHeight;
+    private getIframeNaturalContentHeight;
+    private getChildrenNaturalHeight;
+    private cleanupAutoHeight;
+    private applyAutoHeight;
+    private isAutoHeightMessage;
+}
+export {};

package/dist/src/html-overlay/mime-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function getMimeType(path: string): string;
+export declare function createDataUrl(source: string, mimeType: string): string;

package/dist/src/html-overlay/overlay-transform.d.ts

@@ -0,0 +1,13 @@
+import type { Box2 } from '../math';
+export type CardOverlayBoxStyle = {
+    left: string;
+    top: string;
+    width: string;
+    height: string;
+    transform: string;
+};
+export declare function getCardOverlayBoxStyle(box: Box2, width: number, height: number, offsetX?: number, offsetY?: number): CardOverlayBoxStyle;
+export declare function isPointInCardOverlayBox(box: Box2, point: {
+    x: number;
+    y: number;
+}): boolean;

package/dist/src/html-overlay/path-utils.d.ts

@@ -0,0 +1,8 @@
+export declare function normalizePath(path: string): string;
+export declare function dirname(path: string): string;
+export declare function resolvePath(path: string, fromPath: string): string;
+export declare function splitResourcePath(path: string): {
+    path: string;
+    suffix: string;
+};
+export declare function shouldRewriteResource(url: string): boolean;

package/dist/src/html-overlay/shell-runtime.d.ts

@@ -0,0 +1,6 @@
+import type { CardHTMLContent, CardHTMLRenderCleanup, CardHTMLShellContent } from '../types';
+export type MountedHTMLShell = {
+    contentContainer: HTMLElement;
+    cleanup?: CardHTMLRenderCleanup;
+};
+export declare function mountHTMLShell(container: HTMLElement, content: CardHTMLContent, shell?: CardHTMLShellContent): MountedHTMLShell;

package/dist/src/index.d.ts

@@ -0,0 +1,14 @@
+export type { SDKOptions, SDKInputParam, PageData, PageProperty, ViewProperty, ActiveData, ViewParam, BaseItemProperty, SpriteItemProperty, TextItemProperty, VideoItemProperty, GeneratorItemProperty, FrameItemProperty, FrameLayoutMode, SpriteCreateInfo, TextCreateInfo, GroupCreateInfo, VideoCreateInfo, GeneratorCreateInfo, EffectsCreateInfo, FrameCreateInfo, CardCreateInfo, CardItemProperty, CardItemTransformInfo, ItemCreateInfo, } from './types';
+export type { CardTypeConfig, CardConfig } from './config';
+export type { SDKItem } from './sdk-item';
+export { BaseItem, SpriteItem, TextItem, VideoItem, GroupItem, GeneratorItem, EffectsItem, FrameItem, CardItem, isBaseItem, isSpriteItem, isTextItem, isVideoItem, isGroupItem, isGeneratorItem, isEffectsItem, isFrameItem, isCardItem, SDKItemType, } from './sdk-item';
+export type { SDKItemOptions, SpriteItemOptions, TextItemOptions, VideoItemOptions, GroupItemOptions, GeneratorItemOptions, EffectsItemOptions, FrameItemOptions, CardItemOptions, } from './sdk-item';
+export { ItemOrderAction } from './types';
+export type { SetItemPropertyParam, SetSingleItemSinglePropertyParam, SetSingleItemMultiplePropertiesParam, BaseItemPropertyKey, BaseItemPropertyValueMap, ItemPropertyMap, } from './types';
+export type { CreateOperation, DeleteOperation, UpdateOperation, Operation } from './service/UndoRedo';
+export type { SDKEvents } from './sdk';
+export type { GizmoType } from './gesture-handler/gizmo';
+export { SDK } from './sdk';
+export { Box2, Vector2 } from './math';
+export { spec, generateGUID } from './shared';
+export * from './utils';

package/dist/src/math/box2.d.ts

@@ -0,0 +1,166 @@
+import { Vector2 } from './vector2';
+/**
+ * @class 二维包围盒
+ */
+export declare class Box2 {
+    /**
+     * @member {Vector2[]} corners 二维包围盒角点
+     */
+    corners: Vector2[];
+    min: Vector2;
+    max: Vector2;
+    /**
+     * 构造函数，传入值为空时表示空包围盒
+     * @param {Vector2} [min=new Vector2(Infinity, Infinity)] 最小点
+     * @param {Vector2} [max=new Vector2(-Infinity, -Infinity)] 最大点
+     */
+    constructor(min?: Vector2, max?: Vector2);
+    /**
+     * 通过最大最小点设置二维包围盒
+     * @param {Vector2} min 最小点
+     * @param {Vector2} max 最大点
+     * @returns {Box2} 二维包围盒
+     */
+    set(min: Vector2, max: Vector2): this;
+    /**
+     * 通过角点设置二维包围盒
+     * @param {Vector2[]} vecArray 二维空间点数组
+     * @returns {Box2} 二维包围盒
+     */
+    setFromVec2Array(vecArray: Vector2[]): this;
+    setFromCorners(corners: Vector2[]): this;
+    /**
+     * 通过屏幕坐标点设置二维包围盒 - 点为屏幕坐标点，x正方向为右，y正方向为向上
+     * @param vecArray 屏幕坐标点
+     */
+    setFromVec2ArrayWithOutCorners(vecArray: Vector2[]): this;
+    /**
+     * 通过中心与大小设置二维包围盒
+     * @param {Vector2} center 二维中心点
+     * @param {Vector2} size 二维大小
+     * @returns {Box2} 二维包围盒
+     */
+    setFromCenterAndSize(center: Vector2, size: Vector2): this;
+    /**
+     * 克隆二维包围盒
+     * @returns {Box2} 克隆结果
+     */
+    clone(): Box2;
+    /**
+     * 复制二维包围盒
+     * @param {Box2} box 二维包围盒
+     * @returns {Box2} 复制结果
+     */
+    copyFrom(box: Box2): this;
+    /**
+     * 二维包围盒置空
+     * @returns {Box2} 置空结果
+     */
+    makeEmpty(): this;
+    /**
+     * 二维包围盒判空
+     * @returns {boolean} 判空结果
+     */
+    isEmpty(): boolean;
+    /**
+     * 获取二维包围盒角点
+     * @returns {Vector2[]} 二维包围盒角点
+     */
+    getCorners(): Vector2[];
+    /**
+     * 获取二维包围盒中心点
+     * @param {Vector2} [target=new Vector2()] 目标点(用以存放二维包围盒中心点)
+     * @returns {Vector2} 二维包围盒中心点
+     */
+    getCenter(target?: Vector2): Vector2;
+    /**
+     * 获取二维包围盒大小
+     * @param {Vector2} [target=new Vector2()] 目标向量(用以存放二维包围盒大小)
+     * @returns {Vector2} 二维包围盒大小
+     */
+    getSize(target?: Vector2): Vector2;
+    /**
+     * 通过二维空间点扩展二维包围盒
+     * @param {Vector2} point 二维空间点
+     * @returns {Box2} 扩展包围盒
+     */
+    expandByPoint(point: Vector2): this;
+    /**
+     * 通过向量扩展二维包围盒
+     * @param {Vector2} vector 二维向量
+     * @returns {Box2} 扩展结果
+     */
+    expandByVector(vector: Vector2): this;
+    /**
+     * 通过大小扩展二维包围盒
+     * @param {number} scalar 扩展大小
+     * @returns {Box2} 扩展结果
+     */
+    expandByScalar(scalar: number): this;
+    /**
+     * 判断二维包围盒是否包含二维空间点
+     * @param {Vector2} point 二维空间点
+     * @param {boolean} [isOrthogonal=true] 包围盒正交判断(默认为true)
+     * @returns {boolean} 点包含判断结果
+     */
+    containsPoint(point: Vector2, isOrthogonal?: boolean): boolean;
+    /**
+     * 判断二维包围盒包含关系(if this contains other)
+     * @param {Box2} box 其它包围盒
+     * @returns {boolean} 二维包围盒包含判断结果
+     */
+    containsBox(box: Box2): boolean;
+    /**
+     * 获取点以包围盒左上角顶点为原点的相对位置
+     * @param {Vector2} point 指定二维空间点
+     * @param {Vector2} [target=new Vector2()] 目标空间点
+     * @returns {Vector2} 计算结果空间点
+     */
+    getParameter(point: Vector2, target?: Vector2): Vector2;
+    /**
+     * 求点与二维包围盒的最近点
+     * @param {Vector2} point 二维空间点
+     * @param {Vector2} [target=new Vector2()] 结果点
+     * @returns {Vector2} 二维空间点
+     */
+    clampPoint(point: Vector2, target?: Vector2): Vector2;
+    /**
+     * 求点到二维包围盒的距离
+     * @param {Vector2} point 二维空间点
+     * @returns {number} 距离
+     */
+    distanceToPoint(point: Vector2): number;
+    /**
+     * 二维包围盒求交集
+     * @param {Box2} box 二维包围盒
+     * @returns {Box2} 求交结果
+     */
+    intersect(box: Box2): this;
+    /**
+     * 二维包围盒求并集
+     * @param {Box2} box 二维包围盒
+     * @returns {Box2} 求并结果
+     */
+    union(target: Box2 | Vector2): this;
+    /**
+     * 二维包围盒位移
+     * @param {Vector2} offset 位移向量
+     * @returns {Box2} 位移结果
+     */
+    translate(offset: Vector2): this;
+    scale(scalar: number | Vector2, anchor?: Vector2): this;
+    /**
+     * 二维包围盒判等
+     * @param {Box2} box 二维包围盒
+     * @returns {boolean} 判等结果
+     */
+    equals(box: Box2): boolean;
+    /**
+     * 判断二维包围盒相交关系(if this intersect other)
+     * @param {Box2} box 二维包围盒
+     * @param {boolean} [isOrthogonal=true] 正交判断(当前包围盒)
+     * @returns {boolean} 相交判断结果
+     */
+    intersectsBox(box: Box2, isOrthogonal?: boolean): boolean;
+    rotate(angle: number, center?: Vector2): this;
+}

package/dist/src/math/circle.d.ts

@@ -0,0 +1,82 @@
+import type { Box2 } from './box2';
+import { Vector2 } from './vector2';
+export declare class Circle {
+    center: Vector2;
+    radius: number;
+    constructor(center?: Vector2, radius?: number);
+    /**
+     * 通过中心点与大小设置圆
+     * @param {Vector2} center 圆心
+     * @param {number} radius 半径
+     * @returns {Circle}
+     */
+    set(center: Vector2, radius: number): this;
+    /**
+     * 克隆圆
+     * @returns {Circle} 克隆结果
+     */
+    clone(): Circle;
+    /**
+     * 复制圆
+     * @param {Circle} circle 复制对象
+     * @returns {Circle} 复制结果
+     */
+    copy(circle: Circle): this;
+    /**
+     * 圆置空
+     * @returns {Circle} 置空结果
+     */
+    makeEmpty(): this;
+    /**
+     * 圆判空
+     * @returns {boolean} 判空结果
+     */
+    isEmpty(): boolean;
+    /**
+     * 获取圆心
+     * @param {Vector2} [target=new Vector2()] 目标结果对象
+     * @returns {Vector2} 圆心
+     */
+    getCenter(target?: Vector2): Vector2;
+    /**
+     * 获取半径
+     * @returns {number} 半径
+     */
+    getRadius(): number;
+    /**
+     * 通过二维空间点扩展圆
+     * @param {Vector2} point 二维空间点
+     * @returns {Circle} 扩展结果
+     */
+    expandByPoint(point: Vector2): this;
+    /**
+     * 通过大小扩展圆
+     * @param {number} scalar 扩展大小
+     * @returns {Circle} 扩展结果
+     */
+    expandByScalar(scalar: number): this;
+    /**
+     * 判断圆是否包含二维空间点
+     * @param {Vector2} point 二维空间点
+     * @returns {boolean}  包含判断结果
+     */
+    containsPoint(point: Vector2): boolean;
+    /**
+     * 判断圆是否包含二维包围盒
+     * @param {Box2} box 二维包围盒
+     * @returns {boolean} 包含判断结果
+     */
+    containsBox(box: Box2): boolean;
+    /**
+     * 判断圆与二维包围盒的相交关系
+     * @param {Box2} box 二维包围盒
+     * @returns {boolean} 相交判断结果
+     */
+    intersectsBox(box: Box2): boolean;
+    /**
+     * 求点与圆的最短距离
+     * @param {Vector2} point 二维空间点
+     * @returns {number} 距离
+     */
+    distanceToPoint(point: Vector2): number;
+}

package/dist/src/math/euler.d.ts

@@ -0,0 +1,20 @@
+import { math } from '../shared';
+import { Matrix4 } from './matrix4';
+import { Vector3 } from './vector3';
+export declare class Euler extends math.Euler {
+    constructor(x?: number, y?: number, z?: number, order?: math.EulerOrder);
+    getInvertMatrixByEuler(): Matrix4;
+    /**
+     * 欧拉角保存于三维向量(应用于计算)
+     * @param {Vector3} [optionalResult] 目标保存对象
+     * @returns {Vector3} 保存结果
+     */
+    toDegreeVector3(optionalResult?: Vector3): Vector3;
+    /**
+     * 由角度三维向量构建欧拉角
+     * @param {Vector3} v 角度三维向量
+     * @param {EulerOrder} [order] 欧拉角顺序，默认为ZYX
+     * @returns {Euler} 欧拉角
+     */
+    setFromDegreeVector3(degree: Vector3, order?: math.EulerOrder): this;
+}

package/dist/src/math/index.d.ts

@@ -0,0 +1,13 @@
+export * from './box2';
+export * from './circle';
+export * from './euler';
+export * from './line2';
+export * from './line3';
+export * from './matrix4';
+export * from './plane';
+export * from './quaternion';
+export * from './ray-caster';
+export * from './ray';
+export * from './utils';
+export * from './vector2';
+export * from './vector3';