refactor: rename UIOptions.canvasActions.saveScene to UIOptions.canvasActions.saveToActiveFile (#3657)

* refactor rename action saveScene to saveFileToDisk

* docs

* fix

* fix

src/actions/actionExport.tsx

@@ -71,8 +71,8 @@ export const actionChangeExportEmbedScene = register({
   ),
 });
 
-export const actionSaveScene = register({
-  name: "saveScene",
+export const actionSaveToActiveFile = register({
+  name: "saveToActiveFile",
   perform: async (elements, appState, value) => {
     const fileHandleExists = !!appState.fileHandle;
     try {

src/actions/index.ts

@@ -34,7 +34,7 @@ export { actionFinalize } from "./actionFinalize";
 export {
   actionChangeProjectName,
   actionChangeExportBackground,
-  actionSaveScene,
+  actionSaveToActiveFile,
   actionSaveAsScene,
   actionLoadScene,
 } from "./actionExport";

src/actions/types.ts

@@ -66,7 +66,7 @@ export type ActionName =
   | "changeProjectName"
   | "changeExportBackground"
   | "changeExportEmbedScene"
-  | "saveScene"
+  | "saveToActiveFile"
   | "saveAsScene"
   | "loadScene"
   | "duplicateSelection"

src/components/BackgroundPickerAndDarkModeToggle.tsx

@@ -18,7 +18,7 @@ export const BackgroundPickerAndDarkModeToggle = ({
     {showThemeBtn && actionManager.renderAction("toggleTheme")}
     {appState.fileHandle && (
       <div style={{ marginInlineStart: "0.25rem" }}>
-        {actionManager.renderAction("saveScene")}
+        {actionManager.renderAction("saveToActiveFile")}
       </div>
     )}
   </div>

src/constants.ts

@@ -134,7 +134,7 @@ export const DEFAULT_UI_OPTIONS: AppProps["UIOptions"] = {
     export: true,
     loadScene: true,
     saveAsScene: true,
-    saveScene: true,
+    saveToActiveFile: true,
     theme: true,
   },
 };

src/packages/excalidraw/CHANGELOG.md

@@ -17,8 +17,8 @@ Please add the latest change on the top under the correct section.
 
 ### Refactor
 
-#### BREAKING CHANGE
-
+- #### BREAKING CHANGE
+  - Rename `UIOptions.canvasActions.saveScene` to `UIOptions.canvasActions.saveToActiveFile`[#3657](https://github.com/excalidraw/excalidraw/pull/3657).
   - Removed `shouldAddWatermark: boolean` attribute from options for [export](https://github.com/excalidraw/excalidraw/blob/master/src/packages/excalidraw/README.md#export-utilities) APIs [#3639](https://github.com/excalidraw/excalidraw/pull/3639).
   - Removed `appState.shouldAddWatermark` so in case you were passing `shouldAddWatermark` in [initialData.AppState](https://github.com/excalidraw/excalidraw/blob/master/src/types.ts#L42) it will not work anymore.
 

src/packages/excalidraw/README_NEXT.md

@@ -574,7 +574,7 @@ This prop can be used to customise UI of Excalidraw. Currently we support custom
 | `export` | boolean | true | Implies whether to show `Export button` |
 | `loadScene` | boolean | true | Implies whether to show `Load button` |
 | `saveAsScene` | boolean | true | Implies whether to show `Save as button` |
-| `saveScene` | boolean | true | Implies whether to show `Save button` |
+| `saveToActiveFile` | boolean | true | Implies whether to show `Save button` to save to current file |
 | `theme` | boolean | true | Implies whether to show `Theme toggle` |
 
 #### `onPaste`

src/tests/excalidrawPackage.test.tsx

@@ -186,9 +186,11 @@ describe("<Excalidraw/>", () => {
         expect(queryByTestId(container, "save-as-button")).toBeNull();
       });
 
-      it("should hide save button when saveScene is false", async () => {
+      it("should hide save button when saveToActiveFile is false", async () => {
         const { container } = await render(
-          <Excalidraw UIOptions={{ canvasActions: { saveScene: false } }} />,
+          <Excalidraw
+            UIOptions={{ canvasActions: { saveToActiveFile: false } }}
+          />,
         );
 
         expect(queryByTestId(container, "save-button")).toBeNull();

src/types.ts

@@ -219,7 +219,7 @@ type CanvasActions = {
   export?: boolean;
   loadScene?: boolean;
   saveAsScene?: boolean;
-  saveScene?: boolean;
+  saveToActiveFile?: boolean;
   theme?: boolean;
 };