@arcgis/map-components 5.2.0-next.13 → 5.2.0-next.130

package/dist/components/arcgis-feature-relationship/customElement.js

@@ -1,32 +1,37 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as B } from "../../chunks/runtime.js";
-import { css as H, html as o } from "lit";
+import { c as H } from "../../chunks/runtime.js";
+import { css as k, html as o } from "lit";
 import { debounce as A } from "@arcgis/toolkit/function";
-import { LitElement as k, renderElement as q, safeClassMap as x } from "@arcgis/lumina";
-import { templateHasKey as D, stripHTML as E } from "@arcgis/core/applications/Components/stringUtils.js";
-import { renderingSanitizer as N } from "@arcgis/core/applications/Components/sanitizerUtils.js";
-import { isRelatableFeatureSupportedLayer as K, findRelatedLayer as W } from "@arcgis/core/applications/Components/featureUtils.js";
-import { substitute as Z, formatNumber as O } from "@arcgis/core/intl.js";
-import { watch as f, on as z } from "@arcgis/core/core/reactiveUtils.js";
-import { o as G } from "../../chunks/feature-utils.js";
+import { LitElement as K, renderElement as q, safeClassMap as D } from "@arcgis/lumina";
+import { templateHasKey as x, stripHTML as N } from "@arcgis/core/applications/Components/stringUtils.js";
+import { renderingSanitizer as O } from "@arcgis/core/applications/Components/sanitizerUtils.js";
+import { isRelatableFeatureSupportedLayer as W, findRelatedLayer as Z } from "@arcgis/core/applications/Components/featureUtils.js";
+import { substitute as z, formatNumber as V } from "@arcgis/core/intl.js";
+import { watch as g, on as G } from "@arcgis/core/core/reactiveUtils.js";
+import { p as J } from "../../chunks/feature-utils.js";
 import M from "@arcgis/core/core/Collection.js";
 import S from "@arcgis/core/rest/support/RelationshipQuery.js";
