feat: New panel.content.unlock() method

Author: bastianallgeier

panel/src/panel/content.js

@@ -323,6 +323,49 @@ export default (panel) => {
 		 */
 		saveAbortController: null,
 
+		/**
+		 * Unlocks the content for the current editor
+		 */
+		async unlock(env = {}) {
+			if (this.isProcessing === true) {
+				return;
+			}
+
+			// Only discard changes from the current view
+			if (this.isCurrent(env) === false) {
+				throw new Error("Cannot unlock content from another view");
+			}
+
+			// Check the lock state to determine if we can unlock
+			if (this.isLocked(env) === false) {
+				throw new Error("The content is not locked");
+			}
+
+			// Cancel any ongoing save requests.
+			// The discard request will throw those
+			// changes away anyway.
+			this.cancelSaving();
+
+			// Start processing the request
+			this.isProcessing = true;
+
+			try {
+				await this.request("unlock", {}, env);
+
+				this.emit("unlock", {}, env);
+			} catch (error) {
+				// handle locked states
+				if (error.key?.startsWith("error.content.lock")) {
+					return this.lockDialog(error.details);
+				}
+
+				// let our regular error handler take over
+				throw error;
+			} finally {
+				this.isProcessing = false;
+			}
+		},
+
 		/**
 		 * Updates the form values of the current view
 		 */