hyperclayjs 1.19.3 → 1.19.5

package/README.md

@@ -63,7 +63,7 @@ import 'hyperclayjs/presets/standard.js';
 | option-visibility | 7.8KB | Dynamic show/hide based on ancestor state with option:attribute="value" |
 | persist | 2.4KB | Persist input/select/textarea values to the DOM with [persist] attribute |
 | save-core | 8.9KB | Basic save function only - hyperclay.savePage() |
-| save-system | 12.1KB | CMD+S, [trigger-save] button, savestatus attribute |
+| save-system | 13.4KB | CMD+S, [trigger-save] button, savestatus attribute |
 | save-toast | 0.9KB | Toast notifications for save events |
 | snapshot | 10.8KB | Source of truth for page state - captures DOM snapshots for save and sync |
 | tailwind-inject | 1.4KB | Injects tailwind CSS link with cache-bust on save |
@@ -132,17 +132,17 @@ import 'hyperclayjs/presets/standard.js';
 
 ## Presets
 
-### Minimal (~51.3KB)
+### Minimal (~52.6KB)
 Essential features for basic editing
 
 **Modules:** `save-core`, `snapshot`, `save-system`, `edit-mode-helpers`, `toast`, `save-toast`, `export-to-window`, `view-mode-excludes-edit-modules`
 
-### Standard (~73.6KB)
+### Standard (~74.9KB)
 Standard feature set for most use cases
 
 **Modules:** `save-core`, `snapshot`, `save-system`, `unsaved-warning`, `edit-mode-helpers`, `persist`, `option-visibility`, `event-attrs`, `dom-helpers`, `toast`, `save-toast`, `export-to-window`, `view-mode-excludes-edit-modules`
 
-### Everything (~207.4KB)
+### Everything (~208.7KB)
 All available features
 
 Includes all available modules across all categories.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperclayjs",
-  "version": "1.19.3",
+  "version": "1.19.5",
   "description": "Modular JavaScript library for building interactive HTML applications with Hyperclay",
   "type": "module",
   "main": "src/hyperclay.js",

package/src/core/savePage.js

@@ -196,6 +196,57 @@ export function savePage(callback = () => {}) {
   });
 }
 
+export function savePageForce(callback = () => {}) {
+  if (!isEditMode && !window.hyperclay?.testMode) {
+    return;
+  }
+
+  if (isSaveInProgress()) {
+    return;
+  }
+
+  const wasOffline = !navigator.onLine;
+  if (wasOffline) {
+    setOfflineStateQuiet();
+  }
+
+  let forSave, forComparison;
+  try {
+    ({ forSave, forComparison } = captureForSaveAndComparison());
+  } catch (err) {
+    console.error('savePageForce: captureForSaveAndComparison failed', err);
+    setSaveState('error', err.message);
+    if (typeof callback === 'function') {
+      callback({ msg: err.message, msgType: 'error' });
+    }
+    return;
+  }
+
+  setSavingState();
+
+  saveHtml(forSave, (err, data) => {
+    if (!err) {
+      lastSavedContents = forComparison;
+      unsavedChanges = false;
+      setSaveState('saved', data?.msg || 'Saved');
+      logBaseline('updated after force save', `${lastSavedContents.length} chars`);
+    } else {
+      if (!navigator.onLine) {
+        setSaveState('offline', err.message);
+      } else {
+        setSaveState('error', err.message);
+      }
+    }
+
+    if (typeof callback === 'function') {
+      callback({
+        msg: err?.message || data?.msg,
+        msgType: err ? 'error' : (data?.msgType || 'success')
+      });
+    }
+  });
+}
+
 /**
  * Fetch HTML from a URL and save it, then reload
  * Emits error event if save fails
@@ -378,6 +429,7 @@ export function init() {
 if (!window.__hyperclayNoAutoExport) {
   window.hyperclay = window.hyperclay || {};
   window.hyperclay.savePage = savePage;
+  window.hyperclay.savePageForce = savePageForce;
   window.hyperclay.savePageThrottled = savePageThrottled;
   window.hyperclay.beforeSave = beforeSave;
   window.hyperclay.replacePageWith = replacePageWith;

package/src/hyperclay.js

@@ -1,7 +1,7 @@
 /**
  * DO NOT EDIT THIS FILE DIRECTLY — it is generated from build/hyperclay.template.js
  *
- * HyperclayJS v1.19.3 - Minimal Browser-Native Loader
+ * HyperclayJS v1.19.5 - Minimal Browser-Native Loader
  *
  * Modules auto-init when imported (no separate init call needed).
  * Include `export-to-window` feature to export to window.hyperclay.
@@ -141,7 +141,8 @@ const PRESETS = {
       "behavior-collector",
       "send-message",
       "file-upload",
-      "export-to-window"
+      "export-to-window",
+      "view-mode-excludes-edit-modules"
     ]
   },
   "everything": {
@@ -294,6 +295,7 @@ if (debug) console.log('HyperclayJS: Ready');
 // ES module exports - allows destructuring from import()
 export const savePage = window.hyperclayModules['save-core']?.savePage ?? window.hyperclayModules['save-core']?.default;
 export const beforeSave = window.hyperclayModules['save-system']?.beforeSave ?? window.hyperclayModules['save-system']?.default;
+export const savePageForce = window.hyperclayModules['save-system']?.savePageForce ?? window.hyperclayModules['save-system']?.default;
 export const savePageThrottled = window.hyperclayModules['save-system']?.savePageThrottled ?? window.hyperclayModules['save-system']?.default;
 export const replacePageWith = window.hyperclayModules['save-system']?.replacePageWith ?? window.hyperclayModules['save-system']?.default;
 export const captureSnapshot = window.hyperclayModules['snapshot']?.captureSnapshot ?? window.hyperclayModules['snapshot']?.default;