@esri/solutions-components 0.4.0 → 0.4.2

package/dist/collection/components/pdf-download/pdf-download.js

@@ -19,13 +19,11 @@
  * limitations under the License.
  */
 import "@esri/calcite-components";
-import * as pdfUtils from "../../assets/data/labelFormats.json";
+import * as pdfLabelFormats from "../../assets/data/labelFormats.json";
+import * as downloadUtils from "../../utils/downloadUtils";
 import { loadModules } from "../../utils/loadModules";
 import { Host, h } from "@stencil/core";
-import { exportCSV } from "../../utils/csvUtils";
-import { exportPDF } from "../../utils/pdfUtils";
 import { getLocaleComponentStrings } from "../../utils/locale";
-import { queryFeaturesByID } from "../../utils/queryUtils";
 export class PdfDownload {
   constructor() {
     this.disabled = false;
@@ -45,26 +43,26 @@ export class PdfDownload {
   /**
    * Downloads csv of mailing labels for the provided list of ids
    *
+   * @param selectionSetNames Names of the selection sets used to provide ids
    * @param ids List of ids to download
    * @param removeDuplicates When true a single label is generated when multiple featues have a shared address value
    * @param addColumnTitle Indicates if column headings should be included in output
    * @returns Promise resolving when function is done
    */
-  async downloadCSV(ids, removeDuplicates, addColumnTitle = true) {
-    const labels = await this._prepareLabels(ids, removeDuplicates, addColumnTitle);
-    return exportCSV(labels);
+  async downloadCSV(selectionSetNames, ids, removeDuplicates, addColumnTitle = true) {
+    return downloadUtils.downloadCSV(selectionSetNames, this.layerView.layer, ids, true, // formatUsingLayerPopup
+    removeDuplicates, addColumnTitle);
   }
   /**
    * Downloads pdf of mailing labels for the provided list of ids
    *
+   * @param selectionSetNames Names of the selection sets used to provide ids
    * @param ids List of ids to download
    * @param removeDuplicates When true a single label is generated when multiple featues have a shared address value
    * @returns Promise resolving when function is done
    */
-  async downloadPDF(ids, removeDuplicates) {
-    const labels = await this._prepareLabels(ids, removeDuplicates);
-    const labelPageDescription = this._labelInfoElement.selectedOption.value;
-    return exportPDF(labels, labelPageDescription);
+  async downloadPDF(selectionSetNames, ids, removeDuplicates) {
+    return downloadUtils.downloadPDF(selectionSetNames, this.layerView.layer, ids, removeDuplicates, this._labelInfoElement.selectedOption.value);
   }
   //--------------------------------------------------------------------------
   //
@@ -107,31 +105,6 @@ export class PdfDownload {
     ]);
     this._intl = intl;
   }
-  /**
-   * Converts the text of a custom popup into a multiline label specification; conversion splits text into
-   * lines on <br>s, and removes HTML tags. It does not handle Arcade and related records.
-   *
-   * @param popupInfo Layer's popupInfo structure containing description, fieldInfos, and expressionInfos, e.g.,
-   * "<div style='text-align: left;'>{NAME}<br />{STREET}<br />{CITY}, {STATE} {ZIP} <br /></div>"
-   * @return Label spec
-   */
-  _convertPopupToLabelSpec(popupInfo) {
-    // Replace <br>, <br/> with |
-    popupInfo = popupInfo.replace(/<br\s*\/?>/gi, "|");
-    // Remove remaining HTML tags, replace 0xA0 that popup uses for spaces, replace some char representations,
-    // and split the label back into individual lines
-    let labelSpec = popupInfo
-      .replace(/<[\s.]*[^<>]*\/?>/gi, "")
-      .replace(/\xA0/gi, " ")
-      .replace(/&lt;/gi, "<")
-      .replace(/&gt;/gi, ">")
-      .replace(/&nbsp;/gi, " ")
-      .split("|");
-    // Trim lines and remove empties
-    labelSpec = labelSpec.map(line => line.trim()).filter(line => line.length > 0);
-    return labelSpec;
-  }
-  ;
   /**
    * Gets the formatted pdf export size text
    *
@@ -154,47 +127,6 @@ export class PdfDownload {
     const translations = await getLocaleComponentStrings(this.el);
     this._translations = translations[0];
   }
-  /**
-   * Creates labels from items.
-  *
-  * @param ids List of ids to download
-  * @param removeDuplicates When true a single label is generated when multiple featues have a shared address value
-  * @param includeHeaderNames Add the label format at the front of the list of generated labels
-  * @returns Promise resolving when function is done
-   */
-  async _prepareLabels(ids, removeDuplicates, includeHeaderNames = false) {
-    // Get the attributes of the features to export
-    const featureSet = await queryFeaturesByID(ids, this.layerView.layer);
-    const featuresAttrs = featureSet.features.map(f => f.attributes);
-    // What data fields are used in the labels?
-    // Example labelFormat: ['{NAME}', '{STREET}', '{CITY}, {STATE} {ZIP}']
-    const labelFormat = this._convertPopupToLabelSpec(this.layerView.layer.popupTemplate.content[0].text);
-    // Convert attributes into an array of labels
-    let labels = featuresAttrs.map(featureAttributes => {
-      const label = [];
-      labelFormat.forEach(labelLineTemplate => {
-        const labelLine = this._intl.substitute(labelLineTemplate, featureAttributes).trim();
-        if (labelLine.length > 0) {
-          label.push(labelLine);
-        }
-      });
-      return label;
-    })
-      // Remove empty labels
-      .filter(label => label.length > 0);
-    // Remove duplicates
-    if (removeDuplicates) {
-      const labelsAsStrings = labels.map(label => JSON.stringify(label));
-      const uniqueLabels = new Set(labelsAsStrings);
-      labels = Array.from(uniqueLabels, labelString => JSON.parse(labelString));
-    }
-    // Add header names
-    if (includeHeaderNames) {
-      const headerNames = labelFormat.map(labelFormatLine => labelFormatLine.replace(/\{/g, "").replace(/\}/g, ""));
-      labels.unshift(headerNames);
-    }
-    return Promise.resolve(labels);
-  }
   /**
    * Renders the pdf export size options
    *
@@ -203,7 +135,7 @@ export class PdfDownload {
    * @protected
    */
   _renderItems() {
-    const s = pdfUtils;
+    const s = pdfLabelFormats;
     const sortedPdfIndo = (s.default || s).sort((a, b) => {
       const _a = parseInt(a.descriptionPDF.labelsPerPageDisplay, 10);
       const _b = parseInt(b.descriptionPDF.labelsPerPageDisplay, 10);
@@ -275,8 +207,14 @@ export class PdfDownload {
     return {
       "downloadCSV": {
         "complexType": {
-          "signature": "(ids: number[], removeDuplicates: boolean, addColumnTitle?: boolean) => Promise<void>",
+          "signature": "(selectionSetNames: string[], ids: number[], removeDuplicates: boolean, addColumnTitle?: boolean) => Promise<void>",
           "parameters": [{
+              "tags": [{
+                  "name": "param",
+                  "text": "selectionSetNames Names of the selection sets used to provide ids"
+                }],
+              "text": "Names of the selection sets used to provide ids"
+            }, {
               "tags": [{
                   "name": "param",
                   "text": "ids List of ids to download"
@@ -305,6 +243,9 @@ export class PdfDownload {
         "docs": {
           "text": "Downloads csv of mailing labels for the provided list of ids",
           "tags": [{
+              "name": "param",
+              "text": "selectionSetNames Names of the selection sets used to provide ids"
+            }, {
               "name": "param",
               "text": "ids List of ids to download"
             }, {
@@ -321,8 +262,14 @@ export class PdfDownload {
       },
       "downloadPDF": {
         "complexType": {
-          "signature": "(ids: number[], removeDuplicates: boolean) => Promise<void>",
+          "signature": "(selectionSetNames: string[], ids: number[], removeDuplicates: boolean) => Promise<void>",
           "parameters": [{
+              "tags": [{
+                  "name": "param",
+                  "text": "selectionSetNames Names of the selection sets used to provide ids"
+                }],
+              "text": "Names of the selection sets used to provide ids"
+            }, {
               "tags": [{
                   "name": "param",
                   "text": "ids List of ids to download"
@@ -338,6 +285,9 @@ export class PdfDownload {
           "references": {
             "Promise": {
               "location": "global"
+            },
+            "downloadUtils": {
+              "location": "global"
             }
           },
           "return": "Promise<void>"
@@ -345,6 +295,9 @@ export class PdfDownload {
         "docs": {
           "text": "Downloads pdf of mailing labels for the provided list of ids",
           "tags": [{
+              "name": "param",
+              "text": "selectionSetNames Names of the selection sets used to provide ids"
+            }, {
               "name": "param",
               "text": "ids List of ids to download"
             }, {

package/dist/collection/components/public-notification/public-notification.js

@@ -82,7 +82,8 @@ export class PublicNotification {
     console.log(oldValue);
     if (JSON.stringify(newValue) !== JSON.stringify(oldValue)) {
       console.log("Emit event from parent");
-      this.searchConfigurationChange.emit(newValue);
+      this.searchConfiguration = Object.assign({}, newValue);
+      this.searchConfigurationChange.emit(this.searchConfiguration);
     }
   }
   /**
@@ -152,8 +153,7 @@ export class PublicNotification {
    * Renders the component.
    */
   render() {
-    const hasSelections = this._selectionSets.length > 0;
-    return (h(Host, null, h("calcite-shell", null, h("calcite-action-bar", { class: "border-bottom-1 action-bar-size", "expand-disabled": true, layout: "horizontal", slot: "header" }, this._getActionGroup("list-check", false, EPageType.LIST, this._translations.myLists), this.showRefineSelection ? this._getActionGroup("test-data", !hasSelections, EPageType.REFINE, this._translations.refineSelection) : undefined, this._getActionGroup("file-pdf", !hasSelections, EPageType.PDF, this._translations.downloadPDF), this._getActionGroup("file-csv", !hasSelections, EPageType.CSV, this._translations.downloadCSV)), this._getPage(this._pageType))));
+    return (h(Host, null, h("calcite-shell", null, h("calcite-action-bar", { class: "border-bottom-1 action-bar-size", "expand-disabled": true, layout: "horizontal", slot: "header" }, this._getActionGroup("list-check", EPageType.LIST, this._translations.myLists), this.showRefineSelection ? this._getActionGroup("test-data", EPageType.REFINE, this._translations.refineSelection) : undefined, this._getActionGroup("file-pdf", EPageType.PDF, this._translations.downloadPDF), this._getActionGroup("file-csv", EPageType.CSV, this._translations.downloadCSV)), this._getPage(this._pageType))));
   }
   //--------------------------------------------------------------------------
   //
@@ -183,9 +183,9 @@ export class PublicNotification {
    *
    * @protected
    */
-  _getActionGroup(icon, disabled, pageType, tip) {
+  _getActionGroup(icon, pageType, tip) {
     const groupClass = this.showRefineSelection ? "action-center w-1-4" : "action-center w-1-3";
-    return (h("calcite-action-group", { class: groupClass, layout: "horizontal" }, h("calcite-action", { active: this._pageType === pageType, alignment: "center", class: "width-full height-full", compact: false, disabled: disabled, icon: icon, id: icon, onClick: () => { this._setPageType(pageType); }, text: "" }), h("calcite-tooltip", { label: "", placement: "bottom", "reference-element": icon }, h("span", null, tip))));
+    return (h("calcite-action-group", { class: groupClass, layout: "horizontal" }, h("calcite-action", { active: this._pageType === pageType, alignment: "center", class: "width-full height-full", compact: false, icon: icon, id: icon, onClick: () => { this._setPageType(pageType); }, text: "" }), h("calcite-tooltip", { label: "", placement: "bottom", "reference-element": icon }, h("span", null, tip))));
   }
   /**
    * Navigate to the defined page type
@@ -299,6 +299,16 @@ export class PublicNotification {
       this._layerSelectionChangeEvt.detail[0] : "";
     await this._updateAddresseeLayer(id);
   }
+  /**
+   * Check if any selection sets exist.
+   *
+   * @returns true if selection sets exist
+   *
+   * @protected
+   */
+  _hasSelections() {
+    return this._selectionSets.length > 0;
+  }
   /**
    * Create the Select page that shows the selection workflows
    *
@@ -316,7 +326,7 @@ export class PublicNotification {
       this._selectionWorkflowType === EWorkflowType.SKETCH ? sketchTip : searchTip;
     const nameLabelClass = this.customLabelEnabled ? "" : "display-none";
     return (h("calcite-panel", null, this._getLabel(this._translations.stepTwoFull.replace("{{layer}}", (_a = this.addresseeLayer) === null || _a === void 0 ? void 0 : _a.layer.title)), this._getNotice(noticeText), h("div", { class: "padding-top-sides-1" }, h("map-select-tools", { bufferColor: this.bufferColor, bufferOutlineColor: this.bufferOutlineColor, class: "font-bold", defaultBufferDistance: this.defaultBufferDistance, defaultBufferUnit: this.defaultBufferUnit, enabledLayerIds: this.selectionLayerIds, isUpdate: !!this._activeSelection, mapView: this.mapView, onSelectionSetChange: (evt) => this._updateForSelection(evt), onWorkflowTypeChange: (evt) => this._updateForWorkflowType(evt), ref: (el) => { this._selectTools = el; }, searchConfiguration: this.searchConfiguration, selectLayerView: this.addresseeLayer, selectionSet: this._activeSelection, showBufferTools: this.showSearchSettings })), h("div", { class: "padding-sides-1 padding-bottom-1", style: { "align-items": "end", "display": "flex" } }, h("calcite-icon", { class: "info-blue padding-end-1-2", icon: "feature-layer", scale: "s" }), h("calcite-input-message", { active: true, class: "info-blue", scale: "m" }, this.noResultText && this._numSelected === 0 ? this.noResultText :
-      this._translations.selectedAddresses.replace("{{n}}", this._numSelected.toString()).replace("{{layer}}", ((_b = this.addresseeLayer) === null || _b === void 0 ? void 0 : _b.layer.title) || ""))), h("div", { class: "padding-sides-1 " + nameLabelClass }, h("calcite-label", { class: "font-bold" }, "Name label", h("calcite-input", { onInput: () => {
+      this._translations.selectedAddresses.replace("{{n}}", this._numSelected.toString()).replace("{{layer}}", ((_b = this.addresseeLayer) === null || _b === void 0 ? void 0 : _b.layer.title) || ""))), h("div", { class: "padding-sides-1 " + nameLabelClass }, h("calcite-label", { class: "font-bold" }, "List name", h("calcite-input", { onInput: () => {
         this.labelChange.emit(this._labelName.value);
       }, placeholder: "Insert label here...", ref: (el) => { this._labelName = el; }, value: this._customLabel || "" }))), this._getPageNavButtons(this._translations.done, this._numSelected === 0, () => { void this._saveSelection(); }, this._translations.cancel, false, () => { void this._home(); })));
   }
@@ -327,7 +337,9 @@ export class PublicNotification {
    * @protected
    */
   _getRefinePage() {
-    return (h("calcite-panel", null, this._getLabel(this._translations.refineSelection), this._getNotice(this._translations.refineTip, "padding-sides-1"), h("refine-selection", { addresseeLayer: this.addresseeLayer, enabledLayerIds: this.selectionLayerIds, mapView: this.mapView, selectionSets: this._selectionSets })));
+    const hasSelections = this._hasSelections();
+    return (h("calcite-panel", null, this._getLabel(this._translations.refineSelection), hasSelections ? (h("div", null, this._getNotice(this._translations.refineTip, "padding-sides-1"), h("refine-selection", { addresseeLayer: this.addresseeLayer, enabledLayerIds: this.selectionLayerIds, mapView: this.mapView, selectionSets: this._selectionSets }))) :
+      this._getNotice(this._translations.refineTipNoSelections, "padding-sides-1")));
   }
   /**
    * Create the PDF download page that shows the download options
@@ -358,7 +370,8 @@ export class PublicNotification {
    */
   _getDownloadPage(type) {
     const isPdf = type === EExportType.PDF;
-    return (h("calcite-panel", null, h("div", null, h("div", { class: "padding-top-sides-1" }, h("calcite-label", { class: "font-bold" }, isPdf ? this._translations.pdfDownloads : this._translations.csvDownloads), h("calcite-label", null, this._translations.notifications)), this._getSelectionLists(), h("div", { class: "margin-side-1 padding-top-1 border-bottom" }), h("div", { class: "padding-top-sides-1" }, h("calcite-label", { layout: "inline" }, h("calcite-checkbox", { disabled: !this._downloadActive, ref: (el) => { this._removeDuplicates = el; } }), this._translations.removeDuplicate)), h("div", { class: isPdf ? "" : "display-none" }, this._getLabel(this._translations.selectPDFLabelOption, false), h("div", { class: "padding-sides-1" }, h("pdf-download", { disabled: !this._downloadActive, layerView: this.addresseeLayer, ref: (el) => { this._downloadTools = el; } }))), h("div", { class: "padding-1 display-flex" }, h("calcite-button", { disabled: !this._downloadActive, onClick: isPdf ? () => this._downloadPDF() : () => this._downloadCSV(), width: "full" }, isPdf ? this._translations.downloadPDF : this._translations.downloadCSV)))));
+    const hasSelections = this._hasSelections();
+    return (h("calcite-panel", null, h("div", null, h("div", { class: "padding-top-sides-1" }, h("calcite-label", { class: "font-bold" }, isPdf ? this._translations.downloadPDF : this._translations.downloadCSV)), hasSelections ? (h("div", null, h("calcite-label", null, this._translations.notifications), this._getSelectionLists(), h("div", { class: "margin-side-1 padding-top-1 border-bottom" }), h("div", { class: "padding-top-sides-1" }, h("calcite-label", { layout: "inline" }, h("calcite-checkbox", { disabled: !this._downloadActive, ref: (el) => { this._removeDuplicates = el; } }), this._translations.removeDuplicate)), h("div", { class: isPdf ? "" : "display-none" }, this._getLabel(this._translations.selectPDFLabelOption, false), h("div", { class: "padding-sides-1" }, h("pdf-download", { disabled: !this._downloadActive, layerView: this.addresseeLayer, ref: (el) => { this._downloadTools = el; } }))), h("div", { class: "padding-1 display-flex" }, h("calcite-button", { disabled: !this._downloadActive, onClick: isPdf ? () => this._downloadPDF() : () => this._downloadCSV(), width: "full" }, isPdf ? this._translations.downloadPDF : this._translations.downloadCSV)))) : (this._getNotice(this._translations.downloadNoLists, "padding-sides-1 padding-bottom-1")))));
   }
   /**
    * Create the stacked navigation buttons for a page
@@ -441,7 +454,8 @@ export class PublicNotification {
    */
   _downloadPDF() {
     const ids = utils.getSelectionIds(this._getDownloadSelectionSets());
-    void this._downloadTools.downloadPDF(ids, this._removeDuplicates.checked);
+    const selectionSetNames = this._selectionSets.map(set => set.label);
+    void this._downloadTools.downloadPDF(selectionSetNames, ids, this._removeDuplicates.checked);
   }
   /**
    * Download all selection sets as CSV
@@ -450,7 +464,8 @@ export class PublicNotification {
    */
   _downloadCSV() {
     const ids = utils.getSelectionIds(this._getDownloadSelectionSets());
-    void this._downloadTools.downloadCSV(ids, this._removeDuplicates.checked);
+    const selectionSetNames = this._selectionSets.map(set => set.label);
+    void this._downloadTools.downloadCSV(selectionSetNames, ids, this._removeDuplicates.checked);
   }
   /**
    * Get all enabled selection sets
@@ -897,7 +912,7 @@ export class PublicNotification {
       },
       "searchConfiguration": {
         "type": "unknown",
-        "mutable": false,
+        "mutable": true,
         "complexType": {
           "original": "ISearchConfiguration",
           "resolved": "ISearchConfiguration",

package/dist/collection/components/refine-selection/refine-selection.js

@@ -118,7 +118,7 @@ export class RefineSelection {
     const refineSet = this._getRefineSelectionSet(this.selectionSets);
     const numAdded = (refineSet === null || refineSet === void 0 ? void 0 : refineSet.refineIds.addIds.length) || 0;
     const numRemoved = (refineSet === null || refineSet === void 0 ? void 0 : refineSet.refineIds.removeIds.length) || 0;
-    return [(h("calcite-list-item", { label: this._translations.featuresAdded.replace("{{n}}", numAdded.toString()) })), (h("calcite-list-item", { label: this._translations.featuresRemoved.replace("{{n}}", numRemoved.toString()) })), (h("calcite-list-item", { label: this._translations.totalSelected.replace("{{n}}", total.toString()) }))];
+    return [(h("calcite-list-item", { label: this._translations.featuresAdded.replace("{{n}}", numAdded.toString()), "non-interactive": true })), (h("calcite-list-item", { label: this._translations.featuresRemoved.replace("{{n}}", numRemoved.toString()), "non-interactive": true })), (h("calcite-list-item", { label: this._translations.totalSelected.replace("{{n}}", total.toString()), "non-interactive": true }))];
   }
   /**
    * Fetch the refine selection set

package/dist/collection/utils/csvUtils.js

@@ -18,6 +18,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+//#region Public functions
 /**
  * Export a csv of the attributes from the features that match the provided ids
  *
@@ -29,6 +30,8 @@ export function exportCSV(labels) {
   const outputLines = labels.map(label => Object.values(label).map(v => `"${v}"`).join(",") + "\r\n");
   _downloadCSVFile(outputLines, `notify-${Date.now().toString()}`);
 }
+//#endregion
+//#region Private functions
 /**
  * Download the CSV file
  *
@@ -48,3 +51,4 @@ function _downloadCSVFile(outputLines, fileTitle) {
     document.body.removeChild(link);
   }
 }
+//#endregion

package/dist/collection/utils/csvUtils.ts

@@ -14,6 +14,8 @@
  * limitations under the License.
  */
 
+//#region Public functions
+
 /**
  * Export a csv of the attributes from the features that match the provided ids
  *
@@ -29,6 +31,9 @@ export function exportCSV(
   _downloadCSVFile(outputLines, `notify-${Date.now().toString()}`);
 }
 
+//#endregion
+//#region Private functions
+
 /**
  * Download the CSV file
  *
@@ -51,3 +56,5 @@ function _downloadCSVFile(
     document.body.removeChild(link);
   }
 }
+
+//#endregion

package/dist/collection/utils/downloadUtils.js

@@ -0,0 +1,254 @@
+/*!
+ * Copyright 2022 Esri
+ * Licensed under the Apache License, Version 2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
+ */
+/** @license
+ * Copyright 2022 Esri
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+//#region Declarations
+import { exportCSV } from "./csvUtils";
+import { exportPDF } from "./pdfUtils";
+import { loadModules } from "./loadModules";
+import { queryFeaturesByID } from "./queryUtils";
+export { ILabel } from "./pdfUtils";
+//#endregion
+//#region Public functions
+/**
+ * Downloads csv of mailing labels for the provided list of ids
+ *
+ * @param selectionSetNames Names of the selection sets used to provide ids
+ * @param layer Layer providing features and attributes for download
+ * @param ids List of ids to download
+ * @param formatUsingLayerPopup When true, the layer's popup is used to choose attributes for each column; when false,
+ * all attributes are exported
+ * @param removeDuplicates When true a single label is generated when multiple featues have a shared address value
+ * @param addColumnTitle Indicates if column headings should be included in output
+ * @returns Promise resolving when function is done
+ */
+export async function downloadCSV(selectionSetNames, layer, ids, formatUsingLayerPopup, removeDuplicates = false, addColumnTitle = false) {
+  console.log("downloadCSV using selectionSetNames " + JSON.stringify(selectionSetNames)); //???
+  const labels = await _prepareLabels(layer, ids, removeDuplicates, formatUsingLayerPopup, addColumnTitle);
+  exportCSV(labels);
+  return Promise.resolve();
+}
+/**
+ * Downloads csv of mailing labels for the provided list of ids
+ *
+ * @param selectionSetNames Names of the selection sets used to provide ids
+ * @param layer Layer providing features and attributes for download
+ * @param ids List of ids to download
+ * @param removeDuplicates When true a single label is generated when multiple featues have a shared address value
+ * @param labelPageDescription Provides PDF page layout info
+ * @returns Promise resolving when function is done
+ */
+export async function downloadPDF(selectionSetNames, layer, ids, removeDuplicates, labelPageDescription) {
+  console.log("downloadPDF using selectionSetNames " + JSON.stringify(selectionSetNames)); //???
+  const labels = await _prepareLabels(layer, ids, removeDuplicates);
+  exportPDF(labels, labelPageDescription);
+  return Promise.resolve();
+}
+//#endregion
+//#region Private functions
+/**
+ * Converts a set of fieldInfos into template lines.
+ *
+ * @param fieldInfos Layer's fieldInfos structure
+ * @param bypassFieldVisiblity Indicates if the configured fieldInfo visibility property should be ignored
+ * @return Label spec
+ */
+function _convertPopupFieldsToLabelSpec(fieldInfos, bypassFieldVisiblity = false) {
+  const labelSpec = [];
+  // Every visible attribute is used
+  fieldInfos.forEach(fieldInfo => {
+    if (fieldInfo.visible || bypassFieldVisiblity) {
+      labelSpec.push(`{${fieldInfo.fieldName}}`);
+    }
+  });
+  return labelSpec;
+}
+;
+/**
+ * Converts the text of a custom popup into a multiline label specification; conversion splits text into
+ * lines on <br>s, and removes HTML tags. It does not handle Arcade and related records.
+ *
+ * @param popupInfo Layer's popupInfo structure containing description, fieldInfos, and expressionInfos, e.g.,
+ * "<div style='text-align: left;'>{NAME}<br />{STREET}<br />{CITY}, {STATE} {ZIP} <br /></div>"
+ * @return Label spec
+ */
+function _convertPopupTextToLabelSpec(popupInfo) {
+  // Replace <br>, <br/> with |
+  popupInfo = popupInfo.replace(/<br\s*\/?>/gi, "|");
+  // Remove remaining HTML tags, replace 0xA0 that popup uses for spaces, replace some char representations,
+  // and split the label back into individual lines
+  let labelSpec = popupInfo
+    .replace(/<[\s.]*[^<>]*\/?>/gi, "")
+    .replace(/\xA0/gi, " ")
+    .replace(/&lt;/gi, "<")
+    .replace(/&gt;/gi, ">")
+    .replace(/&nbsp;/gi, " ")
+    .split("|");
+  // Trim lines and remove empties
+  labelSpec = labelSpec.map(line => line.trim()).filter(line => line.length > 0);
+  return labelSpec;
+}
+;
+/**
+ * Extracts Arcade expressions from the lines of a label format and creates an Arcade executor for each
+ * referenced expression name.
+ *
+ * @param labelFormat Label to examine
+ * @param layer Layer from which to fetch features
+ * @return Promise resolving to a set of executors keyed using the expression name
+ */
+async function _createArcadeExecutors(labelFormat, layer) {
+  const arcadeExecutors = {};
+  // Are any Arcade expressions in the layer?
+  if (!Array.isArray(layer.popupTemplate.expressionInfos) || layer.popupTemplate.expressionInfos.length === 0) {
+    return Promise.resolve(arcadeExecutors);
+  }
+  // Are there any Arcade expressions in the label format?
+  const arcadeExpressionRegExp = /\{expression\/\w+\}/g;
+  const arcadeExpressionsMatches = labelFormat.join("|").match(arcadeExpressionRegExp);
+  if (!arcadeExpressionsMatches) {
+    return Promise.resolve(arcadeExecutors);
+  }
+  // Generate an Arcade executor for each match
+  const [arcade] = await loadModules(["esri/arcade"]);
+  const labelingProfile = arcade.createArcadeProfile("popup");
+  const createArcadeExecutorPromises = {};
+  arcadeExpressionsMatches.forEach((match) => {
+    const expressionName = match.substring(match.indexOf("/") + 1, match.length - 1);
+    (layer.popupTemplate.expressionInfos || []).forEach(expressionInfo => {
+      if (expressionInfo.name === expressionName) {
+        createArcadeExecutorPromises[expressionName] =
+          arcade.createArcadeExecutor(expressionInfo.expression, labelingProfile);
+      }
+    });
+  });
+  const promises = Object.values(createArcadeExecutorPromises);
+  return Promise.all(promises)
+    .then(executors => {
+    const expressionNames = Object.keys(createArcadeExecutorPromises);
+    for (let i = 0; i < expressionNames.length; ++i) {
+      arcadeExecutors[expressionNames[i]] = executors[i].valueOf();
+    }
+    return arcadeExecutors;
+  });
+}
+/**
+ * Creates labels from items.
+ *
+ * @param layer Layer from which to fetch features
+ * @param ids List of ids to download
+ * @param removeDuplicates When true a single label is generated when multiple featues have a shared address value
+ * @param formatUsingLayerPopup When true, the layer's popup is used to choose attributes for each column; when false,
+ * all attributes are exported
+ * @param includeHeaderNames Add the label format at the front of the list of generated labels
+ * @returns Promise resolving when function is done
+ */
+async function _prepareLabels(layer, ids, removeDuplicates = true, formatUsingLayerPopup = true, includeHeaderNames = false) {
+  var _a, _b, _c, _d;
+  const [intl] = await loadModules(["esri/intl"]);
+  // Get the features to export
+  const featureSet = await queryFeaturesByID(ids, layer);
+  // Get the label formatting, if any
+  let labelFormat;
+  let arcadeExecutors = {};
+  if (layer.popupEnabled) {
+    // What data fields are used in the labels?
+    // Example labelFormat: ['{NAME}', '{STREET}', '{CITY}, {STATE} {ZIP}']
+    if (formatUsingLayerPopup && ((_b = (_a = layer.popupTemplate) === null || _a === void 0 ? void 0 : _a.content[0]) === null || _b === void 0 ? void 0 : _b.type) === "fields") {
+      labelFormat = _convertPopupFieldsToLabelSpec(layer.popupTemplate.fieldInfos);
+      // If popup is configured with "no attribute information", then no fields will visible
+      if (labelFormat.length === 0) {
+        // Can we use the popup title?
+        // eslint-disable-next-line unicorn/prefer-ternary
+        if (typeof layer.popupTemplate.title === "string") {
+          labelFormat = [layer.popupTemplate.title];
+          // Otherwise revert to using attributes
+        }
+        else {
+          labelFormat = _convertPopupFieldsToLabelSpec(layer.popupTemplate.fieldInfos, true);
+        }
+      }
+    }
+    else if (formatUsingLayerPopup && ((_d = (_c = layer.popupTemplate) === null || _c === void 0 ? void 0 : _c.content[0]) === null || _d === void 0 ? void 0 : _d.type) === "text") {
+      labelFormat = _convertPopupTextToLabelSpec(layer.popupTemplate.content[0].text);
+      // Do we need any Arcade executors?
+      arcadeExecutors = await _createArcadeExecutors(labelFormat, layer);
+    }
+  }
+  // Apply the label format
+  let labels;
+  // eslint-disable-next-line unicorn/prefer-ternary
+  if (labelFormat) {
+    const arcadeExpressionRegExp = /\{expression\/\w+\}/g;
+    // Convert attributes into an array of labels
+    labels = featureSet.features.map(feature => {
+      const label = [];
+      labelFormat.forEach(labelLineTemplate => {
+        let labelLine = labelLineTemplate;
+        // Replace Arcade expressions
+        const arcadeExpressionsMatches = labelLine.match(arcadeExpressionRegExp);
+        if (arcadeExpressionsMatches) {
+          arcadeExpressionsMatches.forEach((match) => {
+            const expressionName = match.substring(match.indexOf("/") + 1, match.length - 1);
+            const replacement = arcadeExecutors[expressionName].execute({ "$feature": feature });
+            labelLine = labelLine.replace(match, replacement);
+          });
+        }
+        // Replace fields; must be done after Arcade check because `substitute` will discard Arcade expressions!
+        labelLine = intl.substitute(labelLine, feature.attributes).trim();
+        if (labelLine.length > 0) {
+          label.push(labelLine);
+        }
+      });
+      return label;
+    })
+      // Remove empty labels
+      .filter(label => label.length > 0);
+  }
+  else {
+    // Export all attributes
+    labels = featureSet.features.map(feature => {
+      return Object.values(feature.attributes).map(attribute => `${attribute}`);
+    });
+  }
+  // Remove duplicates
+  if (removeDuplicates) {
+    const labelsAsStrings = labels.map(label => JSON.stringify(label));
+    const uniqueLabels = new Set(labelsAsStrings);
+    labels = Array.from(uniqueLabels, labelString => JSON.parse(labelString));
+  }
+  // Add header names
+  if (includeHeaderNames) {
+    let headerNames = [];
+    if (labelFormat) {
+      headerNames = labelFormat.map(labelFormatLine => labelFormatLine.replace(/\{/g, "").replace(/\}/g, ""));
+    }
+    else {
+      const featuresAttrs = featureSet.features[0].attributes;
+      Object.keys(featuresAttrs).forEach(k => {
+        if (featuresAttrs[0].hasOwnProperty(k)) {
+          headerNames.push(k);
+        }
+      });
+    }
+    labels.unshift(headerNames);
+  }
+  return Promise.resolve(labels);
+}
+//#endregion