@tldraw/editor 4.3.0-canary.fd6b7f2a8adc → 4.3.0-next.2b3bfbba757b

package/dist-cjs/index.d.ts

@@ -7,7 +7,6 @@ import { Editor as Editor_2 } from '@tiptap/core';
 import { EditorProviderProps as EditorProviderProps_2 } from '@tiptap/react';
 import EventEmitter from 'eventemitter3';
 import { ExoticComponent } from 'react';
-import { ExtractShapeByProps } from '@tldraw/tlschema';
 import { ForwardRefExoticComponent } from 'react';
 import { HistoryEntry } from '@tldraw/store';
 import { IndexKey } from '@tldraw/utils';
@@ -49,7 +48,6 @@ import { TLBindingId } from '@tldraw/tlschema';
 import { TLBindingUpdate } from '@tldraw/tlschema';
 import { TLBookmarkAsset } from '@tldraw/tlschema';
 import { TLCamera } from '@tldraw/tlschema';
-import { TLCreateShapePartial } from '@tldraw/tlschema';
 import { TLCursor } from '@tldraw/tlschema';
 import { TLCursorType } from '@tldraw/tlschema';
 import { TLDefaultDashStyle } from '@tldraw/tlschema';
@@ -149,7 +147,7 @@ export declare abstract class BaseBoxShapeTool extends StateNode {
     static id: string;
     static initial: string;
     static children(): TLStateNodeConstructor[];
-    abstract shapeType: TLBaseBoxShape['type'];
+    abstract shapeType: string;
     onCreate?(_shape: null | TLShape): null | void;
 }
 
@@ -167,7 +165,7 @@ export declare abstract class BaseBoxShapeUtil<Shape extends TLBaseBoxShape> ext
  *
  * @public
  */
