hyperclayjs 1.9.0 → 1.11.0

package/README.md

@@ -63,9 +63,10 @@ import 'hyperclayjs/presets/standard.js';
 | option-visibility | 5.3KB | 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 | 6.8KB | Basic save function only - hyperclay.savePage() |
-| save-system | 7.1KB | Manual save: keyboard shortcut (CMD+S), save button, change tracking |
+| save-system | 7.1KB | CMD+S, [trigger-save] button, savestatus attribute |
 | save-toast | 0.9KB | Toast notifications for save events |
 | snapshot | 7.5KB | Source of truth for page state - captures DOM snapshots for save and sync |
+| tailwind-inject | 0.4KB | Injects tailwind CSS link with cache-bust on save |
 | unsaved-warning | 0.8KB | Warn before leaving page with unsaved changes |
 
 ### Custom Attributes (HTML enhancements)
@@ -105,7 +106,7 @@ import 'hyperclayjs/presets/standard.js';
 | all-js | 14.4KB | Full DOM manipulation library |
 | dom-ready | 0.4KB | DOM ready callback |
 | form-data | 2KB | Extract form data as an object |
-| style-injection | 1.9KB | Dynamic stylesheet injection |
+| style-injection | 2.4KB | Dynamic stylesheet injection |
 
 ### String Utilities (String manipulation helpers)
 
@@ -120,7 +121,7 @@ import 'hyperclayjs/presets/standard.js';
 | Module | Size | Description |
 |--------|------|-------------|
 | file-upload | 10.7KB | File upload with progress |
-| live-sync | 12KB | Real-time DOM sync across browsers and with file system |
+| live-sync | 12.7KB | Real-time DOM sync across browsers |
 | send-message | 1.3KB | Message sending utility |
 
 ### Vendor Libraries (Third-party libraries)
@@ -141,7 +142,7 @@ Standard feature set for most use cases
 
 **Modules:** `save-core`, `save-system`, `edit-mode-helpers`, `persist`, `option-visibility`, `event-attrs`, `dom-helpers`, `toast`, `save-toast`, `export-to-window`
 
-### Everything (~176.5KB)
+### Everything (~178.1KB)
 All available features
 
 Includes all available modules across all categories.
