From 65efa0e3166b6db4f977997ba6ea1ef9c66dbf9c Mon Sep 17 00:00:00 2001
From: jmoenig <jens@moenig.org>
Date: Tue, 22 Dec 2020 00:35:29 +0100
Subject: [PATCH] added unsavedChanges() method and documentation to the Snap!
 API

---
 API.md     | 13 ++++++++++++-
 HISTORY.md |  2 ++
 snap.html  |  2 +-
 src/api.js |  7 ++++++-
 4 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/API.md b/API.md
index a6e46b2a..3ca71838 100755
--- a/API.md
+++ b/API.md
@@ -1,6 +1,6 @@
 # The Snap! API
 
-Jens Mönig, Bernat Romagosa, November 21, 2020
+Jens Mönig, Bernat Romagosa, December 22, 2020
 
 This document describes how Snap! can be accessed from an outside program to start scripts, send and retrieve information. The model use case is embedding interactive Snap! projects in other websites such as MOOCs or other adaptive learning platforms.
 
@@ -32,6 +32,7 @@ Currently the API consists of the following methods:
 
 * IDE_Morph.prototype.getProjectXML()
 * IDE_Morph.prototype.loadProjectXML()
+* IDE_Morph.prototype.unsavedChanges()
 
 ## Referencing the IDE
 
@@ -213,6 +214,16 @@ the loadProjectXML() method replaces the current project of the IDE with another
 unefined
 
 
+### IDE_Morph.prototype.unsavedChanges()
+the unsavedChanges() method return a Boolean value indicating whether the currently edited project has been modifed since it was last saved.
+
+#### syntax
+    ide.unsavedChanges();
+    
+#### return value
+a Boolean
+
+
 ## Manipulating Lists
 
 Snap! lists can be accessed and manipulated through a set of methods described in the file `lists.js`
diff --git a/HISTORY.md b/HISTORY.md
index 25f8a293..014740e8 100755
--- a/HISTORY.md
+++ b/HISTORY.md
@@ -14,12 +14,14 @@
     * fixed keyboard formula entry for subtraction
 * **Documentation Updates:**
     * new Manual for v6.5, thanks, Brian!
+    * added unsavedChanges() method and documentation to the Snap! API
 * **Translation Updates:**
     * German
     * Catalan, thanks, Joan!
 
 ### 2020-12-22
 * threads: up to 40x speed-up for "new costume from list" reporter primitive 
+* api: added unsavedChanges() method and documentation 
 
 ### 2020-12-21
 * gui: tweaked backup / restore
diff --git a/snap.html b/snap.html
index de7c142b..9bf68d4c 100755
--- a/snap.html
+++ b/snap.html
@@ -23,7 +23,7 @@
         <script src="src/store.js?version=2020-12-11"></script>
         <script src="src/locale.js?version=2020-12-21"></script>
         <script src="src/cloud.js?version=2020-10-21"></script>
-        <script src="src/api.js?version=2020-11-21"></script>
+        <script src="src/api.js?version=2020-12-22"></script>
         <script src="src/sha512.js?version=2019-06-27"></script>
         <script src="src/FileSaver.min.js?version=2019-06-27"></script>
         <script>
diff --git a/src/api.js b/src/api.js
index 44c9325f..c074576a 100644
--- a/src/api.js
+++ b/src/api.js
@@ -62,6 +62,7 @@
 
             - IDE_Morph.prototype.getProjectXML()
             - IDE_Morph.prototype.loadProjectXML(projectXML)
+            - IDE_Morph.prototype.unsavedChanges()
 
     Getting hold of an ide can usually be achieved by
     evaluating:
@@ -205,7 +206,7 @@
 
 // Global stuff ////////////////////////////////////////////////////////
 
-modules.api = '2020-November-21';
+modules.api = '2020-December-22';
 
 // IDE_Morph external communication API - experimental
 /*
@@ -342,3 +343,7 @@ IDE_Morph.prototype.loadProjectXML = function (projectXML) {
     this.world().animations = [];
     this.openProjectString(projectXML);
 };
+
+IDE_Morph.prototype.unsavedChange = function () {
+    return this.hasUnsavedEdits;
+};