powerpagestoolkit 2.7.121 → 2.7.132

package/dist/types/core/DOMNodeReference.d.ts

@@ -1,4 +1,34 @@
 import * as s from "@/constants/symbols.js";
+declare type BusinessRule = {
+    /**
+     * @param condition A function that returns a boolean to determine
+     * the visibility of the target element. If `condition()` returns true, the element is shown;
+     * otherwise, it is hidden.
+     
+     * @param clearValuesOnHide Should the values in the targeted field be cleared when hidden? Defaults to true
+     */
+    setVisibility?: [condition: () => boolean, clearValuesOnHide?: boolean];
+    /**
+     * @param isRequired Function determining if field is required
+     * @param isValid Function validating field input.
+     */
+    setRequired?: [
+        isRequired: () => boolean,
+        isValid: (isRequired: boolean) => boolean
+    ];
+    /**
+     * @param condition A function to determine if the value provided should be applied to this field
+     * @param value The value to set for the HTML element.
+     * for parents of boolean radios, pass true or false as value, or
+     * an expression returning a boolean
+     */
+    setValue?: [condition: () => boolean, value: () => any | any];
+    /**
+     * @param condition A function to determine if this field
+     * should be enabled in a form, or disabled. True || 1 = disabled. False || 0 = enabled
+     */
+    setDisabled?: () => boolean;
+};
 export default class DOMNodeReference {
     target: Element | string;
     logicalName?: string;
@@ -251,3 +281,4 @@ export default class DOMNodeReference {
      */
     onceLoaded(callback: (instance: DOMNodeReference) => any): any;
 }
+export {};

package/dist/types/core/bindForm.d.ts

@@ -1,10 +1,13 @@
 import DOMNodeReference from "./DOMNodeReference.js";
 import DOMNodeReferenceArray from "./DOMNodeReferenceArray.js";
+declare type BoundForm = DOMNodeReferenceArray & Record<string, DOMNodeReference>;
 /**
  * Get all controls related to the form for manipulating with the
  * DOMNodeReference class. Rather than having to instantiate each fields that you need manually,
  * you can call this method once with the form ID and gain access to all fields
  * @param formId The string GUID of the form you want to bind to
- * @returns An array of DOMNodeReferences
+ * @returns An array of DOMNodeReferences, accessible as properties of a Record<string, DOMNodeReference> i.e. formProp = form["some_logicalName"]
+ * @see {@link BoundForm}
  */
-export default function bindForm<T extends string>(formId: string): Promise<DOMNodeReferenceArray & Record<T, DOMNodeReference>>;
+export default function bindForm(formId: string): Promise<BoundForm>;
+export {};

package/dist/types/core/createDOMNodeReferences.d.ts

@@ -7,7 +7,7 @@ import DOMNodeReferenceArray from "./DOMNodeReferenceArray.js";
  * @param options Options for advanced retrieval of elements
  * @param options.multiple - Should this call return an array of instantiated references, or just a single? Defaults to false, returning a single instance
  * @param options.root - Optionally specify the element within to search for the element targeted by 'target'. Defaults to 'document.body'
- * @param options.timeoutMs - Optionally specify the amount of time that should be waited to find the targeted element before throwing error - useful for async DOM loading. Relies on MutationObserver.  WARNING: Implementing multiple references with timeout can results in infinite loading.
+ * @param options.timeoutMs - Optionally specify the amount of time that should be waited to find the targeted element before throwing error - useful for async DOM loading. Relies on MutationObserver.  ***WARNING***: Implementing multiple references with timeout can result in infinite loading.
  * @returns  A promise that resolves to a Proxy of the initialized DOMNodeReference instance.
  */
 export default function createDOMNodeReference(target: string | HTMLElement, options?: {

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 import "./style.css";
 import API from "./core/API.js";
 import createRef from "./core/createDOMNodeReferences.js";
-import waitFor from "./utils/waitFor.js";
+import waitFor from "./core/waitFor.js";
 import bindForm from "./core/bindForm.js";
 export { API, createRef, waitFor, bindForm };

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "powerpagestoolkit",
-  "version": "2.7.121",
+  "version": "2.7.132",
   "description": "Reference, manipulate, and engage with Power Pages sites through the nodes in the DOM; use a variety of custom methods that allow customizing your power pages site quicker and easier.  ",
   "main": "./dist/bundle.js",
   "types": "./dist/index.d.ts",
+  "unpkg": "./dist/index.iife.js",
+  "jsdelivr": "./dist/index.iife.js",
+  "browser": "./dist/index.iife.js",
+  "typesVersions": {
+    "*": {
+      "*": ["./dist/types/*"]
+    }
+  },
   "scripts": {
     "typecheck": "tsc",
     "node:build": "node build.js",
@@ -17,7 +25,7 @@
     "@types/node": "^22.8.6",
     "@typescript-eslint/parser": "^8.20.0",
     "css-loader": "^7.1.2",
-    "esbuild": "^0.24.0",
+    "esbuild": "^0.24.2",
     "esbuild-css-modules-plugin": "^3.1.2",
     "eslint": "^8.57.1",
     "eslint-plugin-import": "^2.31.0",
@@ -60,6 +68,7 @@
   "files": [
     "dist/bundle.js",
     "dist/bundle.css",
+    "dist/index.iife.js",
     "dist/types/**/*.d.ts",
     "assets/**"
   ],