@tsdraw/core 0.4.0

package/dist/index.d.cts

@@ -0,0 +1,464 @@
+type ShapeId = string;
+interface Vec3 {
+    x: number;
+    y: number;
+    z?: number;
+}
+type SegmentType = 'free' | 'straight';
+interface DrawSegment {
+    type: SegmentType;
+    path: string;
+}
+type SizeStyle = 's' | 'm' | 'l' | 'xl';
+type DashStyle = 'draw' | 'solid' | 'dashed' | 'dotted';
+type ColorStyle = string;
+interface DrawShape {
+    id: ShapeId;
+    type: 'draw';
+    x: number;
+    y: number;
+    props: {
+        color: ColorStyle;
+        dash: DashStyle;
+        size: SizeStyle;
+        scale: number;
+        isPen: boolean;
+        isComplete: boolean;
+        segments: DrawSegment[];
+        isClosed?: boolean;
+    };
+}
+type Shape = DrawShape;
+interface PageState {
+    id: string;
+    shapes: Record<ShapeId, Shape>;
+    erasingShapeIds: ShapeId[];
+}
+declare const STROKE_WIDTHS: Record<SizeStyle, number>;
+declare const DRAG_DISTANCE_SQUARED = 36;
+declare const DEFAULT_COLORS: Record<string, string>;
+declare const MAX_POINTS_PER_SHAPE = 200;
+
+declare class DocumentStore {
+    private state;
+    private order;
+    getPage(): PageState;
+    getShape(id: ShapeId): Shape | undefined;
+    getCurrentPageShapesSorted(): Shape[];
+    getCurrentPageRenderingShapesSorted(): Shape[];
+    getErasingShapeIds(): ShapeId[];
+    setErasingShapes(ids: ShapeId[]): void;
+    createShape(shape: Shape): void;
+    updateShape(id: ShapeId, partial: Partial<Shape>): void;
+    deleteShapes(ids: ShapeId[]): void;
+    getCurrentPageShapes(): Shape[];
+    getShapeIdsInBounds(box: {
+        minX: number;
+        minY: number;
+        maxX: number;
+        maxY: number;
+    }): Set<ShapeId>;
+}
+
+interface PointerInput {
+    currentPagePoint: Vec3;
+    originPagePoint: Vec3;
+    previousPagePoint: Vec3;
+    isPen: boolean;
+    shiftKey: boolean;
+    ctrlKey: boolean;
+    isDragging: boolean;
+}
+declare class InputManager {
+    private _current;
+    private _origin;
+    private _previous;
+    private _isPen;
+    private _shiftKey;
+    private _ctrlKey;
+    private _metaKey;
+    private _isDragging;
+    getCurrentPagePoint(): Vec3;
+    getOriginPagePoint(): Vec3;
+    getPreviousPagePoint(): Vec3;
+    getIsPen(): boolean;
+    getShiftKey(): boolean;
+    getCtrlKey(): boolean;
+    getAccelKey(): boolean;
+    getIsDragging(): boolean;
+    pointerDown(pageX: number, pageY: number, pressure?: number, isPen?: boolean): void;
+    pointerMove(pageX: number, pageY: number, pressure?: number, isPen?: boolean): void;
+    pointerUp(): void;
+    setModifiers(shift: boolean, ctrl: boolean, meta?: boolean): void;
+    getInputs(): PointerInput;
+}
+
+interface IEditor {
+    getZoomLevel(): number;
+    options: {
+        dragDistanceSquared: number;
+    };
+    store: DocumentStore;
+    input: InputManager;
+    getShape(id: ShapeId): Shape | undefined;
+    createShape(shape: Shape): void;
+    updateShapes(partials: Array<{
+        id: ShapeId;
+        type: string;
+        props?: Partial<DrawShape['props']>;
+    }>): void;
+    getPointInShapeSpace(shape: DrawShape, pagePoint: Vec3): Vec3;
+    createShapeId(): ShapeId;
+    getErasingShapeIds(): ShapeId[];
+    setErasingShapes(ids: ShapeId[]): void;
+    getCurrentPageRenderingShapesSorted(): Shape[];
+    getCurrentDrawStyle(): {
+        color: ColorStyle;
+        dash: DashStyle;
+        size: SizeStyle;
+    };
+    setCurrentDrawStyle(partial: Partial<{
+        color: ColorStyle;
+        dash: DashStyle;
+        size: SizeStyle;
+    }>): void;
+    panBy(dx: number, dy: number): void;
+}
+
+interface ToolPointerDownInfo {
+    point: Vec3;
+}
+interface ToolPointerMoveInfo {
+    screenDeltaX?: number;
+    screenDeltaY?: number;
+}
+interface ToolKeyInfo {
+    key: string;
+}
+type ToolStateTransitionInfo = ToolPointerDownInfo | ToolPointerMoveInfo | ToolKeyInfo;
+interface ToolStateContext {
+    transition(stateId: string, info?: ToolStateTransitionInfo): void;
+}
+interface StateNodeConstructor {
+    id: string;
+    new (ctx: ToolStateContext, editor: IEditor): StateNode;
+}
+declare abstract class StateNode {
+    protected ctx: ToolStateContext;
+    protected editor: IEditor;
+    static id: string;
+    constructor(ctx: ToolStateContext, editor: IEditor);
+    onEnter(_info?: ToolStateTransitionInfo): void;
+    onExit(_info?: ToolStateTransitionInfo, _to?: string): void;
+    onPointerDown(_info?: ToolPointerDownInfo): void;
+    onPointerMove(_info?: ToolPointerMoveInfo): void;
+    onPointerUp(): void;
+    onKeyDown(_info?: ToolKeyInfo): void;
+    onKeyUp(_info?: ToolKeyInfo): void;
+    onCancel(): void;
+    onInterrupt(): void;
+}
+
+interface Viewport {
+    x: number;
+    y: number;
+    zoom: number;
+}
+declare function createViewport(): Viewport;
+declare function screenToPage(viewport: Viewport, screenX: number, screenY: number): {
+    x: number;
+    y: number;
+};
+declare function pageToScreen(viewport: Viewport, pageX: number, pageY: number): {
+    x: number;
+    y: number;
+};
+declare function setViewport(viewport: Viewport, updater: {
+    x?: number;
+    y?: number;
+    zoom?: number;
+}): Viewport;
+declare function panViewport(viewport: Viewport, dx: number, dy: number): Viewport;
+declare function zoomViewport(viewport: Viewport, factor: number, centerX?: number, centerY?: number): Viewport;
+
+type TsdrawRenderTheme = 'light' | 'dark';
+declare function resolveThemeColor(colorStyle: string, theme: TsdrawRenderTheme): string;
+
+interface ICanvasRenderer {
+    render(ctx: CanvasRenderingContext2D, viewport: Viewport, shapes: Shape[]): void;
+}
+declare class CanvasRenderer implements ICanvasRenderer {
+    private theme;
+    setTheme(theme: TsdrawRenderTheme): void;
+    render(ctx: CanvasRenderingContext2D, viewport: Viewport, shapes: Shape[]): void;
+    private paintStroke;
+    private paintDashedStroke;
+}
+
+type DefaultToolId = 'pen' | 'eraser' | 'select' | 'hand';
+type ToolId = DefaultToolId | (string & {});
+interface ToolDefinition {
+    id: ToolId;
+    initialStateId: string;
+    stateConstructors: StateNodeConstructor[];
+}
+declare class ToolManager {
+    private currentToolId;
+    private currentState;
+    private states;
+    private toolInitialStateIds;
+    registerState(state: StateNode): void;
+    registerTool(id: ToolId, initialStateId: string): void;
+    hasTool(id: ToolId): boolean;
+    setCurrentTool(id: ToolId): void;
+    getCurrentToolId(): ToolId;
+    getCurrentState(): StateNode | null;
+    transition(stateId: string, info?: ToolStateTransitionInfo): void;
+    pointerDown(info: ToolPointerDownInfo): void;
+    pointerMove(info: ToolPointerMoveInfo): void;
+    pointerUp(): void;
+    keyDown(info: ToolKeyInfo): void;
+    keyUp(info: ToolKeyInfo): void;
+    cancel(): void;
+    interrupt(): void;
+}
+
+interface EditorOptions {
+    dragDistanceSquared?: number;
+    toolDefinitions?: ToolDefinition[];
+    initialToolId?: ToolId;
+}
+declare class Editor {
+    readonly store: DocumentStore;
+    readonly input: InputManager;
+    readonly tools: ToolManager;
+    readonly renderer: CanvasRenderer;
+    viewport: Viewport;
+    readonly options: {
+        dragDistanceSquared: number;
+    };
+    private drawStyle;
+    private readonly toolStateContext;
+    constructor(opts?: EditorOptions);
+    registerToolDefinition(toolDefinition: ToolDefinition): void;
+    private getDefaultToolDefinitions;
+    createShapeId(): ShapeId;
+    getZoomLevel(): number;
+    getShape(id: ShapeId): Shape | undefined;
+    createShape(shape: Shape): void;
+    updateShapes(partials: Array<{
+        id: ShapeId;
+        type: string;
+        props?: Partial<DrawShape['props']>;
+    }>): void;
+    getPointInShapeSpace(shape: DrawShape, pagePoint: Vec3): Vec3;
+    getCurrentPageShapes(): DrawShape[];
+    getCurrentPageShapesSorted(): DrawShape[];
+    getCurrentPageRenderingShapesSorted(): DrawShape[];
+    getErasingShapeIds(): string[];
+    setErasingShapes(ids: ShapeId[]): void;
+    setCurrentTool(id: ToolId): void;
+    getCurrentToolId(): ToolId;
+    getCurrentDrawStyle(): {
+        color: ColorStyle;
+        dash: DashStyle;
+        size: SizeStyle;
+    };
+    setCurrentDrawStyle(partial: Partial<{
+        color: ColorStyle;
+        dash: DashStyle;
+        size: SizeStyle;
+    }>): void;
+    panBy(dx: number, dy: number): void;
+    screenToPage(screenX: number, screenY: number): {
+        x: number;
+        y: number;
+    };
+    render(ctx: CanvasRenderingContext2D): void;
+}
+
+declare class PenIdleState extends StateNode {
+    static id: string;
+    onPointerDown(info?: ToolPointerDownInfo): void;
+}
+
+declare class PenDrawingState extends StateNode {
+    static id: string;
+    private _startInfo;
+    private _target;
+    private _isPenDevice;
+    private _hasPressure;
+    private _phase;
+    private _extending;
+    private _anchor;
+    private _pendingAnchor;
+    private _lastSample;
+    private _shouldMerge;
+    private _pathLen;
+    private _activePts;
+    onEnter(info?: ToolPointerDownInfo): void;
+    onPointerMove(): void;
+    onKeyDown(info?: ToolKeyInfo): void;
+    onKeyUp(info?: ToolKeyInfo): void;
+    onPointerUp(): void;
+    onCancel(): void;
+    onInterrupt(): void;
+    private canClosePath;
+    private detectClosure;
+    private measurePath;
+    private beginStroke;
+    private spawnShape;
+    private advanceStroke;
+    private endStroke;
+}
+
+declare class EraserIdleState extends StateNode {
+    static id: string;
+    onPointerDown(info?: ToolPointerDownInfo): void;
+}
+
+declare class EraserPointingState extends StateNode {
+    static id: string;
+    onEnter(_info?: ToolStateTransitionInfo): void;
+    onPointerMove(info?: ToolPointerMoveInfo): void;
+    onPointerUp(): void;
+    onExit(_info?: ToolStateTransitionInfo, to?: string): void;
+    onCancel(): void;
+    private finish;
+}
+
+declare class EraserErasingState extends StateNode {
+    static id: string;
+    private _marked;
+    onEnter(_info?: ToolStateTransitionInfo): void;
+    onPointerMove(): void;
+    onPointerUp(): void;
+    onExit(): void;
+    onCancel(): void;
+    private sweep;
+    private finish;
+}
+
+interface Bounds {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+declare function boundsOf(points: {
+    x: number;
+    y: number;
+}[]): Bounds;
+declare function padBounds(b: Bounds, amount: number): Bounds;
+declare function sqDistance(ax: number, ay: number, bx: number, by: number): number;
+declare function distance(ax: number, ay: number, bx: number, by: number): number;
+declare function closestOnSegment(ax: number, ay: number, bx: number, by: number, px: number, py: number): {
+    x: number;
+    y: number;
+};
+declare function segmentTouchesPolyline(polyline: {
+    x: number;
+    y: number;
+}[], ax: number, ay: number, bx: number, by: number, margin: number): boolean;
+declare function minDistanceToPolyline(px: number, py: number, polyline: {
+    x: number;
+    y: number;
+}[]): number;
+
+declare const ERASER_MARGIN = 4;
+declare function shapePagePoints(shape: DrawShape): {
+    x: number;
+    y: number;
+}[];
+declare function pointHitsShape(shape: DrawShape, pageX: number, pageY: number, margin: number): boolean;
+declare function segmentHitsShape(shape: DrawShape, ax: number, ay: number, bx: number, by: number, margin: number): boolean;
+
+declare class SelectIdleState extends StateNode {
+    static id: string;
+}
+
+interface SelectionBounds {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+type ResizeHandle = 'nw' | 'ne' | 'sw' | 'se';
+interface TransformSnapshot {
+    x: number;
+    y: number;
+    segments: Array<{
+        type: DrawSegment['type'];
+        points: Vec3[];
+    }>;
+}
+declare function isSelectTool(tool: string): boolean;
+declare function getShapeBounds(shape: DrawShape): SelectionBounds;
+declare function normalizeSelectionBounds(a: {
+    x: number;
+    y: number;
+}, b: {
+    x: number;
+    y: number;
+}): SelectionBounds;
+declare function boundsContainPoint(bounds: SelectionBounds, x: number, y: number): boolean;
+declare function boundsIntersect(a: SelectionBounds, b: SelectionBounds): boolean;
+declare function rotatePoint(point: {
+    x: number;
+    y: number;
+}, center: {
+    x: number;
+    y: number;
+}, radians: number): {
+    x: number;
+    y: number;
+};
+declare function buildTransformSnapshots(editor: Editor, ids: ShapeId[]): Map<ShapeId, TransformSnapshot>;
+declare function buildStartPositions(editor: Editor, ids: ShapeId[]): Map<ShapeId, {
+    x: number;
+    y: number;
+}>;
+declare function getTopShapeAtPoint(editor: Editor, point: {
+    x: number;
+    y: number;
+}): DrawShape | null;
+declare function getSelectionBoundsPage(editor: Editor, ids: ShapeId[]): SelectionBounds | null;
+declare function getShapesInBounds(editor: Editor, bounds: SelectionBounds): ShapeId[];
+declare function applyMove(editor: Editor, startPositions: Map<ShapeId, {
+    x: number;
+    y: number;
+}>, deltaX: number, deltaY: number): void;
+declare function applyRotation(editor: Editor, startShapes: Map<ShapeId, TransformSnapshot>, center: {
+    x: number;
+    y: number;
+}, delta: number): void;
+declare function applyResize(editor: Editor, handle: ResizeHandle, startBounds: SelectionBounds, startShapes: Map<ShapeId, TransformSnapshot>, pointer: {
+    x: number;
+    y: number;
+}, lockAspectRatio: boolean): void;
+
+declare class HandIdleState extends StateNode {
+    static id: string;
+    onPointerDown(info?: ToolPointerDownInfo): void;
+}
+
+declare class HandDraggingState extends StateNode {
+    static id: string;
+    onPointerMove(info?: ToolPointerMoveInfo): void;
+    onPointerUp(): void;
+    onCancel(): void;
+    onInterrupt(): void;
+}
+
+declare function encodePoints(points: Vec3[]): string;
+declare function decodePoints(path: string): Vec3[];
+declare function decodeFirstPoint(path: string): Vec3 | null;
+declare function decodeLastPoint(path: string): Vec3 | null;
+declare function decodePathToPoints(segments: {
+    path: string;
+}[], ox: number, oy: number): {
+    x: number;
+    y: number;
+}[];
+
+export { type Bounds, CanvasRenderer, type ColorStyle, DEFAULT_COLORS, DRAG_DISTANCE_SQUARED, type DashStyle, type DefaultToolId, DocumentStore, type DrawSegment, type DrawShape, ERASER_MARGIN, Editor, type EditorOptions, EraserErasingState, EraserIdleState, EraserPointingState, HandDraggingState, HandIdleState, type ICanvasRenderer, type IEditor, InputManager, MAX_POINTS_PER_SHAPE, type PageState, PenDrawingState, PenIdleState, type PointerInput, type ResizeHandle, STROKE_WIDTHS, type SegmentType, SelectIdleState, type SelectionBounds, type Shape, type ShapeId, type SizeStyle, StateNode, type StateNodeConstructor, type ToolDefinition, type ToolId, type ToolKeyInfo, ToolManager, type ToolPointerDownInfo, type ToolPointerMoveInfo, type ToolStateContext, type ToolStateTransitionInfo, type TransformSnapshot, type TsdrawRenderTheme, type Vec3, type Viewport, applyMove, applyResize, applyRotation, boundsContainPoint, boundsIntersect, boundsOf, buildStartPositions, buildTransformSnapshots, closestOnSegment, createViewport, decodeFirstPoint, decodeLastPoint, decodePathToPoints, decodePoints, distance, encodePoints, getSelectionBoundsPage, getShapeBounds, getShapesInBounds, getTopShapeAtPoint, isSelectTool, minDistanceToPolyline, normalizeSelectionBounds, padBounds, pageToScreen, panViewport, pointHitsShape, resolveThemeColor, rotatePoint, screenToPage, segmentHitsShape, segmentTouchesPolyline, setViewport, shapePagePoints, sqDistance, zoomViewport };