@@ -230,7 +231,7 @@ The project uses Madge to automatically analyze dependencies and generate rich m
 npm run generate:deps
 ```
 
-This creates `module-dependency-graph.json` with:
+This creates `module-dependency-graph.generated.json` with:
 - Complete dependency tree
 - Actual file sizes
 - Category assignments

package/package.json

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

package/src/communication/live-sync.js

@@ -228,26 +228,34 @@ class LiveSync {
 
   /**
    * Listen for snapshot-ready events from the save system.
-   * This replaces DOM observation — we sync when save happens.
+   * Receives the full cloned documentElement and extracts head/body.
    */
   listenForSnapshots() {
-    this._snapshotHandler = (event) => {
+    this._snapshotHandler = async (event) => {
       if (this.isPaused) return;
 
-      const { body } = event.detail;
-      if (!body) return;
+      const { documentElement } = event.detail;
+      if (!documentElement) return;
 
-      this.sendBody(body);
+      // Extract head and body directly from cloned element
+      const head = documentElement.querySelector('head')?.innerHTML || '';
+      const body = documentElement.querySelector('body')?.innerHTML || '';
+
+      // Compute headHash using SHA-256 (async)
+      const headHash = await this.computeHeadHash(head);
+
+      // Send update even if body is empty (allows clearing content)
+      this.sendUpdate(body, headHash);
     };
 
     document.addEventListener('hyperclay:snapshot-ready', this._snapshotHandler);
   }
 
   /**
-   * Send body HTML to the server (debounced)
+   * Send body and headHash to the server (debounced)
    * Only updates lastBodyHtml after successful save
    */
-  sendBody(body) {
+  sendUpdate(body, headHash) {
     clearTimeout(this.debounceTimer);
 
     this.debounceTimer = setTimeout(() => {
@@ -256,9 +264,8 @@ class LiveSync {
 
       console.log('[LiveSync] Sending update');
 
-      // Compute head hash to send to server (for hosted mode)
-      const headHash = this.computeHeadHash();
-      this.lastHeadHash = headHash; // Track local head changes
+      // Track local head changes
+      this.lastHeadHash = headHash;
 
       fetch('/live-sync/save', {
         method: 'POST',
@@ -286,21 +293,30 @@ class LiveSync {
   }
 
   /**
-   * Compute MD5-like hash of head content (first 8 hex chars)
-   * Uses a simple string hash since we don't have crypto in browser
+   * Compute SHA-256 hash of head content (first 16 hex chars)
+   * Uses SubtleCrypto API (async)
+   * @param {string} head - Head innerHTML
+   * @returns {Promise<string|null>} 16-char hex hash or null if unavailable
    */
-  computeHeadHash() {
-    const head = document.head?.innerHTML;
+  async computeHeadHash(head) {
     if (!head) return null;
 
-    // Simple hash function (djb2)
-    let hash = 5381;
-    for (let i = 0; i < head.length; i++) {
-      hash = ((hash << 5) + hash) + head.charCodeAt(i);
-      hash = hash & hash; // Convert to 32bit integer
+    // SubtleCrypto requires secure context (HTTPS or localhost)
+    if (!crypto?.subtle?.digest) {
+      console.warn('[LiveSync] SHA-256 unavailable (non-secure context), skipping headHash');
+      return null;
+    }
+
+    try {
+      const encoder = new TextEncoder();
+      const data = encoder.encode(head);
+      const hashBuffer = await crypto.subtle.digest('SHA-256', data);
+      const hashArray = Array.from(new Uint8Array(hashBuffer));
+      return hashArray.map(b => b.toString(16).padStart(2, '0')).join('').slice(0, 16);
+    } catch (e) {
+      console.warn('[LiveSync] SHA-256 hash failed, skipping headHash:', e);
+      return null;
     }
-    // Convert to hex and take first 8 chars
-    return Math.abs(hash).toString(16).padStart(8, '0').slice(0, 8);
   }
 
   /**

package/src/core/snapshot.js

@@ -128,10 +128,10 @@ export function captureForSave({ emitForSync = true } = {}) {
   const clone = captureSnapshot();
 
   // Emit for live-sync before stripping admin elements
+  // Sends full cloned documentElement so live-sync can extract head and body
   if (emitForSync) {
-    const bodyForSync = clone.querySelector('body').innerHTML;
     document.dispatchEvent(new CustomEvent('hyperclay:snapshot-ready', {
-      detail: { body: bodyForSync }
+      detail: { documentElement: clone }
     }));
   }
 

package/src/core/tailwindInject.js

@@ -0,0 +1,14 @@
+import { insertStyles } from '../dom-utilities/insertStyleTag.js';
+import cookie from '../utilities/cookie.js';
+
+function init() {
+  const currentResource = cookie.get('currentResource');
+  if (!currentResource) return;
+
+  const href = `/tailwindcss/${currentResource}`;
+  insertStyles(href, (link) => {
+    link.setAttribute('onaftersave', 'cacheBust(this)');
+  });
+}
+
+init();

package/src/dom-utilities/insertStyleTag.js

@@ -6,24 +6,33 @@
  * duplicates. This ensures:
  *   - No flickering: new styles are applied before old ones are removed
  *   - Always upgrades: we default to the new styles/approach
+ *
+ * Usage:
+ *   insertStyles('/path/to/file.css')                    // External stylesheet
+ *   insertStyles('/path/to/file.css', (link) => { ... }) // With callback
+ *   insertStyles('my-styles', '.foo { ... }')            // Inline CSS
+ *   insertStyles('my-styles', '.foo { ... }', (style) => { ... }) // With callback
  */
-function insertStyles(nameOrHref, css) {
-  if (css !== undefined) {
-    // Inline style: insertStyles('my-styles', '.foo { ... }')
+function insertStyles(nameOrHref, cssOrCallback, callback) {
+  if (typeof cssOrCallback === 'string') {
+    // Inline style: insertStyles('my-styles', '.foo { ... }', optionalCallback)
     const name = nameOrHref;
+    const css = cssOrCallback;
     const oldStyles = document.querySelectorAll(`style[data-name="${name}"]`);
 
     const style = document.createElement('style');
     style.dataset.name = name;
     style.textContent = css;
+    if (callback) callback(style);
     document.head.appendChild(style);
 
     oldStyles.forEach(el => el.remove());
     return style;
   }
 
-  // External stylesheet: insertStyles('/path/to/file.css')
+  // External stylesheet: insertStyles('/path/to/file.css', optionalCallback)
   const href = nameOrHref;
+  const cb = typeof cssOrCallback === 'function' ? cssOrCallback : undefined;
 
   let identifier;
   try {
@@ -40,6 +49,7 @@ function insertStyles(nameOrHref, css) {
   const link = document.createElement('link');
   link.rel = 'stylesheet';
   link.href = href;
+  if (cb) cb(link);
   document.head.appendChild(link);
 
   oldLinks.forEach(el => el.remove());

package/src/hyperclay.js

@@ -1,5 +1,5 @@
 /**
- * HyperclayJS v1.9.0 - Minimal Browser-Native Loader
+ * HyperclayJS v1.11.0 - Minimal Browser-Native Loader
  *
  * Modules auto-init when imported (no separate init call needed).
  * Include `export-to-window` feature to export to window.hyperclay.
@@ -64,6 +64,7 @@ const MODULE_PATHS = {
   "send-message": "./communication/sendMessage.js",
   "file-upload": "./communication/uploadFile.js",
   "live-sync": "./communication/live-sync.js",
+  "tailwind-inject": "./core/tailwindInject.js",
   "export-to-window": "./core/exportToWindow.js"
 };
 const PRESETS = {
@@ -138,10 +139,27 @@ const PRESETS = {
       "send-message",
       "file-upload",
       "live-sync",
+      "tailwind-inject",
       "export-to-window"
     ]
   }
 };
+const EDIT_MODE_ONLY = new Set([
+  "save-core",
+  "save-system",
+  "autosave",
+  "unsaved-warning",
+  "save-toast",
+  "edit-mode-helpers",
+  "persist",
+  "snapshot",
+  "sortable",
+  "onaftersave",
+  "cache-bust",
+  "file-upload",
+  "live-sync",
+  "tailwind-inject"
+]);
 
 // Parse URL (use import.meta.url for ES modules since document.currentScript is null)
 const url = new URL(import.meta.url);
@@ -167,6 +185,17 @@ if (exclude) {
   requested = requested.filter(f => !excluded.has(f));
 }
 
+// view-mode-excludes-edit-modules: skip edit-only modules when not in edit mode
+const viewModeExcludesEdit = requested.includes('view-mode-excludes-edit-modules');
+if (viewModeExcludesEdit) {
+  requested = requested.filter(f => f !== 'view-mode-excludes-edit-modules');
+  const { isEditMode } = await import('./core/isAdminOfCurrentResource.js');
+  if (!isEditMode) {
+    requested = requested.filter(f => !EDIT_MODE_ONLY.has(f));
+    if (debug) console.log('HyperclayJS: View mode - excluding edit-only modules');
+  }
+}
+
 // Modules that extend prototypes must load before modules that execute user code
 const LOAD_FIRST = new Set(['dom-helpers', 'all-js']);
 

package/src/module-dependency-graph.json

@@ -1,953 +0,0 @@
-{
-  "rawDependencies": {
-    "communication/behaviorCollector.js": [],
-    "communication/live-sync.js": [],
-    "communication/sendMessage.js": [
-      "communication/behaviorCollector.js",
-      "dom-utilities/getDataFromForm.js",
-      "ui/toast.js"
-    ],
-    "communication/uploadFile.js": [
-      "string-utilities/copy-to-clipboard.js",
-      "ui/toast.js",
-      "utilities/debounce.js"
-    ],
-    "core/adminContenteditable.js": [
-      "core/isAdminOfCurrentResource.js",
-      "core/savePage.js",
-      "dom-utilities/onDomReady.js"
-    ],
-    "core/adminInputs.js": [
-      "core/isAdminOfCurrentResource.js",
-      "core/savePage.js",
-      "dom-utilities/onDomReady.js"
-    ],
-    "core/adminOnClick.js": [
-      "core/isAdminOfCurrentResource.js",
-      "core/savePage.js",
-      "dom-utilities/onDomReady.js"
-    ],
-    "core/adminResources.js": [
-      "core/isAdminOfCurrentResource.js",
-      "core/savePage.js",
-      "dom-utilities/onDomReady.js"
-    ],
-    "core/adminSystem.js": [
-      "core/adminContenteditable.js",
-      "core/adminInputs.js",
-      "core/adminOnClick.js",
-      "core/adminResources.js"
-    ],
-    "core/autosave.js": [
-      "core/isAdminOfCurrentResource.js",
-      "core/savePage.js",
-      "utilities/mutation.js"
-    ],
-    "core/editmode.js": [
-      "core/isAdminOfCurrentResource.js"
-    ],
-    "core/editmodeSystem.js": [
-      "core/editmode.js",
-      "core/isAdminOfCurrentResource.js",
-      "core/setPageTypeOnDocumentElement.js"
-    ],
-    "core/enablePersistentFormInputValues.js": [
-      "core/snapshot.js"
-    ],
-    "core/exportToWindow.js": [],
-    "core/isAdminOfCurrentResource.js": [
-      "string-utilities/query.js",
-      "utilities/cookie.js"
-    ],
-    "core/optionVisibility.js": [
-      "dom-utilities/insertStyleTag.js",
-      "utilities/mutation.js"
-    ],
-    "core/savePage.js": [
-      "core/isAdminOfCurrentResource.js",
-      "core/savePageCore.js",
-      "utilities/throttle.js"
-    ],
-    "core/savePageCore.js": [
-      "core/isAdminOfCurrentResource.js",
-      "core/snapshot.js",
-      "utilities/cookie.js"
-    ],
-    "core/saveToast.js": [
-      "core/isAdminOfCurrentResource.js",
-      "ui/toast.js"
-    ],
-    "core/setPageTypeOnDocumentElement.js": [
-      "core/isAdminOfCurrentResource.js",
-      "core/savePage.js",
-      "dom-utilities/onDomReady.js"
-    ],
-    "core/snapshot.js": [],
-    "core/unsavedWarning.js": [
-      "core/isAdminOfCurrentResource.js",
-      "core/savePage.js"
-    ],
-    "custom-attributes/ajaxElements.js": [
-      "dom-utilities/getDataFromForm.js"
-    ],
-    "custom-attributes/autosize.js": [],
-    "custom-attributes/domHelpers.js": [
-      "utilities/nearest.js",
-      "utilities/pipe.js"
-    ],
-    "custom-attributes/events.js": [
-      "custom-attributes/onclickaway.js",
-      "custom-attributes/onclone.js",
-      "custom-attributes/onmutation.js",
-      "custom-attributes/onpagemutation.js",
-      "custom-attributes/onrender.js"
-    ],
-    "custom-attributes/inputHelpers.js": [
-      "custom-attributes/autosize.js",
-      "custom-attributes/preventEnter.js"
-    ],
-    "custom-attributes/onaftersave.js": [],
-    "custom-attributes/onclickaway.js": [],
-    "custom-attributes/onclone.js": [],
-    "custom-attributes/onmutation.js": [
-      "utilities/mutation.js"
-    ],
-    "custom-attributes/onpagemutation.js": [
-      "utilities/mutation.js"
-    ],
-    "custom-attributes/onrender.js": [
-      "dom-utilities/onLoad.js",
-      "utilities/mutation.js"
-    ],
-    "custom-attributes/preventEnter.js": [],
-    "custom-attributes/sortable.js": [
-      "core/isAdminOfCurrentResource.js",
-      "utilities/loadVendorScript.js",
-      "utilities/mutation.js"
-    ],
-    "dom-utilities/All.js": [],
-    "dom-utilities/getDataFromForm.js": [],
-    "dom-utilities/insertStyleTag.js": [],
-    "dom-utilities/onDomReady.js": [],
-    "dom-utilities/onLoad.js": [],
-    "hyperclay.js": [],
-    "string-utilities/copy-to-clipboard.js": [],
-    "string-utilities/query.js": [],
-    "string-utilities/slugify.js": [],
-    "ui/prompts.js": [
-      "dom-utilities/onDomReady.js",
-      "string-utilities/copy-to-clipboard.js",
-      "ui/theModal.js",
-      "ui/toast.js"
-    ],
-    "ui/theModal.js": [],
-    "ui/toast-hyperclay.js": [
-      "ui/toast.js"
-    ],
-    "ui/toast.js": [],
-    "utilities/cacheBust.js": [],
-    "utilities/cookie.js": [],
-    "utilities/debounce.js": [],
-    "utilities/loadVendorScript.js": [],
-    "utilities/mutation.js": [],
-    "utilities/nearest.js": [],
-    "utilities/pipe.js": [],
-    "utilities/throttle.js": [],
-    "vendor/Sortable.vendor.js": [],
-    "vendor/idiomorph.min.js": []
-  },
-  "modules": {
-    "save-core": {
-      "name": "save-core",
-      "category": "core",
-      "size": 6.8,
-      "files": [
-        "core/savePageCore.js"
-      ],
-      "description": "Basic save function only - hyperclay.savePage()",
-      "exports": {
-        "savePage": [
-          "hyperclay"
-        ]
-      }
-    },
-    "save-system": {
-      "name": "save-system",
-      "category": "core",
-      "size": 7.1,
-      "files": [
-        "core/savePage.js"
-      ],
-      "description": "Manual save: keyboard shortcut (CMD+S), save button, change tracking",
-      "exports": {
-        "beforeSave": [
-          "hyperclay"
-        ],
-        "savePage": [
-          "hyperclay"
-        ],
-        "savePageThrottled": [
-          "hyperclay"
-        ],
-        "replacePageWith": [
-          "hyperclay"
-        ]
-      }
-    },
-    "autosave": {
-      "name": "autosave",
-      "category": "core",
-      "size": 0.9,
-      "files": [
-        "core/autosave.js"
-      ],
-      "description": "Auto-save on DOM changes",
-      "exports": {}
-    },
-    "unsaved-warning": {
-      "name": "unsaved-warning",
-      "category": "core",
-      "size": 0.8,
-      "files": [
-        "core/unsavedWarning.js"
-      ],
-      "description": "Warn before leaving page with unsaved changes",
-      "exports": {}
-    },
-    "save-toast": {
-      "name": "save-toast",
-      "category": "core",
-      "size": 0.9,
-      "files": [
-        "core/saveToast.js"
-      ],
-      "description": "Toast notifications for save events",
-      "exports": {}
-    },
-    "edit-mode-helpers": {
-      "name": "edit-mode-helpers",
-      "category": "core",
-      "size": 7.500000000000001,
-      "files": [
-        "core/adminSystem.js",
-        "core/adminContenteditable.js",
-        "core/adminInputs.js",
-        "core/adminOnClick.js",
-        "core/adminResources.js"
-      ],
-      "description": "Admin-only functionality: [edit-mode-input], [edit-mode-resource], [edit-mode-onclick]",
-      "exports": {}
-    },
-    "persist": {
-      "name": "persist",
-      "category": "core",
-      "size": 2.4,
-      "files": [
-        "core/enablePersistentFormInputValues.js"
-      ],
-      "description": "Persist input/select/textarea values to the DOM with [persist] attribute",
-      "exports": {}
-    },
-    "snapshot": {
-      "name": "snapshot",
-      "category": "core",
-      "size": 7.5,
-      "files": [
-        "core/snapshot.js"
-      ],
-      "description": "Source of truth for page state - captures DOM snapshots for save and sync",
-      "exports": {
-        "captureSnapshot": [
-          "hyperclay"
-        ],
-        "captureForSave": [
-          "hyperclay"
-        ],
-        "captureBodyForSync": [
-          "hyperclay"
-        ],
-        "onSnapshot": [
-          "hyperclay"
-        ],
-        "onPrepareForSave": [
-          "hyperclay"
-        ],
-        "beforeSave": [
-          "hyperclay"
-        ],
-        "getPageContents": [
-          "hyperclay"
-        ]
-      }
-    },
-    "option-visibility": {
-      "name": "option-visibility",
-      "category": "core",
-      "size": 5.3,
-      "files": [
-        "core/optionVisibility.js"
-      ],
-      "description": "Dynamic show/hide based on ancestor state with option:attribute=\"value\"",
-      "exports": {}
-    },
-    "edit-mode": {
-      "name": "edit-mode",
-      "category": "core",
-      "size": 1.8,
-      "files": [
-        "core/editmodeSystem.js",
-        "core/editmode.js",
-        "core/setPageTypeOnDocumentElement.js"
-      ],
-      "description": "Toggle edit mode on hyperclay on/off",
-      "exports": {
-        "toggleEditMode": [
-          "hyperclay"
-        ],
-        "isEditMode": [
-          "hyperclay"
-        ],
-        "isOwner": [
-          "hyperclay"
-        ]
-      }
-    },
-    "event-attrs": {
-      "name": "event-attrs",
-      "category": "custom-attributes",
-      "size": 4.1000000000000005,
-      "files": [
-        "custom-attributes/events.js",
-        "custom-attributes/onclickaway.js",
-        "custom-attributes/onclone.js",
-        "custom-attributes/onpagemutation.js",
-        "custom-attributes/onrender.js"
-      ],
-      "description": "[onclickaway], [onclone], [onpagemutation], [onrender]",
-      "exports": {}
-    },
-    "ajax-elements": {
-      "name": "ajax-elements",
-      "category": "custom-attributes",
-      "size": 2.6,
-      "files": [
-        "custom-attributes/ajaxElements.js"
-      ],
-      "description": "[ajax-form], [ajax-button] for async form submissions",
-      "exports": {}
-    },
-    "sortable": {
-      "name": "sortable",
-      "category": "custom-attributes",
-      "size": 3.4,
-      "files": [
-        "custom-attributes/sortable.js"
-      ],
-      "description": "Drag-drop sorting with [sortable], lazy-loads ~118KB Sortable.js in edit mode",
-      "exports": {}
-    },
-    "dom-helpers": {
-      "name": "dom-helpers",
-      "category": "custom-attributes",
-      "size": 6.2,
-      "files": [
-        "custom-attributes/domHelpers.js"
-      ],
-      "description": "el.nearest, el.val, el.text, el.exec, el.cycle",
-      "exports": {}
-    },
-    "input-helpers": {
-      "name": "input-helpers",
-      "category": "custom-attributes",
-      "size": 1.2,
-      "files": [
-        "custom-attributes/inputHelpers.js",
-        "custom-attributes/preventEnter.js",
-        "custom-attributes/autosize.js"
-      ],
-      "description": "[prevent-enter], [autosize] for textareas",
-      "exports": {}
-    },
-    "onaftersave": {
-      "name": "onaftersave",
-      "category": "custom-attributes",
-      "size": 1,
-      "files": [
-        "custom-attributes/onaftersave.js"
-      ],
-      "description": "[onaftersave] attribute - run JS when save status changes",
-      "exports": {}
-    },
-    "dialogs": {
-      "name": "dialogs",
-      "category": "ui",
-      "size": 7.7,
-      "files": [
-        "ui/prompts.js"
-      ],
-      "description": "ask(), consent(), tell(), snippet() dialog functions",
-      "exports": {
-        "ask": [
-          "window",
-          "hyperclay"
-        ],
-        "consent": [
-          "window",
-          "hyperclay"
-        ],
-        "tell": [
-          "window",
-          "hyperclay"
-        ],
-        "snippet": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "toast": {
-      "name": "toast",
-      "category": "ui",
-      "size": 7.7,
-      "files": [
-        "ui/toast.js"
-      ],
-      "description": "Success/error message notifications, toast(msg, msgType)",
-      "exports": {
-        "toast": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "toast-hyperclay": {
-      "name": "toast-hyperclay",
-      "category": "ui",
-      "size": 1,
-      "files": [
-        "ui/toast-hyperclay.js"
-      ],
-      "description": "toastHyperclay() with legacy Hyperclay platform styling (hidden feature)",
-      "exports": {
-        "toastHyperclay": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "the-modal": {
-      "name": "the-modal",
-      "category": "ui",
-      "size": 21.8,
-      "files": [
-        "ui/theModal.js"
-      ],
-      "description": "Full modal window creation system - window.theModal",
-      "exports": {
-        "themodal": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "mutation": {
-      "name": "mutation",
-      "category": "utilities",
-      "size": 13,
-      "files": [
-        "utilities/mutation.js"
-      ],
-      "description": "DOM mutation observation (often auto-included)",
-      "exports": {
-        "Mutation": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "nearest": {
-      "name": "nearest",
-      "category": "utilities",
-      "size": 3.4,
-      "files": [
-        "utilities/nearest.js"
-      ],
-      "description": "Find nearest elements (often auto-included)",
-      "exports": {
-        "nearest": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "cookie": {
-      "name": "cookie",
-      "category": "utilities",
-      "size": 1.4,
-      "files": [
-        "utilities/cookie.js"
-      ],
-      "description": "Cookie management (often auto-included)",
-      "exports": {
-        "cookie": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "throttle": {
-      "name": "throttle",
-      "category": "utilities",
-      "size": 0.8,
-      "files": [
-        "utilities/throttle.js"
-      ],
-      "description": "Function throttling",
-      "exports": {
-        "throttle": [
-          "hyperclay"
-        ]
-      }
-    },
-    "debounce": {
-      "name": "debounce",
-      "category": "utilities",
-      "size": 0.4,
-      "files": [
-        "utilities/debounce.js"
-      ],
-      "description": "Function debouncing",
-      "exports": {
-        "debounce": [
-          "hyperclay"
-        ]
-      }
-    },
-    "cache-bust": {
-      "name": "cache-bust",
-      "category": "utilities",
-      "size": 0.6,
-      "files": [
-        "utilities/cacheBust.js"
-      ],
-      "description": "Cache-bust href/src attributes",
-      "exports": {
-        "cacheBust": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "dom-ready": {
-      "name": "dom-ready",
-      "category": "dom-utilities",
-      "size": 0.4,
-      "files": [
-        "dom-utilities/onDomReady.js"
-      ],
-      "description": "DOM ready callback",
-      "exports": {
-        "onDomReady": [
-          "hyperclay"
-        ]
-      }
-    },
-    "window-load": {
-      "name": "window-load",
-      "category": "dom-utilities",
-      "size": 0.4,
-      "files": [
-        "dom-utilities/onLoad.js"
-      ],
-      "description": "Window load callback",
-      "exports": {
-        "onLoad": [
-          "hyperclay"
-        ]
-      }
-    },
-    "all-js": {
-      "name": "all-js",
-      "category": "dom-utilities",
-      "size": 14.4,
-      "files": [
-        "dom-utilities/All.js"
-      ],
-      "description": "Full DOM manipulation library",
-      "exports": {
-        "All": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "style-injection": {
-      "name": "style-injection",
-      "category": "dom-utilities",
-      "size": 1.9,
-      "files": [
-        "dom-utilities/insertStyleTag.js"
-      ],
-      "description": "Dynamic stylesheet injection",
-      "exports": {
-        "insertStyles": [
-          "window",
-          "hyperclay"
-        ],
-        "insertStyleTag": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "form-data": {
-      "name": "form-data",
-      "category": "dom-utilities",
-      "size": 2,
-      "files": [
-        "dom-utilities/getDataFromForm.js"
-      ],
-      "description": "Extract form data as an object",
-      "exports": {
-        "getDataFromForm": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "idiomorph": {
-      "name": "idiomorph",
-      "category": "vendor",
-      "size": 8.3,
-      "files": [
-        "vendor/idiomorph.min.js"
-      ],
-      "description": "Efficient DOM morphing library",
-      "exports": {
-        "Idiomorph": [
-          "hyperclay"
-        ]
-      }
-    },
-    "slugify": {
-      "name": "slugify",
-      "category": "string-utilities",
-      "size": 0.7,
-      "files": [
-        "string-utilities/slugify.js"
-      ],
-      "description": "URL-friendly slug generator",
-      "exports": {
-        "slugify": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "copy-to-clipboard": {
-      "name": "copy-to-clipboard",
-      "category": "string-utilities",
-      "size": 0.9,
-      "files": [
-        "string-utilities/copy-to-clipboard.js"
-      ],
-      "description": "Clipboard utility",
-      "exports": {
-        "copyToClipboard": [
-          "hyperclay"
-        ]
-      }
-    },
-    "query-params": {
-      "name": "query-params",
-      "category": "string-utilities",
-      "size": 0.3,
-      "files": [
-        "string-utilities/query.js"
-      ],
-      "description": "Parse URL search params",
-      "exports": {
-        "query": [
-          "window",
-          "hyperclay"
-        ]
-      }
-    },
-    "behavior-collector": {
-      "name": "behavior-collector",
-      "category": "communication",
-      "size": 5.5,
-      "files": [
-        "communication/behaviorCollector.js"
-      ],
-      "description": "Tracks user interactions (mouse, scroll, keyboard)",
-      "exports": {
-        "behaviorCollector": [
-          "hyperclay"
-        ]
-      }
-    },
-    "send-message": {
-      "name": "send-message",
-      "category": "communication",
-      "size": 1.3,
-      "files": [
-        "communication/sendMessage.js"
-      ],
-      "description": "Message sending utility",
-      "exports": {
-        "sendMessage": [
-          "hyperclay"
-        ]
-      }
-    },
-    "file-upload": {
-      "name": "file-upload",
-      "category": "communication",
-      "size": 10.7,
-      "files": [
-        "communication/uploadFile.js"
-      ],
-      "description": "File upload with progress",
-      "exports": {
-        "uploadFile": [
-          "hyperclay"
-        ],
-        "createFile": [
-          "hyperclay"
-        ],
-        "uploadFileBasic": [
-          "hyperclay"
-        ]
-      }
-    },
-    "live-sync": {
-      "name": "live-sync",
-      "category": "communication",
-      "size": 12,
-      "files": [
-        "communication/live-sync.js"
-      ],
-      "description": "Real-time DOM sync across browsers and with file system",
-      "exports": {
-        "liveSync": [
-          "hyperclay"
-        ]
-      }
-    },
-    "export-to-window": {
-      "name": "export-to-window",
-      "category": "core",
-      "size": 0.4,
-      "files": [
-        "core/exportToWindow.js"
-      ],
-      "description": "Export all modules to window.hyperclay and window globals",
-      "exports": {}
-    }
-  },
-  "modulePaths": {
-    "save-core": "./core/savePageCore.js",
-    "save-system": "./core/savePage.js",
-    "autosave": "./core/autosave.js",
-    "unsaved-warning": "./core/unsavedWarning.js",
-    "save-toast": "./core/saveToast.js",
-    "edit-mode-helpers": "./core/adminSystem.js",
-    "persist": "./core/enablePersistentFormInputValues.js",
-    "snapshot": "./core/snapshot.js",
-    "option-visibility": "./core/optionVisibility.js",
-    "edit-mode": "./core/editmodeSystem.js",
-    "event-attrs": "./custom-attributes/events.js",
-    "ajax-elements": "./custom-attributes/ajaxElements.js",
-    "sortable": "./custom-attributes/sortable.js",
-    "dom-helpers": "./custom-attributes/domHelpers.js",
-    "input-helpers": "./custom-attributes/inputHelpers.js",
-    "onaftersave": "./custom-attributes/onaftersave.js",
-    "dialogs": "./ui/prompts.js",
-    "toast": "./ui/toast.js",
-    "toast-hyperclay": "./ui/toast-hyperclay.js",
-    "the-modal": "./ui/theModal.js",
-    "mutation": "./utilities/mutation.js",
-    "nearest": "./utilities/nearest.js",
-    "cookie": "./utilities/cookie.js",
-    "throttle": "./utilities/throttle.js",
-    "debounce": "./utilities/debounce.js",
-    "cache-bust": "./utilities/cacheBust.js",
-    "dom-ready": "./dom-utilities/onDomReady.js",
-    "window-load": "./dom-utilities/onLoad.js",
-    "all-js": "./dom-utilities/All.js",
-    "style-injection": "./dom-utilities/insertStyleTag.js",
-    "form-data": "./dom-utilities/getDataFromForm.js",
-    "idiomorph": "./vendor/idiomorph.min.js",
-    "slugify": "./string-utilities/slugify.js",
-    "copy-to-clipboard": "./string-utilities/copy-to-clipboard.js",
-    "query-params": "./string-utilities/query.js",
-    "behavior-collector": "./communication/behaviorCollector.js",
-    "send-message": "./communication/sendMessage.js",
-    "file-upload": "./communication/uploadFile.js",
-    "live-sync": "./communication/live-sync.js",
-    "export-to-window": "./core/exportToWindow.js"
-  },
-  "categories": {
-    "core": {
-      "name": "Core Features",
-      "description": "Essential functionality",
-      "modules": [
-        "save-core",
-        "save-system",
-        "autosave",
-        "unsaved-warning",
-        "save-toast",
-        "edit-mode-helpers",
-        "persist",
-        "snapshot",
-        "option-visibility",
-        "edit-mode"
-      ]
-    },
-    "custom-attributes": {
-      "name": "Custom Attributes",
-      "description": "HTML enhancements",
-      "modules": [
-        "event-attrs",
-        "ajax-elements",
-        "sortable",
-        "dom-helpers",
-        "input-helpers",
-        "onaftersave"
-      ]
-    },
-    "ui": {
-      "name": "UI Components",
-      "description": "User interface elements",
-      "modules": [
-        "dialogs",
-        "toast",
-        "the-modal"
-      ]
-    },
-    "utilities": {
-      "name": "Utilities",
-      "description": "Core utilities (often auto-included)",
-      "modules": [
-        "mutation",
-        "nearest",
-        "cookie",
-        "throttle",
-        "debounce",
-        "cache-bust"
-      ]
-    },
-    "dom-utilities": {
-      "name": "DOM Utilities",
-      "description": "DOM manipulation helpers",
-      "modules": [
-        "dom-ready",
-        "all-js",
-        "style-injection",
-        "form-data"
-      ]
-    },
-    "string-utilities": {
-      "name": "String Utilities",
-      "description": "String manipulation helpers",
-      "modules": [
-        "slugify",
-        "copy-to-clipboard",
-        "query-params"
-      ]
-    },
-    "communication": {
-      "name": "Communication & Files",
-      "description": "File handling and messaging",
-      "modules": [
-        "send-message",
-        "file-upload",
-        "live-sync"
-      ]
-    },
-    "vendor": {
-      "name": "Vendor Libraries",
-      "description": "Third-party libraries",
-      "modules": [
-        "idiomorph"
-      ]
-    }
-  },
-  "presets": {
-    "minimal": {
-      "name": "Minimal",
-      "description": "Essential features for basic editing",
-      "modules": [
-        "save-core",
-        "save-system",
-        "edit-mode-helpers",
-        "toast",
-        "save-toast",
-        "export-to-window"
-      ]
-    },
-    "standard": {
-      "name": "Standard",
-      "description": "Standard feature set for most use cases",
-      "modules": [
-        "save-core",
-        "save-system",
-        "edit-mode-helpers",
-        "persist",
-        "option-visibility",
-        "event-attrs",
-        "dom-helpers",
-        "toast",
-        "save-toast",
-        "export-to-window"
-      ]
-    },
-    "everything": {
-      "name": "Everything",
-      "description": "All available features",
-      "modules": [
-        "save-core",
-        "save-system",
-        "autosave",
-        "unsaved-warning",
-        "save-toast",
-        "edit-mode-helpers",
-        "persist",
-        "snapshot",
-        "option-visibility",
-        "edit-mode",
-        "event-attrs",
-        "ajax-elements",
-        "sortable",
-        "dom-helpers",
-        "input-helpers",
-        "onaftersave",
-        "dialogs",
-        "toast",
-        "toast-hyperclay",
-        "the-modal",
-        "mutation",
-        "nearest",
-        "cookie",
-        "throttle",
-        "debounce",
-        "cache-bust",
-        "dom-ready",
-        "window-load",
-        "all-js",
-        "style-injection",
-        "form-data",
-        "idiomorph",
-        "slugify",
-        "copy-to-clipboard",
-        "query-params",
-        "behavior-collector",
-        "send-message",
-        "file-upload",
-        "live-sync",
-        "export-to-window"
-      ]
-    }
-  }
-}