hyperclayjs 1.1.0 → 1.1.2

package/README.md

@@ -93,7 +93,7 @@ import 'hyperclayjs/presets/standard.js';
 
 | Module | Size | Description |
 |--------|------|-------------|
-| All.js (jQuery-like) | 13.8KB | Full DOM manipulation library |
+| All.js (jQuery-like) | 13.9KB | Full DOM manipulation library |
 | DOM Ready | 0.2KB | DOM ready callback |
 | Get Data From Form | 1.7KB | Extract form data as an object |
 | Style Injection | 0.8KB | Dynamic stylesheet injection |
@@ -134,7 +134,7 @@ Standard feature set for most use cases
 
 **Modules:** `save-core`, `save`, `admin`, `persist`, `ajax`, `events`, `helpers`, `toast`
 
-### Everything (~616.3KB)
+### Everything (~616.4KB)
 All available features
 
 Includes all available modules across all categories.

package/dom-utilities/All.js

@@ -343,13 +343,15 @@ const defaultPlugins = {
 const All = new Proxy(function (selectorOrElements, contextSelector) {
   // If there's a context selector, search within that context
   if (arguments.length === 2) {
-    if (typeof contextSelector !== 'string') {
-      throw new TypeError('Context selector must be a string');
+    // Support both string selectors and element references as context
+    let contextElements;
+    if (typeof contextSelector === 'string') {
+      contextElements = Array.from(document.querySelectorAll(contextSelector));
+    } else {
+      // Convert element/array/document to element array
+      contextElements = toElementArray(contextSelector);
     }
 
-    // Get the context element(s)
-    const contextElements = Array.from(document.querySelectorAll(contextSelector));
-
     // If first arg is a string selector, search within each context
     if (typeof selectorOrElements === 'string') {
       const elements = contextElements.flatMap(context => {

package/hyperclay.js

@@ -25,13 +25,27 @@
 (async function() {
   'use strict';
 
+  // Create a promise that resolves when hyperclay is ready
+  let hyperclayReadyResolve;
+  window.hyperclayReady = new Promise(resolve => {
+    hyperclayReadyResolve = resolve;
+  });
+
+  // Initialize namespaces
+  window.hyperclay = window.hyperclay || {};
+
   // Module dependency map - AUTO-GENERATED
   const moduleDependencies = {
   "save-core": {
     "path": "./core/savePageCore.js",
     "dependencies": [
       "cookie"
-    ]
+    ],
+    "exports": {
+      "savePage": [
+        "hyperclay"
+      ]
+    }
   },
   "save": {
     "path": "./core/savePage.js",
@@ -40,62 +54,120 @@
       "toast",
       "mutation",
       "throttle"
-    ]
+    ],
+    "exports": {
+      "beforeSave": [
+        "hyperclay"
+      ],
+      "savePage": [
+        "hyperclay"
+      ],
+      "replacePageWith": [
+        "hyperclay"
+      ],
+      "initHyperclaySaveButton": [
+        "hyperclay"
+      ],
+      "initSaveKeyboardShortcut": [
+        "hyperclay"
+      ],
+      "initSavePageOnChange": [
+        "hyperclay"
+      ]
+    }
   },
   "admin": {
     "path": "./core/adminSystem.js",
     "dependencies": [
       "save",
       "dom-ready"
-    ]
+    ],
+    "exports": {}
   },
   "persist": {
     "path": "./core/enablePersistentFormInputValues.js",
     "dependencies": [
       "save"
-    ]
+    ],
+    "exports": {
+      "enablePersistentFormInputValues": [
+        "hyperclay"
+      ]
+    }
   },
   "options": {
     "path": "./core/optionVisibilityRuleGenerator.js",
     "dependencies": [
       "mutation"
-    ]
+    ],
+    "exports": {
+      "optionVisibilityRuleGenerator": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "editmode": {
     "path": "./core/editmodeSystem.js",
     "dependencies": [
       "save",
       "dom-ready"
-    ]
+    ],
+    "exports": {
+      "toggleEditMode": [
+        "hyperclay"
+      ],
+      "isEditMode": [
+        "hyperclay"
+      ],
+      "isOwner": [
+        "hyperclay"
+      ]
+    }
   },
   "events": {
     "path": "./custom-attributes/events.js",
     "dependencies": [
       "mutation",
       "window-load"
-    ]
+    ],
+    "exports": {}
   },
   "ajax": {
     "path": "./custom-attributes/ajaxElements.js",
     "dependencies": [
       "get-data-from-form"
-    ]
+    ],
+    "exports": {}
   },
   "sortable": {
     "path": "./custom-attributes/sortable.js",
     "dependencies": [
       "mutation"
-    ]
+    ],
+    "exports": {
+      "Sortable": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "helpers": {
     "path": "./custom-attributes/domHelpers.js",
     "dependencies": [
       "nearest"
-    ]
+    ],
+    "exports": {
+      "initCustomAttributes": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "inputs": {
     "path": "./custom-attributes/inputHelpers.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {}
   },
   "prompts": {
     "path": "./ui/prompts.js",
@@ -104,92 +176,219 @@
       "copy-to-clipboard",
       "modals",
       "toast"
-    ]
+    ],
+    "exports": {
+      "ask": [
+        "window",
+        "hyperclay"
+      ],
+      "consent": [
+        "window",
+        "hyperclay"
+      ],
+      "tell": [
+        "window",
+        "hyperclay"
+      ],
+      "snippet": [
+        "hyperclay"
+      ],
+      "showApiKey": [
+        "hyperclay"
+      ]
+    }
   },
   "toast": {
     "path": "./ui/toast.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "toast": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "modals": {
     "path": "./ui/theModal.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "themodal": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "info": {
     "path": "./ui/info.js",
     "dependencies": [
       "dom-ready",
       "modals"
-    ]
+    ],
+    "exports": {
+      "info": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "tailwind-play": {
     "path": "./vendor/tailwind-play.js",
     "dependencies": [
       "style-injection"
-    ]
+    ],
+    "exports": {}
   },
   "mutation": {
     "path": "./utilities/mutation.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "Mutation": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "nearest": {
     "path": "./utilities/nearest.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "nearest": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "cookie": {
     "path": "./utilities/cookie.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "cookie": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "throttle": {
     "path": "./utilities/throttle.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "throttle": [
+        "hyperclay"
+      ]
+    }
   },
   "debounce": {
     "path": "./utilities/debounce.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "debounce": [
+        "hyperclay"
+      ]
+    }
   },
   "dom-ready": {
     "path": "./dom-utilities/onDomReady.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "onDomReady": [
+        "hyperclay"
+      ]
+    }
   },
   "window-load": {
     "path": "./dom-utilities/onLoad.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "onLoad": [
+        "hyperclay"
+      ]
+    }
   },
