@zsviczian/excalidraw 0.12.0-obsidian-11 → 0.13.0-obsidian

package/types/data/restore.d.ts

@@ -8,7 +8,7 @@ export declare type RestoredDataState = {
     appState: RestoredAppState;
     files: BinaryFiles;
 };
-export declare const restoreElements: (elements: ImportedDataState["elements"], localElements: readonly ExcalidrawElement[] | null | undefined) => ExcalidrawElement[];
+export declare const restoreElements: (elements: ImportedDataState["elements"], localElements: readonly ExcalidrawElement[] | null | undefined, refreshDimensions?: boolean) => ExcalidrawElement[];
 export declare const restoreAppState: (appState: ImportedDataState["appState"], localAppState: Partial<AppState> | null | undefined) => RestoredAppState;
 export declare const restore: (data: Pick<ImportedDataState, "appState" | "elements" | "files"> | null, localAppState: Partial<AppState> | null | undefined, localElements: readonly ExcalidrawElement[] | null | undefined) => RestoredDataState;
 export declare const restoreLibraryItems: (libraryItems: ImportedDataState["libraryItems"], defaultStatus: LibraryItem["status"]) => LibraryItem[];

package/types/data/types.d.ts

@@ -10,12 +10,27 @@ export interface ExportedDataState {
     appState: ReturnType<typeof cleanAppStateForExport>;
     files: BinaryFiles | undefined;
 }
