@tldraw/editor 5.2.0-canary.083e81484bc9 → 5.2.0-canary.0878dbd31f0d

package/README.md

@@ -4,6 +4,12 @@ The core editor and composable parts for tldraw. [Click here](https://tldraw.dev
 
 You might be more interested in the general package [tldraw](https://github.com/tldraw/tldraw/tree/main/packages/tldraw) instead of using this package directly.
 
+## Documentation
+
+Documentation for the most recent release can be found on [tldraw.dev/docs](https://tldraw.dev/docs), including [reference docs](https://tldraw.dev/reference/editor/Editor). Our release notes can be found [here](https://tldraw.dev/releases).
+
+For more agent-friendly docs, see our [LLMs.txt](https://tldraw.dev/llms.txt).
+
 ## License
 
 This project is part of the tldraw SDK. It is provided under the [tldraw SDK license](https://github.com/tldraw/tldraw/blob/main/LICENSE.md).

package/dist-cjs/index.d.ts

@@ -89,6 +89,7 @@ import { TLUnknownAsset } from '@tldraw/tlschema';
 import { TLUnknownBinding } from '@tldraw/tlschema';
 import { TLUnknownShape } from '@tldraw/tlschema';
 import { TLUser } from '@tldraw/tlschema';
+import { TLUserId } from '@tldraw/tlschema';
 import { TLUserStore } from '@tldraw/tlschema';
 import { TLVideoAsset } from '@tldraw/tlschema';
 import { UnknownRecord } from '@tldraw/store';
@@ -2456,7 +2457,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @param opts - The camera move options.
      * @public
      */
-    zoomToUser(userId: string, opts?: TLCameraMoveOptions): this;
+    zoomToUser(userId: TLUserId, opts?: TLCameraMoveOptions): this;
     /* Excluded from this release type: _willSetInitialBounds */
     /**
      * Update the viewport. The viewport will measure the size and screen position of its container
@@ -2609,7 +2610,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    startFollowingUser(userId: string): this;
+    startFollowingUser(userId: TLUserId): this;
     /**
      * Stop viewport-following a user.
      *
@@ -9617,13 +9618,13 @@ export declare function usePassThroughWheelEvents(ref: RefObject<HTMLElement | n
  * @returns The list of peer UserIDs
  * @public
  */
-export declare function usePeerIds(): string[];
+export declare function usePeerIds(): TLUserId[];
 
 /**
  * @returns The latest presence of the user matching userId
  * @public
  */
-export declare function usePresence(userId: string): null | TLInstancePresence;
+export declare function usePresence(userId: TLUserId): null | TLInstancePresence;
 
 /* Excluded from this release type: USER_COLORS */
 
@@ -9663,7 +9664,25 @@ export declare class UserPreferencesManager {
     getEdgeScrollSpeed(): number;
     getAnimationSpeed(): number;
     getAreKeyboardShortcutsEnabled(): boolean;
+    /**
+     * The current user's raw, app-provided id — the value set in the user's
+     * {@link @tldraw/editor#TLUserPreferences}. Use this when you need the id your application
+     * assigned to the user. To compare against or look up store records, use
+     * {@link UserPreferencesManager.getRecordId} instead.
+     */
+    getExternalId(): string;
+    /**
+     * @deprecated Use {@link UserPreferencesManager.getExternalId} for the raw app-provided id, or
+     * {@link UserPreferencesManager.getRecordId} for the prefixed `TLUserId` record id.
+     */
     getId(): string;
+    /**
+     * The current user's id as a tldraw {@link @tldraw/tlschema#TLUserId} record id (prefixed
+     * with `user:`). Use this when comparing against or looking up store records, such as a
+     * presence record's `userId` or `followingUserId`. For the raw, app-provided id, use
+     * {@link UserPreferencesManager.getExternalId}.
+     */
+    getRecordId(): TLUserId;
     getName(): string;
     getLocale(): string;
     getColor(): string;

package/dist-cjs/index.js

@@ -379,7 +379,7 @@ var import_uniq = require("./lib/utils/uniq");
 var import_defaultThemes2 = require("./lib/editor/managers/ThemeManager/defaultThemes");
 (0, import_utils.registerTldrawLibraryVersion)(
   "@tldraw/editor",
-  "5.2.0-canary.083e81484bc9",
+  "5.2.0-canary.0878dbd31f0d",
   "cjs"
 );
 //# sourceMappingURL=index.js.map

package/dist-cjs/lib/editor/Editor.js

@@ -2152,7 +2152,7 @@ class Editor extends import_eventemitter3.default {
     return baseCamera;
   }
   _getFollowingPresence(targetUserId) {
-    const visited = [this.user.getId()];
+    const visited = [this.user.getRecordId()];
     const collaborators = this.getCollaborators();
     let leaderPresence = null;
     while (targetUserId && !visited.includes(targetUserId)) {
@@ -3200,7 +3200,7 @@ class Editor extends import_eventemitter3.default {
    */
   startFollowingUser(userId) {
     this.stopFollowingUser();
-    const thisUserId = this.user.getId();
+    const thisUserId = this.user.getExternalId();
     if (!thisUserId) {
       console.warn("You should set the userId for the current instance before following a user");
     }
@@ -8137,7 +8137,10 @@ class Editor extends import_eventemitter3.default {
             inputs.buttons.add(info.button);
             inputs.setIsPointing(true);
             inputs.setIsDragging(false);
-            if (!isPenMode && isPen) this.updateInstanceState({ isPenMode: true });
+            if (!isPenMode && isPen) {
+              this.updateInstanceState({ isPenMode: true });
+              this.interrupt();
+            }
             if (info.button === import_constants.STYLUS_ERASER_BUTTON) {
               this._restoreToolId = this.getCurrentToolId();
               this.complete();
@@ -8240,7 +8243,10 @@ class Editor extends import_eventemitter3.default {
                     this.setCursor({ type: this._prevCursor, rotation: 0 });
                   }
                   if (slideSpeed > 0) {
-                    this.slideCamera({ speed: slideSpeed, direction: slideDirection });
+                    this.slideCamera({
+                      speed: slideSpeed,
+                      direction: { x: slideDirection.x, y: slideDirection.y, z: 0 }
+                    });
                   }
                   this._selectedShapeIdsAtPointerDown = [];
                   this._didCaptureSelectionAtPointerDown = false;