@excalidraw/common 0.18.0-063e025 → 0.18.0-1acf66e

package/dist/types/excalidraw/drawShapeTrail.d.ts

@@ -0,0 +1,16 @@
+import type { GlobalPoint } from "@excalidraw/math";
+import type App from "./components/App";
+import type { Trail } from "./animatedTrail";
+export declare class DrawShapeTrail implements Trail {
+    private app;
+    private trail;
+    constructor(app: App);
+    private getTrailOptions;
+    startPath(x: number, y: number): void;
+    addPointToPath(x: number, y: number): void;
+    endPath(): void;
+    clearTrails(): void;
+    getCurrentPoints(): GlobalPoint[];
+    start(container: SVGSVGElement): void;
+    stop(): void;
+}

package/dist/types/excalidraw/scene/types.d.ts

@@ -9,6 +9,9 @@ export type StaticCanvasRenderConfig = {
     canvasBackgroundColor: AppState["viewBackgroundColor"];
     imageCache: AppClassProperties["imageCache"];
     renderGrid: boolean;
+    /** whether to render link icons on elements with links (never rendered
+     when exporting). @default true */
+    renderLinks?: boolean;
     /** when exporting the behavior is slightly different (e.g. we can't use
      CSS filters), and we disable render optimizations for best output */
     isExporting: boolean;

package/dist/types/excalidraw/types.d.ts

@@ -1,7 +1,7 @@
 import type { IMAGE_MIME_TYPES, UserIdleState, throttleRAF, MIME_TYPES, EditorInterface, StrokeWidthKey } from "@excalidraw/common";
 import type { LinearElementEditor } from "@excalidraw/element";
 import type { MaybeTransformHandleType } from "@excalidraw/element";
-import type { PointerType, ExcalidrawLinearElement, NonDeletedExcalidrawElement, NonDeleted, TextAlign, ExcalidrawElement, GroupId, ExcalidrawBindableElement, Arrowhead, FontFamilyValues, FileId, Theme, StrokeRoundness, ExcalidrawEmbeddableElement, ExcalidrawMagicFrameElement, ExcalidrawFrameLikeElement, ExcalidrawElementType, ExcalidrawIframeLikeElement, OrderedExcalidrawElement, ExcalidrawNonSelectionElement, BindMode, ExcalidrawTextElement, StrokeVariability } from "@excalidraw/element/types";
+import type { PointerType, ExcalidrawLinearElement, NonDeletedExcalidrawElement, NonDeleted, TextAlign, ExcalidrawElement, GroupId, ExcalidrawBindableElement, ExcalidrawArrowElement, Arrowhead, FontFamilyValues, FileId, Theme, StrokeRoundness, ExcalidrawEmbeddableElement, ExcalidrawMagicFrameElement, ExcalidrawFrameLikeElement, ExcalidrawElementType, ExcalidrawIframeLikeElement, OrderedExcalidrawElement, ExcalidrawNonSelectionElement, BindMode, ExcalidrawTextElement, StrokeVariability } from "@excalidraw/element/types";
 import type { Merge, MaybePromise, ValueOf, MakeBrand } from "@excalidraw/common/utility-types";
 import type { CaptureUpdateActionType, DurableIncrement, EphemeralIncrement } from "@excalidraw/element";
 import type { GlobalPoint } from "@excalidraw/math";
@@ -85,7 +85,7 @@ export type BinaryFileData = {
 };
 export type BinaryFileMetadata = Omit<BinaryFileData, "dataURL">;
 export type BinaryFiles = Record<ExcalidrawElement["id"], BinaryFileData>;
-export type ToolType = "selection" | "lasso" | "rectangle" | "diamond" | "ellipse" | "arrow" | "line" | "freedraw" | "text" | "image" | "eraser" | "hand" | "frame" | "magicframe" | "embeddable" | "laser";
+export type ToolType = "selection" | "lasso" | "rectangle" | "diamond" | "ellipse" | "arrow" | "line" | "freedraw" | "text" | "image" | "eraser" | "hand" | "frame" | "magicframe" | "embeddable" | "laser" | "autoshape";
 export type ElementOrToolType = ExcalidrawElementType | ToolType | "custom";
 export type ActiveTool = {
     type: ToolType;
@@ -139,7 +139,9 @@ export type InteractiveCanvasAppState = Readonly<_CommonCanvasAppState & {
     newElement: AppState["newElement"];
     isBindingEnabled: AppState["isBindingEnabled"];
     isMidpointSnappingEnabled: AppState["isMidpointSnappingEnabled"];
+    gridModeEnabled: AppState["gridModeEnabled"];
     suggestedBinding: AppState["suggestedBinding"];
+    hoveredArrowTextAnchor: AppState["hoveredArrowTextAnchor"];
     isRotating: AppState["isRotating"];
     elementsToHighlight: AppState["elementsToHighlight"];
     collaborators: AppState["collaborators"];
@@ -261,6 +263,15 @@ export interface AppState {
         element: NonDeleted<ExcalidrawBindableElement>;
         midPoint?: GlobalPoint;
     } | null;
+    /**
+     * Where on a hovered arrow the text tool would attach text if clicked —
+     * a free endpoint (binds the arrow to a new text element positioned against
+     * that endpoint) or the arrow's midpoint (adds a label bound to the arrow).
+     */
+    hoveredArrowTextAnchor: {
+        elementId: ExcalidrawArrowElement["id"];
+        anchor: "start" | "end" | "label";
+    } | null;
     frameToHighlight: NonDeleted<ExcalidrawFrameLikeElement> | null;
     frameRendering: {
         enabled: boolean;
@@ -268,7 +279,10 @@ export interface AppState {
         outline: boolean;
         clip: boolean;
     };
-    editingFrame: string | null;
+    /**
+     * frame-like element whose name is currently being edited
+     */
+    editingFrame: ExcalidrawFrameLikeElement["id"] | null;
     elementsToHighlight: readonly NonDeletedExcalidrawElement[] | null;
     /**
      * set when a new text is created or when an existing text is being edited
@@ -430,7 +444,7 @@ export type SearchMatch = {
         showOnCanvas: boolean;
     }[];
 };
-export type UIAppState = Omit<AppState, "cursorButton" | "scrollX" | "scrollY" | "zoom" | "shouldCacheIgnoreZoom" | "snapLines" | "originSnapOffset" | "suggestedBinding" | "frameToHighlight" | "elementsToHighlight">;
+export type UIAppState = Omit<AppState, "cursorButton" | "scrollX" | "scrollY" | "zoom" | "shouldCacheIgnoreZoom" | "snapLines" | "originSnapOffset" | "suggestedBinding" | "hoveredArrowTextAnchor" | "frameToHighlight" | "elementsToHighlight">;
 export type NormalizedZoomValue = number & {
     _brand: "normalizedZoom";
 };
@@ -487,6 +501,111 @@ export type OnExportProgress = {
     /** 0-1 range */
     progress?: number;
 };
+export type InteractionConfig = {
+    /**
+     * Interactions that stay enabled while the editor is otherwise
+     * non-interactive. Opt-in: anything omitted or `false` is disabled.
+     */
+    enabled?: {
+        /**
+         * Element links render their link icon and stay clickable — clicking
+         * anywhere on a linked element opens the link, same as in view mode.
+         * When disabled, link icons are not rendered at all.
+         *
+         * @default false
+         */
+        links?: boolean;
+        /**
+         * Embeddable & iframe elements stay interactive — hovering & clicking
+         * activates them so their content can be used, same as in view mode.
+         *
+         * @default false
+         */
+        embeds?: boolean;
+        /**
+         * Umbrella for all interactive content on canvas — shorthand for
+         * enabling `links` & `embeds` (and future interactive content kinds)
+         * together. Additive: `interactiveContent: true` enables them
+         * regardless of their individual values.
+         *
+         * @default false
+         */
+        interactiveContent?: boolean;
+        /**
+         * Canvas navigation — panning (pointer drag, wheel, PageUp/PageDown)
+         * and zooming (ctrl/cmd + wheel, pinch, and the canvas zoom &
+         * zoom-to-fit shortcuts: ctrl/cmd +/-/0, shift+1/2/3), same as in view
+         * mode. Respects `appState.scrollConstraints` if set, so it composes
+         * with viewport locking. The rest of the keyboard stays disabled. Note
+         * the editor consumes wheel & touch input again when enabled, so the
+         * page no longer scrolls over the editor.
+         *
+         * @default false
+         */
+        navigation?: boolean;
+        /**
+         * Whether the browser's own zoom remains available over the editor —
+         * ctrl/cmd + wheel, pinch, and (while the editor has focus)
+         * ctrl/cmd +/-/0 shortcuts. Prevented by default, mirroring the
+         * interactive editor. Regular page scrolling stays available either way.
+         * With `navigation` enabled, the zoom input (wheel, pinch, keyboard
+         * shortcuts) zooms the canvas instead either way, making this moot.
+         *
+         * @default false
+         */
+        browserZoom?: boolean;
+        /**
+         * Tools that stay user-driven while the editor is otherwise
+         * non-interactive: pointer input keeps driving the listed tool when it's
+         * the active tool. Does not enable user-driven tool *switching* — the
+         * keyboard stays disabled and tool selection remains host-driven
+         * (`ExcalidrawAPI.setActiveTool`).
+         *
+         * Composes with `navigation`: the enabled tool wins the primary-pointer
+         * drag, while wheel input (and wheel-button drag) still pans/zooms.
+         */
+        tools?: {
+            /**
+             * The laser pointer stays usable — pointer strokes draw laser trails
+             * and pointer positions keep broadcasting via `onPointerUpdate`, so
+             * e.g. collaborators see a presenter's laser & cursor.
+             *
+             * @default false
+             */
+            laser?: boolean;
+            /**
+             * Custom tools (`activeTool.type === "custom"`) stay usable — the
+             * editor keeps dispatching `onPointerDown` / `onPointerUp` for them.
+             * Tool behavior is host-implemented; activate custom tools with
+             * `locked: true` or they revert to the selection tool (and go inert)
+             * after the first pointer interaction.
+             *
+             * @default false
+             */
+            custom?: boolean;
+        };
+    };
+};
+export type UIConfig = {
+    /**
+     * Default UI controls that stay enabled while the rest of Excalidraw's
+     * default UI is hidden. Opt-in: anything omitted or `false` is disabled.
+     */
+    enabled: {
+        /**
+         * The zoom-out, reset-zoom, and zoom-in controls.
+         *
+         * @default false
+         */
+        zoom?: boolean;
+        /**
+         * The button shown when the viewport is scrolled away from all content.
+         *
+         * @default false
+         */
+        scrollBackToContent?: boolean;
+    };
+};
 export interface ExcalidrawProps {
     onChange?: (elements: readonly OrderedExcalidrawElement[], appState: AppState, files: BinaryFiles) => void;
     onThemeChange?: (theme: Theme | "system") => void;
@@ -542,6 +661,70 @@ export interface ExcalidrawProps {
     renderTopRightUI?: (isMobile: boolean, appState: UIAppState) => JSX.Element | null;
     langCode?: Language["code"];
     viewModeEnabled?: boolean;
+    /**
+     * Whether the editor accepts user input (pointer, keyboard, wheel, touch,
+     * clipboard, drag&drop). When `false`, the scene still renders and reacts
+     * to programmatic updates (imperative API), but the user cannot affect it
+     * in any way. Implies view mode.
+     *
+     * Pass a config object to keep specific interactions enabled while the
+     * editor is otherwise non-interactive (see `InteractionConfig`):
+     *
+     * ```tsx
+     * <Excalidraw interaction={{ enabled: { links: true } }} />
+     * ```
+     *
+     * @default true
+     */
+    interaction?: boolean | InteractionConfig;
+    /**
+     * Whether Excalidraw's default UI is rendered — toolbar, default menus,
+     * footer controls, sidebars, and canvas popups. Host UI passed through
+     * children (including exported components such as `MainMenu` and `Footer`)
+     * or render props continues to render, together with any supporting dialogs
+     * it opens.
+     *
+     * Canvas content (elements, text editing surface, frame names, embeds) still
+     * renders, and the editor remains interactive unless `interaction` is set to
+     * `false`.
+     *
+     * Pass a config object to keep specific default controls rendered while the
+     * rest of the default UI is hidden (see `UIConfig`):
+     *
+     * ```tsx
+     * <Excalidraw ui={{ enabled: { zoom: true } }} />
+     * ```
+     *
+     * NOTE: this is WIP and what default UI is/is not rendered when ui=false
+     * may yet change.
+     *
+     * @default true
+     */
+    ui?: boolean | UIConfig;
+    /**
+     * Forces the active editor tool (controlled). While set, user- and
+     * API-driven tool switching is ignored — `setActiveTool` refuses with a
+     * console warning, non-forced toolbar buttons render disabled — and the
+     * editor snaps back if internal flows reset the tool. The forced tool
+     * behaves as if locked (see the tool lock / padlock): it doesn't revert to
+     * the selection tool after use, and elements drawn with it aren't
+     * auto-selected — without mutating `appState.activeTool.locked`, so the
+     * user's persisted padlock preference stays untouched. Unset to return
+     * tool control to the editor (the current tool stays active).
+     *
+     * The forced tool must be activatable to take effect: not disabled via
+     * `UIOptions.tools`, and — while the editor is non-interactive — allowed
+     * via `interaction.enabled.tools`. Otherwise the editor stays on (or, when
+     * non-interactive, resets to) the `selection` tool, and the forced tool is
+     * applied once it becomes activatable. `image` cannot be forced (its
+     * activation opens the file picker).
+     */
+    activeTool?: {
+        type: Exclude<ToolType, "image">;
+    } | {
+        type: "custom";
+        customType: string;
+    };
     zenModeEnabled?: boolean;
     gridModeEnabled?: boolean;
     objectsSnapModeEnabled?: boolean;
@@ -678,8 +861,7 @@ export type AppClassProperties = {
     id: App["id"];
     onInsertElements: App["onInsertElements"];
     onExportImage: App["onExportImage"];
-    lastViewportPosition: App["lastViewportPosition"];
-    setViewport: App["setViewport"];
+    viewport: App["viewport"];
     addFiles: App["addFiles"];
     addElementsFromPasteOrLibrary: App["addElementsFromPasteOrLibrary"];
     togglePenMode: App["togglePenMode"];
@@ -690,11 +872,13 @@ export type AppClassProperties = {
     onMagicframeToolSelect: App["onMagicframeToolSelect"];
     getName: App["getName"];
     dismissLinearEditor: App["dismissLinearEditor"];
-    flowChartCreator: App["flowChartCreator"];
+    flowchart: App["flowchart"];
+    drawShape: App["drawShape"];
+    cursor: App["cursor"];
+    isToolLocked: App["isToolLocked"];
     getEffectiveGridSize: App["getEffectiveGridSize"];
     setPlugins: App["setPlugins"];
     plugins: App["plugins"];
-    getViewportOffsets: App["getViewportOffsets"];
     visibleElements: App["visibleElements"];
     excalidrawContainerValue: App["excalidrawContainerValue"];
     onPointerUpEmitter: App["onPointerUpEmitter"];
@@ -703,8 +887,11 @@ export type AppClassProperties = {
     onEvent: App["onEvent"];
     onStateChange: App["onStateChange"];
     lastPointerMoveCoords: App["lastPointerMoveCoords"];
+    lastPointerMoveEvent: App["lastPointerMoveEvent"];
     bindModeHandler: App["bindModeHandler"];
     setAppState: App["setAppState"];
+    isInteractionEnabled: App["isInteractionEnabled"];
+    isNavigationEnabled: App["isNavigationEnabled"];
 };
 export type PointerDownState = Readonly<{
     origin: Readonly<{
@@ -791,16 +978,16 @@ export interface ExcalidrawImperativeAPI {
     getAppState: () => InstanceType<typeof App>["state"];
     getFiles: () => InstanceType<typeof App>["files"];
     getName: InstanceType<typeof App>["getName"];
-    setViewport: InstanceType<typeof App>["setViewport"];
-    getViewportOffsets: InstanceType<typeof App>["getViewportOffsets"];
+    setViewport: InstanceType<typeof App>["viewport"]["setViewport"];
+    getViewportOffsets: InstanceType<typeof App>["viewport"]["getOffsets"];
     registerAction: (action: Action) => void;
     refresh: InstanceType<typeof App>["refresh"];
     setToast: InstanceType<typeof App>["setToast"];
     addFiles: (data: BinaryFileData[]) => void;
     id: string;
     setActiveTool: InstanceType<typeof App>["setActiveTool"];
-    setCursor: InstanceType<typeof App>["setCursor"];
-    resetCursor: InstanceType<typeof App>["resetCursor"];
+    setCursor: InstanceType<typeof App>["cursor"]["set"];
+    resetCursor: InstanceType<typeof App>["cursor"]["reset"];
     toggleSidebar: InstanceType<typeof App>["toggleSidebar"];
     getEditorInterface: () => EditorInterface;
     /**
@@ -823,7 +1010,6 @@ export type FrameNameBounds = {
     y: number;
     width: number;
     height: number;
-    angle: number;
 };
 export type FrameNameBoundsCache = {
     get: (frameElement: ExcalidrawFrameLikeElement | ExcalidrawMagicFrameElement) => FrameNameBounds | null;

package/dist/types/excalidraw/viewport.d.ts

@@ -1,10 +1,14 @@
 import type { SceneBounds } from "@excalidraw/element";
 import type { Bounds } from "@excalidraw/common";
-import type { ExcalidrawElement, NonDeleted, NonDeletedSceneElementsMap } from "@excalidraw/element/types";
+import type { ExcalidrawElement } from "@excalidraw/element/types";
 import type { AppState, NormalizedZoomValue, Offsets, PointerCoords, ScrollConstraints, ViewportOffsets, Zoom } from "./types";
-export declare const SCROLL_TO_CONTENT_ANIMATION_KEY = "animateScrollToContent";
 /** default rubberband overscroll give for scroll locks, in viewport px */
 export declare const DEFAULT_OVERSCROLL = 150;
+type ZoomOptions = {
+    viewportX: number;
+    viewportY: number;
+    nextZoom: NormalizedZoomValue;
+};
 export type AnimationOptions = {
     duration?: number;
 };
@@ -14,7 +18,6 @@ export type SetViewportRect = {
     width?: number;
     height?: number;
 };
-export declare const isSetViewportRect: (target: unknown) => target is SetViewportRect;
 export type SetViewportOptions = {
     /**
      * what to show in the viewport: an explicit scene-coordinate box/rect,
@@ -63,22 +66,13 @@ type Viewport = Pick<AppState, "scrollX" | "scrollY" | "zoom">;
  * resting clamp — pass 0 for a hard clamp.
  */
 export declare const constrainScrollState: (state: Pick<AppState, "scrollX" | "scrollY" | "zoom" | "width" | "height" | "scrollConstraints">, overscroll?: number) => Viewport;
-export declare const isViewportOverscrolled: (state: Pick<AppState, "scrollX" | "scrollY" | "zoom" | "width" | "height" | "scrollConstraints">) => boolean;
-/**
- * Rubberband snap-back: animates the viewport from its current (possibly
- * overscrolled) position back inside the lock box via the shared
- * AnimationController. No-op when already within the hard bounds (or when there
- * is no lock).
- */
-export declare const animateToConstraints: (state: Pick<AppState, "scrollX" | "scrollY" | "zoom" | "width" | "height" | "scrollConstraints">, onFrame: (viewport: Pick<AppState, "scrollX" | "scrollY" | "zoom" | "shouldCacheIgnoreZoom">) => void, duration?: number) => void;
 /**
- * Scrolls (and, per `fit`, zooms) the viewport so the given target box is in
- * view, optionally animating the transition. `onComplete` runs once the
- * viewport has settled on the target.
+ * Resolves a focal-point zoom against the active scroll constraints while
+ * preserving the current rubberband displacement in screen pixels. This lets
+ * zoom and scroll-constraint snap-back compose without either visually
+ * cancelling the other.
  */
-export declare const setViewportToBounds: (state: AppState, bounds: Bounds, opts: Pick<SetViewportOptions, "fit" | "animation"> & {
-    offsets?: Offsets;
-}, onFrame: (state: Pick<AppState, "scrollX" | "scrollY" | "zoom" | "shouldCacheIgnoreZoom">) => void, onComplete?: () => void) => void;
+export declare const getViewportForZoomWithScrollConstraints: (opts: ZoomOptions, state: AppState) => Viewport;
 export declare const zoomToFitBounds: ({ bounds, appState, canvasOffsets, fit, minZoom, maxZoom, steppedZoom, }: {
     bounds: SceneBounds;
     canvasOffsets?: Offsets;
@@ -106,26 +100,30 @@ export declare const zoomToFitBounds: ({ bounds, appState, canvasOffsets, fit, m
             element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
             state: "hover" | "active";
         } | null;
-        newElement: NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
+        newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
         resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-        multiElement: NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
+        multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
         selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
         isBindingEnabled: boolean;
         boxSelectionMode: import("./types").BoxSelectionMode;
         bindingPreference: "enabled" | "disabled";
         isMidpointSnappingEnabled: boolean;
         suggestedBinding: {
-            element: NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
+            element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
             midPoint?: import("@excalidraw/math").GlobalPoint;
         } | null;
-        frameToHighlight: NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+        hoveredArrowTextAnchor: {
+            elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
+            anchor: "start" | "end" | "label";
+        } | null;
+        frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
         frameRendering: {
             enabled: boolean;
             name: boolean;
             outline: boolean;
             clip: boolean;
         };
-        editingFrame: string | null;
+        editingFrame: import("@excalidraw/element/types").ExcalidrawFrameLikeElement["id"] | null;
         elementsToHighlight: readonly import("@excalidraw/element/types").NonDeletedExcalidrawElement[] | null;
         editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
         activeTool: {
@@ -251,48 +249,6 @@ export declare const zoomToFitBounds: ({ bounds, appState, canvasOffsets, fit, m
     };
     captureUpdate: "EVENTUALLY";
 };
-/** Computes the viewport (scroll + zoom) that brings the target box into view,
- * based on the requested fit behavior. */
-export declare const getTargetViewport: (state: AppState, bounds: Bounds, fit?: SetViewportOptions["fit"], offsets?: Offsets) => Viewport;
-export type ResolvedViewportTarget = {
-    /** null when the target couldn't be resolved (unknown id/link, or all
-     * supplied elements deleted) */
-    bounds: Bounds | null;
-    /** how the target was specified, so callers can react to unresolved
-     * targets themselves (e.g. toast on a broken element link) */
-    type: "element" | "area" | "link";
-};
-/** Resolves a `setViewport` target to a scene-coordinate box. */
-export declare const resolveViewportTarget: (target: SetViewportOptions["target"], elementsMap: NonDeletedSceneElementsMap, appState: Pick<AppState, "width" | "height">) => ResolvedViewportTarget;
-/** Computes the viewport patch for landing on `bounds`: the target
- * scroll/zoom, plus the scroll lock to install — or `scrollConstraints: null`
- * to clear a previous lock when none is requested. */
-export declare const getConstrainedTargetViewport: (appState: AppState, bounds: Bounds, { fit, offsets, lock, }: Pick<SetViewportOptions, "fit" | "lock"> & {
-    offsets?: Offsets;
-}) => Viewport & {
-    scrollConstraints: ScrollConstraints | null;
-};
-/**
- * Interpolates the viewport from `from` to `target` at the (already-eased)
- * blend amount `factor` (0 = `from`, 1 = `target`).
- *
- * Zoom is interpolated geometrically (so it feels uniform), but the pan can't
- * simply lerp alongside it: pairing a geometric zoom with a linear scroll (or
- * a linearly-tweened focal point) makes scene points swoop along curved,
- * non-monotone screen paths once the zoom ratio exceeds ~e (the destination
- * visibly drifts away before converging). Instead we interpolate the view
- * transform affinely — a scene point maps to screen as
- * `(scenePt + scroll) * zoom`, and requiring every point to travel a straight
- * screen line forces `zoom` to be a convex blend `(1-m)*z0 + m*z1` with
- * `scroll * zoom` lerped by that same weight. Deriving `m` from the geometric
- * zoom keeps its pacing while making all screen trajectories straight and
- * monotone.
- */
-export declare const interpolateViewport: ({ from, target, factor, }: {
-    from: Viewport;
-    target: Viewport;
-    factor: number;
-}) => Viewport;
 export declare const getClosestElementBounds: (elements: readonly ExcalidrawElement[], from: {
     x: number;
     y: number;

package/dist/types/laser-pointer/src/state.d.ts

@@ -6,6 +6,7 @@ export type SizeMappingDetails = {
     totalLength: number;
 };
 export type LaserPointerOptions = {
+    /** @default 2 */
     size: number;
     streamline: number;
     simplify: number;

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

@@ -2,6 +2,7 @@ export * from "./angle";
 export * from "./curve";
 export * from "./ellipse";
 export * from "./line";
+export * from "./pca";
 export * from "./point";
 export * from "./polygon";
 export * from "./range";

package/dist/types/math/src/pca.d.ts

@@ -0,0 +1,79 @@
+import type { GlobalPoint, LocalPoint, Vector } from "./types";
+/**
+ * The principal axes of a point set, i.e. the eigen decomposition of its
+ * 2x2 covariance matrix.
+ *
+ * The axes are orthonormal and ordered by variance, so `major` is the
+ * direction along which the points spread the most. Together with `centroid`
+ * they define a canonical frame: expressing the points in it removes
+ * translation and rotation, and dividing by `sqrt(majorVariance)` removes
+ * scale.
+ */
+export type PrincipalAxes<Point extends GlobalPoint | LocalPoint> = {
+    centroid: Point;
+    /** Unit vector along the direction of largest variance. */
+    major: Vector;
+    /** Unit vector along the direction of smallest variance, normal to major. */
+    minor: Vector;
+    /** Variance along `major` (the larger eigenvalue, λ₁). */
+    majorVariance: number;
+    /** Variance along `minor` (the smaller eigenvalue, λ₂). */
+    minorVariance: number;
+};
+/**
+ * A point expressed in a principal axes frame: `u` along the major axis,
+ * `v` along the minor axis, both relative to the centroid.
+ */
+export type PrincipalCoords = [u: number, v: number];
+/**
+ * Compute the centroid of a point set.
+ */
+export declare function centroid<Point extends GlobalPoint | LocalPoint>(points: readonly Point[]): Point;
+/**
+ * Principal component analysis of a 2D point set.
+ *
+ * Computes the centroid and the eigen decomposition of the covariance matrix
+ * [[μ20, μ11], [μ11, μ02]].
+ *
+ * @param points At least two points; fewer leaves the axes degenerate.
+ * @returns The centroid, the orthonormal axes and their variances.
+ */
+export declare function principalAxes<Point extends GlobalPoint | LocalPoint>(points: readonly Point[]): PrincipalAxes<Point>;
+/**
+ * Express points in the frame of the given principal axes, making the point
+ * cloud rotation, scale and translation invariant.
+ */
+export declare function principalCoords<Point extends GlobalPoint | LocalPoint>(points: readonly Point[], axes: PrincipalAxes<Point>, scale?: number): PrincipalCoords[];
+/**
+ * Flip the major axis so that it points toward the denser end of the point
+ * cloud, resolving the 180° sign ambiguity of the eigenvector.
+ *
+ * @returns The axes with `major`/`minor` flipped if needed. Variances are
+ * unchanged, as they are invariant to axis sign.
+ */
+export declare function orientPrincipalAxes<Point extends GlobalPoint | LocalPoint>(points: readonly Point[], axes: PrincipalAxes<Point>): PrincipalAxes<Point>;
+/**
+ * Ratio of the minor to the major variance in [0, 1]
+ *
+ * @returns 0 is a perfectly straight stroke, 1 is a stroke with no preferred
+ * direction.
+ */
+export declare function elongation<Point extends GlobalPoint | LocalPoint>(axes: PrincipalAxes<Point>): number;
+/**
+ * The `order`-th standardized moment of a sample in a rotation and scale
+ * invariant way (sandardizing by sigma).
+ *
+ * @returns 0 for a degenerate (zero variance) sample.
+ */
+export declare function standardizedMoment(values: readonly number[], order: number): number;
+/**
+ * Third standardized moment: how lopsided a sample is.
+ *
+ */
+export declare function skewness(values: readonly number[]): number;
+/**
+ * Fourth standardized moment: how the mass is split between the tails and the
+ * middle of a sample. Not excess kurtosis, a normal sample gives 3.
+ *
+ */
+export declare function kurtosis(values: readonly number[]): number;

package/dist/types/math/src/polygon.d.ts

@@ -3,4 +3,28 @@ export declare function polygon<Point extends GlobalPoint | LocalPoint>(...point
 export declare function polygonFromPoints<Point extends GlobalPoint | LocalPoint>(points: Point[]): Polygon<Point>;
 export declare const polygonIncludesPoint: <Point extends LocalPoint | GlobalPoint>(point: Point, polygon: Polygon<Point>) => boolean;
 export declare const polygonIncludesPointNonZero: <Point extends [number, number]>(point: Point, polygon: Point[]) => boolean;
-export declare const pointOnPolygon: <Point extends LocalPoint | GlobalPoint>(p: Point, poly: Polygon<Point>, threshold?: number) => boolean;
+export declare function polygonIsClosed<Point extends LocalPoint | GlobalPoint>(polygon: readonly Point[], tolerance?: number): boolean;
+/**
+ * The signed area of a polygon via the shoelace formula. Positive when the
+ * vertices wind counter-clockwise in a y-down coordinate system.
+ *
+ * The polygon may be given open or closed; a closing vertex is ignored.
+ */
+export declare function polygonSignedArea<Point extends LocalPoint | GlobalPoint>(polygon: readonly Point[]): number;
+export declare function polygonArea<Point extends LocalPoint | GlobalPoint>(polygon: readonly Point[]): number;
+/**
+ * The convex hull of a point set via Andrew's monotone chain.
+ *
+ * @returns The hull vertices in counter-clockwise order (y-down), without a
+ * repeated closing vertex.
+ */
+export declare function convexHull<Point extends LocalPoint | GlobalPoint>(points: readonly Point[]): Point[];
+/**
+ * Drop the points of a convex polygon that only contribute a shallow turn,
+ * merging each run of near-collinear points into one.
+ *
+ * @param polygon A convex polygon, as returned by `convexHull`.
+ * @param angleThreshold Minimum accumulated turn (radians) for a vertex to be
+ * kept.
+ */
+export declare function simplifyConvexPolygon<Point extends LocalPoint | GlobalPoint>(polygon: readonly Point[], angleThreshold: number): Point[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excalidraw/common",
-  "version": "0.18.0-063e025",
+  "version": "0.18.0-1acf66e",
   "type": "module",
   "types": "./dist/types/common/src/index.d.ts",
   "main": "./dist/prod/index.js",