hyperclayjs 1.3.1 → 1.4.0

package/dom-utilities/All.js

@@ -403,9 +403,12 @@ const All = new Proxy(function (selectorOrElements, contextSelector) {
 // Install default plugins
 All.use(defaultPlugins);
 
-// Self-export to window and hyperclay
-window.All = All;
-window.hyperclay = window.hyperclay || {};
-window.hyperclay.All = All;
-
-export default All;
+// Auto-export to window unless suppressed by loader
+if (!window.__hyperclayNoAutoExport) {
+  window.All = All;
+  window.hyperclay = window.hyperclay || {};
+  window.hyperclay.All = All;
+  window.h = window.hyperclay;
+}
+
+export default All;

package/dom-utilities/getDataFromForm.js

@@ -59,9 +59,12 @@ function getDataFromForm(container) {
   return formData;
 }
 
-// Self-export to window and hyperclay
-window.getDataFromForm = getDataFromForm;
-window.hyperclay = window.hyperclay || {};
-window.hyperclay.getDataFromForm = getDataFromForm;
+// Auto-export to window unless suppressed by loader
+if (!window.__hyperclayNoAutoExport) {
+  window.getDataFromForm = getDataFromForm;
+  window.hyperclay = window.hyperclay || {};
+  window.hyperclay.getDataFromForm = getDataFromForm;
+  window.h = window.hyperclay;
+}
 
-export default getDataFromForm;
+export default getDataFromForm;

package/dom-utilities/insertStyleTag.js

@@ -27,9 +27,12 @@ function insertStyleTag(href) {
   document.head.appendChild(link);
 }
 
-// Self-export to window and hyperclay
-window.insertStyleTag = insertStyleTag;
-window.hyperclay = window.hyperclay || {};
-window.hyperclay.insertStyleTag = insertStyleTag;
+// Auto-export to window unless suppressed by loader
+if (!window.__hyperclayNoAutoExport) {
+  window.insertStyleTag = insertStyleTag;
+  window.hyperclay = window.hyperclay || {};
+  window.hyperclay.insertStyleTag = insertStyleTag;
+  window.h = window.hyperclay;
+}
 
-export default insertStyleTag;
+export default insertStyleTag;

package/dom-utilities/onDomReady.js

@@ -6,8 +6,11 @@ function onDomReady (callback) {
   }
 }
 
-// Self-export to hyperclay only
-window.hyperclay = window.hyperclay || {};
-window.hyperclay.onDomReady = onDomReady;
+// Auto-export to window unless suppressed by loader
+if (!window.__hyperclayNoAutoExport) {
+  window.hyperclay = window.hyperclay || {};
+  window.hyperclay.onDomReady = onDomReady;
+  window.h = window.hyperclay;
+}
 
-export default onDomReady;
+export default onDomReady;

package/dom-utilities/onLoad.js

@@ -6,8 +6,11 @@ function onLoad (callback) {
   }
 }
 
-// Self-export to hyperclay only
-window.hyperclay = window.hyperclay || {};
-window.hyperclay.onLoad = onLoad;
+// Auto-export to window unless suppressed by loader
+if (!window.__hyperclayNoAutoExport) {
+  window.hyperclay = window.hyperclay || {};
+  window.hyperclay.onLoad = onLoad;
+  window.h = window.hyperclay;
+}
 
-export default onLoad;
+export default onLoad;

package/hyperclay.js

@@ -1,28 +1,34 @@
 /**
- * HyperclayJS v1.3.1 - Minimal Browser-Native Loader
+ * HyperclayJS v1.4.0 - Minimal Browser-Native Loader
  *
- * Modules self-export to window.hyperclay when imported.
  * Modules auto-init when imported (no separate init call needed).
- * Uses top-level await so subsequent module scripts automatically wait.
+ * Include `export-to-window` feature to export to window.hyperclay.
  *
- * <!-- Load with a preset -->
- * <script src="https://cdn.jsdelivr.net/npm/hyperclayjs@1/hyperclay.js?preset=minimal" type="module"></script>
- * <!-- Load specific features -->
- * <script src="https://cdn.jsdelivr.net/npm/hyperclayjs@1/hyperclay.js?features=save,admin,toast" type="module"></script>
- * <!-- Load preset with exclusions -->
- * <script src="https://cdn.jsdelivr.net/npm/hyperclayjs@1/hyperclay.js?preset=everything&exclude=tailwind-play,behavior-collector" type="module"></script>
+ * Usage (use await import to ensure modules finish loading):
+ *
+ * <script type="module">
+ *   // With window.hyperclay (default presets include export-to-window):
+ *   await import('https://cdn.jsdelivr.net/npm/hyperclayjs@1/hyperclay.js?preset=minimal');
+ *   const { toast, savePage } = window.hyperclay;
+ *
+ *   // ES modules only (exclude export-to-window):
+ *   const hyperclay = await import('https://cdn.jsdelivr.net/npm/hyperclayjs@1/hyperclay.js?preset=minimal&exclude=export-to-window');
+ *   const modules = window.hyperclayModules;
+ * </script>
  *
  * AUTO-GENERATED FILE - Do not edit directly
  */
 
