@tldraw/editor 3.9.0-internal.7f0e15f4f7d9 → 3.10.0-canary.d4dfa96478a4

package/dist-esm/index.d.mts

@@ -7,8 +7,6 @@ import { ComponentType } from 'react';
 import { Computed } from '@tldraw/state';
 import { computed } from '@tldraw/state';
 import { Dispatch } from 'react';
-import { Editor as Editor_2 } from '@tiptap/core';
-import { EditorProviderProps } from '@tiptap/react';
 import { EffectScheduler } from '@tldraw/state';
 import { EMPTY_ARRAY } from '@tldraw/state';
 import EventEmitter from 'eventemitter3';
@@ -20,7 +18,6 @@ import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { LegacyMigrations } from '@tldraw/store';
 import { MigrationSequence } from '@tldraw/store';
 import { NamedExoticComponent } from 'react';
-import { Node as Node_2 } from '@tiptap/pm/model';
 import { PerformanceTracker } from '@tldraw/utils';
 import { PointerEventHandler } from 'react';
 import { react } from '@tldraw/state';
@@ -69,7 +66,6 @@ import { TLPageId } from '@tldraw/tlschema';
 import { TLParentId } from '@tldraw/tlschema';
 import { TLPropsMigrations } from '@tldraw/tlschema';
 import { TLRecord } from '@tldraw/tlschema';
-import { TLRichText } from '@tldraw/tlschema';
 import { TLScribble } from '@tldraw/tlschema';
 import { TLShape } from '@tldraw/tlschema';
 import { TLShapeCrop } from '@tldraw/tlschema';
