powerpagestoolkit 1.3.2 → 1.3.5

package/dist/bundle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/safeAjax.ts", "../src/API.ts", "../src/waitFor.ts", "../src/createInfoElement.ts", "../src/errors.ts", "../src/DOMNodeReference.ts", "../src/createDOMNodeReferences.ts", "../src/List.ts", "../src/getList.ts"],
+  "sourcesContent": ["// @ts-nocheck\r\nexport default function safeAjax(ajaxOptions) {\r\n  const deferredAjax = $.Deferred();\r\n\r\n  // shell is only available via runtime in a PowerPages portal\r\n\r\n  shell\r\n    .getTokenDeferred()\r\n    .done(function (token) {\r\n      // add headers for AJAX\r\n      if (!ajaxOptions.headers) {\r\n        $.extend(ajaxOptions, {\r\n          headers: {\r\n            __RequestVerificationToken: token,\r\n          },\r\n        });\r\n      } else {\r\n        ajaxOptions.headers[\"__RequestVerificationToken\"] = token;\r\n      }\r\n      $.ajax(ajaxOptions)\r\n        .done(function (data, textStatus, jqXHR) {\r\n          //eslint-disable-next-line\r\n          validateLoginSession(data, textStatus, jqXHR, deferredAjax.resolve);\r\n        })\r\n        .fail(deferredAjax.reject); //AJAX\r\n    })\r\n    .fail(function () {\r\n      deferredAjax.rejectWith(this, arguments); // on token failure pass the token AJAX and args\r\n    });\r\n\r\n  return deferredAjax.promise();\r\n}\r\n", "//@ts-nocheck\r\nimport safeAjax from \"./safeAjax.js\";\r\nconst API = {\r\n  /**\r\n   *\r\n   * @param {Schema} schema an instance of a schema class, containing the desired information for the POST request\r\n   * @returns a Promise resolving the successful results *[record id]* of the POST request, or rejecting the failed results *[error]* of the POST request.\r\n   */\r\n  createRecord(schema: Schema): Promise<string> {\r\n    return new Promise((resolve, reject) => {\r\n      safeAjax({\r\n        type: \"POST\",\r\n        url: `/_api/${schema.logicalName()}`,\r\n        data: schema.value(),\r\n        contentType: \"application/json\",\r\n        success: function (response, status, xhr) {\r\n          resolve(xhr.getResponseHeader(\"entityid\"));\r\n        },\r\n        error: (error) => {\r\n          reject(error);\r\n        },\r\n      });\r\n    });\r\n  },\r\n  /**\r\n   *\r\n   * @param {string} tableSetName The DataVerse SET name of the table being queried\r\n   * @param {string} recordID the GUID of the records to be retrieved\r\n   * @param {string} selectColumns *OPTIONAL* if desired, enter your own custom OData query for advanced GET results. Format = select=column1,column2,column3...\r\n   * @returns a Promise resolving the successful results of the GET request, or rejecting the failed results of the GET request\r\n   */\r\n  getRecord(\r\n    tableSetName: string,\r\n    recordID: string,\r\n    selectColumns: string\r\n  ): Promise<object> {\r\n    return new Promise((resolve, reject) => {\r\n      const url = `/_api/${tableSetName}(${recordID})${\r\n        selectColumns ? `?$${selectColumns}` : \"\"\r\n      }`;\r\n\r\n      safeAjax({\r\n        type: \"GET\",\r\n        url: url,\r\n        success: resolve,\r\n        error: reject,\r\n      });\r\n    });\r\n  },\r\n  /**\r\n   *\r\n   * @param {String} tableSetName The DataVerse SET name of the table being queried\r\n   * @param {String} queryParameters *OPTIONAL* the OData query parameters for refining search results: *format = $filter=filters&$select=columns*\r\n   * @returns a Promise resolving the successful results of the GET request, or rejecting the failed results of the GET request\r\n   */\r\n  getMultiple(\r\n    tableSetName: string,\r\n    queryParameters: string\r\n  ): Promise<Array<object>> {\r\n    return new Promise((resolve, reject) => {\r\n      // Construct the URL based on the presence of query parameters\r\n      const url = `/_api/${tableSetName}${\r\n        queryParameters ? `?${queryParameters}` : \"\"\r\n      }`;\r\n\r\n      safeAjax({\r\n        type: \"GET\",\r\n        url: url,\r\n        success: function (response) {\r\n          resolve(response.value);\r\n        },\r\n        error: reject,\r\n      });\r\n    });\r\n  },\r\n};\r\n\r\nexport default API;\r\n", "export default function waitFor(\r\n  target: HTMLElement | string\r\n): Promise<HTMLElement> {\r\n  return new Promise((resolve, reject) => {\r\n    // Create observer to watch for target in DOM\r\n    const observer = new MutationObserver(() => {\r\n      const observedElement = <HTMLElement>(\r\n        document.querySelector(<string>target)\r\n      );\r\n      if (observedElement) {\r\n        clearTimeout(timeout);\r\n        observer.disconnect();\r\n        resolve(observedElement);\r\n      }\r\n    });\r\n    const timeout = setTimeout(() => {\r\n      observer.disconnect();\r\n      reject(new Error(`Element not found: ${target} within 5 seconds`));\r\n    }, 5000);\r\n\r\n    // Check if target is already in DOM\r\n    if (target instanceof HTMLElement) {\r\n      clearTimeout(timeout);\r\n      return resolve(target);\r\n    }\r\n    const element = <HTMLElement>document.querySelector(target);\r\n    if (element) {\r\n      clearTimeout(timeout);\r\n      return resolve(element);\r\n    }\r\n\r\n    observer.observe(document.body, {\r\n      subtree: true,\r\n      attributes: true,\r\n      childList: true, // Detects added/removed child elements\r\n    });\r\n  });\r\n}\r\n", "export default function CreateInfoEl(titleString: string) {\r\n  const span = document.createElement(\"span\");\r\n  span.classList.add(\"info-icon\");\r\n\r\n  const icon = document.createElement(\"i\");\r\n  icon.classList.add(\"fa\", \"fa-solid\", \"fa-info-circle\");\r\n  icon.setAttribute(\"aria-label\", \"Info\");\r\n  icon.style.cursor = \"pointer\";\r\n\r\n  const flyoutContent = document.createElement(\"div\");\r\n  flyoutContent.innerHTML = titleString;\r\n  flyoutContent.classList.add(\"flyout-content\");\r\n\r\n  span.appendChild(icon);\r\n  span.appendChild(flyoutContent);\r\n\r\n  // Function to position flyout content\r\n  const positionFlyout = () => {\r\n    flyoutContent.style.display = \"block\"; // Show the flyout to calculate dimensions\r\n\r\n    const flyoutRect = flyoutContent.getBoundingClientRect();\r\n    const viewportWidth = window.innerWidth;\r\n\r\n    // Position the flyout\r\n\r\n    // Adjust if flyout is too far to the right\r\n    if (flyoutRect.right > viewportWidth) {\r\n      const overflowAmount = flyoutRect.right - viewportWidth;\r\n      flyoutContent.style.left = `calc(50% - ${overflowAmount}px)`; // Shift left\r\n    }\r\n\r\n    // Adjust if flyout is too far to the left\r\n    if (flyoutRect.left < 0) {\r\n      const overflowAmount = Math.abs(flyoutRect.left);\r\n      flyoutContent.style.left = `calc(50% + ${overflowAmount}px)`; // Shift right\r\n    }\r\n  };\r\n\r\n  icon.addEventListener(\"mouseenter\", positionFlyout);\r\n\r\n  icon.addEventListener(\"mouseleave\", () => {\r\n    flyoutContent.style.display = \"none\"; // Hide on mouse leave\r\n  });\r\n\r\n  icon.addEventListener(\"touchstart\", (event) => {\r\n    event.preventDefault();\r\n    // Toggle flyout visibility on touch\r\n    flyoutContent.style.display =\r\n      flyoutContent.style.display === \"block\" ? \"none\" : \"block\";\r\n    if (flyoutContent.style.display === \"block\") {\r\n      positionFlyout(); // Position the flyout when displayed\r\n    }\r\n  });\r\n\r\n  document.body.addEventListener(\"click\", (event: Event) => {\r\n    if (!span.contains(<Node>event.target)) {\r\n      flyoutContent.style.display = \"none\"; // Hide on body click\r\n    }\r\n  });\r\n\r\n  flyoutContent.style.display = \"none\";\r\n  return span;\r\n}\r\n", "import DOMNodeReference from \"./DOMNodeReference.js\";\r\n\r\nexport class DOMNodeInitializationError extends Error {\r\n  constructor(instance: DOMNodeReference, error: string) {\r\n    super(\r\n      `There was an error initializing a DOMNodeReference for target: ${instance.target}, :: ${error}`\r\n    );\r\n    this.name = \"DOMNodeInitializationError\";\r\n  }\r\n}\r\n\r\nexport class DOMNodeNotFoundError extends Error {\r\n  constructor(instance: DOMNodeReference) {\r\n    super(`The targeted DOM element was not found: ${instance.target}`);\r\n  }\r\n}\r\n\r\nexport class ConditionalRenderingError extends Error {\r\n  constructor(instance: DOMNodeReference, error: string) {\r\n    super(\r\n      `There was an error condiguring conditional rendering for target: ${instance.target} :: ${error}`\r\n    );\r\n  }\r\n}\r\n", "import waitFor from \"@/waitFor.js\";\r\nimport createInfoEl from \"@/createInfoElement.js\";\r\nimport {\r\n  DOMNodeInitializationError,\r\n  DOMNodeNotFoundError,\r\n  ConditionalRenderingError,\r\n} from \"@/errors.js\";\r\nimport { createDOMNodeReference } from \"@/createDOMNodeReferences.js\";\r\n\r\nexport const _init = Symbol(\"_init\");\r\n\r\n/******/ /******/ /******/ export default class DOMNodeReference {\r\n  // properties initialized in the constructor\r\n  public target: HTMLElement | string;\r\n  private isLoaded: boolean;\r\n  private defaultDisplay: string;\r\n  /**\r\n   * The value of the element that this node represents\r\n   * stays in syncs with the live DOM elements via event handler\r\n   * @type {any}\r\n   */\r\n  public value: any;\r\n\r\n  // other properties made available after async _init\r\n  /**\r\n   * The element targeted when instantiating DOMNodeReference.\r\n   * Made available in order to perform normal DOM traversal,\r\n   * or access properties not available through this class.\r\n   * @property {HTMLElement | null}\r\n   */\r\n  public declare element: HTMLElement;\r\n  private declare visibilityController: HTMLElement;\r\n  public declare checked: boolean;\r\n  /**\r\n   * Represents the 'yes' option of a boolean radio field.\r\n   * This property is only available when the parent node\r\n   * is a main field for a boolean radio input.\r\n   * @property {DOMNodeReferenceProxy | null}\r\n   */\r\n  public declare yesRadio?: DOMNodeReference | null;\r\n  /**\r\n   * Represents the 'no' option of a boolean radio field.\r\n   * This property is only available when the parent node\r\n   * is a main field for a boolean radio input.\r\n   * @property {DOMNodeReferenceProxy | null}\r\n   */\r\n  public declare noRadio?: DOMNodeReference | null;\r\n\r\n  /**\r\n   * Creates an instance of DOMNodeReference.\r\n   * @param {string} target - The CSS selector to find the desired DOM element.\r\n   */\r\n  /******/ /******/ constructor(target: HTMLElement | string) {\r\n    this.target = target;\r\n    this.isLoaded = false;\r\n    this.defaultDisplay = \"\";\r\n    this.value = null;\r\n\r\n    // we defer the rest of initialization\r\n  }\r\n\r\n  public async [_init](): Promise<void> {\r\n    /**\r\n     * dynamically define the _init method using our custom symbol\r\n     * this makes it so that the _init method cannot be accessed outside\r\n     * of this package: i.e. by any consumers of the package\r\n     */\r\n    try {\r\n      const element = await waitFor(this.target);\r\n      this.element = element;\r\n\r\n      if (!this.element) {\r\n        throw new DOMNodeNotFoundError(this);\r\n      }\r\n      if (this.element.classList.contains(\"boolean-radio\")) {\r\n        await this._attachRadioButtons();\r\n      }\r\n\r\n      this._initValueSync();\r\n      this._attachVisibilityController();\r\n      this.defaultDisplay = this.visibilityController.style.display;\r\n\r\n      this.isLoaded = true;\r\n    } catch (e) {\r\n      throw new DOMNodeInitializationError(this, e as string);\r\n    }\r\n  }\r\n\r\n  // Function to update this.value based on element type\r\n  private _initValueSync() {\r\n    // Initial sync\r\n    this.updateValue();\r\n\r\n    // Event listeners for real-time changes based on element type\r\n    const elementType = (this.element as HTMLInputElement).type;\r\n    if (elementType === \"checkbox\" || elementType === \"radio\") {\r\n      this.element.addEventListener(\"click\", this.updateValue.bind(this));\r\n    } else if (\r\n      elementType === \"select-one\" ||\r\n      elementType === \"select-multiple\"\r\n    ) {\r\n      this.element.addEventListener(\"change\", this.updateValue.bind(this));\r\n    } else {\r\n      this.element.addEventListener(\"input\", this.updateValue.bind(this));\r\n    }\r\n  }\r\n\r\n  public updateValue(): void {\r\n    switch ((this.element as HTMLInputElement).type) {\r\n      case \"checkbox\":\r\n      case \"radio\":\r\n        this.value = (this.element as HTMLInputElement).checked;\r\n        this.checked = (this.element as HTMLInputElement).checked;\r\n        break;\r\n      case \"select-multiple\":\r\n        this.value = Array.from(\r\n          (this.element as HTMLSelectElement).selectedOptions\r\n        ).map((option) => option.value);\r\n        break;\r\n      case \"number\":\r\n        this.value =\r\n          (this.element as HTMLInputElement).value !== \"\"\r\n            ? Number((this.element as HTMLInputElement).value)\r\n            : null;\r\n        break;\r\n      default:\r\n        this.value = null;\r\n        break;\r\n    }\r\n\r\n    if (this.element.classList.contains(\"boolean-radio\")) {\r\n      (this.yesRadio as DOMNodeReference).updateValue();\r\n      (this.noRadio as DOMNodeReference).updateValue();\r\n    }\r\n  }\r\n\r\n  private _attachVisibilityController(): void {\r\n    // Set the default visibility controller to the element itself\r\n    this.visibilityController = this.element;\r\n\r\n    // If the element is a table, use its closest fieldset as the controller\r\n    if (this.element.tagName === \"TABLE\") {\r\n      const fieldset = this.element.closest(\"fieldset\");\r\n      if (fieldset) {\r\n        this.visibilityController = fieldset;\r\n      }\r\n      return;\r\n    }\r\n\r\n    // For specific tag types, use the closest 'td' if available as the controller\r\n    const tagsRequiringTdParent = [\r\n      \"SPAN\",\r\n      \"INPUT\",\r\n      \"TEXTAREA\",\r\n      \"SELECT\",\r\n      \"TABLE\",\r\n    ];\r\n    if (tagsRequiringTdParent.includes(this.element.tagName)) {\r\n      const tdParent = this.element.closest(\"td\");\r\n      if (tdParent) {\r\n        this.visibilityController = tdParent;\r\n      }\r\n    }\r\n  }\r\n\r\n  private async _attachRadioButtons(): Promise<void> {\r\n    this.yesRadio = await createDOMNodeReference(`#${this.element.id}_1`);\r\n    this.noRadio = await createDOMNodeReference(`#${this.element.id}_0`);\r\n  }\r\n\r\n  /**\r\n   * Sets up an event listener based on the specified event type, executing the specified\r\n   * event handler\r\n   * @param {string} eventType - The DOM event to watch for\r\n   * @param {(this: DOMNodeReference, e: Event) => void} eventHandler - The callback function that runs when the\r\n   * specified event occurs\r\n   * @returns - Instance of this\r\n   */\r\n  public on(\r\n    eventType: string,\r\n    eventHandler: (e: Event) => void\r\n  ): DOMNodeReference {\r\n    this.element.addEventListener(eventType, eventHandler.bind(this));\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Hides the element by setting its display style to \"none\".\r\n   * @returns - Instance of this\r\n   */\r\n  public hide(): DOMNodeReference {\r\n    this.visibilityController.style.display = \"none\";\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Shows the element by restoring its default display style.\r\n   * @returns - Instance of this\r\n   */\r\n  public show(): DOMNodeReference {\r\n    this.visibilityController.style.display = this.defaultDisplay;\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   *\r\n   * @param {function(this: DOMNodeReference): boolean | boolean} shouldShow - Either a function that returns true or false,\r\n   * or a natural boolean to determine the visibility of this\r\n   * @returns - Instance of this\r\n   */\r\n  public toggleVisibility(shouldShow: Function | boolean): DOMNodeReference {\r\n    if (shouldShow instanceof Function) {\r\n      shouldShow(this) ? this.show() : this.hide();\r\n    } else {\r\n      shouldShow ? this.show() : this.hide();\r\n    }\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Sets the value of the HTML element.\r\n   * @param {() => any} value - The value to set for the HTML element.\r\n   * for parents of boolean radios, pass true or false as value, or\r\n   * an expression returning a boolean\r\n   * @returns - Instance of this\r\n   */\r\n  public setValue(value: any): DOMNodeReference {\r\n    if (this.element.classList.contains(\"boolean-radio\")) {\r\n      (\r\n        (this.yesRadio as DOMNodeReference).element as HTMLInputElement\r\n      ).checked = value;\r\n      ((this.noRadio as DOMNodeReference).element as HTMLInputElement).checked =\r\n        !value;\r\n    } else {\r\n      (this.element as HTMLInputElement).value = value;\r\n    }\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Disables the element so that users cannot input any data\r\n   * @returns - Instance of this\r\n   */\r\n  public disable(): DOMNodeReference {\r\n    try {\r\n      (this.element as HTMLInputElement).disabled = true;\r\n    } catch (e) {\r\n      throw new Error(\r\n        `There was an error trying to disable the target: ${this.target}`\r\n      );\r\n    }\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Enables the element so that users can input data\r\n   * @returns - Instance of this\r\n   */\r\n  public enable(): DOMNodeReference {\r\n    try {\r\n      (this.element as HTMLInputElement).disabled = false;\r\n    } catch (e) {\r\n      throw new Error(\r\n        `There was an error trying to disable the target: ${this.target}`\r\n      );\r\n    }\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   *\r\n   * @param {...HTMLElement} elements - The elements to prepend to the element targeted by this.\r\n   * @returns - Instance of this\r\n   */\r\n  public prepend(...elements: HTMLElement[]): DOMNodeReference {\r\n    this.element.prepend(...elements);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Appends child elements to the HTML element.\r\n   * @param {...HTMLElement} elements - The elements to append to the element targeted by this.\r\n   * @returns - Instance of this\r\n   */\r\n  public append(...elements: HTMLElement[]): DOMNodeReference {\r\n    this.element.append(...elements);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Inserts elements before the HTML element.\r\n   * @param {...HTMLElement} elements - The elements to insert before the HTML element.\r\n   * @returns - Instance of this\r\n   */\r\n  public before(...elements: HTMLElement[]): DOMNodeReference {\r\n    this.element.before(...elements);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Inserts elements after the HTML element.\r\n   * @param {...HTMLElement} elements - The elements to insert after the HTML element.\r\n   * @returns - Instance of this\r\n   */\r\n  public after(...elements: HTMLElement[]): DOMNodeReference {\r\n    this.element.after(...elements);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Retrieves the label associated with the HTML element.\r\n   * @returns {HTMLElement} The label element associated with this element.\r\n   */\r\n  public getLabel(): HTMLElement | null {\r\n    return document.querySelector(`#${this.element.id}_label`) || null;\r\n  }\r\n\r\n  /**\r\n   * Appends child elements to the label associated with the HTML element.\r\n   * @param {...HTMLElement} elements - The elements to append to the label.\r\n   * @returns - Instance of this\r\n   */\r\n  public appendToLabel(...elements: HTMLElement[]): DOMNodeReference {\r\n    const label = this.getLabel();\r\n    if (label) {\r\n      label.append(\" \", ...elements);\r\n    }\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Adds a tooltip with specified text to the label associated with the HTML element.\r\n   * @param {string} text - The text to display in the tooltip.\r\n   * @returns - Instance of this\r\n   */\r\n  public addLabelTooltip(text: string): DOMNodeReference {\r\n    this.appendToLabel(createInfoEl(text));\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Adds a tooltip with the specified text to the element\r\n   * @param {string} text - The text to display in the tooltip\r\n   * @returns - Instance of this\r\n   */\r\n  public addTooltip(text: string): DOMNodeReference {\r\n    this.append(createInfoEl(text));\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Sets the inner HTML content of the HTML element.\r\n   * @param {string} string - The text to set as the inner HTML of the element.\r\n   * @returns - Instance of this\r\n   */\r\n  setInnerHTML(string: string) {\r\n    this.element.innerHTML = string;\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Removes this element from the DOM\r\n   * @returns - Instance of this\r\n   */\r\n  remove() {\r\n    this.element.remove();\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   *\r\n   * @param {Partial<CSSStyleDeclaration} options and object containing the styles you want to set : {key: value} e.g.: {'display': 'block'}\r\n   * @returns - Instance of this\r\n   */\r\n  setStyle(options: Partial<CSSStyleDeclaration>) {\r\n    if (Object.prototype.toString.call(options) !== \"[object Object]\") {\r\n      throw new Error(\r\n        `powerpagestoolkit: 'DOMNodeReference.setStyle' required options to be in the form of an object. Argument passed was of type: ${typeof options}`\r\n      );\r\n    }\r\n\r\n    for (const key in options) {\r\n      this.element.style[key as any] = options[key] as string;\r\n    }\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Unchecks both the yes and no radio buttons if they exist.\r\n   * @returns - Instance of this\r\n   */\r\n  public uncheckRadios(): DOMNodeReference {\r\n    if (this.yesRadio && this.noRadio) {\r\n      (this.yesRadio.element as HTMLInputElement).checked = false;\r\n      (this.noRadio.element as HTMLInputElement).checked = false;\r\n    } else {\r\n      console.error(\r\n        \"[SYNACT] Attempted to uncheck radios for an element that has no radios\"\r\n      );\r\n    }\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Configures conditional rendering for the target element based on a condition\r\n   * and the visibility of one or more trigger elements.\r\n   *\r\n   * @param {(this: DOMNodeReference) => boolean} condition - A function that returns a boolean to determine\r\n   * the visibility of the target element. If `condition()` returns true, the element is shown;\r\n   * otherwise, it is hidden.\r\n   * @param {Array<DOMNodeReference>} [dependencies] - An array of `DOMNodeReference` instances. Event listeners are\r\n   * registered on each to toggle the visibility of the target element based on the `condition` and the visibility of\r\n   * the target node.\r\n   * @returns - Instance of this\r\n   */\r\n  public configureConditionalRendering(\r\n    condition: () => boolean,\r\n    dependencies: Array<DOMNodeReference>\r\n  ): DOMNodeReference {\r\n    try {\r\n      this.toggleVisibility(condition());\r\n\r\n      if (!dependencies) {\r\n        console.warn(\r\n          `powerpagestoolkit: No dependencies were found when configuring conditional rendering for ${this}. Be sure that if you are referencing other nodes in your rendering logic, that you include those nodes in the dependency array`\r\n        );\r\n        return this;\r\n      }\r\n\r\n      dependencies.forEach((node) => {\r\n        node.on(\"change\", () => this.toggleVisibility(condition()));\r\n\r\n        const observer = new MutationObserver(() => {\r\n          const display = window.getComputedStyle(\r\n            node.visibilityController\r\n          ).display;\r\n          this.toggleVisibility(display !== \"none\" && condition());\r\n        });\r\n        observer.observe(node.visibilityController, {\r\n          attributes: true,\r\n          attributeFilter: [\"style\"],\r\n        });\r\n      });\r\n\r\n      return this;\r\n    } catch (e) {\r\n      throw new ConditionalRenderingError(this, e as string);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Sets up validation and requirement rules for the field. This function dynamically updates the field's required status and validates its input based on the specified conditions.\r\n   *\r\n   * @param {function(this: DOMNodeReference): boolean} isRequired - A function that determines whether the field should be required. Returns `true` if required, `false` otherwise.\r\n   * @param {function(this: DOMNodeReference): boolean} isValid - A function that checks if the field's input is valid. Returns `true` if valid, `false` otherwise.\r\n   * @param {string} fieldDisplayName - The name of the field, used in error messages if validation fails.\r\n   * @param {Array<DOMNodeReference>} [dependencies] Other fields that this field\u2019s requirement depends on. When these fields change, the required status of this field is re-evaluated. Make sure any DOMNodeReference used in `isRequired` or `isValid` is included in this array.\r\n   * @returns - Instance of this\r\n   */\r\n  public configureValidationAndRequirements(\r\n    isRequired: (instance: DOMNodeReference) => boolean,\r\n    isValid: (instance: DOMNodeReference) => boolean,\r\n    fieldDisplayName: string,\r\n    dependencies: Array<DOMNodeReference>\r\n  ): DOMNodeReference {\r\n    if (typeof Page_Validators !== \"undefined\") {\r\n      const newValidator = document.createElement(\"span\");\r\n      newValidator.style.display = \"none\";\r\n      newValidator.id = `${this.element.id}Validator`;\r\n      (newValidator as any).controltovalidate = this.element.id;\r\n      (\r\n        newValidator as any\r\n      ).errormessage = `<a href='#${this.element.id}_label'>${fieldDisplayName} is a required field</a>`;\r\n      (newValidator as any).evaluationfunction = isValid.bind(this);\r\n      //eslint-disable-next-line\r\n      Page_Validators.push(newValidator);\r\n    } else {\r\n      throw new Error(\r\n        \"Attempted to add to Validator where Page_Validators do not exist\"\r\n      );\r\n    }\r\n\r\n    this.setRequiredLevel(isRequired(this));\r\n\r\n    if (!dependencies) {\r\n      console.warn(\r\n        `powerpagestoolkit: No dependencies were found when configuring requirement and validation for ${this}. Be sure that if you are referencing other nodes in your requirement or validation logic, that you include those nodes in the dependency array`\r\n      );\r\n      return this;\r\n    }\r\n    dependencies.forEach((dep) => {\r\n      dep.element.addEventListener(\"change\", () =>\r\n        this.setRequiredLevel(isRequired(this))\r\n      );\r\n    });\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Sets the required level for the field by adding or removing the \"required-field\" class on the label.\r\n   *\r\n   * @param {boolean} isRequired - Determines whether the field should be marked as required.\r\n   * If true, the \"required-field\" class is added to the label; if false, it is removed.\r\n   * @returns - Instance of this\r\n   */\r\n  public setRequiredLevel(isRequired: Function | boolean): DOMNodeReference {\r\n    if (isRequired instanceof Function) {\r\n      isRequired()\r\n        ? this.getLabel()?.classList.add(\"required-field\")\r\n        : this.getLabel()?.classList.remove(\"required-field\");\r\n      return this;\r\n    } else {\r\n      isRequired\r\n        ? this.getLabel()?.classList.add(\"required-field\")\r\n        : this.getLabel()?.classList.remove(\"required-field\");\r\n      return this;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Executes a callback function once the element is fully loaded.\r\n   * If the element is already loaded, the callback is called immediately.\r\n   * Otherwise, a MutationObserver is used to detect when the element is added to the DOM.\r\n   * @param {Function} callback - A callback function to execute once the element is loaded.\r\n   */\r\n  public onceLoaded(callback: (instance: DOMNodeReference) => any): any {\r\n    if (this.isLoaded) {\r\n      callback(this);\r\n      return;\r\n    }\r\n\r\n    if (this.target instanceof HTMLElement) {\r\n      callback(this);\r\n      return;\r\n    }\r\n    const observer = new MutationObserver(() => {\r\n      if (document.querySelector(this.target as string)) {\r\n        observer.disconnect(); // Stop observing once loaded\r\n        this.isLoaded = true;\r\n        callback(this); // Call the provided callback\r\n      }\r\n    });\r\n\r\n    observer.observe(document.body, {\r\n      subtree: true,\r\n      childList: true,\r\n    });\r\n  }\r\n}\r\n", "import DOMNodeReference, { _init } from \"./DOMNodeReference.js\";\r\n\r\n/**\r\n * Creates and initializes a DOMNodeReference instance.\r\n * @async\r\n * @param {string | HTMLElement} target - The CSS selector for the desired DOM element, or, optionally, the element itself for which to create a DOMNodeReference.\r\n * @returns {Promise<DOMNodeReference>} A promise that resolves to a Proxy of the initialized DOMNodeReference instance.\r\n */\r\nexport async function createDOMNodeReference(\r\n  target: HTMLElement | string\r\n): Promise<DOMNodeReference> {\r\n  try {\r\n    const instance = new DOMNodeReference(target);\r\n    await instance[_init]();\r\n\r\n    return new Proxy(instance, {\r\n      get: (target, prop) => {\r\n        // do not proxy the initialization method\r\n        // init() is only needed in this factory function\r\n        if (prop.toString().startsWith(\"_\")) return undefined;\r\n\r\n        // proxy the class to wrap all methods in the 'onceLoaded' method, to make sure the\r\n        // element is always available before executing method\r\n        const value = target[prop as keyof DOMNodeReference];\r\n        if (typeof value === \"function\" && prop !== \"onceLoaded\") {\r\n          return (...args: any[]) => {\r\n            target.onceLoaded(() => value.apply(target, args));\r\n            return target;\r\n          };\r\n        }\r\n        return value;\r\n      },\r\n    });\r\n  } catch (e) {\r\n    throw new Error(e as string);\r\n  }\r\n}\r\n\r\n/**\r\n * Creates and initializes multiple DOMNodeReference instances.\r\n * @async\r\n * @param {string} querySelector - The CSS selector for the desired DOM elements.\r\n * @returns {Promise<DOMNodeReference[]>} A promise that resolves to an array of Proxies of initialized DOMNodeReference instances.\r\n */\r\nexport async function createMultipleDOMNodeReferences(\r\n  querySelector: string\r\n): Promise<DOMNodeReference[]> {\r\n  try {\r\n    const elements = Array.from(\r\n      document.querySelectorAll(querySelector)\r\n    ) as HTMLElement[];\r\n\r\n    const initializedElements = await Promise.all(\r\n      elements.map((element) => createDOMNodeReference(element))\r\n    );\r\n\r\n    const domNodeArray = initializedElements as DOMNodeReferenceArray;\r\n\r\n    domNodeArray.hideAll = () =>\r\n      domNodeArray.forEach((instance) => instance.hide());\r\n    domNodeArray.showAll = () =>\r\n      domNodeArray.forEach((instance) => instance.show());\r\n\r\n    return domNodeArray;\r\n  } catch (e) {\r\n    console.error(\r\n      `There was an error creating multiple DOMNodeReferences: ${e}`\r\n    );\r\n    throw new Error(e as string);\r\n  }\r\n}\r\n", "import { createMultipleDOMNodeReferences } from \"./createDOMNodeReferences.js\";\r\nimport DOMNodeReference, { _init } from \"./DOMNodeReference.js\";\r\nimport ListItem from \"./ListItem.js\";\r\nexport const _listInit = Symbol(\"_listInit\");\r\n\r\n/******/ /******/ /******/ export default class List extends DOMNodeReference {\r\n  /**\r\n   * @property an array of List Items contained within this list\r\n   */\r\n  public declare listItems: ListItem[];\r\n\r\n  constructor(target: HTMLElement | string) {\r\n    super(target);\r\n    this.listItems = [];\r\n  }\r\n\r\n  public async [_listInit](): Promise<void> {\r\n    await super[_init]();\r\n    const li = await createMultipleDOMNodeReferences(\r\n      \"div.ms-DetailsRow-fields\"\r\n    );\r\n    console.log(li);\r\n    setTimeout(() => {\r\n      console.log(li);\r\n    }, 1000);\r\n  }\r\n}\r\n", "import List, { _listInit } from \"./List.js\";\r\n\r\nexport default async function (): Promise<List> {\r\n  try {\r\n    const instance = new List(\"div.ms-DetailsList\");\r\n    await instance[_listInit]();\r\n\r\n    return new Proxy(instance, {\r\n      get: (target, prop) => {\r\n        // do not proxy the initialization method\r\n        // init() is only needed in this factory function\r\n        if (prop.toString().startsWith(\"_\")) return undefined;\r\n\r\n        // proxy the class to wrap all methods in the 'onceLoaded' method, to make sure the\r\n        // element is always available before executing method\r\n        const value = target[prop as keyof List];\r\n        if (typeof value === \"function\" && prop !== \"onceLoaded\") {\r\n          return (...args: any[]) => {\r\n            target.onceLoaded(() => value.apply(target, args));\r\n            return target;\r\n          };\r\n        }\r\n        return value;\r\n      },\r\n    });\r\n  } catch (e) {\r\n    throw new Error(e as string);\r\n  }\r\n}\r\n"],
+  "mappings": "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",
+  "names": ["target"]
+}

