@esri/solutions-components 0.5.0 → 0.5.2

package/dist/cjs/{downloadUtils-415ab342.js → downloadUtils-9359e9ff.js}

@@ -8,7 +8,7 @@
 const _commonjsHelpers = require('./_commonjsHelpers-384729db.js');
 const index = require('./index-c6979cbb.js');
 const loadModules = require('./loadModules-0806a34f.js');
-const mapViewUtils = require('./mapViewUtils-f617ae9a.js');
+const mapViewUtils = require('./mapViewUtils-090f4d4d.js');
 
 /** @license
  * Copyright 2022 Esri
@@ -26,32 +26,19 @@ const mapViewUtils = require('./mapViewUtils-f617ae9a.js');
  * limitations under the License.
  */
 //#region Public functions
-/**
- * Export a csv of the attributes from the features that match the provided ids
- *
- * @param labels Labels to write
- */
-function exportCSV(labels) {
-  // Format values to string so it doesn't get tripped up when a value has a comma
-  // another option could be to export with a different delimiter
-  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
  *
+ * @param title Title (without file extension) to use for file; defaults to "export"
  * @param outputLines Lines of output to write to file
- * @param fileTitle Title (without file extension) to use for file; defaults to "export"
  *
  * @see {@link https://medium.com/@danny.pule/export-json-to-csv-file-using-javascript-a0b7bc5b00d2}
  */
-function _downloadCSVFile(outputLines, fileTitle) {
+function downloadCSVFile(title, outputLines) {
   const link = document.createElement("a");
   if (link.download !== undefined) {
     link.href = URL.createObjectURL(new Blob(outputLines, { type: "text/csv;charset=utf-8;" }));
-    link.download = `${fileTitle}.csv` || "export.csv";
+    link.download = `${title}.csv` || "export.csv";
     link.style.visibility = "hidden";
     document.body.appendChild(link);
     link.click();
@@ -60,6 +47,37 @@ function _downloadCSVFile(outputLines, fileTitle) {
 }
 //#endregion
 
+/** @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.
+ */
+//#endregion
+//#region Public functions
+/**
+ * Export a csv of the attributes from the features that match the provided ids
+ *
+ * @param title Title to use for file
+ * @param labels Labels to write
+ */
+function exportCSV(title, labels) {
+  // Format values to string so it doesn't get tripped up when a value has a comma
+  // another option could be to export with a different delimiter
+  const outputLines = labels.map(label => Object.values(label).map(v => `"${v}"`).join(",") + "\r\n");
+  downloadCSVFile(title, outputLines);
+}
+//#endregion
+
 var _typeof_1 = _commonjsHelpers.createCommonjsModule(function (module) {
 function _typeof(obj) {
   "@babel/helpers - typeof";
@@ -1082,7 +1100,7 @@ function(t){var e=function(t){for(var e=t.length,r=new Uint8Array(e),n=0;n<e;n++
  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  * ====================================================================
  */
-function(t){function e(){return (n.canvg?Promise.resolve(n.canvg):Promise.resolve().then(function () { return require('./index.es-98008aa0.js'); })).catch((function(t){return Promise.reject(new Error("Could not load canvg: "+t))})).then((function(t){return t.default?t.default:t}))}E.API.addSvgAsImage=function(t,r,n,i,o,s,c,u){if(isNaN(r)||isNaN(n))throw a.error("jsPDF.addSvgAsImage: Invalid coordinates",arguments),new Error("Invalid coordinates passed to jsPDF.addSvgAsImage");if(isNaN(i)||isNaN(o))throw a.error("jsPDF.addSvgAsImage: Invalid measurements",arguments),new Error("Invalid measurements (width and/or height) passed to jsPDF.addSvgAsImage");var h=document.createElement("canvas");h.width=i,h.height=o;var l=h.getContext("2d");l.fillStyle="#fff",l.fillRect(0,0,h.width,h.height);var f={ignoreMouse:!0,ignoreAnimation:!0,ignoreDimensions:!0},d=this;return e().then((function(e){return e.fromString(l,t,f)}),(function(){return Promise.reject(new Error("Could not load canvg."))})).then((function(t){return t.render(f)})).then((function(){d.addImage(h.toDataURL("image/jpeg",1),r,n,i,o,c,u);}))};}(),E.API.putTotalPages=function(t){var e,r=0;parseInt(this.internal.getFont().id.substr(1),10)<15?(e=new RegExp(t,"g"),r=this.internal.getNumberOfPages()):(e=new RegExp(this.pdfEscape16(t,this.internal.getFont()),"g"),r=this.pdfEscape16(this.internal.getNumberOfPages()+"",this.internal.getFont()));for(var n=1;n<=this.internal.getNumberOfPages();n++)for(var i=0;i<this.internal.pages[n].length;i++)this.internal.pages[n][i]=this.internal.pages[n][i].replace(e,r);return this},E.API.viewerPreferences=function(e,r){var n;e=e||{},r=r||!1;var i,a,o,s={HideToolbar:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.3},HideMenubar:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.3},HideWindowUI:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.3},FitWindow:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.3},CenterWindow:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.3},DisplayDocTitle:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.4},NonFullScreenPageMode:{defaultValue:"UseNone",value:"UseNone",type:"name",explicitSet:!1,valueSet:["UseNone","UseOutlines","UseThumbs","UseOC"],pdfVersion:1.3},Direction:{defaultValue:"L2R",value:"L2R",type:"name",explicitSet:!1,valueSet:["L2R","R2L"],pdfVersion:1.3},ViewArea:{defaultValue:"CropBox",value:"CropBox",type:"name",explicitSet:!1,valueSet:["MediaBox","CropBox","TrimBox","BleedBox","ArtBox"],pdfVersion:1.4},ViewClip:{defaultValue:"CropBox",value:"CropBox",type:"name",explicitSet:!1,valueSet:["MediaBox","CropBox","TrimBox","BleedBox","ArtBox"],pdfVersion:1.4},PrintArea:{defaultValue:"CropBox",value:"CropBox",type:"name",explicitSet:!1,valueSet:["MediaBox","CropBox","TrimBox","BleedBox","ArtBox"],pdfVersion:1.4},PrintClip:{defaultValue:"CropBox",value:"CropBox",type:"name",explicitSet:!1,valueSet:["MediaBox","CropBox","TrimBox","BleedBox","ArtBox"],pdfVersion:1.4},PrintScaling:{defaultValue:"AppDefault",value:"AppDefault",type:"name",explicitSet:!1,valueSet:["AppDefault","None"],pdfVersion:1.6},Duplex:{defaultValue:"",value:"none",type:"name",explicitSet:!1,valueSet:["Simplex","DuplexFlipShortEdge","DuplexFlipLongEdge","none"],pdfVersion:1.7},PickTrayByPDFSize:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.7},PrintPageRange:{defaultValue:"",value:"",type:"array",explicitSet:!1,valueSet:null,pdfVersion:1.7},NumCopies:{defaultValue:1,value:1,type:"integer",explicitSet:!1,valueSet:null,pdfVersion:1.7}},c=Object.keys(s),u=[],h=0,l=0,f=0;function d(t,e){var r,n=!1;for(r=0;r<t.length;r+=1)t[r]===e&&(n=!0);return n}if(void 0===this.internal.viewerpreferences&&(this.internal.viewerpreferences={},this.internal.viewerpreferences.configuration=JSON.parse(JSON.stringify(s)),this.internal.viewerpreferences.isSubscribed=!1),n=this.internal.viewerpreferences.configuration,"reset"===e||!0===r){var p=c.length;for(f=0;f<p;f+=1)n[c[f]].value=n[c[f]].defaultValue,n[c[f]].explicitSet=!1;}if("object"===t(e))for(a in e)if(o=e[a],d(c,a)&&void 0!==o){if("boolean"===n[a].type&&"boolean"==typeof o)n[a].value=o;else if("name"===n[a].type&&d(n[a].valueSet,o))n[a].value=o;else if("integer"===n[a].type&&Number.isInteger(o))n[a].value=o;else if("array"===n[a].type){for(h=0;h<o.length;h+=1)if(i=!0,1===o[h].length&&"number"==typeof o[h][0])u.push(String(o[h]-1));else if(o[h].length>1){for(l=0;l<o[h].length;l+=1)"number"!=typeof o[h][l]&&(i=!1);!0===i&&u.push([o[h][0]-1,o[h][1]-1].join(" "));}n[a].value="["+u.join(" ")+"]";}else n[a].value=n[a].defaultValue;n[a].explicitSet=!0;}return !1===this.internal.viewerpreferences.isSubscribed&&(this.internal.events.subscribe("putCatalog",(function(){var t,e=[];for(t in n)!0===n[t].explicitSet&&("name"===n[t].type?e.push("/"+t+" /"+n[t].value):e.push("/"+t+" "+n[t].value));0!==e.length&&this.internal.write("/ViewerPreferences\n<<\n"+e.join("\n")+"\n>>");})),this.internal.viewerpreferences.isSubscribed=!0),this.internal.viewerpreferences.configuration=n,this},
+function(t){function e(){return (n.canvg?Promise.resolve(n.canvg):Promise.resolve().then(function () { return require('./index.es-9c0d0ed6.js'); })).catch((function(t){return Promise.reject(new Error("Could not load canvg: "+t))})).then((function(t){return t.default?t.default:t}))}E.API.addSvgAsImage=function(t,r,n,i,o,s,c,u){if(isNaN(r)||isNaN(n))throw a.error("jsPDF.addSvgAsImage: Invalid coordinates",arguments),new Error("Invalid coordinates passed to jsPDF.addSvgAsImage");if(isNaN(i)||isNaN(o))throw a.error("jsPDF.addSvgAsImage: Invalid measurements",arguments),new Error("Invalid measurements (width and/or height) passed to jsPDF.addSvgAsImage");var h=document.createElement("canvas");h.width=i,h.height=o;var l=h.getContext("2d");l.fillStyle="#fff",l.fillRect(0,0,h.width,h.height);var f={ignoreMouse:!0,ignoreAnimation:!0,ignoreDimensions:!0},d=this;return e().then((function(e){return e.fromString(l,t,f)}),(function(){return Promise.reject(new Error("Could not load canvg."))})).then((function(t){return t.render(f)})).then((function(){d.addImage(h.toDataURL("image/jpeg",1),r,n,i,o,c,u);}))};}(),E.API.putTotalPages=function(t){var e,r=0;parseInt(this.internal.getFont().id.substr(1),10)<15?(e=new RegExp(t,"g"),r=this.internal.getNumberOfPages()):(e=new RegExp(this.pdfEscape16(t,this.internal.getFont()),"g"),r=this.pdfEscape16(this.internal.getNumberOfPages()+"",this.internal.getFont()));for(var n=1;n<=this.internal.getNumberOfPages();n++)for(var i=0;i<this.internal.pages[n].length;i++)this.internal.pages[n][i]=this.internal.pages[n][i].replace(e,r);return this},E.API.viewerPreferences=function(e,r){var n;e=e||{},r=r||!1;var i,a,o,s={HideToolbar:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.3},HideMenubar:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.3},HideWindowUI:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.3},FitWindow:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.3},CenterWindow:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.3},DisplayDocTitle:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.4},NonFullScreenPageMode:{defaultValue:"UseNone",value:"UseNone",type:"name",explicitSet:!1,valueSet:["UseNone","UseOutlines","UseThumbs","UseOC"],pdfVersion:1.3},Direction:{defaultValue:"L2R",value:"L2R",type:"name",explicitSet:!1,valueSet:["L2R","R2L"],pdfVersion:1.3},ViewArea:{defaultValue:"CropBox",value:"CropBox",type:"name",explicitSet:!1,valueSet:["MediaBox","CropBox","TrimBox","BleedBox","ArtBox"],pdfVersion:1.4},ViewClip:{defaultValue:"CropBox",value:"CropBox",type:"name",explicitSet:!1,valueSet:["MediaBox","CropBox","TrimBox","BleedBox","ArtBox"],pdfVersion:1.4},PrintArea:{defaultValue:"CropBox",value:"CropBox",type:"name",explicitSet:!1,valueSet:["MediaBox","CropBox","TrimBox","BleedBox","ArtBox"],pdfVersion:1.4},PrintClip:{defaultValue:"CropBox",value:"CropBox",type:"name",explicitSet:!1,valueSet:["MediaBox","CropBox","TrimBox","BleedBox","ArtBox"],pdfVersion:1.4},PrintScaling:{defaultValue:"AppDefault",value:"AppDefault",type:"name",explicitSet:!1,valueSet:["AppDefault","None"],pdfVersion:1.6},Duplex:{defaultValue:"",value:"none",type:"name",explicitSet:!1,valueSet:["Simplex","DuplexFlipShortEdge","DuplexFlipLongEdge","none"],pdfVersion:1.7},PickTrayByPDFSize:{defaultValue:!1,value:!1,type:"boolean",explicitSet:!1,valueSet:[!0,!1],pdfVersion:1.7},PrintPageRange:{defaultValue:"",value:"",type:"array",explicitSet:!1,valueSet:null,pdfVersion:1.7},NumCopies:{defaultValue:1,value:1,type:"integer",explicitSet:!1,valueSet:null,pdfVersion:1.7}},c=Object.keys(s),u=[],h=0,l=0,f=0;function d(t,e){var r,n=!1;for(r=0;r<t.length;r+=1)t[r]===e&&(n=!0);return n}if(void 0===this.internal.viewerpreferences&&(this.internal.viewerpreferences={},this.internal.viewerpreferences.configuration=JSON.parse(JSON.stringify(s)),this.internal.viewerpreferences.isSubscribed=!1),n=this.internal.viewerpreferences.configuration,"reset"===e||!0===r){var p=c.length;for(f=0;f<p;f+=1)n[c[f]].value=n[c[f]].defaultValue,n[c[f]].explicitSet=!1;}if("object"===t(e))for(a in e)if(o=e[a],d(c,a)&&void 0!==o){if("boolean"===n[a].type&&"boolean"==typeof o)n[a].value=o;else if("name"===n[a].type&&d(n[a].valueSet,o))n[a].value=o;else if("integer"===n[a].type&&Number.isInteger(o))n[a].value=o;else if("array"===n[a].type){for(h=0;h<o.length;h+=1)if(i=!0,1===o[h].length&&"number"==typeof o[h][0])u.push(String(o[h]-1));else if(o[h].length>1){for(l=0;l<o[h].length;l+=1)"number"!=typeof o[h][l]&&(i=!1);!0===i&&u.push([o[h][0]-1,o[h][1]-1].join(" "));}n[a].value="["+u.join(" ")+"]";}else n[a].value=n[a].defaultValue;n[a].explicitSet=!0;}return !1===this.internal.viewerpreferences.isSubscribed&&(this.internal.events.subscribe("putCatalog",(function(){var t,e=[];for(t in n)!0===n[t].explicitSet&&("name"===n[t].type?e.push("/"+t+" /"+n[t].value):e.push("/"+t+" "+n[t].value));0!==e.length&&this.internal.write("/ViewerPreferences\n<<\n"+e.join("\n")+"\n>>");})),this.internal.viewerpreferences.isSubscribed=!0),this.internal.viewerpreferences.configuration=n,this},
 /** ====================================================================
  * @license
  * jsPDF XMP metadata plugin
@@ -1126,7 +1144,7 @@ function(t){t.__bidiEngine__=t.prototype.__bidiEngine__=function(t){var r,n,i,a,
 
 /* @preserve
 * arcgis-pdf-creator v0.0.1
-* Fri Feb 03 2023 09:47:02 GMT-0800 (Pacific Standard Time)
+* Tue Mar 21 2023 10:44:29 GMT-0700 (Pacific Daylight Time)
 */
 /** @license
  * Copyright 2022 Esri
@@ -1401,13 +1419,16 @@ class PDFCreator {
      *
      * @param text String to estimate
      * @param fontSize Text size in points
-     * @returns Estimated width of text in doc units
+     * @returns Estimated width of text using (points x 1/72 inches/point) * 0.6;
+     * need to override this generalized function with a specific PDF generator;
+     * the 0.6 width:height ratio comes from https://www.fhwa.dot.gov/publications/research/safety/98057/ch03.cfm#width
      *
      * @class PDFCreator
      */
     getTextWidth(text, fontSize) {
+        const ratioWidthToHeight = 0.6;
         // Return a value for testing
-        return text.length * fontSize;
+        return text.length * fontSize * this.fontProps.fontResolutionInchesPerPoint * ratioWidthToHeight;
     }
     /**
      * @class PDFCreator
@@ -1515,7 +1536,7 @@ class PDFCreator {
 
 /* @preserve
 * arcgis-pdf-creator v0.0.1
-* Fri Feb 03 2023 09:47:02 GMT-0800 (Pacific Standard Time)
+* Tue Mar 21 2023 10:44:29 GMT-0700 (Pacific Daylight Time)
 */
 
 /** @license
@@ -1743,7 +1764,7 @@ class PDFCreator_jsPDF extends PDFCreator {
 
 /* @preserve
 * arcgis-pdf-creator v0.0.1
-* Fri Feb 03 2023 09:47:02 GMT-0800 (Pacific Standard Time)
+* Tue Mar 21 2023 10:44:29 GMT-0700 (Pacific Daylight Time)
 */
 /** @license
  * Copyright 2022 Esri
@@ -1806,7 +1827,7 @@ function drawGridOfBoxes(PDFCreator, options = {
 
 /* @preserve
 * arcgis-pdf-creator v0.0.1
-* Fri Feb 03 2023 09:47:02 GMT-0800 (Pacific Standard Time)
+* Tue Mar 21 2023 10:44:29 GMT-0700 (Pacific Daylight Time)
 */
 
 /** @license
@@ -1833,12 +1854,13 @@ class PDFLabels {
      * @param labels Array of labels; each label consists of one or more line strings
      * @param labelSpec Properties describing page dimensions of labels sheet
      * @param startingPageNum The 1-based page number to start printing labels into; page is assumed to be blank & to exist
+     * @param heading Line to add at top of label page outside of labels
      * @param progressCallback Callback with percent done in range 0..100
      * @returns Promise which, when resolved, returns the 1-based page number of the last page containing labels
      *
      * @class PDFLabels
      */
