@esri/hub-web-components 0.17.0 → 0.19.0

package/dist/components/arcgis-layout-column/customElement.js

@@ -9,8 +9,8 @@ import { Logger as a } from "@esri/hub-common";
 import { spreadProps as N } from "@open-wc/lit-helpers";
 import { i as w } from "../../chunks/isNodeVisible.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 class C extends p {
   constructor() {
     super(...arguments), this.debug = !1, this.isEditMode = !1, this.arcgisLayoutNodeHighlight = n(), this.arcgisLayoutNodeUnHighlight = n();
@@ -59,7 +59,6 @@ class C extends p {
         try {
           return h({ tagName: t.tag, classes: this._getChildClasses(t).join(" "), styles: t.styles, options: {
             isEditMode: this.isEditMode,
-            // onKeyDown: this.isEditMode ? this._handleNodeKeyDown : undefined,
             onMouseLeave: this.isEditMode ? this._handleMouseLeaveNode : void 0,
             onMouseEnter: this.isEditMode ? this._handleMouseEnterNode : void 0
           }, props: {

package/dist/components/arcgis-layout-container/customElement.d.ts

@@ -1,11 +1,17 @@
 /// <reference types="../../index.d.ts" />
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { HTMLConfigurableLayoutNodeElement, ILayoutNode, IProcessLayoutOptions, Layout, ILayout, ILayoutPublishEventDetail } from '@esri/hub-common';
-import { ILayoutNodeRepositionEventDetail } from '../arcgis-layout-node-controls/customElement.js';
 import { getLayoutNodeConfig } from '../layouts/utils/getLayoutNodeConfig';
 import { ArcgisLayoutNodeEditor } from '../arcgis-layout-node-editor/customElement.js';
 import { ILayoutNodeAddEventDetail } from '../arcgis-layout-node-highlight/customElement.js';
+import { ILayoutNodeRepositionEventDetail } from '@esri/hub-common/dist/types/layouts/layout-event-types';
 
+/**
+ * @internal
+ * Main container component for rendering and managing
+ * an ILayout and its nodes. Orchestrates layout
+ * composition, editing, and interaction logic.
+ */
 export declare class ArcgisLayoutContainer extends LitElement {
     /** The layout to render */
     layout: Layout;
@@ -18,15 +24,18 @@ export declare class ArcgisLayoutContainer extends LitElement {
      */
     isEditMode: boolean;
     /**
-     * Whether the layout is currently being
-     * published.
+     * Whether the layout is currently being published.
+     * We use this to disable and show a loading state
+     * on the "Publish" button in the edit toolbar.
      *
      * @default false
      */
     isPublishing: boolean;
     /** Options for processing the layout */
     options: IProcessLayoutOptions;
+    /** Event emitted when the layout is edited */
     readonly arcgisHubLayoutChanged: TargetedEvent<this, void>;
+    /** Event emitted when the layout editor is exited */
     readonly arcgisHubLayoutEditorExit: TargetedEvent<this, void>;
     /** Event emitted when the layout is published */
     readonly arcgisHubLayoutPublished: TargetedEvent<this, ILayoutPublishEventDetail>;

package/dist/components/arcgis-layout-container/customElement.js

@@ -1,34 +1,34 @@
 import { c as A } from "../../chunks/runtime.js";
 import { html as _ } from "lit-html";
 import { keyed as $ } from "lit-html/directives/keyed.js";
-import { LitElement as k, useContextProvider as T, createEvent as N, noShadowRoot as M } from "@arcgis/lumina";
+import { LitElement as k, useContextProvider as R, createEvent as E, noShadowRoot as T } from "@arcgis/lumina";
 import { createRef as L, ref as b } from "lit/directives/ref.js";
-import { l as I, g as R, i as H } from "../../chunks/interpolate-translations.js";
+import { l as M, g as I, i as H } from "../../chunks/interpolate-translations.js";
 import { css as D } from "@lit/reactive-element/css-tag.js";
 import { layoutNodeTags as x, cloneObject as f, setProp as O, getProp as S, deepMerge as V, Logger as y, createId as U, getWithDefault as j } from "@esri/hub-common";
 import { g as B } from "../../chunks/state.js";
 import { f as m, p as z } from "../../chunks/processLayout.js";
-import { c as F, b as w, i as E, a as C } from "../../chunks/typeGuards.js";
+import { c as F, b as w, i as N, a as C } from "../../chunks/typeGuards.js";
 import { u as G } from "../../chunks/useT9n.js";
 import { migrateSchema as q } from "@esri/hub-components";
 import { f as X } from "../../chunks/findColumnAndNodeIndex.js";
 import { dictionary as Y } from "@esri/telemetry-dictionary-hub";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 const W = D`@layer{arcgis-layout-container{display:block;--offsetTop: 0px;calcite-shell{position:static;font-size:inherit}#arcgis-layout-container-edit-mode-live-region{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}}arcgis-layout-container[is-edit-mode]{height:calc(100vh - var(--offsetTop));arcgis-layout{margin-block-start:15px}calcite-panel>*{margin:1rem}calcite-panel>calcite-action.panel-close{margin:0}}}`;
 function J(t, i) {
   const s = ["order", "offset", "width"], e = [];
   return s.forEach((n) => {
     let o;
-    w(t) && (o = t.sectionProps?.[n]), E(t) && (o = t.rowProps?.[n]), C(t) && (o = t.columnProps?.[n]), typeof o == "number" ? (o < 0 || o > 12) && e.push(`Node "${t.id}": ${i} > ${n} out of range (0-12): ${o}`) : typeof o == "object" && Object.entries(o).forEach(([a, r]) => {
+    w(t) && (o = t.sectionProps?.[n]), N(t) && (o = t.rowProps?.[n]), C(t) && (o = t.columnProps?.[n]), typeof o == "number" ? (o < 0 || o > 12) && e.push(`Node "${t.id}": ${i} > ${n} out of range (0-12): ${o}`) : typeof o == "object" && Object.entries(o).forEach(([a, r]) => {
       typeof r == "number" && (r < 0 || r > 12) && e.push(`Node "${t.id}": ${i} > ${n}.${a} out of range (0-12): ${r}`);
     });
   }), e;
 }
 function K(t, i, s, e) {
   const n = [];
-  return t.id || n.push(`${i} > missing required id.`), t.tag || n.push(`${i} > missing required tag.`), t.id && (s.has(t.id) && n.push(`Node "${t.id}": ${i} > duplicate id: "${t.id}"`), s.add(t.id)), e.includes(t.tag) || n.push(`Node "${t.id}": ${i} > has invalid tag: ${t.tag}`), n.push(...J(t, i)), (w(t) || E(t) || C(t)) && (!t.children || !Array.isArray(t.children) || t.children.length === 0) && n.push(`Node "${t.id}": ${i} > missing or empty children array.`), n;
+  return t.id || n.push(`${i} > missing required id.`), t.tag || n.push(`${i} > missing required tag.`), t.id && (s.has(t.id) && n.push(`Node "${t.id}": ${i} > duplicate id: "${t.id}"`), s.add(t.id)), e.includes(t.tag) || n.push(`Node "${t.id}": ${i} > has invalid tag: ${t.tag}`), n.push(...J(t, i)), (w(t) || N(t) || C(t)) && (!t.children || !Array.isArray(t.children) || t.children.length === 0) && n.push(`Node "${t.id}": ${i} > missing or empty children array.`), n;
 }
 function v({ node: t, nodePath: i, idSet: s, validTags: e, errors: n }) {
   if (t.tag === "arcgis-nav-card") {
@@ -46,7 +46,7 @@ function v({ node: t, nodePath: i, idSet: s, validTags: e, errors: n }) {
   }
   n.push(...K(t, i, s, e)), Array.isArray(t.children) && t.children.forEach((o, a) => {
     let r = `${i}.Child[${a}]`, c = Array.from(x);
-    w(t) ? (c = ["arcgis-layout-row"], r = `${i}.Row[${a}]`) : E(t) ? (c = ["arcgis-layout-column"], r = `${i}.Column[${a}]`) : C(t) && (c = Array.from(x).filter(
+    w(t) ? (c = ["arcgis-layout-row"], r = `${i}.Row[${a}]`) : N(t) ? (c = ["arcgis-layout-column"], r = `${i}.Column[${a}]`) : C(t) && (c = Array.from(x).filter(
       (u) => u !== "arcgis-layout-column" && u !== "arcgis-layout-section"
     )), v({
       node: o,
@@ -157,7 +157,7 @@ function ri(t, i) {
                     if (h && e({ sections: h }))
                       return !0;
                   }
-                  if (g.children && E(g) && e({ sections: [{ children: [g] }] }))
+                  if (g.children && N(g) && e({ sections: [{ children: [g] }] }))
                     return !0;
                 }
             }
@@ -208,7 +208,7 @@ function hi(t, i) {
                     if (h && e({ sections: h }))
                       return !0;
                   }
-                  if (g.children && E(g) && e({ sections: [{ children: [g] }] }))
+                  if (g.children && N(g) && e({ sections: [{ children: [g] }] }))
                     return !0;
                 }
             }
@@ -236,10 +236,7 @@ function li(t, i) {
 }
 class di extends k {
   constructor() {
-    super(), this._messages = G({ blocking: !0 }), this.#t = T({ context: I }), this.#i = !1, this._isNodeDirty = !1, this._layoutRef = L(), this._nodeControlsEl = L(), this._initShell = () => {
-      const i = this.el;
-      i.style.setProperty("--offsetTop", `${i.offsetTop}px`);
-    }, this._layoutNodeEditor = L(), this._handleExitEditMode = async (i) => {
+    super(), this._messages = G({ blocking: !0 }), this.#t = R({ context: M }), this.#i = !1, this._isNodeDirty = !1, this._layoutRef = L(), this._nodeControlsRef = L(), this._layoutNodeEditorRef = L(), this._handleExitEditMode = async (i) => {
       i.stopPropagation(), this.arcgisHubLayoutEditorExit.emit();
     }, this._handlePublishLayout = async (i) => {
       i.stopPropagation(), this.arcgisHubLayoutPublished.emit({
@@ -258,7 +255,7 @@ class di extends k {
         ...Y.category.interaction.action.close.label.sidePanel,
         details: this._layoutNodeEditorConfig?.layoutNodeConfig?.name || "unknown"
       });
-    }, this._liveAnnouncement = void 0, this._layoutErrors = [], this._historyStack = [], this._historyIdx = -1, this._isLayoutDirty = !1, this._isLayoutValid = !0, this._isEditPanelOpen = !1, this.debug = !1, this.isEditMode = !1, this.isPublishing = !1, this.options = {}, this.arcgisHubLayoutChanged = N(), this.arcgisHubLayoutEditorExit = N(), this.arcgisHubLayoutPublished = N(), this.hubTelemetry = N(), this.listen("arcgisLayoutNodeChange", async (i) => {
+    }, this._liveAnnouncement = void 0, this._layoutErrors = [], this._historyStack = [], this._historyIdx = -1, this._isLayoutDirty = !1, this._isLayoutValid = !0, this._isEditPanelOpen = !1, this.debug = !1, this.isEditMode = !1, this.isPublishing = !1, this.options = {}, this.arcgisHubLayoutChanged = E(), this.arcgisHubLayoutEditorExit = E(), this.arcgisHubLayoutPublished = E(), this.hubTelemetry = E(), this.listen("arcgisLayoutNodeChange", async (i) => {
       await this._handleLayoutNodeEditorChange(i);
     }), this.listen("arcgisLayoutNodeVisibilityChange", async (i) => {
       await this._handleLayoutNodeVisibilityChange(i);
@@ -272,7 +269,7 @@ class di extends k {
     this.properties = { _liveAnnouncement: 16, _processedLayout: 16, _layoutErrors: 16, _highlightedNode: 16, _highlightedElement: 16, _layoutNodeEditorConfig: 16, _historyStack: 16, _historyIdx: 16, _isLayoutDirty: 16, _isLayoutValid: 16, _isEditPanelOpen: 16, layout: 0, debug: 7, isEditMode: 7, isPublishing: 5, options: 0 };
   }
   static {
-    this.shadowRootOptions = M;
+    this.shadowRootOptions = T;
   }
   static {
     this.styles = W;
@@ -290,6 +287,14 @@ class di extends k {
       e.lazy = !1;
     })), (!this.hasUpdated || i.has("_processedLayout")) && this.#t.setValue({ messages: this._messages, layout: this._processedLayout });
   }
+  _initShell() {
+    const i = this.el;
+    i.style.setProperty("--offsetTop", `${i.offsetTop}px`);
+  }
+  async _init() {
+    const i = await ei(this.layout);
+    this._layout = f(i), this._processedLayout = await this._validateAndProcess(this._layout, this.options), this._historyStack = [this._processedLayout], this._historyIdx = 0;
+  }
   async getUpdateComplete() {
     const i = await super.getUpdateComplete();
     return await this._layoutRef.value?.updateComplete, await new Promise((s) => setTimeout(s, 150)), i;
@@ -305,10 +310,6 @@ class di extends k {
     const i = this.isEditMode ? this._messages.editModeActivatedLiveRegion : this._messages.editModeDeactivatedLiveRegion;
     await this.updateComplete, this._liveAnnouncement = i;
   }
-  async _init() {
-    const i = await ei(this.layout);
-    this._layout = f(i), this._processedLayout = await this._validateAndProcess(this._layout, this.options), this._historyStack = [this._processedLayout], this._historyIdx = 0;
-  }
   async _updateLayoutNode(i, s, e, n, o) {
     const a = f(this._layout), r = m(a, i);
     r && (O(s, e, r), this._layout = a, this._processedLayout = await this._validateAndProcess(a, this.options), this._highlightedNode = m(this._processedLayout, i), this._historyIdx < this._historyStack.length - 1 && (this._historyStack = this._historyStack.slice(0, this._historyIdx + 1)), this._historyStack.push(this._processedLayout), this._historyIdx = this._historyStack.length - 1, this._isLayoutValid = n, this._isNodeDirty = !0, this._isLayoutDirty = !0, o && o());
@@ -351,8 +352,7 @@ class di extends k {
     }
   }
   _handleNodeUnHighlight(i) {
-    i.stopPropagation(), !this.#i && (y.debug("NODE UNHIGHLIGHT EVENT >>>", i), !this._nodeControlsEl.value?.matches(":hover") && // this._highlightedElement === referenceElement &&
-    !this.hitTest(i.detail) && (this._highlightedNode = void 0, this._highlightedElement = void 0));
+    i.stopPropagation(), !this.#i && (y.debug("NODE UNHIGHLIGHT EVENT >>>", i), !this._nodeControlsRef.value?.matches(":hover") && !this.hitTest(i.detail) && (this._highlightedNode = void 0, this._highlightedElement = void 0));
   }
   _handleNodeControlsMouseOut(i) {
     this.#i || this.hitTest(i) || (this._highlightedNode = void 0, this._highlightedElement = void 0);
@@ -361,7 +361,7 @@ class di extends k {
     if (!this._highlightedElement || !this._highlightedNode)
       return;
     this._isEditPanelOpen = !0;
-    let s = R(this._highlightedElement, this._highlightedNode);
+    let s = I(this._highlightedElement, this._highlightedNode);
     s && (s = H(this._messages, s)), this._layoutNodeEditorConfig = {
       layoutNodeConfig: f(s),
       layoutNode: f(this._highlightedNode)
@@ -389,13 +389,13 @@ class di extends k {
   }
   renderNodeControls() {
     let i;
-    return this.isEditMode && this._highlightedElement && this._highlightedNode && (i = _`<arcgis-layout-node-controls .layoutNodeEditorRef=${this._layoutNodeEditor.value} .isEditMode=${this.isEditMode} .isLayoutValid=${this._isLayoutValid} .layout=${this._processedLayout} .messages=${this._messages} .node=${this._highlightedNode} @mouseout=${this._handleNodeControlsMouseOut} .referenceElement=${this._highlightedElement} style="position: absolute;" ${b(this._nodeControlsEl)}></arcgis-layout-node-controls>`), i;
+    return this.isEditMode && this._highlightedElement && this._highlightedNode && (i = _`<arcgis-layout-node-controls .layoutNodeEditorRef=${this._layoutNodeEditorRef.value} .isEditMode=${this.isEditMode} .isLayoutValid=${this._isLayoutValid} .layout=${this._processedLayout} .messages=${this._messages} .node=${this._highlightedNode} @mouseout=${this._handleNodeControlsMouseOut} .referenceElement=${this._highlightedElement} style="position: absolute;" ${b(this._nodeControlsRef)}></arcgis-layout-node-controls>`), i;
   }
   renderEditor() {
     if (this.isEditMode && this._isEditPanelOpen) {
       const i = this._layoutNodeEditorConfig;
       if (i?.layoutNodeConfig?.editor)
-        return _`<calcite-shell-panel position=end slot=panel-end><calcite-panel .heading=${j(i.layoutNodeConfig, "i18n.label", S(this._messages, "layoutNodeControls.configurableNodes.default.label"))}><calcite-action class="panel-close" icon=x @click=${this._handleCloseEditPanel} slot=header-actions-end .text=${this._messages.close}></calcite-action>${$(i.layoutNode.id, _`<arcgis-layout-node-editor .layoutNodeConfig=${i.layoutNodeConfig} .node=${i.layoutNode} ${b(this._layoutNodeEditor)}></arcgis-layout-node-editor>`)}</calcite-panel></calcite-shell-panel>`;
+        return _`<calcite-shell-panel position=end slot=panel-end><calcite-panel .heading=${j(i.layoutNodeConfig, "i18n.label", S(this._messages, "layoutNodeControls.configurableNodes.default.label"))}><calcite-action class="panel-close" icon=x @click=${this._handleCloseEditPanel} slot=header-actions-end .text=${this._messages.close}></calcite-action>${$(i.layoutNode.id, _`<arcgis-layout-node-editor .layoutNodeConfig=${i.layoutNodeConfig} .node=${i.layoutNode} ${b(this._layoutNodeEditorRef)}></arcgis-layout-node-editor>`)}</calcite-panel></calcite-shell-panel>`;
     }
     return null;
   }

package/dist/components/arcgis-layout-editor-toolbar/customElement.d.ts

@@ -3,7 +3,9 @@ import { PublicLitElement as LitElement, JsxNode, TargetedEvent } from '@arcgis/
 
 /** @private */
 export declare class ArcgisLayoutEditorToolbar extends LitElement {
+    /** Callback fired when the "Exit" button is clicked. */
     exitEditMode: ((event: MouseEvent) => Promise<void>) | undefined;
+    /** Callback fired when the "Publish" button is clicked. */
     publishLayout: ((event: MouseEvent) => Promise<void>) | undefined;
     /**
      * Whether the layout has unsaved changes.
@@ -22,7 +24,7 @@ export declare class ArcgisLayoutEditorToolbar extends LitElement {
      */
     isLayoutValid: boolean;
     /**
-     * whether the layout is currently being published
+     * Whether the layout is currently being published
      *
      * @default false
      */

package/dist/components/arcgis-layout-editor-toolbar/customElement.js

@@ -2,16 +2,16 @@ import { c as i } from "../../chunks/runtime.js";
 import { html as s } from "lit-html";
 import { LitElement as e } from "@arcgis/lumina";
 import { css as o } from "@lit/reactive-element/css-tag.js";
-import { u as l } from "../../chunks/useT9n.js";
-import { focusElement as a } from "@arcgis/toolkit/dom";
+import { u as a } from "../../chunks/useT9n.js";
+import { focusElement as l } from "@arcgis/toolkit/dom";
 import { createRef as r, ref as n } from "lit/directives/ref.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 const c = o`calcite-navigation{border-block-start:1px solid var(--calcite-navigation-border-color, var(--calcite-color-border-3));[slot=content-end]{margin-inline-end:1rem}[slot=content-end]{display:flex}[slot=content-end]{gap:.75rem}}`;
 class u extends e {
   constructor() {
-    super(...arguments), this._messages = l(), this._exitButtonEl = r(), this.isLayoutDirty = !1, this.isLayoutValid = !0, this.isPublishing = !1;
+    super(...arguments), this._messages = a(), this._exitButtonRef = r(), this.isLayoutDirty = !1, this.isLayoutValid = !0, this.isPublishing = !1;
   }
   static {
     this.properties = { exitEditMode: 0, publishLayout: 0, isLayoutDirty: 5, isLayoutValid: 5, isPublishing: 5 };
@@ -27,11 +27,11 @@ class u extends e {
     return this.isLayoutDirty || (t = this._messages.noChanges), this.isLayoutValid || (t = this._messages.invalidLayout), t;
   }
   loaded() {
-    a(this._exitButtonEl.value);
+    l(this._exitButtonRef.value);
   }
   render() {
     const t = this._messages.exit;
-    return s`<calcite-navigation><calcite-action .label=${t} @click=${this.exitEditMode} scale=l slot=content-start .text=${t} text-enabled ${n(this._exitButtonEl)}></calcite-action><div slot=content-end><arcgis-ref-tooltip .isSlottedElDisabled=${this._isPublishDisabled} .text=${this._disalbedPublishTooltip}><calcite-button .disabled=${this._isPublishDisabled} .loading=${this.isPublishing} @click=${this.publishLayout} round>${this._messages.publish}</calcite-button></arcgis-ref-tooltip></div></calcite-navigation>`;
+    return s`<calcite-navigation><calcite-action .label=${t} @click=${this.exitEditMode} scale=l slot=content-start .text=${t} text-enabled ${n(this._exitButtonRef)}></calcite-action><div slot=content-end><arcgis-ref-tooltip .isSlottedElDisabled=${this._isPublishDisabled} .text=${this._disalbedPublishTooltip}><calcite-button .disabled=${this._isPublishDisabled} .loading=${this.isPublishing} @click=${this.publishLayout} round>${this._messages.publish}</calcite-button></arcgis-ref-tooltip></div></calcite-navigation>`;
   }
 }
 i("arcgis-layout-editor-toolbar", u);

package/dist/components/arcgis-layout-node-controls/customElement.d.ts

@@ -3,10 +3,7 @@ import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/
 import { HTMLConfigurableLayoutNodeElement, ILayout, ILayoutNodeChangeEventDetail, LayoutNode } from '@esri/hub-common';
 import { ArcgisLayoutContainer } from '../arcgis-layout-container/customElement.js';
 import { ArcgisLayoutNodeEditor } from '../arcgis-layout-node-editor/customElement.js';
-export interface ILayoutNodeRepositionEventDetail {
-    node: LayoutNode;
-    direction: "down" | "up";
-}
+import { ILayoutNodeRepositionEventDetail } from '@esri/hub-common/dist/types/layouts/layout-event-types';
 
 /** @private */
 export declare class ArcgisLayoutNodeControls extends LitElement {
@@ -34,14 +31,18 @@ export declare class ArcgisLayoutNodeControls extends LitElement {
     referenceElement?: HTMLConfigurableLayoutNodeElement;
     /** The t9n strings used in the layout node controls */
     messages: ArcgisLayoutContainer["_messages"];
+    /**
+     * Reference to the layout node editor. Used
+     * to set the focus trap options of the node
+     * controls popover.
+     */
     layoutNodeEditorRef?: ArcgisLayoutNodeEditor;
     /** Event emitted for telemetry */
     readonly hubTelemetry: TargetedEvent<this, Record<string, unknown>>;
-    /** Event emitted when editor is opened */
+    /** Event emitted when node editor is opened */
     readonly arcgisLayoutNodeEditorOpen: TargetedEvent<this, void>;
     /**
-     * Emitted when the node changes (e.g. the node's
-     * visibility settings).
+     * Event emitted when the node's visibility settings change.
      *
      * Note: leveraging the ILayoutNodeChangeEventDetail
      * interface sets us up for a future where node
@@ -49,5 +50,6 @@ export declare class ArcgisLayoutNodeControls extends LitElement {
      * editor (as opposed to simple toggle).
      */
     readonly arcgisLayoutNodeVisibilityChange: TargetedEvent<this, ILayoutNodeChangeEventDetail>;
+    /** Event emitted when the node is repositioned */
     readonly arcgisLayoutNodeReposition: TargetedEvent<this, ILayoutNodeRepositionEventDetail>;
 }

package/dist/components/arcgis-layout-node-controls/customElement.js

@@ -8,8 +8,8 @@ import { i as b } from "../../chunks/isNodeVisible.js";
 import { dictionary as l } from "@esri/telemetry-dictionary-hub";
 import { f as r } from "../../chunks/findColumnAndNodeIndex.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 const N = h`:host{position:absolute}`;
 class C extends d {
   constructor() {

package/dist/components/arcgis-layout-node-editor/customElement.d.ts

@@ -14,6 +14,7 @@ export declare class ArcgisLayoutNodeEditor extends LitElement {
      * properties when changes are made in the editor.
      */
     layoutNodeConfig: ILayoutNodeConfig | undefined;
+    /** Public method to set focus to the editor. */
     setFocus(): void;
     /** Emitted when the node's editor values change. */
     readonly arcgisLayoutNodeChange: TargetedEvent<this, ILayoutNodeChangeEventDetail>;

package/dist/components/arcgis-layout-node-editor/customElement.js

@@ -6,8 +6,8 @@ import { html as a } from "lit";
 import { css as f } from "@lit/reactive-element/css-tag.js";
 import { ArcgisLayoutNodeEditorDynamicTag as C } from "./layout-node-editor-dynamic-tag/customElement.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 const p = f`@layer{arcgis-configuration-editor:focus{--focus-color: var(--calcite-color-focus, var(--calcite-ui-focus-color, var(--calcite-color-brand)));outline:solid 2px var(--focus-color)}}`;
 class m extends n {
   constructor() {

package/dist/components/arcgis-layout-node-editor/layout-node-editor-dynamic-tag/customElement.d.ts

@@ -7,9 +7,10 @@ interface ArcgisLayoutEditorProps {
 }
 /**
  * @private
+ *
  * Functional component to dynamically render an ILayout
  * editor based on the tagName provided. This allows us
- * to get around inherent limitations of Lumina:
+ * to work around inherent limitations of Lumina:
  * https://qawebgis.esri.com/components/lumina/jsx#dynamic-tag-name
  * https://qawebgis.esri.com/components/lumina/jsx#spread-attributes
  */

package/dist/components/arcgis-layout-node-editor/layout-node-editor-dynamic-tag/customElement.js

@@ -1,8 +1,8 @@
 import { html as t } from "lit-html";
 import { spreadProps as d, spreadEvents as o } from "@open-wc/lit-helpers";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 function g({ tagName: c, props: r }) {
   const n = r.onInputChangeEvent || void 0, a = {
     ...r

package/dist/components/arcgis-layout-node-highlight/customElement.js

@@ -8,8 +8,8 @@ import { m as $, i as L } from "../../chunks/memoizeAsync.js";
 import { dictionary as c } from "@esri/telemetry-dictionary-hub";
 import { g as E } from "../../chunks/state.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 const O = y`@layer{arcgis-layout-node-highlight{--button-height: 30px;--label-height: 30px;opacity:0;position:absolute;calcite-label{position:fixed;position-anchor:var(--anchor-element-name);inset-block:calc(anchor(top) - var(--label-height)) calc(anchor(top) + 2px);background-color:#fff;padding:2px 5px;border:solid 2px var(--calcite-ui-brand);border-bottom:none}calcite-button{position:fixed;position-anchor:var(--anchor-element-name);justify-self:anchor-center;inset-block-start:calc(anchor(bottom) - var(--button-height) / 2)}.popover-content{max-height:19.3rem;overflow-y:auto}calcite-list-item{--calcite-list-border-color: transparent}}.current-node+arcgis-layout-node-highlight{opacity:1}}`, s = c.category.interaction.action.select.label.layoutNode, I = [
   {
     tag: "arcgis-text-card",

package/dist/components/arcgis-layout-node-overlay/customElement.d.ts

@@ -1,11 +1,7 @@
 /// <reference types="../../index.d.ts" />
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 
-/**
- * A component for rendering overlay content on
- * layout nodes. Overlays are used to indicate
- * special states of layout nodes (e.g., hidden).
- */
+/** @private */
 export declare class ArcgisLayoutNodeOverlay extends LitElement {
     /**
      * The type of overlay to display. For now, we'll

package/dist/components/arcgis-layout-node-overlay/customElement.js

@@ -4,8 +4,8 @@ import { LitElement as s } from "@arcgis/lumina";
 import { css as r } from "@lit/reactive-element/css-tag.js";
 import { u as n } from "../../chunks/useT9n.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 const a = r`:host{display:flex;justify-content:center;align-items:center;position:fixed;position-area:center;width:anchor-size(width);height:anchor-size(height);anchor-name:--overlay;pointer-events:none;outline:1.5px dashed var(--calcite-color-border-1)}.overlay{opacity:.6;background-color:#ffffffa6;width:100%;height:100%}.overlay-content{position:fixed}`;
 class c extends s {
   constructor() {

package/dist/components/arcgis-layout-row/customElement.d.ts

@@ -4,29 +4,27 @@ import { ILayoutNode, IRow, LayoutUtils } from '@esri/hub-common';
 
 /** @private */
 export declare class ArcgisLayoutRow extends LitElement {
-    /** The row node to render */
+    /** The row node to render. */
     node: IRow;
     /**
-     * The currently focused/hovered node. This is
-     * tracked in order to show the node's configuration
-     * controls and "active" state in the UI.
+     * The currently focused/hovered node. Used to show
+     * configuration controls and active state in the UI.
      */
     highlightedNode?: ILayoutNode;
     /**
      * Utility functions passed down to all child layout
-     * components. For now, this is specifically needed to
-     * process a remote layout that is referenced by a
-     * layout node.
+     * components. Used for processing remote layouts
+     * referenced by a node.
      */
     utils?: LayoutUtils;
     /**
-     * Enables debug mode
+     * Enables debug mode.
      *
      * @default false
      */
     debug: boolean;
     /**
-     * Whether the layout is in edit mode
+     * Whether the layout is in edit mode.
      *
      * @default false
      */

package/dist/components/arcgis-layout-row/customElement.js

@@ -7,8 +7,8 @@ import { Logger as a } from "@esri/hub-common";
 import { spreadProps as p } from "@open-wc/lit-helpers";
 import { a as h } from "../../chunks/typeGuards.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 class y extends d {
   constructor() {
     super(...arguments), this.debug = !1, this.isEditMode = !1;

package/dist/components/arcgis-layout-section/customElement.d.ts

@@ -4,29 +4,27 @@ import { ILayoutNode, ISection, LayoutUtils } from '@esri/hub-common';
 
 /** @private */
 export declare class ArcgisLayoutSection extends LitElement {
-    /** The section node to render */
+    /** The section node to render. */
     node: ISection;
     /**
-     * The currently focused/hovered node. This is
-     * tracked in order to show the node's configuration
-     * controls and "active" state in the UI.
+     * The currently focused/hovered node. Used to show
+     * configuration controls and active state in the UI.
      */
     highlightedNode?: ILayoutNode;
     /**
      * Utility functions passed down to all child layout
-     * components. For now, this is specifically needed to
-     * process a remote layout that is referenced by a
-     * layout node.
+     * components. Used for processing remote layouts
+     * referenced by a node.
      */
     utils?: LayoutUtils;
     /**
-     * Enables debug mode
+     * Enables debug mode.
      *
      * @default false
      */
     debug: boolean;
     /**
-     * Whether the layout is in edit mode
+     * Whether the layout is in edit mode.
      *
      * @default false
      */

package/dist/components/arcgis-layout-section/customElement.js

@@ -7,8 +7,8 @@ import { g as m } from "../../chunks/getResponsiveClasses.js";
 import { Logger as d } from "@esri/hub-common";
 import { spreadProps as c } from "@open-wc/lit-helpers";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 class w extends u {
   constructor() {
     super(...arguments), this.debug = !1, this.isEditMode = !1;

package/dist/components/arcgis-nav-card/customElement.js

@@ -6,8 +6,8 @@ import { getProp as r } from "@esri/hub-common";
 import { i as p } from "../../chunks/isNodeVisible.js";
 import { b as f } from "../../chunks/getResponsiveClasses.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 function v(i, e, t, s) {
   {
     let a = i;

package/dist/components/arcgis-text-card/customElement.js

@@ -6,8 +6,8 @@ import { sanitizeHtml as r } from "@esri/hub-components";
 import { getProp as t } from "@esri/hub-common";
 import { u as a } from "../../chunks/useT9n.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 const n = o`:host>div>h1:first-child,:host>div>h2:first-child,:host>div>h3:first-child,:host>div>h4:first-child,:host>div>h5:first-child,:host>div>h6:first-child,:host>div>p:first-child{margin-top:0}`;
 class d extends s {
   constructor() {

package/dist/components/layouts/components/layout-node/customElement.d.ts

@@ -3,20 +3,30 @@ import { JsxNode } from '@arcgis/lumina';
 import { LayoutNodeTag } from '@esri/hub-common';
 import { ArcgisLayoutSection } from '../../../arcgis-layout-section/customElement.js';
 import { ArcgisLayoutColumn } from '../../../arcgis-layout-column/customElement.js';
-interface ArcgisLayoutNodeProps {
+/**
+ * @private
+ *
+ * Functional component to dynamically render a layout node
+ * based on the tagName provided. This allows us to work around
+ * inherent Lumina limitations:
+ * https://qawebgis.esri.com/components/lumina/jsx#dynamic-tag-name
+ * https://qawebgis.esri.com/components/lumina/jsx#spread-attributes
+ */
+export declare function ArcgisLayoutNode({ tagName, props, classes, styles, children, options, }: {
+    /** The tag name to render */
     tagName: Exclude<LayoutNodeTag, [ArcgisLayoutSection, ArcgisLayoutColumn]>;
+    /** CSS classes to apply to the rendered node. */
     classes?: string;
+    /** Inline styles to apply to the rendered node. */
     styles?: Record<string, string>;
+    /** Props to spread onto the rendered node. */
     props: Record<string, unknown>;
+    /** Children to render inside the node. */
     children?: JsxNode | JsxNode[];
-    options: Record<string, unknown>;
-}
-/**
- * Functional component to dynamically render an ILayout
- * node based on the tagName provided. This allows us
- * to get around inherent limitations of Lumina:
- * https://qawebgis.esri.com/components/lumina/jsx#dynamic-tag-name
- * https://qawebgis.esri.com/components/lumina/jsx#spread-attributes
- */
-export declare function ArcgisLayoutNode({ tagName, props, classes, styles, children, options, }: ArcgisLayoutNodeProps): JsxNode;
-export {};
+    /** Additional node options */
+    options: {
+        isEditMode?: boolean;
+        onMouseEnter?: ((event: MouseEvent) => void) | undefined;
+        onMouseLeave?: ((event: MouseEvent) => void) | undefined;
+    };
+}): JsxNode;

package/dist/components/layouts/components/layout-node/customElement.js

@@ -4,8 +4,8 @@ import { spread as $, spreadProps as g, spreadEvents as b } from "@open-wc/lit-h
 import { getProp as y } from "@esri/hub-common";
 import { i as v } from "../../../../chunks/isNodeVisible.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/0.17/esri/copyright.txt for details.
-v0.17.0 */
+See https://js.arcgis.com/0.19/esri/copyright.txt for details.
+v0.19.0 */
 function N({ tagName: k, props: u, classes: w, styles: a, children: o, options: n }) {
   const m = n.onMouseLeave, h = n.onMouseEnter, l = y(u, "node.id"), c = {
     ...u,
@@ -17,11 +17,9 @@ function N({ tagName: k, props: u, classes: w, styles: a, children: o, options:
     label: u.label
     // label must be an attribute
   }, r = {
-    // keydown: onKeyDownHandler,
     mouseleave: m,
     mouseenter: h,
     focus: h
-    // blur: onUnHighlightHandler, we do not handle blur events because we need the element to remain "highlighted" so its add button can be focused
   };
   (!v(y(u, "node")) || n.isEditMode) && (a || (a = {}), a["anchor-name"] = `--overlay-anchor-${l}`);
   let i;