@esri/solutions-components 0.4.0 → 0.4.1

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;
@@ -51,8 +49,8 @@ export class PdfDownload {
    * @returns Promise resolving when function is done
    */
   async downloadCSV(ids, removeDuplicates, addColumnTitle = true) {
-    const labels = await this._prepareLabels(ids, removeDuplicates, addColumnTitle);
-    return exportCSV(labels);
+    return downloadUtils.downloadCSV(this.layerView.layer, ids, true, // formatUsingLayerPopup
+    removeDuplicates, addColumnTitle);
   }
   /**
    * Downloads pdf of mailing labels for the provided list of ids
@@ -62,9 +60,7 @@ export class PdfDownload {
    * @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);
+    return downloadUtils.downloadPDF(this.layerView.layer, ids, removeDuplicates, this._labelInfoElement.selectedOption.value);
   }
   //--------------------------------------------------------------------------
   //
@@ -107,31 +103,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 +125,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 +133,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);
@@ -338,6 +268,9 @@ export class PdfDownload {
           "references": {
             "Promise": {
               "location": "global"
+            },
+            "downloadUtils": {
+              "location": "global"
             }
           },
           "return": "Promise<void>"

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

@@ -316,7 +316,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(); })));
   }
@@ -358,7 +358,7 @@ 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)))));
+    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), 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)))));
   }
   /**
    * Create the stacked navigation buttons for a page
@@ -897,7 +897,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,181 @@
+/*!
+ * 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 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(layer, ids, formatUsingLayerPopup, removeDuplicates = false, addColumnTitle = false) {
+  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 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(layer, ids, removeDuplicates, labelPageDescription) {
+  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
+ * @return Label spec
+ */
+function _convertPopupFieldsToLabelSpec(fieldInfos) {
+  const labelSpec = [];
+  // Every visible attribute is used
+  fieldInfos.forEach(fieldInfo => {
+    if (fieldInfo.visible) {
+      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;
+}
+;
+/**
+ * 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 attributes of the features to export
+  const featureSet = await queryFeaturesByID(ids, layer);
+  const featuresAttrs = featureSet.features.map(f => f.attributes);
+  // Get the label formatting, if any
+  let labelFormat;
+  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);
+    }
+    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);
+    }
+  }
+  // Apply the label format
+  let labels;
+  // eslint-disable-next-line unicorn/prefer-ternary
+  if (labelFormat) {
+    // Convert attributes into an array of labels
+    labels = featuresAttrs.map(featureAttributes => {
+      const label = [];
+      labelFormat.forEach(labelLineTemplate => {
+        const labelLine = intl.substitute(labelLineTemplate, featureAttributes).trim();
+        if (labelLine.length > 0) {
+          label.push(labelLine);
+        }
+      });
+      return label;
+    })
+      // Remove empty labels
+      .filter(label => label.length > 0);
+  }
+  else {
+    // Export all attributes
+    labels = featuresAttrs.map(featureAttributes => {
+      return Object.values(featureAttributes).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 {
+      Object.keys(featuresAttrs[0]).forEach(k => {
+        if (featuresAttrs[0].hasOwnProperty(k)) {
+          headerNames.push(k);
+        }
+      });
+    }
+    labels.unshift(headerNames);
+  }
+  return Promise.resolve(labels);
+}
+//#endregion

package/dist/collection/utils/downloadUtils.ts

@@ -0,0 +1,235 @@
+/** @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 { ILabel, 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 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(
+  layer: __esri.FeatureLayer,
+  ids: number[],
+  formatUsingLayerPopup: boolean,
+  removeDuplicates = false,
+  addColumnTitle = false
+): Promise<void> {
+  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 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(
+  layer: __esri.FeatureLayer,
+  ids: number[],
+  removeDuplicates: boolean,
+  labelPageDescription: ILabel
+): Promise<void> {
+  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
+ * @return Label spec
+ */
+function _convertPopupFieldsToLabelSpec(
+  fieldInfos: __esri.FieldInfo[]
+): string[] {
+  const labelSpec: string[] = [];
+
+  // Every visible attribute is used
+  fieldInfos.forEach(
+    fieldInfo => {
+      if (fieldInfo.visible) {
+        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: string
+): string[] {
+  // 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;
+};
+
+/**
+ * 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: __esri.FeatureLayer,
+  ids: number[],
+  removeDuplicates = true,
+  formatUsingLayerPopup = true,
+  includeHeaderNames = false
+): Promise<string[][]> {
+  const [intl] = await loadModules([
+    "esri/intl"
+  ]);
+
+  // Get the attributes of the features to export
+  const featureSet = await queryFeaturesByID(ids, layer);
+  const featuresAttrs = featureSet.features.map(f => f.attributes);
+
+  // Get the label formatting, if any
+  let labelFormat: string[];
+  if (layer.popupEnabled) {
+    // What data fields are used in the labels?
+    // Example labelFormat: ['{NAME}', '{STREET}', '{CITY}, {STATE} {ZIP}']
+    if (formatUsingLayerPopup && layer.popupTemplate?.content[0]?.type === "fields") {
+      labelFormat = _convertPopupFieldsToLabelSpec(layer.popupTemplate.fieldInfos);
+
+    } else if (formatUsingLayerPopup && layer.popupTemplate?.content[0]?.type === "text") {
+      labelFormat = _convertPopupTextToLabelSpec(layer.popupTemplate.content[0].text);
+
+    }
+  }
+
+  // Apply the label format
+  let labels: string[][];
+  // eslint-disable-next-line unicorn/prefer-ternary
+  if (labelFormat) {
+    // Convert attributes into an array of labels
+    labels = featuresAttrs.map(
+      featureAttributes => {
+        const label: string[] = [];
+        labelFormat.forEach(
+          labelLineTemplate => {
+            const labelLine = intl.substitute(labelLineTemplate, featureAttributes).trim();
+            if (labelLine.length > 0) {
+              label.push(labelLine);
+            }
+          }
+        )
+        return label;
+      }
+    )
+    // Remove empty labels
+    .filter(label => label.length > 0);
+
+  } else {
+    // Export all attributes
+    labels = featuresAttrs.map(
+      featureAttributes => {
+        return Object.values(featureAttributes).map(
+          attribute => `${attribute}`
+        );
+      }
+    );
+  }
+
+  // Remove duplicates
+  if (removeDuplicates) {
+    const labelsAsStrings: string[] = 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 {
+      Object.keys(featuresAttrs[0]).forEach(k => {
+        if (featuresAttrs[0].hasOwnProperty(k)) {
+          headerNames.push(k);
+        }
+      });
+    }
+
+    labels.unshift(headerNames);
+  }
+
+  return Promise.resolve(labels);
+}
+
+//#endregion

package/dist/collection/utils/interfaces.ts

@@ -108,7 +108,7 @@ export interface ISearchConfiguration {
   sources: Array<ILocatorSourceConfigItem | ILayerSourceConfigItem>;
 }
 
-interface ISearchSourceConfigItem {
+export interface ISearchSourceConfigItem {
   maxResults: number;
   maxSuggestions: number;
   minSuggestCharacters: number;
@@ -387,7 +387,8 @@ export interface ISelectionSet {
   refineIds: IRefineIds;
   redoStack?: IRefineOperation[];
   undoStack?: IRefineOperation[];
-  skipGeomQuery?: boolean;
+  //skipGeomQuery?: boolean;
+  skipGeomOIDs?: number[];
 }
 
 export interface IRefineSelectionEvent {