-    addLabelsToDoc(labels, labelSpec, startingPageNum, progressCallback) {
+    addLabelsToDoc(labels, labelSpec, startingPageNum, heading, progressCallback) {
         return new Promise((resolve) => {
             const labelsPerPageDisplay = labelSpec.numLabelsAcross * labelSpec.numLabelsDown;
             let column;
@@ -1849,6 +1871,9 @@ class PDFLabels {
             // Draw
             let currentPageNum = startingPageNum;
             const topOfFirstLabel = labelSpec.pageProperties.topMargin - this.PDFCreator.pageOptions.topMargin;
+            if (heading) {
+                this._drawSupplementalText(heading, 0, -0.1);
+            }
             for (let iLabel = 0, iNonBlankLabel = 0; iLabel < labels.length; iLabel++) {
                 if (progressCallback) {
                     progressCallback(Math.round(iLabel / labels.length * 100));
@@ -1864,6 +1889,9 @@ class PDFLabels {
                         // Advance to next page
                         this.PDFCreator.addPage();
                         ++currentPageNum;
+                        if (heading) {
+                            this._drawSupplementalText(heading, 0, -0.1);
+                        }
                     }
                     // Prep the new page
                     column = 0;
@@ -1876,11 +1904,14 @@ class PDFLabels {
                     row = 0;
                 }
                 // Draw the label
+                const minimumFontSize = 4;
                 // Temporarily reduce the font size if we have more lines than the label can hold
                 let fontPoints = labelSpec.fontSizePx;
                 if (labelSpec.maxNumLabelLines < labelLines.length) {
-                    fontPoints = Math.floor(labelSpec.maxNumLabelLines / labelLines.length * labelSpec.fontSizePx);
+                    fontPoints = Math.max(Math.floor(labelSpec.maxNumLabelLines / labelLines.length * labelSpec.fontSizePx), minimumFontSize);
                 }
+                // Temporarily reduce the font size farther if label lines are too long
+                fontPoints = this._getFontSizeForOverlongLines(labelLines, maxLabelTextWidth, fontPoints, minimumFontSize);
                 // Clip overlong lines; append ellipses to clipped lines
                 labelLines = this._clipOverlongLines(labelLines, maxLabelTextWidth, fontPoints);
                 const labelLineHeight = this.PDFCreator.fontAscenderDescenderHeight(fontPoints);
@@ -2042,6 +2073,47 @@ class PDFLabels {
         });
         return trimmedLines;
     }
+    /**
+     * Draws supplemental text such as a heading or footer.
+     *
+     * @param text Text to draw
+     * @param left Offset from left edge of document to left edge of text
+     * @param top Offset from top of document to top of text
+     */
+    _drawSupplementalText(text, left, top) {
+        const fontPoints = 6;
+        this.PDFCreator.drawText(text, {
+            left,
+            top,
+            fontPoints,
+            fontColor: "000000"
+        });
+    }
+    /**
+     * Trims a set of text lines to fit within specified bounds.
+     *
+     * @param lines Text lines to be checked
+     * @param maxTextWidth The maximum width permitted for the drawing of the text in doc units
+     * @param preferredFontSize Initial text size in points
+     * @param minimumFontSize The smallest acceptable font size in points
+     * @returns The maximum of `minimumFontSize` and the font size in points that should help all lines
+     * of the label to fit on the label
+     *
+     * @class PDFLabels
+     * @private
+     */
+    _getFontSizeForOverlongLines(lines, maxTextWidth, preferredFontSize, minimumFontSize) {
+        let fontSize = preferredFontSize;
+        lines.forEach(line => {
+            line = line.trim();
+            if (this.PDFCreator.getTextWidth(line, fontSize) > maxTextWidth) {
+                do {
+                    --fontSize;
+                } while (this.PDFCreator.getTextWidth(line, fontSize) > maxTextWidth && fontSize > minimumFontSize);
+            }
+        });
+        return fontSize;
+    }
     /**
      * Loads the label formats.
      *
@@ -2078,31 +2150,34 @@ class PDFLabels {
 /**
  * Exports a PDF of labels.
  *
+ * @param title Title to use for file
  * @param labels Labels to write
  * @param labelPageDescription Page format to use for labels
  */
-function exportPDF(labels, labelPageDescription) {
-  _downloadPDFFile(labels, labelPageDescription, `notify-${Date.now().toString()}`);
+function exportPDF(title, labels, labelPageDescription) {
+  downloadPDFFile(title, labels, labelPageDescription);
 }
 //#endregion
 //#region Private functions
 /**
  * Downloads the PDF file.
  *
+ * @param title Title (without file extension) to use for file; defaults to "export"
  * @param labels Labels to write
  * @param labelPageDescription Page format to use for labels
- * @param fileTitle Title (without file extension) to use for file; defaults to "export"
  */
-function _downloadPDFFile(labels, labelPageDescription, fileTitle) {
+function downloadPDFFile(title, labels, labelPageDescription) {
   const pdfLib = new PDFCreator_jsPDF();
   pdfLib.initialize({
     pageType: "ANSI_A"
-  }, index.getAssetPath(`../assets/arcgis-pdf-creator/`), "en", fileTitle, false)
+  }, index.getAssetPath(`../assets/arcgis-pdf-creator/`), "en", title)
     .then(() => {
     const labeller = new PDFLabels();
     labeller.initialize(pdfLib)
       .then(async () => {
-      await labeller.addLabelsToDoc(labels, labelPageDescription.labelSpec, 1);
+      await labeller.addLabelsToDoc(labels, labelPageDescription.labelSpec, 1, // startingPageNum
+      title // heading
+      );
       pdfLib.save();
     });
   });
@@ -2140,10 +2215,8 @@ const lineSeparatorChar = "|";
  * @returns Promise resolving when function is done
  */
 async function downloadCSV(selectionSetNames, layer, ids, formatUsingLayerPopup, removeDuplicates = false, addColumnTitle = false) {
-  console.log("downloadCSV using selectionSetNames " + JSON.stringify(selectionSetNames)); //???
-  console.log("downloadCSV removeDuplicates", removeDuplicates); //???
   const labels = await _prepareLabels(layer, ids, removeDuplicates, formatUsingLayerPopup, addColumnTitle);
-  exportCSV(labels);
+  exportCSV(_createTitle(selectionSetNames), labels);
   return Promise.resolve();
 }
 /**
@@ -2157,15 +2230,13 @@ async function downloadCSV(selectionSetNames, layer, ids, formatUsingLayerPopup,
  * @returns Promise resolving when function is done
  */
 async function downloadPDF(selectionSetNames, layer, ids, removeDuplicates, labelPageDescription) {
-  console.log("downloadPDF using selectionSetNames " + JSON.stringify(selectionSetNames)); //???
-  console.log("downloadPDF removeDuplicates", removeDuplicates); //???
   let labels = await _prepareLabels(layer, ids, removeDuplicates);
   labels =
     // Remove empty lines in labels
     labels.map(labelLines => labelLines.filter(line => line.length > 0))
       // Remove empty labels
       .filter(label => label.length > 0);
-  exportPDF(labels, labelPageDescription);
+  exportPDF(_createTitle(selectionSetNames), labels, labelPageDescription);
   return Promise.resolve();
 }
 //#endregion
@@ -2202,17 +2273,25 @@ function _convertPopupTextToLabelSpec(popupInfo) {
   popupInfo = popupInfo.replace(/<p[^>]*>/gi, lineSeparatorChar).trim().replace(/^\|/, "");
   // Remove </p>
   popupInfo = popupInfo.replace(/<\/p>/gi, "");
-  // Remove \n
-  popupInfo = popupInfo.replace(/\n/gi, "");
-  // Remove remaining HTML tags, replace 0xA0 that popup uses for spaces, and replace some char representations,
-  // and split the label back into individual lines
-  const labelSpec = popupInfo
+  // Replace \n with the line separator character
+  popupInfo = popupInfo.replace(/\n/gi, "|");
+  // Remove remaining HTML tags, replace 0xA0 that popup uses for spaces, and replace some char representations
+  let labelSpec = popupInfo
     .replace(/<[\s.]*[^<>]*\/?>/gi, "")
     .replace(/\xA0/gi, " ")
     .replace(/&lt;/gi, "<")
     .replace(/&gt;/gi, ">")
     .replace(/&nbsp;/gi, " ");
-  return labelSpec;
+  // Trim each line
+  labelSpec = labelSpec.replace(/\s*\|\s*/g, "|");
+  // Remove empty lines
+  while (labelSpec.match(/\|\|/)) {
+    labelSpec = labelSpec.replace(/\|\|/, "|");
+  }
+  // Remove leading and trailing line feeds
+  labelSpec = labelSpec.replace(/^\|/, "");
+  labelSpec = labelSpec.replace(/\|$/, "");
+  return labelSpec.trim();
 }
 /**
  * Extracts Arcade expressions from the lines of a label format and creates an Arcade executor for each
@@ -2276,6 +2355,18 @@ async function _createArcadeExecutors(labelFormat, layer) {
     return arcadeExecutors;
   });
 }
+/**
+ * Creates a title from a list of selection set names.
+ *
+ * @param selectionSetNames Names to use in title
+ * @return Title composed of the selectionSetNames separated by commas; if there are no
+ * selection set names supplied, "download" is returned
+ */
+function _createTitle(selectionSetNames) {
+  // Windows doesn't permit the characters \/:*?"<>|
+  const title = selectionSetNames.length > 0 ? selectionSetNames.join(", ") : "download";
+  return title;
+}
 /**
  * Prepares an attribute's value by applying domain and type information.
  *

package/dist/cjs/{index.es-98008aa0.js → index.es-9c0d0ed6.js}

@@ -6,12 +6,12 @@
 'use strict';
 
 const _commonjsHelpers = require('./_commonjsHelpers-384729db.js');
-const downloadUtils = require('./downloadUtils-415ab342.js');
+const downloadUtils = require('./downloadUtils-9359e9ff.js');
 require('./index-c6979cbb.js');
 require('./loadModules-0806a34f.js');
 require('./locale-04da9a8c.js');
-require('./mapViewUtils-f617ae9a.js');
-require('./interfaces-17c631bf.js');
+require('./mapViewUtils-090f4d4d.js');
+require('./interfaces-cac36920.js');
 
 var check = function (it) {
   return it && it.Math == Math && it;

package/dist/cjs/{interfaces-17c631bf.js → interfaces-cac36920.js}

@@ -20,6 +20,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+exports.ELayoutMode = void 0;
+(function (ELayoutMode) {
+  ELayoutMode["GRID"] = "GRID";
+  ELayoutMode["HORIZONTAL"] = "HORIZONTAL";
+  ELayoutMode["VERTICAL"] = "VERTICAL";
+})(exports.ELayoutMode || (exports.ELayoutMode = {}));
 /**
  * Resource update types
  */