-import { ignoreAbortErrors as L } from "@arcgis/core/core/promiseUtils.js";
-import { classes as V } from "@arcgis/toolkit/dom";
-import { createRef as J, ref as U } from "lit/directives/ref.js";
-import X from "@arcgis/core/popup/Feature.js";
-const Y = H`:host{position:relative;flex:1 1 auto}.list{min-height:var(--calcite-spacing-xxxl)}.list-item-hidden{display:none}.feature-observer{position:relative;bottom:var(--calcite-spacing-xxl);z-index:2;text-align:center}.sticky-loading-container{display:flex;position:sticky;bottom:var(--calcite-spacing-sm);align-items:center;justify-content:center;z-index:2;margin:0;padding:0;height:var(--calcite-spacing-xxxl);pointer-events:none}`, ee = (g) => {
+import { ignoreAbortErrors as R } from "@arcgis/core/core/promiseUtils.js";
+import { classes as Q } from "@arcgis/toolkit/dom";
+import { createRef as U, ref as X } from "lit/directives/ref.js";
+import Y from "@arcgis/core/popup/FeatureContent.js";
+import { g as L } from "../../chunks/async-utils.js";
+import { bypassReadOnly as ee } from "@arcgis/lumina/controllers";
+const te = k`:host{position:relative;flex:1 1 auto}:host([empty]){display:none}.list{min-height:var(--calcite-spacing-xxxl)}.list-item-hidden{display:none}.feature-observer{position:relative;bottom:var(--calcite-spacing-xxl);z-index:2;text-align:center}.sticky-loading-container{display:flex;position:sticky;bottom:var(--calcite-spacing-sm);align-items:center;justify-content:center;z-index:2;margin:0;padding:0;height:var(--calcite-spacing-xxxl);pointer-events:none}`, re = (h) => {
   const e = [];
-  if (g.formTemplate) {
-    const { description: t, title: r } = g.formTemplate;
-    g.fields?.forEach((i) => {
-      const s = r && D(r, i.name), a = t && D(t, i.name);
+  if (h.formTemplate) {
+    const { description: t, title: r } = h.formTemplate;
+    h.fields?.forEach((i) => {
+      const s = r && x(r, i.name), a = t && x(t, i.name);
       (s || a) && e.push(i.name);
     });
   }
   return e;
-}, R = 100;
-class te extends k {
+}, P = 100;
+function ie(h) {
+  return typeof h == "string" && h.trim().length > 0;
+}
+class se extends K {
   constructor() {
     super(...arguments), this._increaseFeaturePage = () => {
       const { state: e, showAllEnabled: t, relatedFeatures: r, featuresPerPage: i, featurePage: s } = this;
@@ -47,32 +52,32 @@ class te extends k {
     }, this._queryController = async () => {
       this._cancelQuery();
       const e = new AbortController();
-      this._queryAbortController = e, await L(this._query()), this._queryAbortController === e && (this._queryAbortController = null);
+      this._queryAbortController = e, await R(this._query()), this._queryAbortController === e && (this._queryAbortController = null);
     }, this._queryFeatureCountController = async () => {
       this._loaded = !1, this._cancelQueryFeatureCount();
       const e = new AbortController();
-      this._queryFeatureCountAbortController = e, await L(this._queryFeatureCount()), this._queryFeatureCountAbortController === e && (this._queryFeatureCountAbortController = null), this._loaded = !0;
+      this._queryFeatureCountAbortController = e, await R(this._queryFeatureCount()), this._queryFeatureCountAbortController === e && (this._queryFeatureCountAbortController = null), this._loaded = !0;
     }, this._queryPageController = async () => {
       const e = new AbortController();
-      this._queryPageAbortController = e, await L(this._queryPage()), this._queryPageAbortController === e && (this._queryPageAbortController = null);
-    }, this._queryDebounced = A(this._queryController, R), this._queryFeatureCountDebounced = A(this._queryFeatureCountController, R), this._queryPageDebounced = A(this._queryPageController, R), this._query = async () => {
+      this._queryPageAbortController = e, await R(this._queryPage()), this._queryPageAbortController === e && (this._queryPageAbortController = null);
+    }, this._queryDebounced = A(this._queryController, L(P)), this._queryFeatureCountDebounced = A(this._queryFeatureCountController, L(P)), this._queryPageDebounced = A(this._queryPageController, L(P)), this._query = async () => {
       const { _queryAbortController: e, relatedFeatures: t } = this;
       !this.featureCount || this.relatedLayer?.type === "subtype-group" && !this.activeCategory || (this.relatedFeatureViewModels.destroyAll(), this.featurePage = 1, t.destroyAll(), t.addMany(this._sliceFeatures(await this._queryRelatedFeatures({ signal: e?.signal }))));
     }, this._addFlowItem = (e) => {
       e && this.flowItems?.push(e);
-    }, this._relatedFeatureIntersectionObserverNode = J(), this.relatedFeatures = new M(), this._queryAbortController = null, this._queryPageAbortController = null, this._queryFeatureCountAbortController = null, this.featureCount = 0, this._loaded = !1, this.relatedFeatureViewModels = new M(), this.autoDestroyDisabled = !1, this.featuresPerPage = 10, this.useFeatureNextFlowItem = !1, this.flowType = "feature-relationship", this.headingLevel = 2, this.hideHeading = !1, this.hideDescription = !1, this.showAllEnabled = !1;
+    }, this._relatedFeatureIntersectionObserverNode = U(), this.relatedFeatures = new M(), this._queryAbortController = null, this._queryPageAbortController = null, this._queryFeatureCountAbortController = null, this.featureCount = 0, this._loaded = !1, this.relatedFeatureViewModels = new M(), this.autoDestroyDisabled = !1, this.featuresPerPage = 10, this.useFeatureNextFlowItem = !1, this.flowType = "feature-relationship", this.headingLevel = 2, this.hideHeading = !1, this.hideDescription = !1, this.hideEmptyRelationshipContent = !1, this.empty = !1, this.showAllEnabled = !1;
   }
   static {
-    this.properties = { allCategories: 16, _queryAbortController: 16, _queryPageAbortController: 16, _queryFeatureCountAbortController: 16, featureCount: 16, _loaded: 16, canLoad: 16, canQuery: 16, displayShowAllButton: 16, displayListItems: 16, categories: 16, itemDescriptionFieldName: 16, relatedFeatureViewModels: 16, state: 16, autoDestroyDisabled: 5, allItemsDescription: 32, featurePage: 9, featuresPerPage: 9, flowItems: 0, useFeatureNextFlowItem: 5, flowType: 1, headingLevel: 9, messages: 0, heading: 1, description: 1, values: 0, activeCategory: 0, hideHeading: 5, hideDescription: 5, displayCount: 9, graphic: 0, layer: 0, map: 0, view: 0, spatialReference: 0, timeZone: 1, orderByFields: 0, relationshipId: 9, showAllEnabled: 5, label: 3 };
+    this.properties = { allCategories: 16, _queryAbortController: 16, _queryPageAbortController: 16, _queryFeatureCountAbortController: 16, featureCount: 16, _loaded: 16, canLoad: 16, canQuery: 16, displayShowAllButton: 16, displayListItems: 16, categories: 16, itemDescriptionFieldName: 16, relatedFeatureViewModels: 16, state: 16, autoDestroyDisabled: 5, allItemsDescription: 32, featurePage: 9, featuresPerPage: 9, flowItems: 0, useFeatureNextFlowItem: 5, flowType: 1, headingLevel: 9, messages: 0, heading: 1, description: 1, values: 0, activeCategory: 0, hideHeading: 5, hideDescription: 5, hideEmptyRelationshipContent: 5, empty: 39, displayCount: 9, graphic: 0, layer: 0, map: 0, view: 0, spatialReference: 0, timeZone: 1, orderByFields: 0, relationshipId: 9, showAllEnabled: 5, label: 3 };
   }
   static {
-    this.styles = Y;
+    this.styles = te;
   }
   get orderByFieldsFixedCasing() {
     const { orderByFields: e, relatedLayer: t } = this;
     return e && t?.loaded ? e.map((r) => {
       const i = r.clone();
-      return i.field = G(r.field, t), i;
+      return i.field = J(r.field, t), i;
     }) : e ?? [];
   }
   get supportsCacheHint() {
@@ -91,8 +96,8 @@ class te extends k {
     const { layer: e, map: t, relationship: r } = this;
     if (!e?.loaded || !t || !r)
       return null;
-    const i = e.type === "subtype-sublayer" && e.parent && K(e.parent) ? e.parent : e;
-    return W(t, i, r) ?? null;
+    const i = e.type === "subtype-sublayer" && e.parent && W(e.parent) ? e.parent : e;
+    return Z(t, i, r) ?? null;
   }
   get relatedLayerKeyField() {
     const { relatedLayer: e, relationshipId: t } = this;
@@ -141,8 +146,8 @@ class te extends k {
   }
   get allItemsDescription() {
     const { messages: e, featureCount: t, allCategories: r, allCategoriesCount: i } = this;
-    return Z(e?.numberRecords ?? "", {
-      number: O(r ? i : t)
+    return z(e?.numberRecords ?? "", {
+      number: V(r ? i : t)
     });
   }
   get featurePage() {
@@ -159,6 +164,10 @@ class te extends k {
   set heading(e) {
     this._heading = e;
   }
+  get _empty() {
+    const { displayListItems: e, hideEmptyRelationshipContent: t, state: r } = this;
+    return t && r === "ready" && !e;
+  }
   get displayCount() {
     return this._displayCount ?? 3;
   }
@@ -170,7 +179,7 @@ class te extends k {
   }
   loaded() {
     this.manager.onLifecycle(() => [
-      f(() => [
+      g(() => [
         this.displayCount,
         this.graphic,
         this.layer,
@@ -184,14 +193,18 @@ class te extends k {
         this.featureCount,
         this.activeCategory
       ], () => this._queryDebounced(), { initial: !0 }),
-      f(() => [this.featurePage, this.showAllEnabled], () => this._queryPageDebounced()),
-      f(() => [this.layer, this.relationshipId, this.objectId, this.canQuery, this.activeCategory], () => this._queryFeatureCountDebounced(), { initial: !0 }),
-      f(() => [this.state, this.showAllEnabled, this._relatedFeatureIntersectionObserverNode], () => this._handleRelatedFeatureObserverChange()),
-      z(() => this.relatedFeatures, "change", () => this._setRelatedFeaturesViewModels())
+      g(() => [this.featurePage, this.showAllEnabled], () => this._queryPageDebounced()),
+      g(() => [this.layer, this.relationshipId, this.objectId, this.canQuery, this.activeCategory], () => this._queryFeatureCountDebounced(), { initial: !0 }),
+      g(() => [this.state, this.showAllEnabled, this._relatedFeatureIntersectionObserverNode], () => this._handleRelatedFeatureObserverChange()),
+      g(() => [this.displayListItems, this.hideEmptyRelationshipContent, this.state], () => this._setEmpty(this._empty), { initial: !0 }),
+      G(() => this.relatedFeatures, "change", () => this._setRelatedFeaturesViewModels())
     ]), this.manager.onDestroy(() => {
       this.relatedFeatureViewModels.destroyAll(), this.relatedFeatures.destroyAll(), this._cancelQuery(), this._cancelQueryFeatureCount(), this._cancelQueryPage(), this._unobserveRelatedFeatureObserver();
     });
   }
+  _setEmpty(e) {
+    ee(() => this.empty = e);
+  }
   async _queryFeatureCount() {
     const { layer: e, relatedLayer: t } = this;
     await e?.load(), await t?.load();
@@ -202,35 +215,35 @@ class te extends k {
     }
     if (t?.type === "subtype-group" && !i) {
       if (this.featureCount = 0, this.relatedFeatureViewModels.destroyAll(), this.featurePage = 1, this.relatedFeatures.destroyAll(), n && d != null) {
-        const { default: C } = await import("@arcgis/core/smartMapping/statistics/uniqueValues.js"), { uniqueValueInfos: w } = await C({
+        const { default: F } = await import("@arcgis/core/smartMapping/statistics/uniqueValues.js"), { uniqueValueInfos: w } = await F({
           layer: t,
           sqlWhere: `${n} = '${d}'`,
           field: t.subtypeField ?? void 0,
           signal: r?.signal
-        }), v = w.map(({ count: h, value: y }) => {
-          const m = t.subtypes?.find((I) => I.code === y)?.name;
-          return y != null && m ? {
-            count: h,
-            value: y,
-            name: m
+        }), v = w.map(({ count: c, value: p }) => {
+          const f = t.subtypes?.find((I) => I.code === p)?.name;
+          return p != null && f ? {
+            count: c,
+            value: p,
+            name: f
           } : void 0;
-        }).filter((h) => h != null);
+        }).filter((c) => c != null);
         this.allCategories = v;
       }
       return;
     }
-    const { historicMoment: p, gdbVersion: F } = e, _ = new S({
+    const { historicMoment: m, gdbVersion: C } = e, _ = new S({
       cacheHint: b,
-      gdbVersion: F,
-      historicMoment: p,
+      gdbVersion: C,
+      historicMoment: m,
       relationshipId: l,
       returnGeometry: !1,
       objectIds: [a],
       where: this._getRelationshipWhereClause(t)
-    }), c = await e.queryRelatedFeaturesCount(_, {
+    }), y = await e.queryRelatedFeaturesCount(_, {
       signal: r?.signal
     });
-    this.allCategories = void 0, this.featureCount = c[a] || 0;
+    this.allCategories = void 0, this.featureCount = y[a] || 0;
   }
   _getRelationshipWhereClause(e) {
     const { activeCategory: t } = this, r = e.createQuery(), i = "subtypeField" in e ? e.subtypeField : void 0, s = t && i ? `${i} = ${t.value}` : void 0, a = r.where;
@@ -245,33 +258,33 @@ class te extends k {
     !r || t < 2 || !s || this.relatedLayer?.type === "subtype-group" && !this.activeCategory || e.addMany(await this._queryRelatedFeatures({ signal: i?.signal }));
   }
   async _queryRelatedFeatures(e) {
-    const { displayCount: t, featureCount: r, featurePage: i, featuresPerPage: s, layer: a, orderByFieldsFixedCasing: n, relatedLayer: l, relatedLayerKeyFields: d, relationshipId: b, showAllEnabled: p, supportsCacheHint: F } = this, { canQuery: _, objectId: c } = this;
-    if (!_ || !a || !l || c == null)
+    const { displayCount: t, featureCount: r, featurePage: i, featuresPerPage: s, layer: a, orderByFieldsFixedCasing: n, relatedLayer: l, relatedLayerKeyFields: d, relationshipId: b, showAllEnabled: m, supportsCacheHint: C } = this, { canQuery: _, objectId: y } = this;
+    if (!_ || !a || !l || y == null)
       return [];
-    const C = p ? ((i - 1) * s + r) % r : 0, w = p ? s : t, v = l.objectIdField, h = "subtypeField" in l ? l.subtypeField : void 0, y = [
+    const F = m ? ((i - 1) * s + r) % r : 0, w = m ? s : t, v = l.objectIdField, c = "subtypeField" in l ? l.subtypeField : void 0, p = [
       ...n.map((u) => u.field),
-      ...ee(l),
+      ...re(l),
       ...d,
       v,
-      h
-    ].filter((u) => u != null), m = n.map((u) => `${u.field} ${u.order}`), { historicMoment: I, gdbVersion: Q } = a, j = new S({
-      orderByFields: m,
-      start: C,
+      c
+    ].filter(ie), f = n.map((u) => `${u.field} ${u.order}`), { historicMoment: I, gdbVersion: T } = a, j = new S({
+      orderByFields: f,
+      start: F,
       num: w,
-      outFields: y,
-      cacheHint: F,
+      outFields: p,
+      cacheHint: C,
       historicMoment: I,
-      gdbVersion: Q,
+      gdbVersion: T,
       relationshipId: b,
       returnGeometry: !1,
-      objectIds: [c],
+      objectIds: [y],
       where: this._getRelationshipWhereClause(l)
     }), $ = (await a.queryRelatedFeatures(j, {
       signal: e?.signal
-    }))[c]?.features || [];
-    return l.type === "subtype-group" && h ? $.forEach((u) => {
-      const T = u.attributes[h], P = l.findSublayerForSubtypeCode?.(T);
-      u.sourceLayer = P, u.layer = P;
+    }))[y]?.features || [];
+    return l.type === "subtype-group" && c ? $.forEach((u) => {
+      const B = u.attributes[c], E = l.findSublayerForSubtypeCode?.(B);
+      u.sourceLayer = E, u.layer = E;
     }) : $.forEach((u) => {
       u.sourceLayer = l, u.layer = l;
     }), $;
@@ -284,11 +297,11 @@ class te extends k {
     const { flowItems: t } = this;
     if (!t)
       return;
-    const r = this.useFeatureNextFlowItem ? q(o`<arcgis-feature-next .autoDestroyDisabled=${this.autoDestroyDisabled} .flowItems=${t} .flowType=${this.flowType} .graphic=${e.graphic} .map=${this.map} show-relationship-content .spatialReference=${this.spatialReference} .timeZone=${this.timeZone} .view=${this.view}></arcgis-feature-next>`) : q(o`<arcgis-feature .autoDestroyDisabled=${this.autoDestroyDisabled} .flowItems=${t} .flowType=${this.flowType} .graphic=${e.graphic} .map=${this.map} show-relationship-content .spatialReference=${this.spatialReference} .timeZone=${this.timeZone} .view=${this.view}></arcgis-feature>`);
+    const r = this.useFeatureNextFlowItem ? q(o`<arcgis-feature-next .autoDestroyDisabled=${this.autoDestroyDisabled} .flowItems=${t} .flowType=${this.flowType} .graphic=${e.graphic} .hideEmptyRelationshipContent=${this.hideEmptyRelationshipContent} .map=${this.map} show-relationship-content .spatialReference=${this.spatialReference} .timeZone=${this.timeZone} .view=${this.view}></arcgis-feature-next>`) : q(o`<arcgis-feature .autoDestroyDisabled=${this.autoDestroyDisabled} .flowItems=${t} .flowType=${this.flowType} .graphic=${e.graphic} .map=${this.map} show-relationship-content .spatialReference=${this.spatialReference} .timeZone=${this.timeZone} .view=${this.view}></arcgis-feature>`);
     this._addFlowItem(r);
   }
   _addRelationshipFlowItem({ showAllEnabled: e = !1, activeCategory: t }) {
-    this._addFlowItem(q(o`<arcgis-feature-relationship .autoDestroyDisabled=${this.autoDestroyDisabled} .messages=${this.messages} .activeCategory=${t} .displayCount=${this.displayCount} .flowItems=${this.flowItems} .flowType=${this.flowType} .graphic=${this.graphic} .heading=${this.heading} hide-description .showAllEnabled=${e} hide-heading .layer=${this.layer} .map=${this.map} .orderByFields=${this.orderByFields} .relationshipId=${this.relationshipId} .spatialReference=${this.spatialReference} .useFeatureNextFlowItem=${this.useFeatureNextFlowItem} .values=${this.values} .view=${this.view}></arcgis-feature-relationship>`));
+    this._addFlowItem(q(o`<arcgis-feature-relationship .autoDestroyDisabled=${this.autoDestroyDisabled} .messages=${this.messages} .activeCategory=${t} .displayCount=${this.displayCount} .flowItems=${this.flowItems} .flowType=${this.flowType} .graphic=${this.graphic} .heading=${this.heading} hide-description .hideEmptyRelationshipContent=${this.hideEmptyRelationshipContent} .showAllEnabled=${e} hide-heading .layer=${this.layer} .map=${this.map} .orderByFields=${this.orderByFields} .relationshipId=${this.relationshipId} .spatialReference=${this.spatialReference} .useFeatureNextFlowItem=${this.useFeatureNextFlowItem} .values=${this.values} .view=${this.view}></arcgis-feature-relationship>`));
   }
   _showAllRecords() {
     const { flowItems: e } = this;
@@ -309,7 +322,7 @@ class te extends k {
   _setRelatedFeaturesViewModels() {
     const { relatedFeatures: e, relatedFeatureViewModels: t, map: r, view: i, spatialReference: s, timeZone: a } = this;
     e?.filter(Boolean).forEach((n) => {
-      t.some((d) => this._matchesFeature(d, n)) || t.add(new X({
+      t.some((d) => this._matchesFeature(d, n)) || t.add(new Y({
         abilities: { relationshipContent: !1 },
         map: r,
         view: i,
@@ -341,7 +354,7 @@ class te extends k {
     return o`<calcite-icon flip-rtl icon=chevron-right scale=s slot=content-end></calcite-icon>`;
   }
   _renderCategory(e) {
-    const { count: t, name: r } = e, i = O(t);
+    const { count: t, name: r } = e, i = V(t);
     return o`<calcite-list-item class="list-item" .disabled=${!t} .label=${r} @calciteListItemSelect=${() => this._selectCategory(e)}><calcite-chip .label=${i} scale=s slot=content-end>${i}</calcite-chip>${this._renderChevronIconNode()}</calcite-list-item>`;
   }
   _renderRelatedFeature(e) {
@@ -349,7 +362,7 @@ class te extends k {
       ...r,
       ...i?.global
     }, l = (t && n?.[t]) ?? "";
-    return o`<calcite-list-item class=${x(V("list-item", { "list-item-hidden": s === "loading" }))} .description=${E(l.toString())} .label=${E(a)} @calciteListItemSelect=${() => this._selectRecord(e)}><div slot=heading><div .innerHTML=${N.sanitize(a ?? "") ?? ""}></div></div><div slot=description><div .innerHTML=${N.sanitize(l ?? "") ?? ""}></div></div>${this._renderChevronIconNode()}</calcite-list-item>`;
+    return o`<calcite-list-item class=${D(Q("list-item", { "list-item-hidden": s === "loading" }))} .description=${N(l.toString())} .label=${N(a)} @calciteListItemSelect=${() => this._selectRecord(e)}><div slot=heading><div .innerHTML=${O.sanitize(a ?? "") ?? ""}></div></div><div slot=description><div .innerHTML=${O.sanitize(l ?? "") ?? ""}></div></div>${this._renderChevronIconNode()}</calcite-list-item>`;
   }
   _renderShowAllListItem() {
     return this.displayShowAllButton ? o`<calcite-list-item .description=${this.allItemsDescription} .label=${this.messages?.showAll} @calciteListItemSelect=${() => this._showAllRecords()}>${this._renderShowAllIconNode()}</calcite-list-item>` : null;
@@ -358,7 +371,7 @@ class te extends k {
     return o`<calcite-notice icon=information kind=brand open scale=s width=full><div slot=message>${this.messages?.noRelatedFeatures}</div></calcite-notice>`;
   }
   _renderFeatureObserver() {
-    return o`<div class="feature-observer" ${U(this._relatedFeatureIntersectionObserverNode)}></div>`;
+    return o`<div class="feature-observer" ${X(this._relatedFeatureIntersectionObserverNode)}></div>`;
   }
   _renderList() {
     const { relatedFeatureViewModels: e, categories: t } = this;
@@ -366,7 +379,7 @@ class te extends k {
   }
   _renderRelatedFeatures() {
     const { displayListItems: e } = this, { state: t } = this;
-    return o`<div class=${x(V("list", {
+    return o`<div class=${D(Q("list", {
       "list-querying": t === "querying"
     }))}>${e ? this._renderList() : t === "ready" ? this._renderNoRelatedFeaturesMessage() : null}${this._renderStickyLoading()}${this._renderFeatureObserver()}</div>`;
   }
@@ -374,7 +387,7 @@ class te extends k {
     return o`<calcite-notice icon=exclamation-mark-triangle kind=danger open scale=s width=full><div slot=message>${this.messages?.relationshipNotFound}</div></calcite-notice>`;
   }
 }
-B("arcgis-feature-relationship", te);
+H("arcgis-feature-relationship", se);
 export {
-  te as ArcgisFeatureRelationship
+  se as ArcgisFeatureRelationship
 };

package/dist/components/arcgis-feature-table/customElement.d.ts

@@ -1,10 +1,10 @@
 /// <reference path="../../index.d.ts" />
 import type FeatureTable from "@arcgis/core/widgets/FeatureTable.js";
-import type RelationshipColumn from "@arcgis/core/widgets/FeatureTable/RelationshipColumn.js";
-import type GroupColumn from "@arcgis/core/widgets/FeatureTable/Grid/GroupColumn.js";
-import type Column from "@arcgis/core/widgets/FeatureTable/Grid/Column.js";
-import type AttachmentsColumn from "@arcgis/core/widgets/FeatureTable/AttachmentsColumn.js";
 import type ActionColumn from "@arcgis/core/widgets/FeatureTable/ActionColumn.js";
+import type AttachmentsColumn from "@arcgis/core/widgets/FeatureTable/AttachmentsColumn.js";
+import type Column from "@arcgis/core/widgets/FeatureTable/Grid/Column.js";
+import type GroupColumn from "@arcgis/core/widgets/FeatureTable/Grid/GroupColumn.js";
+import type RelationshipColumn from "@arcgis/core/widgets/FeatureTable/RelationshipColumn.js";
 import type LinkChartView from "@arcgis/core/views/LinkChartView.js";
 import type AttributeTableTemplate from "@arcgis/core/tables/AttributeTableTemplate.js";
 import type Collection from "@arcgis/core/core/Collection.js";
@@ -15,11 +15,11 @@ import type Relationship from "@arcgis/core/layers/support/Relationship.js";
 import type SelectionManager from "@arcgis/core/views/SelectionManager.js";
 import type TableTemplate from "@arcgis/core/widgets/FeatureTable/support/TableTemplate.js";
 import type TimeExtent from "@arcgis/core/time/TimeExtent.js";
+import type { CollectionChangeEvent } from "@arcgis/core/core/Collection.js";
+import type { DiscardPendingEditsParameters, FeatureStoreEdits, TableInteractionCellClickEvent, TableInteractionCellDblclickEvent, TableInteractionCellKeydownEvent, TableInteractionCellPointeroutEvent, TableInteractionCellPointeroverEvent, TableInteractionColumnReorderEvent, TableMenuConfig, GridMultiSortPriority, FeatureTableState } from "@arcgis/core/widgets/FeatureTable/Grid/types.js";
+import type { FeatureStoreItem, ActionColumnConfig, FeatureTableSupportedFilters, ColumnSortOrder, FeatureTableSupportedLayer } from "@arcgis/core/widgets/FeatureTable/support/types.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisReferenceElement, IconName } from "../types.js";
-import type { FeatureStoreItem, ActionColumnConfig, FeatureTableSupportedFilters, ColumnSortOrder, FeatureTableSupportedLayer } from "@arcgis/core/widgets/FeatureTable/support/types.js";
-import type { CollectionChangeEvent } from "@arcgis/core/core/Collection.js";
-import type { DiscardPendingEditsParameters, FeatureStoreEdits, TableInteractionColumnReorderEvent, TableInteractionCellPointeroverEvent, TableInteractionCellPointeroutEvent, TableInteractionCellKeydownEvent, TableInteractionCellClickEvent, TableInteractionCellDblclickEvent, TableMenuConfig, GridMultiSortPriority, FeatureTableState } from "@arcgis/core/widgets/FeatureTable/Grid/types.js";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
 import type { FeatureTableDescriptionFunction, FeatureTableTitleFunction } from "@arcgis/core/widgets/FeatureTable.js";
 import type { GeometryUnion } from "@arcgis/core/geometry/types.js";
@@ -117,7 +117,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   accessor attachmentsEnabled: boolean;
   /**
-   * This read-only property provides the the configuration options for the attachments view.
+   * This read-only property provides the configuration options for the attachments view.
    *
    * @since 4.33
    */
@@ -141,6 +141,15 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-feature-table auto-destroy-disabled></arcgis-feature-table>
+   * ```
+   *
+   * ```js
+   * featureTableElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -156,6 +165,12 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * @since 5.0
    */
   accessor autoSaveDisabled: boolean;
+  /**
+   * Indicates the number of pages currently cached in the store.
+   *
+   * @internal
+   */
+  get cachedPageCount(): number;
   /**
    * Indicates whether the table supports adding a related record based on the current relationship
    * configuration. This accounts for whether table is currently configured to show related features.
@@ -212,7 +227,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   accessor description: string | FeatureTableDescriptionFunction | null | undefined;
   /**
-   * When true, the component is visually withdrawn and cannot receive user interaction.
+   * When true, the component is visually de-emphasized and does not accept user interaction.
    *
    * @default false
    * @since 5.0
@@ -316,7 +331,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   get hasPendingEdits(): boolean;
   /**
-   * TODO
+   * A list of field names to hide in the table.
    *
    * @since 4.16
    * @see [TableTemplate](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/support/TableTemplate/)
@@ -329,7 +344,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    *   container: document.getElementById("tableDiv")
    * });
    * @example
-   * // Set this syntax if needing to display a default hidden field, e.g. 'CreationDate`
+   * // Set this syntax if needing to display a default hidden field, e.g. `date_created`
    * const featureTable = new FeatureTable({
    *   layer: featureLayer,
    *   view: view,
@@ -726,7 +741,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * @default "m"
    * @since 4.33
    */
-  accessor navigationScale: "s" | "m" | "l";
+  accessor navigationScale: "l" | "m" | "s";
   /**
    * This property can be used to override the text displayed when the table is fully loaded but no rows are available.
    *
@@ -754,7 +769,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   get pageCount(): number;
   /**
-   * Represents the index of the page of the feature currently being displayed. The number of features per page can be adjusted by modifying the [pageSize](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#pageSize). [Pagination](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#paginationEnabled) must be enabled or the value of this property may not be not reliable due to virtualization of visible pages.
+   * Represents the index of the page of the feature currently being displayed. The number of features per page can be adjusted by modifying the [pageSize](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#pageSize). [Pagination](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#paginationEnabled) must be enabled or the value of this property may not be reliable due to virtualization of visible pages.
    *
    * @since 4.31
    */
@@ -887,7 +902,6 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * This is useful when applications want to share selection sets between components, without relying on the view's selection manager. This property is ignored if [syncViewSelection](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#syncViewSelection) is `true`.
    *
    * @since 5.0
-   * @beta
    */
   accessor selectionManager: SelectionManager | null | undefined;
   /**
@@ -974,7 +988,6 @@ export abstract class ArcgisFeatureTable extends LitElement {
    *
    * @default false
    * @since 5.0
-   * @beta
    */
   accessor syncViewSelection: boolean;
   /**
@@ -988,6 +1001,14 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * @default false
    */
   accessor tableDisabled: boolean;
+  /**
+   * The table ID of a layer in the service.
+   * Use with `layer-item-id` when the service contains multiple layers and tables, and you want to specify which table to use.
+   *
+   * @since 5.2
+   * @internal
+   */
+  accessor tableId: number | undefined;
   /**
    * Reference to a table instance that this table is directly related to.
    *
@@ -1067,17 +1088,27 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * >
    * > The following considerations apply when working with date, time, and big integer field types:
    * >
-   * > By default, the [FeatureTable](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/) displays timezones for `date` and `timestamp-offset` field [types](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) reflecting the MapView's timezone. This timezone can be overridden by setting the table's [timeZone](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#timeZone) property.
+   * > By default, the [FeatureTable](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/) displays time zones for `date` and `timestamp-offset` field [types](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) using the associated view's time zone. This time zone can be overridden by setting the table's [timeZone](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#timeZone) property.
    * > If the table's [view](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#view) isn't set, and the table's [Feature#timeZone](https://developers.arcgis.com/javascript/latest/references/core/widgets/Feature/#timeZone) isn't set, the table defaults to `system` time. The only time that this is not the case is when there is a [FeatureLayer#preferredTimeZone](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#preferredTimeZone) set on the table's layer. If the latter is true, the preferred time zone is used as opposed to `system`.
    *
    * @since 4.28
    */
   accessor timeZone: string | null | undefined;
   /**
-   * The view associated with the component. 
-   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-feature-table component will be associated with a map or scene component rather than using the `view` property.
+   * The view associated with the component.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-feature-table component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: LinkChartView | MapViewOrSceneView | null | undefined;
+  /**
+   * Controls time extent filtering behavior for the table. When `true`, the table's time extent will be derived from the intersection of the
+   * view and layer's time extent. When `false`, only the layer's time extent will be considered.
+   *
+   * When [timeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#timeExtent) is defined, only that time extent will be used and this property will be ignored.
+   *
+   * @default false
+   * @since 5.2
+   */
+  accessor viewTimeEnabled: boolean;
   /**
    * A flattened array of all top-level visible columns. Take note that this does not include nested columns.
    *
@@ -1137,6 +1168,14 @@ export abstract class ArcgisFeatureTable extends LitElement {
   exportSelectionToCSV(includeGeometry?: boolean): Promise<void>;
   /** @param fieldName */
   findColumn(fieldName: string): Promise<ActionColumn | AttachmentsColumn | Column | GroupColumn | RelationshipColumn | null | undefined>;
+  /**
+   * Returns cached features for a specific page index.
+   *
+   * @param pageIndex - The index of the page for which to retrieve cached features.
+   * @returns An array of FeatureStoreItem objects representing the cached features for the specified page, or undefined if no cached features are found for that page.
+   * @internal
+   */
+  getCachedFeaturesByPageIndex(pageIndex: number): Promise<FeatureStoreItem[] | undefined>;
   /**
    * Returns information about the feature with the provided object ID from the internal store.
    *
@@ -1198,7 +1237,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
   readonly arcgisColumnReorder: import("@arcgis/lumina").TargetedEvent<this, TableInteractionColumnReorderEvent>;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "effectiveSize" | "isQueryingOrSyncing" | "layerView" | "size" | "state"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Fires when a row selection is added or removed. */
   readonly arcgisSelectionChange: import("@arcgis/lumina").TargetedEvent<this, CollectionChangeEvent<number | string>>;