@excalidraw/math 0.18.0-91c7748 → 0.18.0-a52cd20

package/dist/types/excalidraw/components/App.arrowText.d.ts

@@ -0,0 +1,70 @@
+import { LinearElementEditor } from "@excalidraw/element";
+import type { ArrowEndpoint } from "@excalidraw/element";
+import type { ExcalidrawElement, ExcalidrawTextElement, FixedPoint, NonDeleted, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
+import type App from "./App";
+import type { PointerDownState } from "../types";
+/**
+ * Text ↔ arrow interactions.
+ *
+ * With the text tool: the free endpoint a click would bind a new text to
+ * (`AppTextTool` resolves and shows it), the binding itself, and the
+ * endpoint-bound flavor of drag-sizing a new text.
+ *
+ * With the selection tool: dragging an arrow's existing label along the arrow
+ * — the grab affordance and the drag itself.
+ *
+ * The scene-level logic lives in `@excalidraw/element`'s
+ * `arrowEndpointText.ts` and `linearElementEditor.ts`.
+ */
+export declare class AppArrowText {
+    private app;
+    constructor(app: App);
+    /**
+     * A free arrow endpoint a new text could be bound to. Binding an endpoint is
+     * an arrow binding, so it follows the binding toggle (ctrl/cmd) like every
+     * other one — holding it makes the text tool drop plain text instead.
+     */
+    getBindableEndpointAtPosition(x: number, y: number): ArrowEndpoint | null;
+    /**
+     * How a text should be created to read as a label for this endpoint — the
+     * side midpoint to bind, the alignment that pins it, and the scene position
+     * it must sit at. `targetStrokeWidth` is the caller's to provide so it can
+     * guarantee it matches the stroke width the text is then created with — the
+     * binding gap derives from it (see `getTextBindingForArrowEndpoint`).
+     */
+    getTextBinding({ arrow, startOrEnd }: ArrowEndpoint, targetStrokeWidth: number): {
+        fixedPoint: FixedPoint;
+        textAlign: import("@excalidraw/element/types").TextAlign;
+        verticalAlign: import("@excalidraw/element/types").VerticalAlign;
+        anchor: import("@excalidraw/math").GlobalPoint;
+    } | null;
+    /**
+     * Binds the arrow endpoint to the created text, at the side midpoint the
+     * placement resolved (`getTextBinding`'s `fixedPoint`).
+     */
+    bindText({ arrow, startOrEnd }: ArrowEndpoint, text: NonDeleted<ExcalidrawTextElement>, fixedPoint: FixedPoint): void;
+    /**
+     * A text bound to an arrow endpoint can't be positioned by the drag — the
+     * binding already placed it — so only its width is dragged out. Returns
+     * whether it owned the drag.
+     */
+    maybeDragNewText(newElement: ExcalidrawElement, pointerCoords: {
+        x: number;
+        y: number;
+    }): boolean;
+    /**
+     * Whether the arrow's label is what a grab at this position would pick up:
+     * the pointer is over the label, and no element stacked above the arrow
+     * owns the hit instead.
+     */
+    isBoundTextGrabbable(element: NonDeletedExcalidrawElement, x: number, y: number): boolean;
+    /**
+     * The pointer-move half of dragging a label along its arrow. Owns the move
+     * whenever the gesture started on the label (`pointerDownState.hit.arrowLabel`),
+     * dragging only once past the threshold. Returns whether it owned it.
+     */
+    maybeDragLabel(linearElementEditor: LinearElementEditor, pointerDownState: PointerDownState, pointerCoords: {
+        x: number;
+        y: number;
+    }): boolean;
+}

package/dist/types/excalidraw/components/App.bucketFill.d.ts

@@ -0,0 +1,48 @@
+import type { Theme } from "@excalidraw/element/types";
+import type App from "./App";
+type ScenePoint = {
+    x: number;
+    y: number;
+};
+/** Owns bucket-fill interaction and App-bound scene mutations. */
+export declare class AppBucketFill {
+    private app;
+    constructor(app: App);
+    private temporaryEyeDropper;
+    /**
+     * The click armed on pointer down, committed on pointer up. Deferring the
+     * scene mutation to pointer up is what lets a pinch/pan second finger, a
+     * long-press context menu, or a pointercancel abort the fill — on pointer
+     * down the editor cannot yet know the gesture will stay a single-pointer
+     * click.
+     */
+    private pending;
+    /** Arm a fill at the pointer-down position; nothing mutates yet. */
+    handlePointerDown: (scenePointer: ScenePoint) => void;
+    /**
+     * Commit the armed fill, at the pointer-DOWN position (what the user
+     * aimed at). No-op when the gesture was aborted in the meantime.
+     */
+    handlePointerUp: () => void;
+    /** Abort the armed fill (second finger, context menu, pointercancel). */
+    cancel: () => void;
+    cycleBackgroundColor: () => void;
+    openTemporaryEyeDropper: () => void;
+    closeTemporaryEyeDropper: () => void;
+    /**
+     * Apply the current bucket fill settings to an existing fill-compatible
+     * element (no-op when nothing would change). One undoable step.
+     */
+    private restyle;
+    private fill;
+    /**
+     * The color the bucket fill tool actually fills with: the shared
+     * `currentItemBackgroundColor`, falling back to green when that is
+     * transparent (the tool's picker doesn't offer transparent, but the shared
+     * state can hold it from the generic shape picker).
+     */
+    getBucketFillBackgroundColor: (backgroundColor: string, 
+    /** supply only for display purposes such as when applying to the cursor */
+    theme?: Theme) => string;
+}
+export {};

package/dist/types/excalidraw/components/App.cursor.d.ts

@@ -0,0 +1,38 @@
+import type { AppState } from "../types";
+import type App from "./App";
+/**
+ * Captures all cursor management for the interactive canvas.
+ *
+ * The canvas cursor is set exclusively imperatively, through this class —
+ * never via inline styles or React-rendered `style.cursor`, which React
+ * would rewrite on rerender whenever the computed value changes, clobbering
+ * cursors set here.
+ */
+export declare class AppCursor {
+    private app;
+    private toolCursorMemo;
+    private eraserCanvasCache;
+    private eraserPreviewDataURL;
+    constructor(app: App);
+    private get canvas();
+    set: (cursor: string) => void;
+    /**
+     * Resets to the resting cursor — the cursor shown when no interaction or
+     * hover affordance overrides it: the view-mode grab cursor when
+     * drag-to-pan applies, the active tool's cursor otherwise.
+     */
+    reset: () => void;
+    /** applies the given tool's cursor (defaults to the active tool) */
+    applyForTool: (activeTool?: AppState["activeTool"]) => void;
+    /**
+     * Re-runs the hover cursor logic at the last known pointer position by
+     * re-dispatching a synthetic pointermove — for state changes that alter
+     * what hovering means without the pointer moving (e.g. the tool reverting
+     * to selection after an element is created). Mouse only: touch and pen
+     * have no resting hover to restore.
+     */
+    refreshHover: () => void;
+    /** clears the inline cursor so the environment default (CSS) applies */
+    private clear;
+    private applyEraser;
+}