@vvfx/sdk 0.1.19-alpha.37 → 0.1.19-alpha.38

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/document-runtime.d.ts

@@ -0,0 +1,3 @@
+import type { CardHTMLDocumentContent, CardHTMLDOMRenderer, CardHTMLRenderCleanup } from '../types';
+export declare function renderDocumentContent(overlay: HTMLElement, content: CardHTMLDocumentContent): CardHTMLRenderCleanup;
+export declare function renderDOMContentInIframe(overlay: HTMLElement, render: CardHTMLDOMRenderer): 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/index.d.ts

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

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

@@ -0,0 +1,43 @@
+import type { Box2 } from '../math';
+import type { EventEmitter } from '../shared';
+import type { SDKEvents } from '../sdk';
+import { type SDKItem } from '../sdk-item';
+type HTMLOverlayManagerOptions = {
+    container: HTMLElement;
+    emitter: EventEmitter<SDKEvents>;
+    getItems: () => SDKItem[];
+    getViewBoxById: (id: string) => Box2;
+    getZoom: () => number;
+    setZoom: (zoom: number) => void;
+    viewportFit: (box: Box2) => void;
+};
+export declare class HTMLOverlayManager {
+    private options;
+    private state;
+    constructor(options: HTMLOverlayManagerOptions);
+    attach(): void;
+    dispose(): void;
+    scheduleRender(): void;
+    private initEvents;
+    private initDOMEvents;
+    private handleContainerDoubleClick;
+    private handleContainerMouseDown;
+    private handleViewportTransform;
+    private render;
+    private renderFrameOverlays;
+    private getOrCreateFrameOverlay;
+    private getOrCreateOverlay;
+    private getHTMLCardIdByEvent;
+    private getLayerPoint;
+    private getOrCreateContentOverlay;
+    private createContentScaleOverlay;
+    private syncContentScale;
+    private syncContentInteraction;
+    private enterEditing;
+    private exitEditing;
+    private isEventInsideOverlay;
+    private renderOverlayContent;
+    private cleanupOverlayContent;
+    private removeOverlay;
+}
+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/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/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, createSDKItem, 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';

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

@@ -0,0 +1,93 @@
+import { Vector2 } from './vector2';
+/**
+ * @class 二维线段
+ */
+export declare class Line2 {
+    start: Vector2;
+    end: Vector2;
+    constructor(start?: Vector2, end?: Vector2);
+    /**
+     * 设置二维线段
+     * @param {Vector2} start 线段起点
+     * @param {Vector2} end 线段终点
+     * @returns {Line2} 二维线段
+     */
+    set(start: Vector2, end: Vector2): this;
+    /**
+     * 复制二维线段
+     * @param {Line2} line 复制对象
+     * @returns {Line2} 复制结果
+     */
+    copyFrom(line: Line2): this;
+    /**
+     * 二维线段求方向
+     * @returns {Vector2} 二维线段方向
+     */
+    direction(): Vector2;
+    /**
+     * 二维线段求中点
+     * @param {Vector2} [target=new Vector2()] 目标保存对象
+     * @returns {Vector2} 二维线段中点
+     */
+    getCenter(target?: Vector2): Vector2;
+    /**
+     * 二维线段向量值
+     * @param {Vector2} [target=new Vector2()] 目标保存对象
+     * @returns {Vector2} 二维线段向量值
+     */
+    delta(target?: Vector2): Vector2;
+    /**
+     * 二维线段欧式距离平方(应用于计算)
+     * @returns {number} 计算结果
+     */
+    distanceSq(): number;
+    /**
+     * 二维线段欧式距离
+     * @returns {number} 计算结果
+     */
+    distance(): number;
+    /**
+     * 求二维线段比例点
+     * @param {number} t 比例值
+     * @param {Vector2} target 目标保存对象
+     * @returns {Vector2} 比例点结果
+     */
+    at(t: number, target?: Vector2): Vector2;
+    /**
+     * 求点与线段的最短距离
+     * @param {Vector2} point 二维空间点
+     * @param {boolean} clampToLine 是否限制于线段内
+     * @returns {number} 距离结果
+     */
+    closestPointToPointParameter(point: Vector2, clampToLine: boolean): number;
+    /**
+     * 求点与线段的最近交点
+     * @param {Vector2} point 二维空间点
+     * @param {boolean} clampToLine 是否限制于线段内
+     * @param {Vector2} target 目标保存对象
+     * @returns {Vector2} 最近交点
+     */
+    closestPointToPoint(point: Vector2, clampToLine: boolean, target?: Vector2): Vector2;
+    /**
+     * 二维线段判等
+     * @param {Line2} line 二维线段
+     * @returns {boolean} 判等结果
+     */
+    equals(line: Line2): boolean;
+    /**
+     * 克隆二维线段
+     * @returns {Line2} 克隆结果
+     */
+    clone(): Line2;
+    /**
+     * 二维线段求长度
+     * @returns {number} 长度
+     */
+    length(): number;
+    /**
+     * 二维线段判断相交
+     * @param {Line2} other 二维线段
+     * @returns {boolean} 相交判断结果
+     */
+    crossWithLine(other: Line2): boolean;
+}

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

@@ -0,0 +1,17 @@
+import { Vector3 } from './vector3';
+/**
+ * @class 三维线段
+ */
+export declare class Line3 {
+    start: Vector3;
+    end: Vector3;
+    /**
+     * 构造函数
+     * @param {Vector3} [start=new Vector3()] 线段起点，默认值为(0, 0, 0)
+     * @param {Vector3} [end=new Vector3()] 线段终点，默认值为(0, 0, 0)
+     */
+    constructor(start?: Vector3, end?: Vector3);
+    closestPointToPointParameter(point: Vector3, clampToLine?: boolean): number;
+    closestPointToPoint(point: Vector3, clampToLine?: boolean): Vector3;
+    delta(): Vector3;
+}

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

@@ -0,0 +1,28 @@
+import { math } from '../shared';
+import type { Euler } from './euler';
+import type { Quaternion } from './quaternion';
+import { Vector3 } from './vector3';
+export declare class Matrix4 extends math.Matrix4 {
+    /**
+     * 通过数组创建矩阵
+     * @param array - 数组
+     * @param [offset=0] - 起始偏移值
+     * @returns 矩阵
+     */
+    static fromArray(array: math.Matrix4DataType, offset?: number): Matrix4;
+    clone(): Matrix4;
+    compose(translation: Vector3, rotation: Quaternion, scale: Vector3, anchor?: math.Vector3): this;
+    /**
+     * 导出四维矩阵[三维空间变换矩阵]旋转部分
+     * @param {Matrix4} m 四维矩阵
+     * @returns {Matrix4} 导出结果
+     */
+    extractRotation(m: Matrix4): this;
+    /**
+     * 由欧拉角设置四维矩阵
+     * @param {Euler} euler 欧拉角
+     * @returns {Matrix4} 四维矩阵
+     */
+    makeRotationFromEuler(euler: Euler): this;
+    setPosition(position: Vector3): this;
+}