package/dist/createDOMNodeReferences.js

@@ -0,0 +1,55 @@
+import DOMNodeReference, { _init } from "./DOMNodeReference.js";
+/**
+ * Creates and initializes a DOMNodeReference instance.
+ * @async
+ * @param {string | HTMLElement} target - The CSS selector for the desired DOM element, or, optionally, the element itself for which to create a DOMNodeReference.
+ * @returns {Promise<DOMNodeReference>} A promise that resolves to a Proxy of the initialized DOMNodeReference instance.
+ */
+export async function createDOMNodeReference(target) {
+    try {
+        const instance = new DOMNodeReference(target);
+        await instance[_init]();
+        return new Proxy(instance, {
+            get: (target, prop) => {
+                // do not proxy the initialization method
+                // init() is only needed in this factory function
+                if (prop.toString().startsWith("_"))
+                    return undefined;
+                // proxy the class to wrap all methods in the 'onceLoaded' method, to make sure the
+                // element is always available before executing method
+                const value = target[prop];
+                if (typeof value === "function" && prop !== "onceLoaded") {
+                    return (...args) => {
+                        target.onceLoaded(() => value.apply(target, args));
+                        return target;
+                    };
+                }
+                return value;
+            },
+        });
+    }
+    catch (e) {
+        throw new Error(e);
+    }
+}
+/**
+ * Creates and initializes multiple DOMNodeReference instances.
+ * @async
+ * @param {string} querySelector - The CSS selector for the desired DOM elements.
+ * @returns {Promise<DOMNodeReference[]>} A promise that resolves to an array of Proxies of initialized DOMNodeReference instances.
+ */
+export async function createMultipleDOMNodeReferences(querySelector) {
+    try {
+        const elements = Array.from(document.querySelectorAll(querySelector));
+        const initializedElements = await Promise.all(elements.map((element) => createDOMNodeReference(element)));
+        const domNodeArray = initializedElements;
+        domNodeArray.hideAll = () => domNodeArray.forEach((instance) => instance.hide());
+        domNodeArray.showAll = () => domNodeArray.forEach((instance) => instance.show());
+        return domNodeArray;
+    }
+    catch (e) {
+        console.error(`There was an error creating multiple DOMNodeReferences: ${e}`);
+        throw new Error(e);
+    }
+}
+//# sourceMappingURL=createDOMNodeReferences.js.map

