hyperclayjs 1.10.0 → 1.11.0

package/README.md

@@ -66,6 +66,7 @@ import 'hyperclayjs/presets/standard.js';
 | 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)
 
@@ -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 (~177.2KB)
+### 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.10.0",
+  "version": "1.11.0",
   "description": "Modular JavaScript library for building interactive HTML applications with Hyperclay",
   "type": "module",
   "main": "src/hyperclay.js",

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.10.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": "CMD+S, [trigger-save] button, savestatus attribute",
-      "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.7,
-      "files": [
-        "communication/live-sync.js"
-      ],
-      "description": "Real-time DOM sync across browsers",
-      "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"
-      ]
-    }
-  }
-}