@arcgis/core 5.1.0-next.63 → 5.1.0-next.65

package/popup/content/ColumnChartMediaInfo.d.ts

@@ -7,7 +7,7 @@ export interface ColumnChartMediaInfoProperties extends ChartMediaInfoProperties
  * A `ColumnChartMediaInfo` is a type of chart media element
  * that represents a column chart displayed within a popup.
  *
- * ![popuptemplate-media-element-columnchart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-columnchart.png)
+ * ![popuptemplate-media-element-columnchart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-columnchart.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/FieldsContent.d.ts

@@ -18,7 +18,7 @@ export interface FieldsContentProperties extends BaseContentProperties, Partial<
  * it will revert to whatever may be set within the [PopupTemplate.fieldInfos](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#fieldInfos)
  * property.
  *
- * ![popuptemplate-fields-element](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-fields-element.png)
+ * ![popuptemplate-fields-element](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-fields-element.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/ImageMediaInfo.d.ts

@@ -11,7 +11,7 @@ export interface ImageMediaInfoProperties extends MediaInfoProperties, Partial<P
 /**
  * An `ImageMediaInfo` is a type of media element that represents images to display within a popup.
  *
- * ![popuptemplate-media-element-image](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-image.png)
+ * ![popuptemplate-media-element-image](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-image.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/LineChartMediaInfo.d.ts

@@ -7,7 +7,7 @@ export interface LineChartMediaInfoProperties extends ChartMediaInfoProperties {
  * A `LineChartMediaInfo` is a type of chart media element
  * that represents a line chart displayed within a popup.
  *
- * ![popuptemplate-media-element-linechart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-linechart.png)
+ * ![popuptemplate-media-element-linechart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-linechart.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/MediaContent.d.ts

@@ -33,7 +33,7 @@ export type PopupContentMediaInfoUnion = BarChartMediaInfo | ColumnChartMediaInf
  * [Binning](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/) and [clustering](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/) popup charts are also based on the renderer colors.
  * However, popup charts only respect the colors from the [pie chart](https://developers.arcgis.com/javascript/latest/references/core/renderers/PieChartRenderer/) renderer when clustering is configured.
  *
- * ![popuptemplate-media-element](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element.png)
+ * ![popuptemplate-media-element](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/PieChartMediaInfo.d.ts

@@ -6,7 +6,7 @@ export interface PieChartMediaInfoProperties extends ChartMediaInfoProperties {}
 /**
  * A `PieChartMediaInfo` is a type of chart media element that represents a pie chart displayed within a popup.
  *
- * ![popuptemplate-media-element-piechart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-piechart.png)
+ * ![popuptemplate-media-element-piechart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-piechart.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/RelationshipContent.d.ts

@@ -23,7 +23,7 @@ export interface RelationshipContentProperties extends BaseContentProperties, Pa
  *
  * | Origin Feature | Related Destination Feature |
  * | -------------- | ------------- |
- * | ![origin feature](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-origin-feature.png) | ![destination feature](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-destination-feature.png) |
+ * | ![origin feature](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-origin-feature.avif) | ![destination feature](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-destination-feature.avif) |
  *
  * > [!WARNING]
  * >

package/popup/content/TextContent.d.ts

@@ -8,7 +8,7 @@ export interface TextContentProperties extends BaseContentProperties, Partial<Pi
  * content. The text may reference values returned from a field attribute or an
  * [Arcade](https://developers.arcgis.com/javascript/latest/arcade/) expression defined in a PopupTemplate's [PopupTemplate.expressionInfos](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#expressionInfos) property.
  *
- * ![popuptemplate-text-element](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-text-element.png).
+ * ![popuptemplate-text-element](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-text-element.avif).
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/support/featureUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import e from"../../core/Logger.js";import{replace as t}from"../../core/string.js";import{getGraphicLayer as n}from"../../graphic/graphicOriginUtils.js";import{formatDate as r,convertDateFormatToIntlOptions as i}from"../../intl/date.js";import{convertNumberFieldFormatToIntlOptions as o,convertNumberFormatToIntlOptions as a,formatNumber as l}from"../../intl/number.js";import{fieldFormatFromFieldInfo as u}from"../../layers/support/fieldFormatUtils.js";import{isRasterPixelValueField as s,featureHasFields as f,isTimeOnlyField as d}from"../../layers/support/fieldUtils.js";import{getFieldConfigurationsContainer as c,getEffectiveLayerCapabilities as p}from"../../layers/support/layerUtils.js";import{formatAnyDate as y,isAnyDateField as m}from"../../smartMapping/support/utils.js";import{loadArcade as g}from"../../support/loadArcade.js";import{getTimeZoneFormattingOptions as I}from"../../time/timeZoneUtils.js";const b="esri.popup.support.featureUtils",h=()=>e.getLogger(b),F=/href=(""|'')/gi,T=/(\{([^{\r\n]+)\})/g,w=/'/g,N=/^\s*expression\//i,C=/(\n)/gi,j=/[\u00A0-\u9999<>&]/gim,Z=/href\s*=\s*(?:"([^"]+)"|'([^']+)')/gi,v=/^(?:mailto:|tel:)/,L="relationships/",U=i("short-date-short-time");function q(e){if(null!=e)return(e.sourceLayer||e.layer)??void 0}async function x({type:e,value:t,event:n}){try{return"function"==typeof t?t(n):await t}catch(r){return void h().error("error",`An error occurred when calling the "${e}" function`,{error:r,graphic:n.graphic,value:t})}}function A(e=""){if(e)return!v.test(e.trim().toLowerCase())}function E(e){return!!e&&N.test(e)}function M(e,t){if(!t||!E(t)||!e)return;const n=t.replace(N,"").toLowerCase();return e.find(({name:e})=>e.toLowerCase()===n)}function k(e){const{fieldInfo:t,graphic:n,layer:r}=e;return R({fieldInfo:t,graphic:n})?c(r,{graphic:n}):null}function R({fieldInfo:e,graphic:t}){return!(!e?.fieldName||E(e.fieldName)||Te(e.fieldName)||t?.popupTemplate)}function $({expressionInfos:e,fieldInfo:t,graphic:n,isContentFieldInfos:r,layer:i}){if(!t?.fieldName)return null;const o=M(e,t.fieldName);if(o)return o.title||null;const a=k({fieldInfo:t,graphic:n,layer:i});if(a){const e=a.getFieldAlias(t.fieldName);return r?t.label||e||t.fieldName:e||t.fieldName}return t.label||t.fieldName}function D(e){const{configurableFieldsContainer:t,fieldInfo:n,isContentFieldInfos:r}=e;if(!n?.fieldName)return null;const i=t.popupTemplate||t.fieldConfigurations?t.getFieldConfiguration(n.fieldName)?.fieldFormat:u(n,t.getField(n.fieldName));return r&&n.fieldFormat||i}function z(e,t){const n=t.get(e.toLowerCase());return`{${n?.fieldName||e}}`}function O(e){return e.replaceAll(F,"")}function S(e,t){const n=Q(t,e);return n?n.name:e}function G(e,t){return e&&e.map(e=>S(e,t))}function Q(e,t){return e&&"function"==typeof e.getField&&t?e.getField(t)??null:null}function P(e){return`${e}`.trim()}function _({attributes:e,globalAttributes:t,layer:n,text:r,expressionAttributes:i,fieldInfoMap:o}){return r?H({formattedAttributes:t,template:V(r,{...t,...i,...e},n),fieldInfoMap:o}):""}function H({formattedAttributes:e,template:n,fieldInfoMap:r}){return P(O(t(t(n,e=>z(e,r)),e)))}function W(e,t,n=!1){const r=t[e];if("string"==typeof r){const i="%27",o=(n?encodeURIComponent(r):r).replaceAll(w,i);t[e]=o}}function B(e,t=!1){const n={...e};return Object.keys(n).forEach(e=>W(e,n,t)),n}function J(e,n,r){const i=(n=P(n))&&!n.startsWith("{");return t(e,B(r,i||!1))}function K(e,t){return e.replaceAll(T,(e,n,r)=>{const i=Q(t,r);return i?`{${i.name}}`:n})}function V(e,t,n){const r=K(e,n);return r?r.replaceAll(Z,(e,n,r)=>J(e,n||r,t)):r}function X(e,t){const n="number"===t?.fieldFormat?.type||t?.format&&null==t.format.dateFormat&&(null!=t.format.places||null!=t.format.digitSeparator);if("string"==typeof e&&n){const t=Number(e);if(!isNaN(t))return t}return e}function Y(e){return null!=e&&"object"==typeof e&&"fieldsIndex"in e&&"geometryType"in e&&"getField"in e&&"load"in e&&"loaded"in e&&"objectIdField"in e&&"spatialReference"in e&&"type"in e&&("feature"===e.type||"scene"===e.type||"subtype-group"===e.type||"subtype-sublayer"===e.type||"sublayer"===e.type)&&"when"in e}function ee(e){return null!=e&&"object"==typeof e&&"createQuery"in e&&"queryFeatureCount"in e&&"queryObjectIds"in e&&"queryRelatedFeatures"in e&&"queryRelatedFeaturesCount"in e&&"relationships"in e}function te(e){return Y(e)&&ee(e)}function ne(e){return!(!(e&&"object"==typeof e&&"createQuery"in e&&"getField"in e&&"queryFeatureCount"in e&&"queryFeatures"in e&&"queryObjectIds"in e&&"capabilities"in e&&"fields"in e&&"fieldsIndex"in e&&"type"in e)||"feature"!==e.type&&"subtype-group"!==e.type&&"subtype-sublayer"!==e.type&&"sublayer"!==e.type||!("when"in e))&&("subtype-sublayer"===e.type&&"parent"in e&&e.parent&&"object"==typeof e.parent?"globalIdField"in e.parent:"globalIdField"in e)}function re(e){if(!e||"object"!=typeof e)return!1;return te(n(e))}function ie(e,t){const{fieldInfos:n,fieldName:r,graphic:i,isContentFieldInfos:u,layer:f,preventPlacesFormatting:d,timeZone:c}=t,p=le(n,r),m=k({fieldInfo:p,graphic:i,layer:f}),g=Q(m||f,r),I=m?null:p?.format,b=m?D({configurableFieldsContainer:m,fieldInfo:p,isContentFieldInfos:u}):null,h="number"===b?.type;if(p&&!s(r)){const t=g?.type,n="date-time"===b?.type,r=I?.dateFormat;if("date"===t||"date-only"===t||"time-only"===t||"timestamp-offset"===t||n||r)return y(e,{format:n?void 0:r,fieldFormat:n?b:void 0,fieldType:t,timeZoneOptions:{layerTimeZone:f&&"preferredTimeZone"in f?f.preferredTimeZone:null,viewTimeZone:c,datesInUnknownTimezone:!(!f||!("datesInUnknownTimezone"in f))&&!!f.datesInUnknownTimezone}})}if("string"==typeof e&&s(r)&&I)return oe(e,I);if("string"==typeof(e=X(e,{format:h?void 0:I,fieldFormat:h?b:void 0}))||null==e||null==I&&null==b)return ye(e);const F=h?o(b):I?a(I):void 0;return l(e,d?{...F,minimumFractionDigits:0,maximumFractionDigits:20}:F)}function oe(e,t){return e=e.trim(),/\d{2}-\d{2}/.test(e)?e:e.includes(",")?ae(e,",",", ",t):e.includes(";")?ae(e,";","; ",t):e.includes(" ")?ae(e," "," ",t):l(Number(e),a(t))}function ae(e,t,n,r){return e.trim().split(t).map(e=>l(Number(e),a(r))).join(n)}function le(e,t){if(e?.length&&t)return e.find(e=>e.fieldName?.toLowerCase()===t.toLowerCase())}function ue({fieldName:e,graphic:t,layer:n}){if(Te(e))return null;if(!n||"function"!=typeof n.getFeatureType)return null;const{typeIdField:r}=n;if(!r||e!==r)return null;const i=n.getFeatureType(t);return i?i.name:null}function se({fieldName:e,value:t,graphic:n,layer:r}){if(Te(e))return null;if(!r||"function"!=typeof r.getFieldDomain)return null;const i=n&&r.getFieldDomain(e,{feature:n});return i&&"coded-value"===i.type?i.getName(t):null}function fe(e,t,n,i){const{creatorField:o,creationDateField:a,editorField:l,editDateField:u}=e;if(!t)return;const s=I(i&&"preferredTimeZone"in i?i.preferredTimeZone:null,!(!i||!("datesInUnknownTimezone"in i))&&!!i.datesInUnknownTimezone,n,U,"date"),f={...U,...s},d=t[u];if("number"==typeof d){const e=t[l];return{type:"edit",date:r(d,f),user:e}}const c=t[a];if("number"==typeof c){const e=t[o];return{type:"create",date:r(c,f),user:e}}return null}function de(e,t){const n=new Map;if(!e)return n;for(const r of e){if(!r.fieldName)continue;const e=S(r.fieldName,t);r.fieldName=e,n.set(e.toLowerCase(),r)}return n}function ce(e){const t=[];if(!e)return t;const{fieldInfos:n,content:r}=e;return n&&t.push(...n),r&&Array.isArray(r)?(r.forEach(e=>{if("fields"===e.type){const n=e?.fieldInfos;n&&t.push(...n)}}),t):t}function pe(e){return e.replaceAll(j,e=>`&#${e.charCodeAt(0)};`)}function ye(e){return"string"==typeof e?e.replaceAll(C,'<br class="esri-text-new-line" />'):e}function me(e){const{fieldInfoMap:t,fieldInfos:n,fieldName:r,graphic:i,isContentFieldInfos:o,layer:a,timeZone:l,value:u}=e;if(null==u)return"";const s=se({fieldName:r,value:u,graphic:i,layer:a});if(s)return s;const f=ue({fieldName:r,graphic:i,layer:a});if(f)return f;if(t.get(r.toLowerCase()))return ie(u,{fieldInfos:n||Array.from(t.values()),fieldName:r,graphic:i,isContentFieldInfos:o,layer:a,timeZone:l});const c=a?.fieldsIndex?.get(r);return c&&(m(c)||d(c))?y(u,{fieldType:c.type,timeZoneOptions:{layerTimeZone:a&&"preferredTimeZone"in a?a.preferredTimeZone:null,viewTimeZone:l,datesInUnknownTimezone:!(!a||!("datesInUnknownTimezone"in a))&&!!a.datesInUnknownTimezone}}):ye(u)}function ge({attributes:e,fieldInfoMap:t,fieldInfos:n,graphic:r,isContentFieldInfos:i,layer:o,relatedInfos:a,timeZone:l}){const u={};return a?.forEach(e=>Ce({attributes:u,relatedInfo:e,fieldInfoMap:t,fieldInfos:n,layer:o,timeZone:l})),e&&Object.keys(e).forEach(a=>{const s=e[a];u[a]=me({fieldInfoMap:t,fieldInfos:n,fieldName:a,graphic:r,isContentFieldInfos:i,layer:o,timeZone:l,value:s})}),u}async function Ie(e,t){const{layer:n,graphic:r,outFields:i,objectIds:o,returnGeometry:a,spatialReference:l}=e,u=o[0];if("number"!=typeof u&&"string"!=typeof u){const e="Could not query required fields for the specified feature. The feature's ID is invalid.",t={layer:n,graphic:r,objectId:u,requiredFields:i};return h().warn(e,t),null}if(!p(n)?.operations?.supportsQuery){const e="The specified layer cannot be queried. The following fields will not be available.",t={layer:n,graphic:r,requiredFields:i,returnGeometry:a};return h().warn(e,t),null}const s=n.createQuery();s.objectIds=o,s.outFields=i?.length?i:[n.objectIdField],s.returnGeometry=!!a,s.returnZ=!!a,s.returnM=!!a,s.outSpatialReference=l;return(await n.queryFeatures(s,t)).features[0]}async function be(e){if(!e.expressionInfos?.length)return!1;const t=await g(),{arcadeUtils:{hasGeometryFunctions:n}}=t;return n(e)}async function he(e){if(!e.expressionInfos?.length)return!1;const t=await g(),{arcadeUtils:{requiresTrack:n}}=t;return n(e)}async function Fe({graphic:e,popupTemplate:t,layer:n,spatialReference:r},i){if(!n||!t)return;if("function"==typeof n.load&&await n.load(i),!e.attributes)return;const o=n.objectIdField,a=e.attributes[o];if(null==a)return;const l=[a],u=new Set(await t.getRequiredFields(n.fieldsIndex));null==n.timeInfo?.trackIdField||u.has(n.timeInfo.trackIdField)||await he(t)&&u.add(n.timeInfo.trackIdField);const s=f(e,u),d=s?[]:u.has(o)?[...u]:[...u,o],c=t.returnGeometry||await be(t);if(s&&!c)return;const p=await Ie({layer:n,graphic:e,outFields:d,objectIds:l,returnGeometry:c,spatialReference:r},i);p&&(p.geometry&&(e.geometry=p.geometry),p.attributes&&(e.attributes={...e.attributes,...p.attributes}))}function Te(e=""){return!!e&&e.includes(L)}function we(e){return e?`${L}${e.layerId}/${e.fieldName}`:""}function Ne({attributes:e,graphic:t,relatedInfo:n,fieldInfos:r,fieldInfoMap:i,layer:o,timeZone:a}){e&&t&&n&&Object.keys(t.attributes).forEach(l=>{const u=we({layerId:n.relation.id.toString(),fieldName:l}),s=t.attributes[l];e[u]=me({fieldName:u,fieldInfos:r,fieldInfoMap:i,layer:o,value:s,graphic:t,timeZone:a})})}function Ce({attributes:e,relatedInfo:t,fieldInfoMap:n,fieldInfos:r,layer:i,timeZone:o}){e&&t&&(t.relatedFeatures?.forEach(a=>Ne({attributes:e,graphic:a,relatedInfo:t,fieldInfoMap:n,fieldInfos:r,layer:i,timeZone:o})),t.relatedStatsFeatures?.forEach(a=>Ne({attributes:e,graphic:a,relatedInfo:t,fieldInfoMap:n,fieldInfos:r,layer:i,timeZone:o})))}const je=e=>{if(!e)return!1;const t=e.toUpperCase();return t.includes("CURRENT_TIMESTAMP")||t.includes("CURRENT_DATE")||t.includes("CURRENT_TIME")},Ze=({layer:e,method:t,query:n,definitionExpression:r})=>{if(!e.capabilities?.query?.supportsCacheHint||"attachments"===t)return;const i=null!=n.where?n.where:null,o=null!=n.geometry?n.geometry:null;je(r)||je(i)||"extent"===o?.type||"tile"===n.resultType||(n.cacheHint=!0)},ve=({query:e,layer:t,method:n})=>{Ze({layer:t,method:n,query:e,definitionExpression:`${t.definitionExpression} ${t.serviceDefinitionExpression??""}`})},Le=({queryPayload:e,layer:t,method:n})=>{Ze({layer:t,method:n,query:e,definitionExpression:`${t.definitionExpression} ${t.serviceDefinitionExpression??""}`})};function Ue(e,t,n){return e&&t&&n?"sublayer"===t.type?Ae({layers:t.layer?.allSublayers,map:e,relatedLayer:t,relationship:n})||Ae({layers:t.layer?.subtables,map:e,relatedLayer:t,relationship:n}):Ae({layers:e.allLayers,map:e,relatedLayer:t,relationship:n})||Ae({layers:e.allTables,map:e,relatedLayer:t,relationship:n}):null}function qe(e,t){return e&&"utilityNetworks"in e&&t?e.utilityNetworks?.find(e=>e.isUtilityLayer(t)):null}function xe(e,t){return e?.allTables.find(e=>"feature"===e.type&&e.layerId===t.id&&e.url===t.layer?.url)}function Ae({map:e,relationship:t,relationship:{relatedTableId:n},relatedLayer:r,layers:i}){if(!i)return null;for(const o of i){if("map-image"===o.type){const n=Ae({layers:o.sublayers,map:e,relatedLayer:r,relationship:t})||Ae({layers:o.subtables,map:e,relatedLayer:r,relationship:t});if(n)return n;continue}if(!te(o))continue;if("sublayer"===r.type){if(o!==r&&o.id===n)return o.isTable?xe(e,o):o;continue}const i="scene"===r.type&&r.associatedLayer?r.associatedLayer.url:r.url;if(!i)return null;if("sublayer"!==o.type){if(o!==r&&o.url===i&&o.layerId===n)return o}else if(o!==r&&o.layer?.url===i&&o.id===n)return o.isTable?xe(e,o):o}return null}export{ye as applyTextFormattingHTML,de as createFieldInfoMap,Ue as findRelatedLayer,qe as findUtilityNetwork,K as fixTokens,ge as formatAttributes,fe as formatEditInfo,ie as formatValueToFieldInfo,ce as getAllFieldInfos,k as getConfigurableFieldsContainer,D as getFieldFormat,le as getFieldInfo,$ as getFieldInfoLabel,S as getFixedFieldName,G as getFixedFieldNames,q as getSourceLayer,x as graphicCallback,pe as htmlEntities,ne as isAssociatedFeatureSupportedLayer,E as isExpressionField,Y as isFeatureSupportedLayer,re as isGraphicForRelatableFeatureSupportedLayer,te as isRelatableFeatureSupportedLayer,ee as isRelatableLayer,Te as isRelatedField,ve as preLayerQueryCallback,Le as preRequestCallback,Ie as querySourceLayer,Fe as queryUpdatedFeature,A as shouldOpenInNewTab,H as substituteAttributes,_ as substituteFieldsInLinksAndAttributes};
+import e from"../../core/Logger.js";import{replace as t}from"../../core/string.js";import{getGraphicLayer as n}from"../../graphic/graphicOriginUtils.js";import{formatDate as r,convertDateFormatToIntlOptions as i}from"../../intl/date.js";import{convertNumberFieldFormatToIntlOptions as o,convertNumberFormatToIntlOptions as a,formatNumber as l}from"../../intl/number.js";import{typesHaveUniqueIdsAndNames as u}from"../../layers/support/featureLayerUtils.js";import{fieldFormatFromFieldInfo as s}from"../../layers/support/fieldFormatUtils.js";import{isRasterPixelValueField as f,featureHasFields as d,isTimeOnlyField as c}from"../../layers/support/fieldUtils.js";import{getFieldConfigurationsContainer as p,getEffectiveLayerCapabilities as y}from"../../layers/support/layerUtils.js";import{formatAnyDate as m,isAnyDateField as g}from"../../smartMapping/support/utils.js";import{loadArcade as I}from"../../support/loadArcade.js";import{getTimeZoneFormattingOptions as b}from"../../time/timeZoneUtils.js";const h="esri.popup.support.featureUtils",F=()=>e.getLogger(h),T=/href=(""|'')/gi,w=/(\{([^{\r\n]+)\})/g,N=/'/g,C=/^\s*expression\//i,j=/(\n)/gi,Z=/[\u00A0-\u9999<>&]/gim,v=/href\s*=\s*(?:"([^"]+)"|'([^']+)')/gi,L=/^(?:mailto:|tel:)/,U="relationships/",q=i("short-date-short-time");function x(e){if(null!=e)return(e.sourceLayer||e.layer)??void 0}async function A({type:e,value:t,event:n}){try{return"function"==typeof t?t(n):await t}catch(r){return void F().error("error",`An error occurred when calling the "${e}" function`,{error:r,graphic:n.graphic,value:t})}}function E(e=""){if(e)return!L.test(e.trim().toLowerCase())}function M(e){return!!e&&C.test(e)}function k(e,t){if(!t||!M(t)||!e)return;const n=t.replace(C,"").toLowerCase();return e.find(({name:e})=>e.toLowerCase()===n)}function R(e){const{fieldInfo:t,graphic:n,layer:r}=e;return $({fieldInfo:t,graphic:n})?p(r,{graphic:n}):null}function $({fieldInfo:e,graphic:t}){return!(!e?.fieldName||M(e.fieldName)||we(e.fieldName)||t?.popupTemplate)}function D({expressionInfos:e,fieldInfo:t,graphic:n,isContentFieldInfos:r,layer:i}){if(!t?.fieldName)return null;const o=k(e,t.fieldName);if(o)return o.title||null;const a=R({fieldInfo:t,graphic:n,layer:i});if(a){const e=a.getFieldAlias(t.fieldName);return r?t.label||e||t.fieldName:e||t.fieldName}return t.label||t.fieldName}function z(e){const{configurableFieldsContainer:t,fieldInfo:n,isContentFieldInfos:r}=e;if(!n?.fieldName)return null;const i=t.popupTemplate||t.fieldConfigurations?t.getFieldConfiguration(n.fieldName)?.fieldFormat:s(n,t.getField(n.fieldName));return r&&n.fieldFormat||i}function O(e,t){const n=t.get(e.toLowerCase());return`{${n?.fieldName||e}}`}function S(e){return e.replaceAll(T,"")}function G(e,t){const n=P(t,e);return n?n.name:e}function Q(e,t){return e&&e.map(e=>G(e,t))}function P(e,t){return e&&"function"==typeof e.getField&&t?e.getField(t)??null:null}function _(e){return`${e}`.trim()}function H({attributes:e,globalAttributes:t,layer:n,text:r,expressionAttributes:i,fieldInfoMap:o}){return r?W({formattedAttributes:t,template:X(r,{...t,...i,...e},n),fieldInfoMap:o}):""}function W({formattedAttributes:e,template:n,fieldInfoMap:r}){return _(S(t(t(n,e=>O(e,r)),e)))}function B(e,t,n=!1){const r=t[e];if("string"==typeof r){const i="%27",o=(n?encodeURIComponent(r):r).replaceAll(N,i);t[e]=o}}function J(e,t=!1){const n={...e};return Object.keys(n).forEach(e=>B(e,n,t)),n}function K(e,n,r){const i=(n=_(n))&&!n.startsWith("{");return t(e,J(r,i||!1))}function V(e,t){return e.replaceAll(w,(e,n,r)=>{const i=P(t,r);return i?`{${i.name}}`:n})}function X(e,t,n){const r=V(e,n);return r?r.replaceAll(v,(e,n,r)=>K(e,n||r,t)):r}function Y(e,t){const n="number"===t?.fieldFormat?.type||t?.format&&null==t.format.dateFormat&&(null!=t.format.places||null!=t.format.digitSeparator);if("string"==typeof e&&n){const t=Number(e);if(!isNaN(t))return t}return e}function ee(e){return null!=e&&"object"==typeof e&&"fieldsIndex"in e&&"geometryType"in e&&"getField"in e&&"load"in e&&"loaded"in e&&"objectIdField"in e&&"spatialReference"in e&&"type"in e&&("feature"===e.type||"scene"===e.type||"subtype-group"===e.type||"subtype-sublayer"===e.type||"sublayer"===e.type)&&"when"in e}function te(e){return null!=e&&"object"==typeof e&&"createQuery"in e&&"queryFeatureCount"in e&&"queryObjectIds"in e&&"queryRelatedFeatures"in e&&"queryRelatedFeaturesCount"in e&&"relationships"in e}function ne(e){return ee(e)&&te(e)}function re(e){return!(!(e&&"object"==typeof e&&"createQuery"in e&&"getField"in e&&"queryFeatureCount"in e&&"queryFeatures"in e&&"queryObjectIds"in e&&"capabilities"in e&&"fields"in e&&"fieldsIndex"in e&&"type"in e)||"feature"!==e.type&&"subtype-group"!==e.type&&"subtype-sublayer"!==e.type&&"sublayer"!==e.type||!("when"in e))&&("subtype-sublayer"===e.type&&"parent"in e&&e.parent&&"object"==typeof e.parent?"globalIdField"in e.parent:"globalIdField"in e)}function ie(e){if(!e||"object"!=typeof e)return!1;return ne(n(e))}function oe(e,t){const{fieldInfos:n,fieldName:r,graphic:i,isContentFieldInfos:u,layer:s,preventPlacesFormatting:d,timeZone:c}=t,p=ue(n,r),y=R({fieldInfo:p,graphic:i,layer:s}),g=P(y||s,r),I=y?null:p?.format,b=y?z({configurableFieldsContainer:y,fieldInfo:p,isContentFieldInfos:u}):null,h="number"===b?.type;if(p&&!f(r)){const t=g?.type,n="date-time"===b?.type,r=I?.dateFormat;if("date"===t||"date-only"===t||"time-only"===t||"timestamp-offset"===t||n||r)return m(e,{format:n?void 0:r,fieldFormat:n?b:void 0,fieldType:t,timeZoneOptions:{layerTimeZone:s&&"preferredTimeZone"in s?s.preferredTimeZone:null,viewTimeZone:c,datesInUnknownTimezone:!(!s||!("datesInUnknownTimezone"in s))&&!!s.datesInUnknownTimezone}})}if("string"==typeof e&&f(r)&&I)return ae(e,I);if("string"==typeof(e=Y(e,{format:h?void 0:I,fieldFormat:h?b:void 0}))||null==e||null==I&&null==b)return me(e);const F=h?o(b):I?a(I):void 0;return l(e,d?{...F,minimumFractionDigits:0,maximumFractionDigits:20}:F)}function ae(e,t){return e=e.trim(),/\d{2}-\d{2}/.test(e)?e:e.includes(",")?le(e,",",", ",t):e.includes(";")?le(e,";","; ",t):e.includes(" ")?le(e," "," ",t):l(Number(e),a(t))}function le(e,t,n,r){return e.trim().split(t).map(e=>l(Number(e),a(r))).join(n)}function ue(e,t){if(e?.length&&t)return e.find(e=>e.fieldName?.toLowerCase()===t.toLowerCase())}function se({fieldName:e,graphic:t,layer:n}){if(we(e))return null;if(!n||"function"!=typeof n.getFeatureType)return null;const{typeIdField:r}=n;if(!r||e!==r)return null;const i=n.getFeatureType(t);return i?i.name:null}function fe({fieldName:e,value:t,graphic:n,layer:r}){if(we(e))return null;if(!r||"function"!=typeof r.getFieldDomain)return null;const i=n&&r.getFieldDomain(e,{feature:n});return i&&"coded-value"===i.type?i.getName(t):null}function de(e,t,n,i){const{creatorField:o,creationDateField:a,editorField:l,editDateField:u}=e;if(!t)return;const s=b(i&&"preferredTimeZone"in i?i.preferredTimeZone:null,!(!i||!("datesInUnknownTimezone"in i))&&!!i.datesInUnknownTimezone,n,q,"date"),f={...q,...s},d=t[u];if("number"==typeof d){const e=t[l];return{type:"edit",date:r(d,f),user:e}}const c=t[a];if("number"==typeof c){const e=t[o];return{type:"create",date:r(c,f),user:e}}return null}function ce(e,t){const n=new Map;if(!e)return n;for(const r of e){if(!r.fieldName)continue;const e=G(r.fieldName,t);r.fieldName=e,n.set(e.toLowerCase(),r)}return n}function pe(e){const t=[];if(!e)return t;const{fieldInfos:n,content:r}=e;return n&&t.push(...n),r&&Array.isArray(r)?(r.forEach(e=>{if("fields"===e.type){const n=e?.fieldInfos;n&&t.push(...n)}}),t):t}function ye(e){return e.replaceAll(Z,e=>`&#${e.charCodeAt(0)};`)}function me(e){return"string"==typeof e?e.replaceAll(j,'<br class="esri-text-new-line" />'):e}function ge(e){const{fieldInfoMap:t,fieldInfos:n,fieldName:r,graphic:i,isContentFieldInfos:o,layer:a,timeZone:l,value:s}=e;if(null==s)return"";const f=fe({fieldName:r,value:s,graphic:i,layer:a});if(f)return f;const d=a?.types&&u(a.types)?se({fieldName:r,graphic:i,layer:a}):null;if(d)return d;if(t.get(r.toLowerCase()))return oe(s,{fieldInfos:n||Array.from(t.values()),fieldName:r,graphic:i,isContentFieldInfos:o,layer:a,timeZone:l});const p=a?.fieldsIndex?.get(r);return p&&(g(p)||c(p))?m(s,{fieldType:p.type,timeZoneOptions:{layerTimeZone:a&&"preferredTimeZone"in a?a.preferredTimeZone:null,viewTimeZone:l,datesInUnknownTimezone:!(!a||!("datesInUnknownTimezone"in a))&&!!a.datesInUnknownTimezone}}):me(s)}function Ie({attributes:e,fieldInfoMap:t,fieldInfos:n,graphic:r,isContentFieldInfos:i,layer:o,relatedInfos:a,timeZone:l}){const u={};return a?.forEach(e=>je({attributes:u,relatedInfo:e,fieldInfoMap:t,fieldInfos:n,layer:o,timeZone:l})),e&&Object.keys(e).forEach(a=>{const s=e[a];u[a]=ge({fieldInfoMap:t,fieldInfos:n,fieldName:a,graphic:r,isContentFieldInfos:i,layer:o,timeZone:l,value:s})}),u}async function be(e,t){const{layer:n,graphic:r,outFields:i,objectIds:o,returnGeometry:a,spatialReference:l}=e,u=o[0];if("number"!=typeof u&&"string"!=typeof u){const e="Could not query required fields for the specified feature. The feature's ID is invalid.",t={layer:n,graphic:r,objectId:u,requiredFields:i};return F().warn(e,t),null}if(!y(n)?.operations?.supportsQuery){const e="The specified layer cannot be queried. The following fields will not be available.",t={layer:n,graphic:r,requiredFields:i,returnGeometry:a};return F().warn(e,t),null}const s=n.createQuery();s.objectIds=o,s.outFields=i?.length?i:[n.objectIdField],s.returnGeometry=!!a,s.returnZ=!!a,s.returnM=!!a,s.outSpatialReference=l;return(await n.queryFeatures(s,t)).features[0]}async function he(e){if(!e.expressionInfos?.length)return!1;const t=await I(),{arcadeUtils:{hasGeometryFunctions:n}}=t;return n(e)}async function Fe(e){if(!e.expressionInfos?.length)return!1;const t=await I(),{arcadeUtils:{requiresTrack:n}}=t;return n(e)}async function Te({graphic:e,popupTemplate:t,layer:n,spatialReference:r},i){if(!n||!t)return;if("function"==typeof n.load&&await n.load(i),!e.attributes)return;const o=n.objectIdField,a=e.attributes[o];if(null==a)return;const l=[a],u=new Set(await t.getRequiredFields(n.fieldsIndex));null==n.timeInfo?.trackIdField||u.has(n.timeInfo.trackIdField)||await Fe(t)&&u.add(n.timeInfo.trackIdField);const s=d(e,u),f=s?[]:u.has(o)?[...u]:[...u,o],c=t.returnGeometry||await he(t);if(s&&!c)return;const p=await be({layer:n,graphic:e,outFields:f,objectIds:l,returnGeometry:c,spatialReference:r},i);p&&(p.geometry&&(e.geometry=p.geometry),p.attributes&&(e.attributes={...e.attributes,...p.attributes}))}function we(e=""){return!!e&&e.includes(U)}function Ne(e){return e?`${U}${e.layerId}/${e.fieldName}`:""}function Ce({attributes:e,graphic:t,relatedInfo:n,fieldInfos:r,fieldInfoMap:i,layer:o,timeZone:a}){e&&t&&n&&Object.keys(t.attributes).forEach(l=>{const u=Ne({layerId:n.relation.id.toString(),fieldName:l}),s=t.attributes[l];e[u]=ge({fieldName:u,fieldInfos:r,fieldInfoMap:i,layer:o,value:s,graphic:t,timeZone:a})})}function je({attributes:e,relatedInfo:t,fieldInfoMap:n,fieldInfos:r,layer:i,timeZone:o}){e&&t&&(t.relatedFeatures?.forEach(a=>Ce({attributes:e,graphic:a,relatedInfo:t,fieldInfoMap:n,fieldInfos:r,layer:i,timeZone:o})),t.relatedStatsFeatures?.forEach(a=>Ce({attributes:e,graphic:a,relatedInfo:t,fieldInfoMap:n,fieldInfos:r,layer:i,timeZone:o})))}const Ze=e=>{if(!e)return!1;const t=e.toUpperCase();return t.includes("CURRENT_TIMESTAMP")||t.includes("CURRENT_DATE")||t.includes("CURRENT_TIME")},ve=({layer:e,method:t,query:n,definitionExpression:r})=>{if(!e.capabilities?.query?.supportsCacheHint||"attachments"===t)return;const i=null!=n.where?n.where:null,o=null!=n.geometry?n.geometry:null;Ze(r)||Ze(i)||"extent"===o?.type||"tile"===n.resultType||(n.cacheHint=!0)},Le=({query:e,layer:t,method:n})=>{ve({layer:t,method:n,query:e,definitionExpression:`${t.definitionExpression} ${t.serviceDefinitionExpression??""}`})},Ue=({queryPayload:e,layer:t,method:n})=>{ve({layer:t,method:n,query:e,definitionExpression:`${t.definitionExpression} ${t.serviceDefinitionExpression??""}`})};function qe(e,t,n){return e&&t&&n?"sublayer"===t.type?Ee({layers:t.layer?.allSublayers,map:e,relatedLayer:t,relationship:n})||Ee({layers:t.layer?.subtables,map:e,relatedLayer:t,relationship:n}):Ee({layers:e.allLayers,map:e,relatedLayer:t,relationship:n})||Ee({layers:e.allTables,map:e,relatedLayer:t,relationship:n}):null}function xe(e,t){return e&&"utilityNetworks"in e&&t?e.utilityNetworks?.find(e=>e.isUtilityLayer(t)):null}function Ae(e,t){return e?.allTables.find(e=>"feature"===e.type&&e.layerId===t.id&&e.url===t.layer?.url)}function Ee({map:e,relationship:t,relationship:{relatedTableId:n},relatedLayer:r,layers:i}){if(!i)return null;for(const o of i){if("map-image"===o.type){const n=Ee({layers:o.sublayers,map:e,relatedLayer:r,relationship:t})||Ee({layers:o.subtables,map:e,relatedLayer:r,relationship:t});if(n)return n;continue}if(!ne(o))continue;if("sublayer"===r.type){if(o!==r&&o.id===n)return o.isTable?Ae(e,o):o;continue}const i="scene"===r.type&&r.associatedLayer?r.associatedLayer.url:r.url;if(!i)return null;if("sublayer"!==o.type){if(o!==r&&o.url===i&&o.layerId===n)return o}else if(o!==r&&o.layer?.url===i&&o.id===n)return o.isTable?Ae(e,o):o}return null}export{me as applyTextFormattingHTML,ce as createFieldInfoMap,qe as findRelatedLayer,xe as findUtilityNetwork,V as fixTokens,Ie as formatAttributes,de as formatEditInfo,oe as formatValueToFieldInfo,pe as getAllFieldInfos,R as getConfigurableFieldsContainer,z as getFieldFormat,ue as getFieldInfo,D as getFieldInfoLabel,G as getFixedFieldName,Q as getFixedFieldNames,x as getSourceLayer,A as graphicCallback,ye as htmlEntities,re as isAssociatedFeatureSupportedLayer,M as isExpressionField,ee as isFeatureSupportedLayer,ie as isGraphicForRelatableFeatureSupportedLayer,ne as isRelatableFeatureSupportedLayer,te as isRelatableLayer,we as isRelatedField,Le as preLayerQueryCallback,Ue as preRequestCallback,be as querySourceLayer,Te as queryUpdatedFeature,E as shouldOpenInNewTab,W as substituteAttributes,H as substituteFieldsInLinksAndAttributes};

package/popup/types.d.ts

@@ -1,5 +1,9 @@
 import type Graphic from "../Graphic.js";
+import type SpatialReference from "../geometry/SpatialReference.js";
+import type Field from "../layers/support/Field.js";
+import type Relationship from "../layers/support/Relationship.js";
 import type Content from "./content/Content.js";
+import type StatisticDefinition from "../rest/support/StatisticDefinition.js";
 import type MapView from "../views/MapView.js";
 import type SceneView from "../views/SceneView.js";
 import type { ScreenPoint } from "../core/types.js";
@@ -168,14 +172,195 @@ export type PopupTemplateTitleResolved = string;
 /** @since 5.0 */
 export type State = "disabled" | "ready" | "error" | "loading";
 
-/** @since 5.0 */
-export interface FeatureFormattedAttributes {}
+/** @since 5.1 */
+export interface FeatureFormattedAttributes {
+  /**
+   * The formatted attributes specified at the root level of the [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
+   * using the [PopupTemplate.fieldInfos](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#fieldInfos) property.
+   *
+   * @since 5.1
+   */
+  global: Record<string, any>;
+  /**
+   * The formatted attributes for an individual content element. This is derived from the
+   * [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/), or
+   * per an individual content element. This element is defined with a [FieldsContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/FieldsContent/)
+   * popup element set on the PopupTemplate's [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content).
+   *
+   * @since 5.1
+   */
+  content: Record<string, any>[];
+}
 
-/** @since 5.0 */
-export interface LastEditInfo {}
+/** @since 5.1 */
+export interface LastEditInfo {
+  /**
+   * User who performed the last edit on a feature.
+   *
+   * @since 5.1
+   */
+  user: string;
+  /**
+   * Date that the edit was performed.
+   *
+   * @since 5.1
+   */
+  date: string;
+  /**
+   * The type of edit that was performed on the feature.
+   *
+   * @since 5.1
+   */
+  type: "edit" | "create";
+}
 
-/** @since 5.0 */
-export interface RelatedInfo {}
+/**
+ * Information about the layer associated with the feature.
+ *
+ * @since 5.1
+ */
+export interface LayerInfo {
+  /**
+   * An array of the layer's fields.
+   *
+   * @since 5.1
+   */
+  fields: Field[];
+  /**
+   * An array of the layer's relationships.
+   *
+   * @since 5.1
+   */
+  relationships: Relationship[];
+  /**
+   * The object ID field of the layer.
+   *
+   * @since 5.1
+   */
+  objectIdField: string;
+  /**
+   * Indicates whether the layer supports statistics.
+   *
+   * @since 5.1
+   */
+  supportsStatistics: boolean;
+}
 
-/** @since 5.0 */
-export interface Abilities {}
+/** @since 5.1 */
+export interface RelatedInfo {
+  /**
+   * The URL of the related layer.
+   *
+   * @since 5.1
+   */
+  url: string;
+  /**
+   * An array of statistics to be calculated for the related features.
+   *
+   * @since 5.1
+   */
+  outStatistics?: StatisticDefinition[];
+  /**
+   * An array of related fields that are related to the current feature.
+   *
+   * @since 5.1
+   */
+  relatedFields?: string[];
+  /**
+   * An array of features related to the current feature.
+   *
+   * @since 5.1
+   */
+  relatedFeatures?: Graphic[];
+  /**
+   * An array of related features with statistics for the current feature.
+   *
+   * @since 5.1
+   */
+  relatedStatsFeatures?: Graphic[];
+  /**
+   * The relationship between the current feature and the related features.
+   *
+   * @since 5.1
+   */
+  relation?: Relationship;
+  /**
+   * The layer information for the related features.
+   *
+   * @since 5.1
+   */
+  layerInfo?: LayerInfo;
+  /**
+   * The spatial reference of the source feature.
+   *
+   * @since 5.1
+   */
+  sourceSpatialReference?: SpatialReference;
+}
+
+/** @since 5.1 */
+export interface Abilities {
+  /**
+   * Indicate whether to query and display [attachments](https://developers.arcgis.com/javascript/latest/references/core/popup/content/AttachmentsContent/) associated with the feature.
+   *
+   * @default true
+   * @since 5.1
+   */
+  attachmentsContent?: boolean;
+  /**
+   * Indicate whether to display animations for charts residing in [media content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/MediaContent/).
+   *
+   * @default true
+   * @since 5.1
+   */
+  chartAnimation?: boolean;
+  /**
+   * Indicate whether to display any [custom content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/CustomContent/).
+   *
+   * @default true
+   * @since 5.1
+   */
+  customContent?: boolean;
+  /**
+   * Indicate whether to display any [expression content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/).
+   *
+   * @default true
+   * @since 5.1
+   */
+  expressionContent?: boolean;
+  /**
+   * Indicate whether to display any [fields content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/FieldsContent/).
+   *
+   * @default true
+   * @since 5.1
+   */
+  fieldsContent?: boolean;
+  /**
+   * Indicate whether to display any [media content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/MediaContent/).
+   *
+   * @default true
+   * @since 5.1
+   */
+  mediaContent?: boolean;
+  /**
+   * Indicate whether to display any [text content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/TextContent/).
+   *
+   * @default true
+   * @since 5.1
+   */
+  textContent?: boolean;
+  /**
+   * Indicate whether the widget should display [relationship content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/RelationshipContent/).
+   *
+   * @default true
+   * @since 5.1
+   */
+  relationshipContent?: boolean;
+  /**
+   * Indicate whether the widget should display [utility network associations content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/UtilityNetworkAssociationsContent/).
+   *
+   * @default true
+   * @since 5.1
+   */
+  utilityNetworkAssociationsContent?: boolean;
+}