package/dist/createDOMNodeReferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDOMNodeReferences.js","sourceRoot":"","sources":["../src/createDOMNodeReferences.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,EAAE,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAA4B;IAE5B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAExB,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE;YACzB,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;gBACpB,yCAAyC;gBACzC,iDAAiD;gBACjD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,OAAO,SAAS,CAAC;gBAEtD,mFAAmF;gBACnF,sDAAsD;gBACtD,MAAM,KAAK,GAAG,MAAM,CAAC,IAA8B,CAAC,CAAC;gBACrD,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;oBACzD,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE;wBACxB,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;wBACnD,OAAO,MAAM,CAAC;oBAChB,CAAC,CAAC;gBACJ,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,CAAW,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,aAAqB;IAErB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CACzB,QAAQ,CAAC,gBAAgB,CAAC,aAAa,CAAC,CACxB,CAAC;QAEnB,MAAM,mBAAmB,GAAG,MAAM,OAAO,CAAC,GAAG,CAC3C,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAC3D,CAAC;QAEF,MAAM,YAAY,GAAG,mBAA4C,CAAC;QAElE,YAAY,CAAC,OAAO,GAAG,GAAG,EAAE,CAC1B,YAAY,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,YAAY,CAAC,OAAO,GAAG,GAAG,EAAE,CAC1B,YAAY,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAEtD,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,2DAA2D,CAAC,EAAE,CAC/D,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,CAAW,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/createInfoElement.js

