@basthon/gui-base 0.38.2 → 0.38.6

package/lib/main.d.ts

@@ -1,3 +1,4 @@
+import { CheckpointsManager } from "@basthon/checkpoints";
 import { KernelBase } from "@basthon/kernel-base";
 import { KernelLoader } from "@basthon/kernel-loader";
 declare global {
@@ -9,6 +10,7 @@ export interface GUIOptions {
     kernelRootPath: string;
     language: string;
     uiName?: string;
+    noCheckpointsInit?: boolean;
 }
 /**
  * Base class for console and notebook GUI.
@@ -17,7 +19,7 @@ export declare class GUIBase {
     private readonly _language;
     private readonly _loaded;
     private _loader;
-    private _checkpoints;
+    private _checkpoints?;
     private _maxCheckpoints;
     protected _contentFilename: string;
     protected _urlKey: string;
@@ -40,6 +42,11 @@ export declare class GUIBase {
      * Check if GUI is loaded.
      */
     loaded(): Promise<void>;
+    /**
+     * Set the checkpoints manager
+     * (typically use with GUIOptions.noCheckpointsInit set to true).
+     */
+    setCheckpointsManager(checkpoints: CheckpointsManager<string>): void;
     /**
      * Notify the user.
      */
@@ -70,11 +77,11 @@ export declare class GUIBase {
     /**
      * Get the content (script or notebook content).
      */
-    protected content(): string;
+    content(): string;
     /**
      * Set the content (script or notebook content).
      */
-    protected setContent(content: string): void;
+    setContent(content: string): void;
     /**
      * Loading the content from query string (ipynb=/script= or from=).
      */
@@ -90,11 +97,15 @@ export declare class GUIBase {
     /**
      * Load content from local forage.
      */
-    protected loadFromStorage(): Promise<string | null>;
+    loadFromStorage(): Promise<string | null>;
     /**
      * Tag last backup as "approved".
      */
     validateBackup(): Promise<void>;
+    /**
+     * Is last backup tagged as "approved"?
+     */
+    lastBackupValid(): Promise<boolean | null | undefined>;
     /**
      * Select a checkpoint to load in the script.
      */
@@ -102,7 +113,7 @@ export declare class GUIBase {
     /**
      * Backup to checkpoints.
      */
-    backup(approved?: boolean): Promise<string>;
+    backup(approved?: boolean): Promise<string | undefined>;
     /**
      * Internal GUI init.
      * It calls setupUI then loadInitialContent.

package/lib/main.js

@@ -18,7 +18,8 @@ export class GUIBase {
         // loading Basthon (errors are fatal)
         this._loader.showLoader("Chargement de Basthon...", false, false);
         /* per language checkpoints */
-        this._checkpoints = new CheckpointsManager(`${options.uiName}.${options.language}`, this._maxCheckpoints);
+        if (!options.noCheckpointsInit)
+            this._checkpoints = new CheckpointsManager(`${options.uiName}.${options.language}`, this._maxCheckpoints);
     }
     /**
      * Language getter.
@@ -37,6 +38,13 @@ export class GUIBase {
      * Check if GUI is loaded.
      */
     async loaded() { await this._loaded.promise; }
+    /**
+     * Set the checkpoints manager
+     * (typically use with GUIOptions.noCheckpointsInit set to true).
+     */
+    setCheckpointsManager(checkpoints) {
+        this._checkpoints = checkpoints;
+    }
     /**
      * Notify the user.
      */
@@ -165,13 +173,14 @@ export class GUIBase {
      * Load content from local forage.
      */
     async loadFromStorage() {
-        const approved = await this._checkpoints.lastHasTag("approved");
+        var _a;
+        const approved = await this.lastBackupValid();
         let content = null;
         if (approved == null) {
             content = null;
         }
         else if (approved) {
-            content = await this._checkpoints.getLast();
+            content = await ((_a = this._checkpoints) === null || _a === void 0 ? void 0 : _a.getLast());
         }
         else {
             const promise = new PromiseDelegate();
@@ -188,17 +197,26 @@ export class GUIBase {
      * Tag last backup as "approved".
      */
     async validateBackup() {
-        await this._checkpoints.tagLast("approved");
+        var _a;
+        await ((_a = this._checkpoints) === null || _a === void 0 ? void 0 : _a.tagLast("approved"));
+    }
+    /**
+     * Is last backup tagged as "approved"?
+     */
+    async lastBackupValid() {
+        var _a;
+        return await ((_a = this._checkpoints) === null || _a === void 0 ? void 0 : _a.lastHasTag("approved"));
     }
     /**
      * Select a checkpoint to load in the script.
      */
     async selectCheckpoint() {
-        const times = await this._checkpoints.times();
+        var _a;
+        const times = await ((_a = this._checkpoints) === null || _a === void 0 ? void 0 : _a.times());
         const promise = new PromiseDelegate();
         const choices = times === null || times === void 0 ? void 0 : times.map((t, i) => ({
             text: CheckpointsManager.toHumanDate(parseInt(t, 10)),
-            handler: async () => { var _a; promise.resolve((_a = (await this._checkpoints.getIndex(i))) !== null && _a !== void 0 ? _a : null); }
+            handler: async () => { var _a, _b; promise.resolve((_b = (await ((_a = this._checkpoints) === null || _a === void 0 ? void 0 : _a.getIndex(i)))) !== null && _b !== void 0 ? _b : null); }
         }));
         if (choices == null)
             return null;
@@ -209,19 +227,21 @@ export class GUIBase {
      * Backup to checkpoints.
      */
     async backup(approved = true) {
-        return await this._checkpoints.push(this.content(), approved ? ["approved"] : []);
+        var _a;
+        return await ((_a = this._checkpoints) === null || _a === void 0 ? void 0 : _a.push(this.content(), approved ? ["approved"] : []));
     }
     /**
      * Internal GUI init.
      * It calls setupUI then loadInitialContent.
      */
     async _init(options = null) {
+        var _a;
         /* all errors redirected to notification system */
         const onerror = this.notifyError.bind(this);
         window.addEventListener('error', onerror);
         window.addEventListener("unhandledrejection", onerror);
         console.error = (message) => onerror(new ErrorEvent(message, { message: message }));
-        await this._checkpoints.ready();
+        await ((_a = this._checkpoints) === null || _a === void 0 ? void 0 : _a.ready());
         await this.setupUI(options);
         await this.loadInitialContent(options);
         await this.kernelLoader.kernelLoaded();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basthon/gui-base",
-  "version": "0.38.2",
+  "version": "0.38.6",
   "description": "Basthon - Base GUI",
   "homepage": "https://basthon.fr",
   "bugs": {
@@ -25,9 +25,9 @@
     "clean": "rm -rf lib/"
   },
   "dependencies": {
-    "@basthon/checkpoints": "^0.38.2",
-    "@basthon/kernel-base": "^0.38.2",
-    "@basthon/kernel-loader": "^0.38.2",
+    "@basthon/checkpoints": "^0.38.6",
+    "@basthon/kernel-base": "^0.38.6",
+    "@basthon/kernel-loader": "^0.38.6",
     "js-base64": "^3.7.2",
     "pako": "^2.0.4",
     "promise-delegate": "^1.0.1"
@@ -41,5 +41,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "df6a3eb261122c31b25c971e1d97e442054432cd"
+  "gitHead": "1598210257bd6c9be809971802a41134835d1cf9"
 }