@@ -888,7 +884,6 @@ export declare const defaultTldrawOptions: {
     readonly longPressDurationMs: 500;
     readonly maxExportDelayMs: 5000;
     readonly maxFilesAtOnce: 100;
-    readonly maxFontsToLoadBeforeRender: number;
     readonly maxPages: 40;
     readonly maxShapesPerPage: 4000;
     readonly multiClickDurationMs: 200;
@@ -984,7 +979,7 @@ export declare class EdgeScrollManager {
 
 /** @public */
 export declare class Editor extends EventEmitter<TLEventMap> {
-    constructor({ store, user, shapeUtils, bindingUtils, tools, getContainer, cameraOptions, textOptions, initialState, autoFocus, inferDarkMode, options, isShapeHidden, fontAssetUrls, }: TLEditorOptions);
+    constructor({ store, user, shapeUtils, bindingUtils, tools, getContainer, cameraOptions, initialState, autoFocus, inferDarkMode, options, isShapeHidden, }: TLEditorOptions);
     private readonly _isShapeHiddenPredicate?;
     private getIsShapeHiddenCache;
     isShapeHidden(shapeOrId: TLShape | TLShapeId): boolean;
@@ -1045,12 +1040,6 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     readonly textMeasure: TextManager;
-    /**
-     * A utility for managing the set of fonts that should be rendered in the document.
-     *
-     * @public
-     */
-    readonly fonts: FontManager;
     /**
      * A manager for the editor's environment.
      *
@@ -1690,26 +1679,6 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     setEditingShape(shape: null | TLShape | TLShapeId): this;
-    private _currentRichTextEditor;
-    /**
-     * The current editing shape's text editor.
-     *
-     * @public
-     */
-    getRichTextEditor(): null | TiptapEditor;
-    /**
-     * Set the current editing shape's rich text editor.
-     *
-     * @example
-     * ```ts
-     * editor.setRichTextEditor(richTextEditorView)
-     * ```
-     *
-     * @param textEditor - The text editor to set as the current editing shape's text editor.
-     *
-     * @public
-     */
-    setRichTextEditor(textEditor: null | TiptapEditor): this;
     /**
      * The current hovered shape id.
      *
@@ -1810,17 +1779,6 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     setCroppingShape(shape: null | TLShape | TLShapeId): this;
-    private _textOptions;
-    /**
-     * Get the current text options.
-     *
-     * @example
-     * ```ts
-     * editor.getTextOptions()
-     * ```
-     *
-     *  @public */
-    getTextOptions(): TLTextOptions;
     /* Excluded from this release type: _unsafe_getCameraId */
     /**
      * The current camera.
@@ -2418,7 +2376,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
         meta?: JsonObject;
         src: string;
     }>;
-    private _getShapeGeometryCache;
+    private _shapeGeometryCaches;
     /**
      * Get the geometry of a shape.
      *
@@ -2426,13 +2384,15 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * ```ts
      * editor.getShapeGeometry(myShape)
      * editor.getShapeGeometry(myShapeId)
+     * editor.getShapeGeometry(myShapeId, { context: "arrow" })
      * ```
      *
      * @param shape - The shape (or shape id) to get the geometry for.
+     * @param opts - Additional options about the request for geometry. Passed to {@link ShapeUtil.getGeometry}.
      *
      * @public
      */
-    getShapeGeometry<T extends Geometry2d>(shape: TLShape | TLShapeId): T;
+    getShapeGeometry<T extends Geometry2d>(shape: TLShape | TLShapeId, opts?: TLGeometryOpts): T;
     /* Excluded from this release type: _getShapeHandlesCache */
     /**
      * Get the handles (if any) for a shape.
@@ -3100,6 +3060,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     bringToFront(shapes: TLShape[] | TLShapeId[]): this;
+    /* Excluded from this release type: collectShapesViaArrowBindings */
     /**
      * Flip shape positions.
      *
@@ -3225,7 +3186,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @example
      * ```ts
      * editor.createShape(myShape)
-     * editor.createShape({ id: 'box1', type: 'text', props: { richText: toRichText("ok") } })
+     * editor.createShape({ id: 'box1', type: 'text', props: { text: "ok" } })
      * ```
      *
      * @param shape - The shape (or shape partial) to create.
@@ -3239,7 +3200,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @example
      * ```ts
      * editor.createShapes([myShape])
-     * editor.createShapes([{ id: 'box1', type: 'text', props: { richText: toRichText("ok") } }])
+     * editor.createShapes([{ id: 'box1', type: 'text', props: { text: "ok" } }])
      * ```
      *
      * @param shapes - The shapes (or shape partials) to create.
@@ -3998,27 +3959,6 @@ export declare const EVENT_NAME_MAP: Record<Exclude<TLEventName, TLPinchEventNam
 
 /* Excluded from this release type: featureFlags */
 
-/** @public */
-export declare class FontManager {
-    private readonly editor;
-    private readonly assetUrls?;
-    constructor(editor: Editor, assetUrls?: {
-        [key: string]: string | undefined;
-    } | undefined);
-    private readonly shapeFontFacesCache;
-    private readonly shapeFontLoadStateCache;
-    getShapeFontFaces(shape: TLShape | TLShapeId): TLFontFace[];
-    trackFontsForShape(shape: TLShape | TLShapeId): void;
-    loadRequiredFontsForCurrentPage(limit?: number): Promise<void>;
-    private readonly fontStates;
-    private getFontState;
-    ensureFontIsLoaded(font: TLFontFace): Promise<void>;
-    private fontsToLoad;
-    requestFonts(fonts: TLFontFace[]): void;
-    private findOrCreateFontFace;
-    toEmbeddedCssDeclaration(font: TLFontFace): Promise<string>;
-}
-
 /** @public */
 export declare interface GapsSnapIndicator {
     id: string;
@@ -4091,9 +4031,6 @@ export declare function getCursor(cursor: TLCursorType, rotation?: number, color
 /** @public */
 export declare function getDefaultCdnBaseUrl(): string;
 
-/** @public */
-export declare function getFontsFromRichText(editor: Editor, richText: TLRichText, initialState: RichTextFontVisitorState): TLFontFace[];
-
 /** @public */
 export declare function getFreshUserPreferences(): TLUserPreferences;
 
@@ -4778,16 +4715,6 @@ export declare function resizeScaled(shape: TLBaseShape<any, {
     y: number;
 };
 
-/** @public */
-export declare type RichTextFontVisitor = (node: TiptapNode, state: RichTextFontVisitorState, addFont: (font: TLFontFace) => void) => RichTextFontVisitorState;
-
-/** @public */
-export declare interface RichTextFontVisitorState {
-    readonly family: string;
-    readonly weight: string;
-    readonly style: string;
-}
-
 /** @public */
 export declare const ROTATE_CORNER_TO_SELECTION_CORNER: {
     readonly bottom_left_rotate: "bottom_left";
@@ -4952,9 +4879,10 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      * Get the shape's geometry.
      *
      * @param shape - The shape.
+     * @param opts - Additional options for the request.
      * @public
      */
-    abstract getGeometry(shape: Shape): Geometry2d;
+    abstract getGeometry(shape: Shape, opts?: TLGeometryOpts): Geometry2d;
     /**
      * Get a JSX element for the shape (as an HTML element).
      *
@@ -4969,17 +4897,10 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      * @public
      */
     abstract indicator(shape: Shape): any;
-    /**
-     * Get the font faces that should be rendered in the document in order for this shape to render
-     * correctly.
-     *
-     * @param shape - The shape.
-     * @public
-     */
-    getFontFaces(shape: Shape): TLFontFace[];
     /**
      * Whether the shape can be snapped to by another shape.
      *
+     * @param shape - The shape.
      * @public
      */
     canSnap(_shape: Shape): boolean;
@@ -4994,7 +4915,7 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      *
      * @public
      */
-    canBind(_opts: TLShapeUtilCanBindOpts<Shape>): boolean;
+    canBind(_opts: TLShapeUtilCanBindOpts): boolean;
     /**
      * Whether the shape can be double clicked to edit.
      *
@@ -5020,11 +4941,15 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      */
     canCrop(_shape: Shape): boolean;
     /**
-     * Whether the shape participates in stacking, aligning, and distributing.
+     * Whether the shape can participate in layout functions such as alignment or distribution.
+     *
+     * @param shape - The shape.
+     * @param info - Additional context information: the type of action causing the layout and the
+     * @public
      *
      * @public
      */
-    canBeLaidOut(_shape: Shape): boolean;
+    canBeLaidOut(_shape: Shape, _info: TLShapeUtilCanBeLaidOutOpts): boolean;
     /* Excluded from this release type: providesBackgroundForChildren */
     /**
      * Whether the shape should hide its resize handles when selected.
@@ -5629,24 +5554,6 @@ export declare class TextManager {
     }): BoxModel & {
         scrollWidth: number;
     };
-    measureHtml(html: string, opts: {
-        /**
-         * When maxWidth is a number, the text will be wrapped to that maxWidth. When maxWidth
-         * is null, the text will be measured without wrapping, but explicit line breaks and
-         * space are preserved.
-         */
-        maxWidth: null | number;
-        disableOverflowWrapBreaking?: boolean;
-        fontFamily: string;
-        fontSize: number;
-        fontStyle: string;
-        fontWeight: string;
-        lineHeight: number;
-        minWidth?: null | number;
-        padding: string;
-    }): BoxModel & {
-        scrollWidth: number;
-    };
     /**
      * Given an html element, measure the position of each span of unbroken
      * word/white-space characters within any text nodes it contains.
@@ -5674,19 +5581,6 @@ export declare class TextManager {
     }[];
 }
 
-/**
- * This is the TipTap editor! Docs are {@link https://tiptap.dev/docs}.
- *
- * @public
- */
-export declare type TiptapEditor = Editor_2;
-
-/**
- * A TipTap node. See {@link https://tiptap.dev/docs}.
- * @public
- */
-export declare type TiptapNode = Node_2;
-
 /** @public */
 export declare type TLAnyBindingUtilConstructor = TLBindingUtilConstructor<any>;
 
@@ -5727,6 +5621,7 @@ export declare interface TLBindingUtilConstructor<T extends TLUnknownBinding, U
 
 /** @public */
 export declare interface TLBrushProps {
+    userId?: string;
     brush: BoxModel;
     color?: string;
     opacity?: number;
@@ -5854,6 +5749,7 @@ export declare type TLClickState = 'idle' | 'overflow' | 'pendingDouble' | 'pend
 
 /** @public */
 export declare interface TLCollaboratorHintProps {
+    userId: string;
     className?: string;
     point: VecModel;
     viewport: Box;
@@ -5900,6 +5796,7 @@ export declare interface TLCropInfo<T extends TLShape> {
 
 /** @public */
 export declare interface TLCursorProps {
+    userId: string;
     className?: string;
     point: null | VecModel;
     zoom: number;
@@ -6010,10 +5907,6 @@ export declare interface TldrawEditorBaseProps {
      * Camera options for the editor.
      */
     cameraOptions?: Partial<TLCameraOptions>;
-    /**
-     * Text options for the editor.
-     */
-    textOptions?: TLTextOptions;
     /**
      * Options for the editor.
      */
@@ -6034,14 +5927,6 @@ export declare interface TldrawEditorBaseProps {
      * remain in the store and participate in all other operations.
      */
     isShapeHidden?(shape: TLShape, editor: Editor): boolean;
-    /**
-     * The URLs for the fonts to use in the editor.
-     */
-    assetUrls?: {
-        fonts?: {
-            [key: string]: string | undefined;
-        };
-    };
 }
 
 /**
@@ -6165,12 +6050,6 @@ export declare interface TldrawOptions {
      * By default, the toolbar items are accessible via number shortcuts according to their order. To disable this, set this option to false.
      */
     readonly enableToolbarKeyboardShortcuts: boolean;
-    /**
-     * The maximum number of fonts that will be loaded while blocking the main rendering of the
-     * canvas. If there are more than this number of fonts needed, we'll just show the canvas right
-     * away and let the fonts load in in the background.
-     */
-    readonly maxFontsToLoadBeforeRender: number;
 }
 
 /** @public */
@@ -6248,12 +6127,8 @@ export declare interface TLEditorOptions {
      * Options for the editor's camera.
      */
     cameraOptions?: Partial<TLCameraOptions>;
-    textOptions?: TLTextOptions;
     options?: Partial<TldrawOptions>;
     licenseKey?: string;
-    fontAssetUrls?: {
-        [key: string]: string | undefined;
-    };
     /**
      * A predicate that should return true if the given shape should be hidden.
      * @param shape - The shape to check.
@@ -6368,13 +6243,6 @@ export declare interface TLEventMap {
     'select-all-text': [{
         shapeId: TLShapeId;
     }];
-    'place-caret': [{
-        point: {
-            x: number;
-            y: number;
-        };
-        shapeId: TLShapeId;
-    }];
 }
 
 /** @public */
@@ -6424,70 +6292,13 @@ export declare interface TLFilesExternalContent extends TLBaseExternalContent {
     ignoreParent: boolean;
 }
 
-/**
- * A font face that can be used in the editor. The properties of this are largely the same as the
- * ones in the
- * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face | css `@font-face` rule}.
- * @public
- */
-export declare interface TLFontFace {
-    /**
-     * How this font can be referred to in CSS.
-     * See {@link https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-family | `font-family`}.
-     */
-    readonly family: string;
-    /**
-     * The source of the font. This
-     * See {@link https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/src | `src`}.
-     */
-    readonly src: TLFontFaceSource;
-    /**
-     * See {@link https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/ascent-override | `ascent-override`}.
-     */
-    readonly ascentOverride?: string;
-    /**
-     * See {@link https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/descent-override | `descent-override`}.
-     */
-    readonly descentOverride?: string;
-    /**
-     * See {@link https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-stretch | `font-stretch`}.
-     */
-    readonly stretch?: string;
-    /**
-     * See {@link https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-style | `font-style`}.
-     */
-    readonly style?: string;
-    /**
-     * See {@link https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-weight | `font-weight`}.
-     */
-    readonly weight?: string;
-    /**
-     * See {@link https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-feature-settings | `font-feature-settings`}.
-     */
-    readonly featureSettings?: string;
-    /**
-     * See {@link https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/line-gap-override | `line-gap-override`}.
-     */
-    readonly lineGapOverride?: string;
-    /**
-     * See {@link https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/unicode-range | `unicode-range`}.
-     */
-    readonly unicodeRange?: string;
-}
-
-/**
- * Represents the `src` property of a {@link TLFontFace}.
- * See {@link https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/src | `src`} for details of the properties here.
+/** Additional options for the {@link ShapeUtil.getGeometry} method.
+ *
  * @public
  */
-export declare interface TLFontFaceSource {
-    /**
-     * A URL from which to load the font. If the value here is a key in
-     * {@link tldraw#TLEditorAssetUrls.fonts}, the value from there will be used instead.
-     */
-    url: string;
-    format?: string;
-    tech?: string;
+export declare interface TLGeometryOpts {
+    /** The context in which the geometry is being requested. */
+    context?: string;
 }
 
 /** @public */
@@ -6888,6 +6699,7 @@ export declare type TLResizeShapeOptions = Partial<{
 
 /** @public */
 export declare interface TLScribbleProps {
+    userId?: string;
     scribble: TLScribble;
     zoom: number;
     color?: string;
@@ -6947,6 +6759,7 @@ export declare type TLShapeIndicatorErrorFallbackComponent = ComponentType<{
 
 /** @public */
 export declare interface TLShapeIndicatorProps {
+    userId?: string;
     shapeId: TLShapeId;
     color?: string | undefined;
     opacity?: number;
@@ -6954,13 +6767,25 @@ export declare interface TLShapeIndicatorProps {
     hidden?: boolean;
 }
 
+/**
+ * Options passed to {@link ShapeUtil.canBeLaidOut}.
+ *
+ * @public
+ */
+export declare interface TLShapeUtilCanBeLaidOutOpts {
+    /** The type of action causing the layout. */
+    type?: 'align' | 'distribute' | 'flip' | 'pack' | 'stack' | 'stretch';
+    /** The other shapes being laid out */
+    shapes?: TLShape[];
+}
+
 /**
  * Options passed to {@link ShapeUtil.canBind}. A binding that could be made. At least one of
  * `fromShapeType` or `toShapeType` will belong to this shape util.
  *
  * @public
  */
-export declare interface TLShapeUtilCanBindOpts<Shape extends TLUnknownShape = TLShape> {
+export declare interface TLShapeUtilCanBindOpts<Shape extends TLUnknownShape = TLUnknownShape> {
     /** The type of shape referenced by the `fromId` of the binding. */
     fromShapeType: string;
     /** The type of shape referenced by the `toId` of the binding. */
@@ -7119,7 +6944,6 @@ export declare interface TLSvgTextExternalContent extends TLBaseExternalContent
 export declare interface TLTextExternalContent extends TLBaseExternalContent {
     type: 'text';
     text: string;
-    html?: string;
 }
 
 /** @public */
@@ -7129,12 +6953,6 @@ export declare interface TLTextExternalContentSource {
     subtype: 'html' | 'json' | 'text' | 'url';
 }
 
-/** @public */
-export declare interface TLTextOptions {
-    tipTapConfig?: EditorProviderProps;
-    addFontsFromNode?: RichTextFontVisitor;
-}
-
 /** @public */
 export declare type TLTickEvent = (info: TLTickEventInfo) => void;
 
@@ -7306,9 +7124,6 @@ export declare function useMaybeEditor(): Editor | null;
 
 /* Excluded from this release type: useOnMount */
 
-/** @public */
-export declare function usePassThroughMouseOverEvents(ref: RefObject<HTMLElement>): void;
-
 /** @public */
 export declare function usePassThroughWheelEvents(ref: RefObject<HTMLElement>): void;
 
@@ -7420,9 +7235,6 @@ export declare function useUniqueSafeId(suffix?: string): SafeId;
 
 export { useValue }
 
-/** @public */
-export declare function useViewportHeight(): number;
-
 /* Excluded from this release type: ValidLicenseKeyResult */
 
 /** @public */

package/dist-esm/index.mjs

@@ -24,9 +24,6 @@ import {
   useValue
 } from "@tldraw/state-react";
 import { resizeScaled } from "./lib/editor/shapes/shared/resizeScaled.mjs";
-import {
-  getFontsFromRichText
-} from "./lib/utils/richText.mjs";
 import { LocalIndexedDb, Table } from "./lib/utils/sync/LocalIndexedDb.mjs";
 export * from "@tldraw/store";
 export * from "@tldraw/tlschema";
@@ -118,9 +115,6 @@ import {
 } from "./lib/editor/bindings/BindingUtil.mjs";
 import { ClickManager } from "./lib/editor/managers/ClickManager.mjs";
 import { EdgeScrollManager } from "./lib/editor/managers/EdgeScrollManager.mjs";
-import {
-  FontManager
-} from "./lib/editor/managers/FontManager.mjs";
 import { HistoryManager } from "./lib/editor/managers/HistoryManager.mjs";
 import { ScribbleManager } from "./lib/editor/managers/ScribbleManager.mjs";
 import {
@@ -168,7 +162,6 @@ import { useIsCropping } from "./lib/hooks/useIsCropping.mjs";
 import { useIsDarkMode } from "./lib/hooks/useIsDarkMode.mjs";
 import { useIsEditing } from "./lib/hooks/useIsEditing.mjs";
 import { useLocalStore } from "./lib/hooks/useLocalStore.mjs";
-import { usePassThroughMouseOverEvents } from "./lib/hooks/usePassThroughMouseOverEvents.mjs";
 import { usePassThroughWheelEvents } from "./lib/hooks/usePassThroughWheelEvents.mjs";
 import { usePeerIds } from "./lib/hooks/usePeerIds.mjs";
 import { usePresence } from "./lib/hooks/usePresence.mjs";
@@ -182,7 +175,6 @@ import {
 import { useSelectionEvents } from "./lib/hooks/useSelectionEvents.mjs";
 import { useTLSchemaFromUtils, useTLStore } from "./lib/hooks/useTLStore.mjs";
 import { useTransform } from "./lib/hooks/useTransform.mjs";
-import { useViewportHeight } from "./lib/hooks/useViewportHeight.mjs";
 import {
   LicenseManager
 } from "./lib/license/LicenseManager.mjs";
@@ -297,7 +289,7 @@ function debugEnableLicensing() {
 }
 registerTldrawLibraryVersion(
   "@tldraw/editor",
-  "3.9.0-internal.7f0e15f4f7d9",
+  "3.10.0-canary.d4dfa96478a4",
   "esm"
 );
 export {
@@ -342,7 +334,6 @@ export {
   Ellipse2d,
   ErrorBoundary,
   ErrorScreen,
-  FontManager,
   Geometry2d,
   Group2d,
   GroupShapeUtil,
@@ -412,7 +403,6 @@ export {
   getArcMeasure,
   getCursor,
   getDefaultCdnBaseUrl,
-  getFontsFromRichText,
   getFreshUserPreferences,
   getIncrementedName,
   getPerfectDashProps,
@@ -496,7 +486,6 @@ export {
   useLocalStore,
   useMaybeEditor,
   useOnMount,
-  usePassThroughMouseOverEvents,
   usePassThroughWheelEvents,
   usePeerIds,
   usePresence,
@@ -516,7 +505,6 @@ export {
   useTransform,
   useUniqueSafeId,
   useValue,
-  useViewportHeight,
   userTypeValidator,
   whyAmIRunning
 };