@@ -0,0 +1,51 @@
+export default function CreateInfoEl(titleString) {
+    const span = document.createElement("span");
+    span.classList.add("info-icon");
+    const icon = document.createElement("i");
+    icon.classList.add("fa", "fa-solid", "fa-info-circle");
+    icon.setAttribute("aria-label", "Info");
+    icon.style.cursor = "pointer";
+    const flyoutContent = document.createElement("div");
+    flyoutContent.innerHTML = titleString;
+    flyoutContent.classList.add("flyout-content");
+    span.appendChild(icon);
+    span.appendChild(flyoutContent);
+    // Function to position flyout content
+    const positionFlyout = () => {
+        flyoutContent.style.display = "block"; // Show the flyout to calculate dimensions
+        const flyoutRect = flyoutContent.getBoundingClientRect();
+        const viewportWidth = window.innerWidth;
+        // Position the flyout
+        // Adjust if flyout is too far to the right
+        if (flyoutRect.right > viewportWidth) {
+            const overflowAmount = flyoutRect.right - viewportWidth;
+            flyoutContent.style.left = `calc(50% - ${overflowAmount}px)`; // Shift left
+        }
+        // Adjust if flyout is too far to the left
+        if (flyoutRect.left < 0) {
+            const overflowAmount = Math.abs(flyoutRect.left);
+            flyoutContent.style.left = `calc(50% + ${overflowAmount}px)`; // Shift right
+        }
+    };
+    icon.addEventListener("mouseenter", positionFlyout);
+    icon.addEventListener("mouseleave", () => {
+        flyoutContent.style.display = "none"; // Hide on mouse leave
+    });
+    icon.addEventListener("touchstart", (event) => {
+        event.preventDefault();
+        // Toggle flyout visibility on touch
+        flyoutContent.style.display =
+            flyoutContent.style.display === "block" ? "none" : "block";
+        if (flyoutContent.style.display === "block") {
+            positionFlyout(); // Position the flyout when displayed
+        }
+    });
+    document.body.addEventListener("click", (event) => {
+        if (!span.contains(event.target)) {
+            flyoutContent.style.display = "none"; // Hide on body click
+        }
+    });
+    flyoutContent.style.display = "none";
+    return span;
+}
+//# sourceMappingURL=createInfoElement.js.map