-  "jquery-like": {
+  "alljs": {
     "path": "./dom-utilities/All.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "All": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "style-injection": {
     "path": "./dom-utilities/insertStyleTag.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "insertStyleTag": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "get-data-from-form": {
     "path": "./dom-utilities/getDataFromForm.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "getDataFromForm": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "dom-morphing": {
     "path": "./vendor/idiomorph.min.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "Idiomorph": [
+        "hyperclay"
+      ]
+    }
   },
   "slugify": {
     "path": "./string-utilities/slugify.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "slugify": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "emmet-html": {
     "path": "./string-utilities/emmet-html.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "emmet": [
+        "hyperclay"
+      ]
+    }
   },
   "copy-to-clipboard": {
     "path": "./string-utilities/copy-to-clipboard.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "copyToClipboard": [
+        "hyperclay"
+      ]
+    }
   },
   "query-parser": {
     "path": "./string-utilities/query.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "query": [
+        "window",
+        "hyperclay"
+      ]
+    }
   },
   "behavior-collector": {
     "path": "./communication/behaviorCollector.js",
-    "dependencies": []
+    "dependencies": [],
+    "exports": {
+      "behaviorCollector": [
+        "hyperclay"
+      ]
+    }
   },
   "send-message": {
     "path": "./communication/sendMessage.js",
@@ -197,7 +396,12 @@
       "behavior-collector",
       "get-data-from-form",
       "toast"
-    ]
+    ],
+    "exports": {
+      "sendMessage": [
+        "hyperclay"
+      ]
+    }
   },
   "file-upload": {
     "path": "./communication/uploadFile.js",
@@ -205,7 +409,18 @@
       "copy-to-clipboard",
       "toast",
       "debounce"
-    ]
+    ],
+    "exports": {
+      "uploadFile": [
+        "hyperclay"
+      ],
+      "createFile": [
+        "hyperclay"
+      ],
+      "uploadFileBasic": [
+        "hyperclay"
+      ]
+    }
   }
 };
 
@@ -262,7 +477,7 @@
       "debounce",
       "dom-ready",
       "window-load",
-      "jquery-like",
+      "alljs",
       "style-injection",
       "get-data-from-form",
       "dom-morphing",
@@ -387,11 +602,6 @@
         loaded.init();
       }
 
