powerpagestoolkit 2.7.1211 → 2.7.1401

package/README.md

@@ -35,7 +35,7 @@ createRef(
   options: {
     multiple: (() => boolean) | boolean = false,
     root: HTMLElement,
-    timeout: number
+    timeoutMs:number
   }
 ): Promise<DOMNodeReference | DOMNodeReference[]>;
 ```
@@ -66,7 +66,7 @@ createRef takes two main arguments:
         <pre><code class="language-javascript">{
   multiple: () => boolean | boolean,
   root: HTMLElement,
-  timeout: number
+  timeoutMs:number
 }</code></pre>
       </td>
       <td style="border: 1px solid #ddd; padding: 8px;">
@@ -98,7 +98,7 @@ const nodes = await createRef(".my-class", { multiple: true });
 
 // If the node you are targeting is not available at the initial execution
 // of the script, set a timeout for 2 seconds
-const node2 = await createRef("#target", { timeout: 2000 });
+const node2 = await createRef("#target", { timeoutMs:2000 });
 
 // need to target a node within a specific node? use that node as the root
 const otherElement = document.getElementById("id");
@@ -107,7 +107,7 @@ const node3 = await createRef("#target", { root: otherElement });
 // implement all options:
 const nodes2 = await createRef("#target", {
   multiple: true,
-  timeout: 4000,
+  timeoutMs:4000,
   root: otherElement,
 });
 ```

package/dist/bundle.js

@@ -102,11 +102,11 @@ var API = {
 };
 var API_default = API;
 
-// src/utils/waitFor.ts
+// src/core/waitFor.ts
 function waitFor(target, root = document, multiple = false, debounceTime2) {
   return new Promise((resolve, reject) => {
     if (multiple) {
-      let timeout;
+      let timeoutMs;
       const observedElements = [];
       const observedSet = /* @__PURE__ */ new Set();
       if (debounceTime2 < 1) {
@@ -122,8 +122,8 @@ function waitFor(target, root = document, multiple = false, debounceTime2) {
             observedElements.push(element);
           }
         });
-        clearTimeout(timeout);
-        timeout = setTimeout(() => {
+        clearTimeout(timeoutMs);
+        timeoutMs = setTimeout(() => {
           if (observedElements.length > 0) {
             observer.disconnect();
             resolve(observedElements);
@@ -613,10 +613,15 @@ var DOMNodeReference = class _DOMNodeReference {
     }
     const eventType = this.determineEventType();
     this.element.dispatchEvent(new Event(eventType, { bubbles: false }));
-    if (this.element.classList.contains("boolean-radio") && this.yesRadio instanceof _DOMNodeReference && this.noRadio instanceof _DOMNodeReference) {
+    if (this.yesRadio instanceof _DOMNodeReference && this.noRadio instanceof _DOMNodeReference) {
       this.yesRadio.element.checked = value;
       this.noRadio.element.checked = !value;
       this.value = value;
+      this.checked = value;
+      this.element.checked = value;
+    } else if (this.isRadio || this.element.type === "radio") {
+      this.checked = value;
+      this.element.checked = value;
     } else {
       this.element.value = value;
     }
@@ -892,7 +897,7 @@ var DOMNodeReference = class _DOMNodeReference {
           evaluationfunction: () => {
             const isFieldRequired = isRequired.bind(this)();
             const isFieldVisible = window.getComputedStyle(this.visibilityController).display !== "none";
-            return !isFieldRequired || !isFieldVisible || isValid.bind(this)();
+            return !isFieldRequired || !isFieldVisible || isValid.bind(this)(isFieldRequired);
           }
         });
         Page_Validators.push(newValidator);
@@ -1330,10 +1335,15 @@ function createReferenceString(tagName, datafieldname) {
     return `[data-name="${datafieldname}"]`;
   return null;
 }
+
+// src/index.ts
+var toolkit = { API: API_default, createRef: createDOMNodeReference, waitFor, bindForm };
+var src_default = toolkit;
 export {
   API_default as API,
   bindForm,
   createDOMNodeReference as createRef,
+  src_default as default,
   waitFor
 };
 

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/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,18 @@
 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 };
+declare const toolkit: {
+    API: {
+        createRecord(tableSetName: string, data: object): Promise<string>;
+        getRecord<T>(tableSetName: string, recordID: string, selectColumns?: string): Promise<T>;
+        getMultiple(tableSetName: string, queryParameters?: string): Promise<Array<object>>;
+        updateRecord(tableSetName: string, recordId: string, data: object): Promise<any>;
+    };
+    createRef: typeof createRef;
+    waitFor: typeof waitFor;
+    bindForm: typeof bindForm;
+};
+export default toolkit;

package/package.json

@@ -1,9 +1,46 @@
 {
   "name": "powerpagestoolkit",
-  "version": "2.7.1211",
+  "version": "2.7.1401",
   "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",
+  "module": "./dist/bundle.js",
+  "types": "./dist/types/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./dist/types/*"
+      ]
+    }
+  },
+  "unpkg": "./dist/bundle.js",
+  "jsdelivr": "./dist/bundle.js",
+  "browser": "./dist/bundle.js",
+  "author": "KeatonBrewster",
+  "license": "AGPL-3.0-only",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Keaton-Brewster/PowerPagesToolKit"
+  },
+  "files": [
+    "dist/bundle.js",
+    "dist/bundle.css",
+    "dist/types/**/*.d.ts",
+    "assets/**"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/bundle.js"
+    },
+    "./createDOMNodeReference": {
+      "import": "./dist/createDOMNodeReference.js",
+      "types": "./dist/createDOMNodeReference.d.ts"
+    },
+    "./style.css": {
+      "import": "./dist/bundle.css"
+    }
+  },
   "scripts": {
     "typecheck": "tsc",
     "node:build": "node build.js",
@@ -17,7 +54,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",
@@ -27,13 +64,6 @@
     "typescript": "^5.6.3",
     "typescript-eslint": "^8.12.2"
   },
-  "author": "KeatonBrewster",
-  "license": "AGPL-3.0-only",
-  "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Keaton-Brewster/PowerPagesToolKit"
-  },
   "keywords": [
     "powerpages",
     "power pages",
@@ -56,24 +86,5 @@
     "form-management",
     "frontend",
     "web-development"
-  ],
-  "files": [
-    "dist/bundle.js",
-    "dist/bundle.css",
-    "dist/types/**/*.d.ts",
-    "assets/**"
-  ],
-  "exports": {
-    ".": {
-      "import": "./dist/bundle.js",
-      "types": "./dist/types/index.d.ts"
-    },
-    "./createDOMNodeReference": {
-      "import": "./dist/createDOMNodeReference.js",
-      "types": "./dist/createDOMNodeReference.d.ts"
-    },
-    "./style.css": {
-      "import": "./dist/bundle.css"
-    }
-  }
+  ]
 }