package/dist/createInfoElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createInfoElement.js","sourceRoot":"","sources":["../src/createInfoElement.ts"],"names":[],"mappings":"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"}

package/dist/errors.js

@@ -0,0 +1,17 @@
+export class DOMNodeInitializationError extends Error {
+    constructor(instance, error) {
+        super(`There was an error initializing a DOMNodeReference for target: ${instance.target}, :: ${error}`);
+        this.name = "DOMNodeInitializationError";
+    }
+}
+export class DOMNodeNotFoundError extends Error {
+    constructor(instance) {
+        super(`The targeted DOM element was not found: ${instance.target}`);
+    }
+}
+export class ConditionalRenderingError extends Error {
+    constructor(instance, error) {
+        super(`There was an error condiguring conditional rendering for target: ${instance.target} :: ${error}`);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,QAA0B,EAAE,KAAa;QACnD,KAAK,CACH,kEAAkE,QAAQ,CAAC,MAAM,QAAQ,KAAK,EAAE,CACjG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,QAA0B;QACpC,KAAK,CAAC,2CAA2C,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,QAA0B,EAAE,KAAa;QACnD,KAAK,CACH,oEAAoE,QAAQ,CAAC,MAAM,OAAO,KAAK,EAAE,CAClG,CAAC;IACJ,CAAC;CACF"}

package/dist/getList.js

@@ -0,0 +1,29 @@
+import List, { _listInit } from "./List.js";
+export default async function () {
+    try {
+        const instance = new List("div.ms-DetailsList");
+        await instance[_listInit]();
+        return new Proxy(instance, {
+            get: (target, prop) => {
+                // do not proxy the initialization method
+                // init() is only needed in this factory function
+                if (prop.toString().startsWith("_"))
+                    return undefined;
+                // proxy the class to wrap all methods in the 'onceLoaded' method, to make sure the
+                // element is always available before executing method
+                const value = target[prop];
+                if (typeof value === "function" && prop !== "onceLoaded") {
+                    return (...args) => {
+                        target.onceLoaded(() => value.apply(target, args));
+                        return target;
+                    };
+                }
+                return value;
+            },
+        });
+    }
+    catch (e) {
+        throw new Error(e);
+    }
+}
+//# sourceMappingURL=getList.js.map

package/dist/getList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getList.js","sourceRoot":"","sources":["../src/getList.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,CAAC,OAAO,CAAC,KAAK;IAClB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAChD,MAAM,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAE5B,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE;YACzB,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;gBACpB,yCAAyC;gBACzC,iDAAiD;gBACjD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,OAAO,SAAS,CAAC;gBAEtD,mFAAmF;gBACnF,sDAAsD;gBACtD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAkB,CAAC,CAAC;gBACzC,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;oBACzD,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE;wBACxB,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;wBACnD,OAAO,MAAM,CAAC;oBAChB,CAAC,CAAC;gBACJ,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,CAAW,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/// <reference path="../@types/index.d.ts" />
+import API from "./API.js";
+import { createDOMNodeReference, createMultipleDOMNodeReferences, } from "./createDOMNodeReferences.js";
+import getList from "./getList.js";
+import "./style.css";
+export { API, createDOMNodeReference, createMultipleDOMNodeReferences, getList, };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,8BAA8B,CAAC;AACtC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,aAAa,CAAC;AAErB,OAAO,EACL,GAAG,EACH,sBAAsB,EACtB,+BAA+B,EAC/B,OAAO,GACR,CAAC"}

package/dist/safeAjax.js

@@ -0,0 +1,31 @@
+// @ts-nocheck
+export default function safeAjax(ajaxOptions) {
+    const deferredAjax = $.Deferred();
+    // shell is only available via runtime in a PowerPages portal
+    shell
+        .getTokenDeferred()
+        .done(function (token) {
+        // add headers for AJAX
+        if (!ajaxOptions.headers) {
+            $.extend(ajaxOptions, {
+                headers: {
+                    __RequestVerificationToken: token,
+                },
+            });
+        }
+        else {
+            ajaxOptions.headers["__RequestVerificationToken"] = token;
+        }
+        $.ajax(ajaxOptions)
+            .done(function (data, textStatus, jqXHR) {
+            //eslint-disable-next-line
+            validateLoginSession(data, textStatus, jqXHR, deferredAjax.resolve);
+        })
+            .fail(deferredAjax.reject); //AJAX
+    })
+        .fail(function () {
+        deferredAjax.rejectWith(this, arguments); // on token failure pass the token AJAX and args
+    });
+    return deferredAjax.promise();
+}
+//# sourceMappingURL=safeAjax.js.map

package/dist/safeAjax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeAjax.js","sourceRoot":"","sources":["../src/safeAjax.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,WAAW;IAC1C,MAAM,YAAY,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IAElC,6DAA6D;IAE7D,KAAK;SACF,gBAAgB,EAAE;SAClB,IAAI,CAAC,UAAU,KAAK;QACnB,uBAAuB;QACvB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE;gBACpB,OAAO,EAAE;oBACP,0BAA0B,EAAE,KAAK;iBAClC;aACF,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,OAAO,CAAC,4BAA4B,CAAC,GAAG,KAAK,CAAC;QAC5D,CAAC;QACD,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;aAChB,IAAI,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,KAAK;YACrC,0BAA0B;YAC1B,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QACtE,CAAC,CAAC;aACD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;IACtC,CAAC,CAAC;SACD,IAAI,CAAC;QACJ,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,gDAAgD;IAC5F,CAAC,CAAC,CAAC;IAEL,OAAO,YAAY,CAAC,OAAO,EAAE,CAAC;AAChC,CAAC"}

package/dist/waitFor.js

@@ -0,0 +1,33 @@
+export default function waitFor(target) {
+    return new Promise((resolve, reject) => {
+        // Create observer to watch for target in DOM
+        const observer = new MutationObserver(() => {
+            const observedElement = (document.querySelector(target));
+            if (observedElement) {
+                clearTimeout(timeout);
+                observer.disconnect();
+                resolve(observedElement);
+            }
+        });
+        const timeout = setTimeout(() => {
+            observer.disconnect();
+            reject(new Error(`Element not found: ${target} within 5 seconds`));
+        }, 5000);
+        // Check if target is already in DOM
+        if (target instanceof HTMLElement) {
+            clearTimeout(timeout);
+            return resolve(target);
+        }
+        const element = document.querySelector(target);
+        if (element) {
+            clearTimeout(timeout);
+            return resolve(element);
+        }
+        observer.observe(document.body, {
+            subtree: true,
+            attributes: true,
+            childList: true, // Detects added/removed child elements
+        });
+    });
+}
+//# sourceMappingURL=waitFor.js.map

package/dist/waitFor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitFor.js","sourceRoot":"","sources":["../src/waitFor.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,OAAO,CAC7B,MAA4B;IAE5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE;YACzC,MAAM,eAAe,GAAgB,CACnC,QAAQ,CAAC,aAAa,CAAS,MAAM,CAAC,CACvC,CAAC;YACF,IAAI,eAAe,EAAE,CAAC;gBACpB,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACtB,OAAO,CAAC,eAAe,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,MAAM,mBAAmB,CAAC,CAAC,CAAC;QACrE,CAAC,EAAE,IAAI,CAAC,CAAC;QAET,oCAAoC;QACpC,IAAI,MAAM,YAAY,WAAW,EAAE,CAAC;YAClC,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,OAAO,GAAgB,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QAED,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE;YAC9B,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,IAAI,EAAE,uCAAuC;SACzD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/index.d.ts

@@ -8,7 +8,6 @@ class DOMNodeReference {
    */
   constructor(target: string): DOMNodeReference;
 
-  target: string;
   /**
    * The element targeted when instantiating DOMNodeReference.
    * Made available in order to perform normal DOM traversal,
@@ -17,8 +16,6 @@ class DOMNodeReference {
    */
   element: HTMLElement | null;
   isLoaded: boolean;
-  visibilityController: HTMLElement | null;
-  defaultDisplay: string;
   /**
    * The value of the element that this node represents
    * stays in syncs with the live DOM elements via event handler
@@ -50,55 +47,64 @@ class DOMNodeReference {
 
   /**
    * Hides the element by setting its display style to "none".
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  hide(): void;
+  hide(): DOMNodeReference;
 
   /**
    * Shows the element by restoring its default display style.
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  show(): void;
+  show(): DOMNodeReference;
 
   /**
    * Sets the value of the HTML element.
    * @param {() => any} 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
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  setValue(value: string): void;
+  setValue(value: string): DOMNodeReference;
 
   /**
    * Disables the element so that users cannot input any data
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  disable(): void;
+  disable(): DOMNodeReference;
 
   /**
    * Enables the element so that users can input data
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  enable(): void;
+  enable(): DOMNodeReference;
 
   /**
    * Prepends elements to the target
-   * @param {...HTMLElement} elements - The elements to prepend to the HTML element
+   * @param {HTMLElement[] | DOMNodeReference[]} nodes - The elements to prepend to the HTML element
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  prepend(...elements: HTMLElement[]): void;
+  prepend(...nodes: HTMLElement[] | DOMNodeReference[]): DOMNodeReference;
 
   /**
    * Appends child elements to the HTML element.
-   * @param {...HTMLElement} elements - The elements to append to the HTML element.
+   * @param {HTMLElement[] | DOMNodeReference[]} nodes - The elements to append to the HTML element.
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  append(...elements: HTMLElement[]): void;
+  append(...nodes: HTMLElement[] | DOMNodeReference[]): DOMNodeReference;
 
   /**
    * Inserts elements before the HTML element.
-   * @param {...HTMLElement} elements - The elements to insert before the HTML element.
+   * @param {HTMLElement[] | DOMNodeReference[]} nodes - The elements to insert before the HTML element.
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  before(...elements: HTMLElement[]): void;
+  before(...nodes: HTMLElement[] | DOMNodeReference[]): DOMNodeReference;
 
   /**
    * Inserts elements after the HTML element.
-   * @param {...HTMLElement} elements - The elements to insert after the HTML element.
+   * @param {HTMLElement[] | DOMNodeReference[]} nodes - The elements to insert after the HTML element.
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  after(...elements: HTMLElement[]): void;
+  after(...nodes: HTMLElement[] | DOMNodeReference[]): DOMNodeReference;
 
   /**
    * Retrieves the label associated with the HTML element.
@@ -110,8 +116,9 @@ class DOMNodeReference {
   /**
    * Appends child elements to the label associated with the HTML element.
    * @param {...HTMLElement} elements - The elements to append to the label.
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  appendToLabel(...elements: HTMLElement[]): void;
+  appendToLabel(...elements: HTMLElement[]): DOMNodeReference;
 
   /**
    * Sets up an event listener based on the specified event type, executing the specified
@@ -119,12 +126,15 @@ class DOMNodeReference {
    * @param {string} eventType - The DOM event to watch for
    * @param {(this: DOMNodeReference, e: Event) => void} eventHandler - The callback function that runs when the
    * specified event occurs
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  on(eventType: string, eventHandler: (event: Event) => void): void;
+  on(eventType: string, eventHandler: (event: Event) => void): DOMNodeReference;
+
   /**
    * Unchecks both the yes and no radio buttons if they exist.
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  uncheckRadios(): void;
+  uncheckRadios(): DOMNodeReference;
 
   /**
    * Sets up validation and requirement rules for the field. This function dynamically updates the field's required status and validates its input based on the specified conditions.
@@ -133,46 +143,66 @@ class DOMNodeReference {
    * @param {function(this: DOMNodeReference): boolean} isValid - A function that checks if the field's input is valid. Returns `true` if valid, `false` otherwise.
    * @param {string} fieldDisplayName - The name of the field, used in error messages if validation fails.
    * @param {Array<DOMNodeReference>} [dependencies] Other fields that this field’s requirement depends on. When these fields change, the required status of this field is re-evaluated. Make sure any DOMNodeReference used in `isRequired` or `isValid` is included in this array.
+   * @returns {DOMNodeReference} Returns 'this'
    */
   configureValidationAndRequirements(
     isRequired: (this: this) => boolean,
     isValid: (this: this) => boolean,
     fieldDisplayName: string,
     dependencies: Array<DOMNodeReference>
-  ): void;
+  ): DOMNodeReference;
 
   /**
    * Sets the required level for the field by adding or removing the "required-field" class on the label.
    *
    * @param {boolean} isRequired - Determines whether the field should be marked as required.
    * If true, the "required-field" class is added to the label; if false, it is removed.
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  setRequiredLevel(isRequired: boolean): void;
+  setRequiredLevel(isRequired: boolean): DOMNodeReference;
 
   /**
    * Adds a tooltip with specified text to the label associated with the HTML element.
    * @param {string} text - The text to display in the tooltip.
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  addLabelTooltip(text: string): void;
+  addLabelTooltip(text: string): DOMNodeReference;
 
   /**
    * Adds a tooltip with the specified text to the element
    * @param {string} text - The text to display in the tooltip
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  addTooltip(text: string): void;
+  addTooltip(text: string): DOMNodeReference;
 
   /**
    * Sets the inner HTML content of the HTML element.
    * @param {string} text - The text to set as the inner HTML of the element.
+   * @returns {DOMNodeReference} Returns 'this'
+   */
+  setInnerHTML(text: string): DOMNodeReference;
+
+  /**
+   * Removes the element from the DOM
+   * @returns {DOMNodeReference} Returns 'this'
+   */
+  remove(): DOMNodeReference;
+
+  /**
+   *
+   * @param {Partial<CSSStyleDeclaration>} options - An object with the style properties (keys) and updated styles (values)
+   * to apply to the this. {"key": "value"}
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  setTextContent(text: string): void;
+  setStyle(options: Partial<CSSStyleDeclaration>): DOMNodeReference;
 
   /**
    *
    * @param {boolean} shouldShow shows or hides the target
    * if = true => show, if = false => hide
+   * @returns {DOMNodeReference} Returns 'this'
    */
-  toggleVisibility(shouldShow: boolean): void;
+  toggleVisibility(shouldShow: boolean): DOMNodeReference;
 
   /**
    * Configures conditional rendering for the target element based on a condition
@@ -181,14 +211,15 @@ class DOMNodeReference {
    * @param {(this: DOMNodeReference) => boolean} 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 {DOMNodeReference[]} triggerNodes - An array of `DOMNodeReference` instances. Event listeners are
+   * @param {Array<DOMNodeReference>} dependencies - An array of `DOMNodeReference` instances. Event listeners are
    * registered on each to toggle the visibility of the target element based on the `condition` and the visibility of
    * the target node.
+   * @returns {DOMNodeReference} Returns 'this'
    */
   configureConditionalRendering(
     condition: (this: DOMNodeReference) => boolean,
-    triggerNodes: DOMNodeReference[]
-  ): void;
+    dependencies: DOMNodeReference[]
+  ): DOMNodeReference;
 
   /**
    * Executes a callback function once the element is fully loaded.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "powerpagestoolkit",
-  "version": "1.3.2",
+  "version": "1.3.5",
   "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/index.bundle.js",
   "types": "index.d.ts",