-export declare interface BindingOnChangeOptions<Binding extends TLBinding = TLBinding> {
+export declare interface BindingOnChangeOptions<Binding extends TLUnknownBinding> {
     /** The binding record before the change is made. */
     bindingBefore: Binding;
     /** The binding record after the change is made. */
@@ -180,7 +178,7 @@ export declare interface BindingOnChangeOptions<Binding extends TLBinding = TLBi
  *
  * @public
  */
-export declare interface BindingOnCreateOptions<Binding extends TLBinding = TLBinding> {
+export declare interface BindingOnCreateOptions<Binding extends TLUnknownBinding> {
     /** The binding being created. */
     binding: Binding;
 }
@@ -191,7 +189,7 @@ export declare interface BindingOnCreateOptions<Binding extends TLBinding = TLBi
  *
  * @public
  */
-export declare interface BindingOnDeleteOptions<Binding extends TLBinding = TLBinding> {
+export declare interface BindingOnDeleteOptions<Binding extends TLUnknownBinding> {
     /** The binding being deleted. */
     binding: Binding;
 }
@@ -202,7 +200,7 @@ export declare interface BindingOnDeleteOptions<Binding extends TLBinding = TLBi
  *
  * @public
  */
-export declare interface BindingOnShapeChangeOptions<Binding extends TLBinding = TLBinding> {
+export declare interface BindingOnShapeChangeOptions<Binding extends TLUnknownBinding> {
     /** The binding record linking these two shapes. */
     binding: Binding;
     /** The shape record before the change is made. */
@@ -226,7 +224,7 @@ export declare interface BindingOnShapeChangeOptions<Binding extends TLBinding =
  *
  * @public
  */
-export declare interface BindingOnShapeDeleteOptions<Binding extends TLBinding = TLBinding> {
+export declare interface BindingOnShapeDeleteOptions<Binding extends TLUnknownBinding> {
     /** The binding record that refers to the shape in question. */
     binding: Binding;
     /** The shape that is about to be deleted. */
@@ -258,7 +256,7 @@ export declare interface BindingOnShapeDeleteOptions<Binding extends TLBinding =
  *
  * @public
  */
-export declare interface BindingOnShapeIsolateOptions<Binding extends TLBinding = TLBinding> {
+export declare interface BindingOnShapeIsolateOptions<Binding extends TLUnknownBinding> {
     /** The binding record that refers to the shape in question. */
     binding: Binding;
     /**
@@ -269,7 +267,7 @@ export declare interface BindingOnShapeIsolateOptions<Binding extends TLBinding
 }
 
 /** @public */
-export declare abstract class BindingUtil<Binding extends TLBinding = TLBinding> {
+export declare abstract class BindingUtil<Binding extends TLUnknownBinding = TLUnknownBinding> {
     editor: Editor;
     constructor(editor: Editor);
     static props?: RecordProps<TLUnknownBinding>;
@@ -1131,7 +1129,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     shapeUtils: {
-        readonly [K in string]?: ShapeUtil<TLShape>;
+        readonly [K in string]?: ShapeUtil<TLUnknownShape>;
     };
     styleProps: {
         [key: string]: Map<StyleProp<any>, string>;
@@ -1151,18 +1149,16 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    getShapeUtil<K extends TLShape['type']>(type: K): ShapeUtil<Extract<TLShape, {
-        type: K;
-    }>>;
-    getShapeUtil<S extends TLShape>(shape: S | S['type'] | TLShapePartial<S>): ShapeUtil<S>;
+    getShapeUtil<S extends TLUnknownShape>(shape: S | TLShapePartial<S>): ShapeUtil<S>;
+    getShapeUtil<S extends TLUnknownShape>(type: S['type']): ShapeUtil<S>;
     getShapeUtil<T extends ShapeUtil>(type: T extends ShapeUtil<infer R> ? R['type'] : string): T;
     /**
      * Returns true if the editor has a shape util for the given shape / shape type.
      *
      * @param shape - A shape, shape partial, or shape type.
      */
-    hasShapeUtil(shape: TLShape | TLShapePartial<TLShape>): boolean;
-    hasShapeUtil(type: TLShape['type']): boolean;
+    hasShapeUtil<S extends TLUnknownShape>(shape: S | TLShapePartial<S>): boolean;
+    hasShapeUtil<S extends TLUnknownShape>(type: S['type']): boolean;
     hasShapeUtil<T extends ShapeUtil>(type: T extends ShapeUtil<infer R> ? R['type'] : string): boolean;
     /**
      * A map of shape utility classes (TLShapeUtils) by shape type.
@@ -1170,7 +1166,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     bindingUtils: {
-        readonly [K in string]?: BindingUtil<TLBinding>;
+        readonly [K in string]?: BindingUtil<TLUnknownBinding>;
     };
     /**
      * Get a binding util from a binding itself.
@@ -1187,12 +1183,10 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    getBindingUtil<K extends TLBinding['type']>(type: K): BindingUtil<Extract<TLBinding, {
-        type: K;
-    }>>;
-    getBindingUtil<S extends TLBinding>(binding: {
+    getBindingUtil<S extends TLUnknownBinding>(binding: {
         type: S['type'];
     } | S): BindingUtil<S>;
+    getBindingUtil<S extends TLUnknownBinding>(type: S['type']): BindingUtil<S>;
     getBindingUtil<T extends BindingUtil>(type: T extends BindingUtil<infer R> ? R['type'] : string): T;
     /**
      * A manager for the app's history.
@@ -2771,7 +2765,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @example
      * ```ts
-     * const isArrowShape = isShapeOfType(someShape, 'arrow')
+     * const isArrowShape = isShapeOfType<TLArrowShape>(someShape, 'arrow')
      * ```
      *
      * @param util - the TLShapeUtil constructor to test against
@@ -2779,13 +2773,8 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    isShapeOfType<K extends TLShape['type']>(shape: TLShape, type: K): shape is Extract<TLShape, {
-        type: K;
-    }>;
-    isShapeOfType<T extends TLShape>(shape: TLShape, type: T['type']): shape is Extract<TLShape, {
-        type: T['type'];
-    }>;
-    isShapeOfType<T extends TLShape = TLShape>(shapeId: TLShapeId, type: T['type']): boolean;
+    isShapeOfType<T extends TLUnknownShape>(shape: TLUnknownShape, type: T['type']): shape is T;
+    isShapeOfType<T extends TLUnknownShape>(shapeId: TLUnknownShape['id'], type: T['type']): shapeId is T['id'];
     /**
      * Get a shape by its id.
      *
@@ -2936,26 +2925,17 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * Get all bindings of a certain type _from_ a particular shape. These are the bindings whose
      * `fromId` matched the shape's ID.
      */
-    getBindingsFromShape<K extends TLBinding['type']>(shape: TLShape | TLShapeId, type: K): Extract<TLBinding, {
-        type: K;
-    }>[];
-    getBindingsFromShape<Binding extends TLBinding = TLBinding>(shape: TLShape | TLShapeId, type: Binding['type']): Binding[];
+    getBindingsFromShape<Binding extends TLUnknownBinding = TLBinding>(shape: TLShape | TLShapeId, type: Binding['type']): Binding[];
     /**
      * Get all bindings of a certain type _to_ a particular shape. These are the bindings whose
      * `toId` matches the shape's ID.
      */
-    getBindingsToShape<K extends TLBinding['type']>(shape: TLShape | TLShapeId, type: K): Extract<TLBinding, {
-        type: K;
-    }>[];
-    getBindingsToShape<Binding extends TLBinding = TLBinding>(shape: TLShape | TLShapeId, type: Binding['type']): Binding[];
+    getBindingsToShape<Binding extends TLUnknownBinding = TLBinding>(shape: TLShape | TLShapeId, type: Binding['type']): Binding[];
     /**
      * Get all bindings involving a particular shape. This includes bindings where the shape is the
      * `fromId` or `toId`. If a type is provided, only bindings of that type are returned.
      */
-    getBindingsInvolvingShape<K extends TLBinding['type']>(shape: TLShape | TLShapeId, type: K): Extract<TLBinding, {
-        type: K;
-    }>[];
-    getBindingsInvolvingShape<Binding extends TLBinding = TLBinding>(shape: TLShape | TLShapeId, type?: Binding['type']): Binding[];
+    getBindingsInvolvingShape<Binding extends TLUnknownBinding = TLBinding>(shape: TLShape | TLShapeId, type?: Binding['type']): Binding[];
     /**
      * Create bindings from a list of partial bindings. You can omit the ID and most props of a
      * binding, but the `type`, `toId`, and `fromId` must all be provided.
@@ -3270,7 +3250,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    canCreateShape(shape: OptionalKeys<TLShapePartial<TLShape>, 'id'> | TLShape['id']): boolean;
+    canCreateShape<T extends TLUnknownShape>(shape: OptionalKeys<TLShapePartial<T>, 'id'> | T['id']): boolean;
     /**
      * Get whether the provided shapes can be created.
      *
@@ -3278,7 +3258,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    canCreateShapes(shapes: (OptionalKeys<TLShapePartial<TLShape>, 'id'> | TLShape['id'])[]): boolean;
+    canCreateShapes<T extends TLUnknownShape>(shapes: (OptionalKeys<TLShapePartial<T>, 'id'> | T['id'])[]): boolean;
     /**
      * Create a single shape.
      *
@@ -3292,7 +3272,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    createShape<TShape extends TLShape>(shape: TLCreateShapePartial<TShape>): this;
+    createShape<T extends TLUnknownShape>(shape: OptionalKeys<TLShapePartial<T>, 'id'>): this;
     /**
      * Create shapes.
      *
@@ -3306,7 +3286,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    createShapes<TShape extends TLShape = TLShape>(shapes: TLCreateShapePartial<TShape>[]): this;
+    createShapes<T extends TLUnknownShape>(shapes: OptionalKeys<TLShapePartial<T>, 'id'>[]): this;
     private animatingShapes;
     /**
      * Animate a shape.
@@ -3392,7 +3372,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    updateShape<T extends TLShape = TLShape>(partial: null | TLShapePartial<T> | undefined): this;
+    updateShape<T extends TLUnknownShape>(partial: null | TLShapePartial<T> | undefined): this;
     /**
      * Update shapes using partials of each shape.
      *
@@ -3405,7 +3385,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    updateShapes<T extends TLShape>(partials: (null | TLShapePartial<T> | undefined)[]): this;
+    updateShapes<T extends TLUnknownShape>(partials: (null | TLShapePartial<T> | undefined)[]): this;
     /* Excluded from this release type: _updateShapes */
     /* Excluded from this release type: _getUnlockedShapeIds */
     /**
@@ -5136,7 +5116,7 @@ export declare function setRuntimeOverrides(input: Partial<typeof runtime>): voi
 export declare function setUserPreferences(user: TLUserPreferences): void;
 
 /** @public */
-export declare abstract class ShapeUtil<Shape extends TLShape = TLShape> {
+export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknownShape> {
     editor: Editor;
     /** Configure this shape utils {@link ShapeUtil.options | `options`}. */
     static configure<T extends TLShapeUtilConstructor<any, any>>(this: T, options: T extends new (...args: any[]) => {
@@ -6061,7 +6041,7 @@ export declare type TLAnyBindingUtilConstructor = TLBindingUtilConstructor<any>;
 export declare type TLAnyShapeUtilConstructor = TLShapeUtilConstructor<any>;
 
 /** @public */
-export declare type TLBaseBoxShape = ExtractShapeByProps<{
+export declare type TLBaseBoxShape = TLBaseShape<string, {
     h: number;
     w: number;
 }>;
@@ -6083,7 +6063,7 @@ export declare interface TLBaseExternalContent {
 }
 
 /** @public */
-export declare interface TLBindingUtilConstructor<T extends TLBinding, U extends BindingUtil<T> = BindingUtil<T>> {
+export declare interface TLBindingUtilConstructor<T extends TLUnknownBinding, U extends BindingUtil<T> = BindingUtil<T>> {
     new (editor: Editor): U;
     type: T['type'];
     /** Validations for this binding's props. */
@@ -7517,11 +7497,11 @@ export declare interface TLShapeUtilCanBeLaidOutOpts {
  *
  * @public
  */
-export declare interface TLShapeUtilCanBindOpts<Shape extends TLShape = TLShape> {
+export declare interface TLShapeUtilCanBindOpts<Shape extends TLUnknownShape = TLUnknownShape> {
     /** The type of shape referenced by the `fromId` of the binding. */
-    fromShapeType: TLShape['type'];
+    fromShapeType: string;
     /** The type of shape referenced by the `toId` of the binding. */
-    toShapeType: TLShape['type'];
+    toShapeType: string;
     /** The type of binding. */
     bindingType: string;
 }
@@ -7533,7 +7513,7 @@ export declare interface TLShapeUtilCanvasSvgDef {
 }
 
 /** @public */
-export declare interface TLShapeUtilConstructor<T extends TLShape, U extends ShapeUtil<T> = ShapeUtil<T>> {
+export declare interface TLShapeUtilConstructor<T extends TLUnknownShape, U extends ShapeUtil<T> = ShapeUtil<T>> {
     new (editor: Editor): U;
     type: T['type'];
     props?: RecordProps<T>;

package/dist-cjs/index.js

@@ -370,7 +370,7 @@ var import_uniq = require("./lib/utils/uniq");
 var import_window_open = require("./lib/utils/window-open");
 (0, import_utils.registerTldrawLibraryVersion)(
   "@tldraw/editor",
-  "4.3.0-canary.fd6b7f2a8adc",
+  "4.3.0-next.2b3bfbba757b",
   "cjs"
 );
 //# sourceMappingURL=index.js.map

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

@@ -4400,18 +4400,30 @@ class Editor extends (_a = import_eventemitter3.default, _getIsShapeHiddenCache_
   getBinding(id) {
     return this.store.get(id);
   }
+  /**
+   * Get all bindings of a certain type _from_ a particular shape. These are the bindings whose
+   * `fromId` matched the shape's ID.
+   */
   getBindingsFromShape(shape, type) {
     const id = typeof shape === "string" ? shape : shape.id;
     return this.getBindingsInvolvingShape(id).filter(
       (b) => b.fromId === id && b.type === type
     );
   }
+  /**
+   * Get all bindings of a certain type _to_ a particular shape. These are the bindings whose
+   * `toId` matches the shape's ID.
+   */
   getBindingsToShape(shape, type) {
     const id = typeof shape === "string" ? shape : shape.id;
     return this.getBindingsInvolvingShape(id).filter(
       (b) => b.toId === id && b.type === type
     );
   }
+  /**
+   * Get all bindings involving a particular shape. This includes bindings where the shape is the
+   * `fromId` or `toId`. If a type is provided, only bindings of that type are returned.
+   */
   getBindingsInvolvingShape(shape, type) {
     const id = typeof shape === "string" ? shape : shape.id;
     const result = this._getBindingsIndexCache().get(id) ?? import_state.EMPTY_ARRAY;
@@ -7469,7 +7481,6 @@ class Editor extends (_a = import_eventemitter3.default, _getIsShapeHiddenCache_
           this.setCursor({ type: this._prevCursor, rotation: 0 });
         }
       }
-      this.emit("event", info);
       this.root.handleEvent(info);
       return;
     }