-window.hyperclay = window.hyperclay || {};
 window.hyperclayModules = window.hyperclayModules || {};
 
+// Suppress auto-export in modules - export-to-window will flip this to false
+window.__hyperclayNoAutoExport = true;
+
 const MODULE_PATHS = {
   "save-core": "./core/savePageCore.js",
   "save-system": "./core/savePage.js",
   "autosave": "./core/autosave.js",
-  "admin": "./core/adminSystem.js",
+  "edit-mode-helpers": "./core/adminSystem.js",
   "persist": "./core/enablePersistentFormInputValues.js",
   "option-visibility": "./core/optionVisibilityRuleGenerator.js",
   "edit-mode": "./core/editmodeSystem.js",
@@ -34,7 +40,7 @@ const MODULE_PATHS = {
   "dialogs": "./ui/prompts.js",
   "toast": "./ui/toast.js",
   "toast-hyperclay": "./ui/toast-hyperclay.js",
-  "modal": "./ui/theModal.js",
+  "the-modal": "./ui/theModal.js",
   "tailwind-play": "./vendor/tailwind-play.js",
   "mutation": "./utilities/mutation.js",
   "nearest": "./utilities/nearest.js",
@@ -48,12 +54,12 @@ const MODULE_PATHS = {
   "form-data": "./dom-utilities/getDataFromForm.js",
   "idiomorph": "./vendor/idiomorph.min.js",
   "slugify": "./string-utilities/slugify.js",
-  "emmet": "./string-utilities/emmet-html.js",
-  "clipboard": "./string-utilities/copy-to-clipboard.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"
+  "file-upload": "./communication/uploadFile.js",
+  "export-to-window": "./core/exportToWindow.js"
 };
 const PRESETS = {
   "minimal": {
@@ -62,8 +68,9 @@ const PRESETS = {
     "modules": [
       "save-core",
       "save-system",
-      "admin",
-      "toast"
+      "edit-mode-helpers",
+      "toast",
+      "export-to-window"
     ]
   },
   "standard": {
@@ -72,12 +79,13 @@ const PRESETS = {
     "modules": [
       "save-core",
       "save-system",
-      "admin",
+      "edit-mode-helpers",
       "persist",
       "option-visibility",
       "event-attrs",
       "dom-helpers",
-      "toast"
+      "toast",
+      "export-to-window"
     ]
   },
   "everything": {
@@ -87,7 +95,7 @@ const PRESETS = {
       "save-core",
       "save-system",
       "autosave",
-      "admin",
+      "edit-mode-helpers",
       "persist",
       "option-visibility",
       "edit-mode",
@@ -99,7 +107,7 @@ const PRESETS = {
       "dialogs",
       "toast",
       "toast-hyperclay",
-      "modal",
+      "the-modal",
       "tailwind-play",
       "mutation",
       "nearest",
@@ -113,12 +121,12 @@ const PRESETS = {
       "form-data",
       "idiomorph",
       "slugify",
-      "emmet",
-      "clipboard",
+      "copy-to-clipboard",
       "query-params",
       "behavior-collector",
       "send-message",
-      "file-upload"
+      "file-upload",
+      "export-to-window"
     ]
   }
 };
@@ -150,6 +158,9 @@ if (exclude) {
 // Modules that extend prototypes must load before modules that execute user code
 const LOAD_FIRST = new Set(['dom-helpers', 'all-js']);
 
+// export-to-window flips the flag, so it must load before other modules
+const LOAD_BEFORE_ALL = 'export-to-window';
+
 const loadModules = (modules) => Promise.all(modules.map(async feature => {
   const path = MODULE_PATHS[feature];
   if (!path) throw new Error(`Unknown feature: ${feature}`);
@@ -160,14 +171,62 @@ const loadModules = (modules) => Promise.all(modules.map(async feature => {
 
 if (debug) console.log('HyperclayJS: Loading features:', requested);
 
-// Load in waves: prototype extenders first, then everything else
-const first = requested.filter(f => LOAD_FIRST.has(f));
-const rest = requested.filter(f => !LOAD_FIRST.has(f));
+// Separate export-to-window - it must load FIRST to flip the flag
+const shouldExportToWindow = requested.includes(LOAD_BEFORE_ALL);
+const modulesToLoad = requested.filter(f => f !== LOAD_BEFORE_ALL);
 
-if (first.length) await loadModules(first);
-if (rest.length) await loadModules(rest);
+// Load in waves: export-to-window first, then prototype extenders, then everything else
+const first = modulesToLoad.filter(f => LOAD_FIRST.has(f));
+const rest = modulesToLoad.filter(f => !LOAD_FIRST.has(f));
 
-// Create h alias
-window.h = window.hyperclay;
+try {
+  // Load export-to-window FIRST to flip the flag before other modules load
+  if (shouldExportToWindow) {
+    if (debug) console.log('HyperclayJS: Enabling window exports...');
+    const exportModule = await import(`${baseUrl}/${MODULE_PATHS[LOAD_BEFORE_ALL]}`);
+    window.hyperclayModules[LOAD_BEFORE_ALL] = exportModule;
+  }
+
+  if (first.length) await loadModules(first);
+  if (rest.length) await loadModules(rest);
+} catch (err) {
+  console.error('HyperclayJS: Failed to load modules:', err);
+  throw err;
+}
 
 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 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 toggleEditMode = window.hyperclayModules['edit-mode']?.toggleEditMode ?? window.hyperclayModules['edit-mode']?.default;
+export const isEditMode = window.hyperclayModules['edit-mode']?.isEditMode ?? window.hyperclayModules['edit-mode']?.default;
+export const isOwner = window.hyperclayModules['edit-mode']?.isOwner ?? window.hyperclayModules['edit-mode']?.default;
+export const ask = window.hyperclayModules['dialogs']?.ask ?? window.hyperclayModules['dialogs']?.default;
+export const consent = window.hyperclayModules['dialogs']?.consent ?? window.hyperclayModules['dialogs']?.default;
+export const tell = window.hyperclayModules['dialogs']?.tell ?? window.hyperclayModules['dialogs']?.default;
+export const snippet = window.hyperclayModules['dialogs']?.snippet ?? window.hyperclayModules['dialogs']?.default;
+export const toast = window.hyperclayModules['toast']?.toast ?? window.hyperclayModules['toast']?.default;
+export const toastHyperclay = window.hyperclayModules['toast-hyperclay']?.toastHyperclay ?? window.hyperclayModules['toast-hyperclay']?.default;
+export const themodal = window.hyperclayModules['the-modal']?.themodal ?? window.hyperclayModules['the-modal']?.default;
+export const Mutation = window.hyperclayModules['mutation']?.Mutation ?? window.hyperclayModules['mutation']?.default;
+export const nearest = window.hyperclayModules['nearest']?.nearest ?? window.hyperclayModules['nearest']?.default;
+export const cookie = window.hyperclayModules['cookie']?.cookie ?? window.hyperclayModules['cookie']?.default;
+export const throttle = window.hyperclayModules['throttle']?.throttle ?? window.hyperclayModules['throttle']?.default;
+export const debounce = window.hyperclayModules['debounce']?.debounce ?? window.hyperclayModules['debounce']?.default;
+export const onDomReady = window.hyperclayModules['dom-ready']?.onDomReady ?? window.hyperclayModules['dom-ready']?.default;
+export const onLoad = window.hyperclayModules['window-load']?.onLoad ?? window.hyperclayModules['window-load']?.default;
+export const All = window.hyperclayModules['all-js']?.All ?? window.hyperclayModules['all-js']?.default;
+export const insertStyleTag = window.hyperclayModules['style-injection']?.insertStyleTag ?? window.hyperclayModules['style-injection']?.default;
+export const getDataFromForm = window.hyperclayModules['form-data']?.getDataFromForm ?? window.hyperclayModules['form-data']?.default;
+export const Idiomorph = window.hyperclayModules['idiomorph']?.Idiomorph ?? window.hyperclayModules['idiomorph']?.default;
+export const slugify = window.hyperclayModules['slugify']?.slugify ?? window.hyperclayModules['slugify']?.default;
+export const copyToClipboard = window.hyperclayModules['copy-to-clipboard']?.copyToClipboard ?? window.hyperclayModules['copy-to-clipboard']?.default;
+export const query = window.hyperclayModules['query-params']?.query ?? window.hyperclayModules['query-params']?.default;
+export const behaviorCollector = window.hyperclayModules['behavior-collector']?.behaviorCollector ?? window.hyperclayModules['behavior-collector']?.default;
+export const sendMessage = window.hyperclayModules['send-message']?.sendMessage ?? window.hyperclayModules['send-message']?.default;
+export const uploadFile = window.hyperclayModules['file-upload']?.uploadFile ?? window.hyperclayModules['file-upload']?.default;
+export const createFile = window.hyperclayModules['file-upload']?.createFile ?? window.hyperclayModules['file-upload']?.default;
+export const uploadFileBasic = window.hyperclayModules['file-upload']?.uploadFileBasic ?? window.hyperclayModules['file-upload']?.default;