@arsedizioni/ars-utils 22.1.0 → 22.1.1

package/fesm2022/arsedizioni-ars-utils-core.mjs

@@ -3957,6 +3957,29 @@ class SplashService {
     bootstrapped() { this.api?.disarm(); }
     /** Fade out and remove the splash overlay from the DOM. */
     hide() { this.api?.hide(); }
+    /**
+     * Give up on loading, without taking the splash away.
+     *
+     * The splash stays where it is but stops pretending something is still happening: the progress
+     * bar goes and a reload button appears, so a user who would otherwise sit in front of an endless
+     * animation has something to do. Uncovering the page instead would be worse — whatever is
+     * underneath is, by definition, not ready.
+     *
+     * Falls back to {@link setMessage} where `index.html` does not publish `fail`: the user still
+     * reads what happened, only without the button.
+     * @param text - What to tell the user.
+     */
+    fail(text) {
+        const api = this.api;
+        if (!api)
+            return;
+        if (api.fail) {
+            api.fail(text);
+        }
+        else {
+            api.setMessage(text);
+        }
+    }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.0", ngImport: i0, type: SplashService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
     static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.1.0", ngImport: i0, type: SplashService }); }
 }