-      // Make module available globally if it exports to window
-      if (loaded.exportToWindow && typeof loaded.exportToWindow === 'function') {
-        loaded.exportToWindow();
-      }
-
       return loaded;
     } catch (error) {
       console.error(`HyperclayJS: Failed to load ${feature}:`, error);
@@ -426,6 +636,39 @@
     // Store loaded modules globally for access
     window.hyperclayModules = loadedModules;
 
+    // Attach exports to window based on module configuration
+    for (const feature of loadOrder) {
+      const module = loadedModules[feature];
+      const moduleConfig = moduleDependencies[feature];
+
+      if (!module || !moduleConfig.exports) continue;
+
+      // For each export in the module's configuration
+      for (const [exportName, locations] of Object.entries(moduleConfig.exports)) {
+        // Try to get the export - check both named export and default export
+        let exportValue = module[exportName];
+
+        // If not found as named export, try default export
+        if (!exportValue && module.default) {
+          exportValue = module.default;
+        }
+
+        if (!exportValue) continue;
+
+        // Attach to each configured location
+        locations.forEach(location => {
+          if (location === 'window') {
+            window[exportName] = exportValue;
+          } else if (location === 'hyperclay') {
+            window.hyperclay[exportName] = exportValue;
+          }
+        });
+      }
+    }
+
+    // Create window.h alias
+    window.h = window.hyperclay;
+
     // Fire custom event when loading is complete
     window.dispatchEvent(new CustomEvent('hyperclayReady', {
       detail: {
@@ -434,6 +677,11 @@
       }
     }));
 
+    // Resolve the ready promise
+    if (hyperclayReadyResolve) {
+      hyperclayReadyResolve(window.hyperclay);
+    }
+
     console.log('HyperclayJS: All modules loaded successfully');
 
     // Show feature summary - AUTO-GENERATED
@@ -461,7 +709,7 @@
   "debounce": 0.2,
   "dom-ready": 0.2,
   "window-load": 0.2,
-  "jquery-like": 13.8,
+  "alljs": 13.9,
   "style-injection": 0.8,
   "get-data-from-form": 1.7,
   "dom-morphing": 7.9,

package/module-dependency-graph.json

@@ -9,6 +9,7 @@
     "build/generate-load-jsdelivr.js": [],
     "build/generate-readme.js": [],
     "build/hyperclay.template.js": [],
+    "build/update-index-url.js": [],
     "communication/behaviorCollector.js": [],
     "communication/sendMessage.js": [
       "communication/behaviorCollector.js",
@@ -511,10 +512,10 @@
         ]
       }
     },
-    "jquery-like": {
+    "alljs": {
       "name": "All.js (jQuery-like)",
       "category": "dom-utilities",
-      "size": 13.8,
+      "size": 13.9,
       "files": [
         "dom-utilities/All.js"
       ],
@@ -729,7 +730,7 @@
       "modules": [
         "dom-ready",
         "window-load",
-        "jquery-like",
+        "alljs",
         "style-injection",
         "get-data-from-form"
       ]
@@ -813,7 +814,7 @@
         "debounce",
         "dom-ready",
         "window-load",
-        "jquery-like",
+        "alljs",
         "style-injection",
         "get-data-from-form",
         "dom-morphing",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperclayjs",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Modular JavaScript library for building interactive HTML applications with Hyperclay",
   "type": "module",
   "main": "hyperclay.js",
@@ -33,17 +33,18 @@
   ],
   "scripts": {
     "dev": "npm run build && http-server -p 3535 -o /index.html",
-    "build": "npm run generate:deps && npm run build:loader && npm run build:readme && npm run build:load-jsdelivr",
+    "build": "npm run generate:deps && npm run build:loader && npm run build:readme && npm run build:load-jsdelivr && npm run build:index-url",
     "generate:deps": "node build/generate-dependency-graph.js",
     "build:loader": "node build/build-loader.js",
     "build:readme": "node build/generate-readme.js",
     "build:load-jsdelivr": "node build/generate-load-jsdelivr.js",
+    "build:index-url": "node build/update-index-url.js",
     "test": "jest",
     "lint": "eslint .",
     "format": "prettier --write .",
     "release": "./scripts/release.sh",
     "prepublishOnly": "npm run build && npm test",
-    "postpublish": "open http://127.0.0.1:3535/load-jsdelivr.html"
+    "postpublish": "test -n \"$SKIP_POSTPUBLISH\" || open http://127.0.0.1:3535/load-jsdelivr.html"
   },
   "repository": {
     "type": "git",