+/**
+ * Map of legacy AppState keys, with values of:
+ *  [<legacy type>, <new AppState proeprty>]
+ *
+ * This is a helper type used in downstream abstractions.
+ * Don't consume on its own.
+ */
+export declare type LegacyAppState = {
+    /** @deprecated #5663 TODO remove 22-12-15 */
+    isLibraryOpen: [boolean, "openSidebar"];
+    /** @deprecated #5663 TODO remove 22-12-15 */
+    isLibraryMenuDocked: [boolean, "isSidebarDocked"];
+};
 export interface ImportedDataState {
     type?: string;
     version?: number;
     source?: string;
     elements?: readonly ExcalidrawElement[] | null;
-    appState?: Readonly<Partial<AppState>> | null;
+    appState?: Readonly<Partial<AppState & {
+        [T in keyof LegacyAppState]: LegacyAppState[T][0];
+    }>> | null;
     scrollToContent?: boolean;
     libraryItems?: LibraryItems_anyVersion;
     files?: BinaryFiles;

package/types/element/Hyperlink.d.ts

@@ -72,6 +72,8 @@ export declare const actionLink: {
                 value: import("../types").NormalizedZoomValue;
             }>;
             openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
+            openSidebar: "library" | "customSidebar" | null;
+            isSidebarDocked: boolean;
             lastPointerDownWith: import("./types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -98,8 +100,6 @@ export declare const actionLink: {
             height: number;
             offsetTop: number;
             offsetLeft: number;
-            isLibraryOpen: boolean;
-            isLibraryMenuDocked: boolean;
             fileHandle: import("browser-fs-access").FileSystemHandle | null;
             collaborators: Map<string, import("../types").Collaborator>;
             showStats: boolean;

package/types/element/index.d.ts

@@ -1,5 +1,5 @@
 import { ExcalidrawElement, NonDeletedExcalidrawElement, NonDeleted } from "./types";
-export { newElement, newTextElement, updateTextElement, newLinearElement, newImageElement, duplicateElement, } from "./newElement";
+export { newElement, newTextElement, updateTextElement, refreshTextDimensions, newLinearElement, newImageElement, duplicateElement, } from "./newElement";
 export { getElementAbsoluteCoords, getElementBounds, getCommonBounds, getDiamondPoints, getArrowheadPoints, getClosestElementBounds, } from "./bounds";
 export { OMIT_SIDES_FOR_MULTIPLE_ELEMENTS, getTransformHandlesFromCoords, getTransformHandles, } from "./transformHandles";
 export { hitTest, isHittingElementBoundingBoxWithoutHittingElement, } from "./collision";

package/types/element/linearElementEditor.d.ts

@@ -160,6 +160,8 @@ export declare class LinearElementEditor {
             }>;
             openMenu: "canvas" | "shape" | null;
             openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
+            openSidebar: "library" | "customSidebar" | null;
+            isSidebarDocked: boolean;
             lastPointerDownWith: import("./types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -186,8 +188,6 @@ export declare class LinearElementEditor {
             height: number;
             offsetTop: number;
             offsetLeft: number;
-            isLibraryOpen: boolean;
-            isLibraryMenuDocked: boolean;
             fileHandle: import("browser-fs-access").FileSystemHandle | null;
             collaborators: Map<string, import("../types").Collaborator>;
             showStats: boolean;

package/types/element/newElement.d.ts

@@ -13,6 +13,14 @@ export declare const newTextElement: (opts: {
     verticalAlign: VerticalAlign;
     containerId?: ExcalidrawRectangleElement["id"];
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawTextElement>;
+export declare const refreshTextDimensions: (textElement: ExcalidrawTextElement, text?: string) => {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    baseline: number;
+    text: string;
+};
 export declare const getMaxContainerWidth: (container: ExcalidrawElement) => number;
 export declare const getMaxContainerHeight: (container: ExcalidrawElement) => number;
 export declare const updateTextElement: (textElement: ExcalidrawTextElement, { text, isDeleted, originalText, rawText, link, }: {

package/types/keys.d.ts

@@ -17,11 +17,8 @@ export declare const CODES: {
     readonly SLASH: "Slash";
     readonly C: "KeyC";
     readonly D: "KeyD";
-    readonly G: "KeyG";
-    readonly F: "KeyF";
     readonly H: "KeyH";
     readonly V: "KeyV";
-    readonly X: "KeyX";
     readonly Z: "KeyZ";
     readonly R: "KeyR";
 };
@@ -44,9 +41,12 @@ export declare const KEYS: {
     readonly PERIOD: ".";
     readonly COMMA: ",";
     readonly A: "a";
+    readonly C: "c";
     readonly D: "d";
     readonly E: "e";
+    readonly F: "f";
     readonly G: "g";
+    readonly H: "h";
     readonly I: "i";
     readonly L: "l";
     readonly O: "o";

package/types/packages/excalidraw/example/App.d.ts

@@ -1,7 +1,8 @@
+import type * as TExcalidraw from "../index";
 import "./App.scss";
 declare global {
     interface Window {
-        ExcalidrawLib: any;
+        ExcalidrawLib: typeof TExcalidraw;
     }
 }
 export default function App(): JSX.Element;

package/types/packages/excalidraw/example/sidebar/ExampleSidebar.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+import "./ExampleSidebar.scss";
+export default function Sidebar({ children }: {
+    children: React.ReactNode;
+}): JSX.Element;

package/types/packages/excalidraw/index.d.ts

@@ -18,3 +18,4 @@ export { FONT_FAMILY, THEME, MIME_TYPES } from "../../constants";
 export { mutateElement, newElementWith, bumpVersion, } from "../../element/mutateElement";
 export { parseLibraryTokensFromUrl, useHandleLibrary, } from "../../data/library";
 export { sceneCoordsToViewportCoords, viewportCoordsToSceneCoords, } from "../../utils";
+export { Sidebar } from "../../components/Sidebar/Sidebar";

package/types/scene/scrollbars.d.ts

@@ -3,7 +3,7 @@ import { Zoom } from "../types";
 import { ScrollBars } from "./types";
 export declare const SCROLLBAR_MARGIN = 4;
 export declare const SCROLLBAR_WIDTH = 6;
-export declare const SCROLLBAR_COLOR = "rgba(0,0,0,0.3)";
+export declare const SCROLLBAR_COLOR = "rgba(128,128,128,0.3)";
 export declare const getScrollBars: (elements: readonly ExcalidrawElement[], viewportWidth: number, viewportHeight: number, { scrollX, scrollY, zoom, }: {
     scrollX: number;
     scrollY: number;

package/types/types.d.ts

@@ -104,6 +104,8 @@ export declare type AppState = {
     zoom: Zoom;
     openMenu: "canvas" | "shape" | null;
     openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
+    openSidebar: "library" | "customSidebar" | null;
+    isSidebarDocked: boolean;
     lastPointerDownWith: PointerType;
     selectedElementIds: {
         [id: string]: boolean;
@@ -133,8 +135,6 @@ export declare type AppState = {
     height: number;
     offsetTop: number;
     offsetLeft: number;
-    isLibraryOpen: boolean;
-    isLibraryMenuDocked: boolean;
     fileHandle: FileSystemHandle | null;
     collaborators: Map<string, Collaborator>;
     showStats: boolean;
@@ -251,6 +251,10 @@ export interface ExcalidrawProps {
     onLinkHover?: (element: NonDeletedExcalidrawElement, event: React.PointerEvent<HTMLCanvasElement>) => void;
     onPointerDown?: (activeTool: AppState["activeTool"], pointerDownState: PointerDownState) => void;
     onScrollChange?: (scrollX: number, scrollY: number) => void;
+    /**
+     * Render function that renders custom <Sidebar /> component.
+     */
+    renderSidebar?: () => JSX.Element | null;
 }
 export declare type SceneData = {
     elements?: ImportedDataState["elements"];
@@ -287,6 +291,7 @@ export declare type AppProps = Merge<ExcalidrawProps, {
     detectScroll: boolean;
     handleKeyboardGlobally: boolean;
     isCollaborating: boolean;
+    children?: React.ReactNode;
 }>;
 /** A subset of App class properties that we need to use elsewhere
  * in the app, eg Manager. Factored out into a separate type to keep DRY. */
@@ -393,6 +398,7 @@ export declare type ExcalidrawImperativeAPI = {
     setActiveTool: InstanceType<typeof App>["setActiveTool"];
     setCursor: InstanceType<typeof App>["setCursor"];
     resetCursor: InstanceType<typeof App>["resetCursor"];
+    toggleMenu: InstanceType<typeof App>["toggleMenu"];
 };
 export declare type Device = Readonly<{
     isSmScreen: boolean;