@esri/hub-web-components 0.16.2 → 0.18.0

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.16/esri/copyright.txt for details.
-v0.16.2 */
+See https://js.arcgis.com/0.18/esri/copyright.txt for details.
+v0.18.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.16/esri/copyright.txt for details.
-v0.16.2 */
+See https://js.arcgis.com/0.18/esri/copyright.txt for details.
+v0.18.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.16/esri/copyright.txt for details.
-v0.16.2 */
+See https://js.arcgis.com/0.18/esri/copyright.txt for details.
+v0.18.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.16/esri/copyright.txt for details.
-v0.16.2 */
+See https://js.arcgis.com/0.18/esri/copyright.txt for details.
+v0.18.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.16/esri/copyright.txt for details.
-v0.16.2 */
+See https://js.arcgis.com/0.18/esri/copyright.txt for details.
+v0.18.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.16/esri/copyright.txt for details.
-v0.16.2 */
+See https://js.arcgis.com/0.18/esri/copyright.txt for details.
+v0.18.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.16/esri/copyright.txt for details.
-v0.16.2 */
+See https://js.arcgis.com/0.18/esri/copyright.txt for details.
+v0.18.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.16/esri/copyright.txt for details.
-v0.16.2 */
+See https://js.arcgis.com/0.18/esri/copyright.txt for details.
+v0.18.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.16/esri/copyright.txt for details.
-v0.16.2 */
+See https://js.arcgis.com/0.18/esri/copyright.txt for details.
+v0.18.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.16/esri/copyright.txt for details.
-v0.16.2 */
+See https://js.arcgis.com/0.18/esri/copyright.txt for details.
+v0.18.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.16/esri/copyright.txt for details.
-v0.16.2 */
+See https://js.arcgis.com/0.18/esri/copyright.txt for details.
+v0.18.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;

package/dist/components/layouts/utils/findColumnAndNodeIndex.d.ts

@@ -6,10 +6,14 @@ export interface ColumnNodeLocation {
     isLastInColumn: boolean;
 }
 /**
- * Recursively traverses the layout to find the IColumn containing the given LayoutNode,
- * and returns the column and the index of the node within that column.
- * @param targetNode The LayoutNode to find
- * @param layout The ILayout to search
- * @returns {ColumnNodeLocation | undefined} The column and index, or undefined if not found
+ * Recursively traverses a layout to find the column
+ * containing a given node, returning the column and
+ * the index of the node within that column. Handles
+ * nested structures, including nav-card sections and
+ * rows within columns.
+ *
+ * @param targetNode - The LayoutNode to locate within the layout structure.
+ * @param layout - The ILayout object to search.
+ * @returns {ColumnNodeLocation | undefined} The column and index if found, or undefined if not found.
  */
 export declare function findColumnAndNodeIndex(targetNode: LayoutNode, layout: ILayout): ColumnNodeLocation | undefined;

package/dist/components/layouts/utils/findNodeById.d.ts

@@ -1,8 +1,10 @@
 import { ILayout, LayoutNode } from '@esri/hub-common';
 /**
- * Recursively traverses the layout to find the LayoutNode with the given id.
- * @param layout The ILayout to search
- * @param nodeId The id of the LayoutNode to find
- * @returns {LayoutNode | undefined} The LayoutNode, or undefined if not found
+ * Recursively traverses a layout to find a node
+ * with a given id.
+ *
+ * @param layout - The ILayout object to search for the node.
+ * @param nodeId - The id of the LayoutNode to find.
+ * @returns {LayoutNode | undefined} The layout node, or undefined if not found.
  */
 export declare function findNodeById(layout: ILayout, nodeId: string): LayoutNode | undefined;

package/dist/components/layouts/utils/getAddableLayoutNodes.d.ts

@@ -9,4 +9,14 @@ export interface IAddLayoutNodeConfiguration {
     telemetry?: Record<string, unknown>;
 }
 export declare const layoutNodeConfig: IAddLayoutNodeConfiguration[];
+/**
+ * Memoized async function that returns addable layout
+ * node configurations, filtered and interpolated for
+ * the current context and options.
+ *
+ * @param _layout - The layout to process (not currently used, but reserved for future logic).
+ * @param options - Options for processing, including translations and entity context.
+ * @param context - contextual portal & auth information for permission checks and interpolation.
+ * @returns {Promise<IAddLayoutNodeConfiguration[]>} Promise resolving to the list of addable node configurations.
+ */
 export declare const getAddableLayoutNodes: (_layout: import('@esri/hub-common').ILayoutV2, options: Record<string, unknown>, context: IArcGISContext) => Promise<Promise<IAddLayoutNodeConfiguration[]>>;

package/dist/components/layouts/utils/getResponsiveClasses.d.ts

@@ -1,6 +1,44 @@
 import { ColumnWidth, ResponsiveValue, ISection, IRow, IColumn } from '@esri/hub-common';
+/**
+ * Generates responsive CSS classes based on the provided
+ * property name and its value(s).
+ *
+ * @param propName - The name of the property for which to generate classes
+ * @param value - The responsive value(s) for the property
+ * @param valueMapper - Optional function to map the value to a string
+ * @returns An array of CSS classes
+ * @example
+ * getResponsiveClasses('col', { xs: 12, md: 6 }); => ['col-12', 'col-md-6']
+ * getResponsiveClasses('align-items', true); => ['align-items']
+ * getResponsiveClasses('offset', 3); => ['offset-3']
+ * getResponsiveClasses('custom-prop', "some-value", (val) => val.toUpperCase()); => ['custom-prop-SOME-VALUE']
+ */
 export declare function getResponsiveClasses<T>(propName: string, value: ResponsiveValue<T> | undefined, valueMapper?: (val: T) => string): string[];
+/**
+ * Helper to build CSS classes for a section node.
+ *
+ * @param section - The section node
+ * @returns An array of classes to apply to the section node
+ */
 export declare function getSectionClasses(section: ISection): string[];
+/**
+ * Helper to build CSS classes for a row node.
+ *
+ * @param row - The row node
+ * @returns An array of classes to apply to the row node
+ */
 export declare function getRowClasses(row: IRow): string[];
+/**
+ * Helper to build CSS classes for column width.
+ *
+ * @param width - The column width responsive value
+ * @returns An array of classes to apply for the column width
+ */
 export declare function getColumnWidthClasses(width: ResponsiveValue<ColumnWidth> | undefined): string[];
+/**
+ * Helper to build CSS classes for a column node.
+ *
+ * @param column - The column node
+ * @returns An array of classes to apply to the column node
+ */
 export declare function getColumnClasses(column: IColumn): string[];

package/dist/components/layouts/utils/layoutContext.d.ts

@@ -1,9 +1,15 @@
 import { ArcgisLayoutContainer } from '../../arcgis-layout-container/customElement.js';
 import { ILayout } from '@esri/hub-common';
-export type LayoutContext = {
-    messages: ArcgisLayoutContainer["_messages"];
-    layout: ILayout | undefined;
-};
+/**
+ * Lumina Context for sharing layout information from
+ * the layout container to child components without
+ * needing to prop drill.
+ */
 export declare const layoutContext: {
-    __context__: LayoutContext;
+    __context__: {
+        /** localized messages from the layout container */
+        messages: ArcgisLayoutContainer["_messages"];
+        /** the processed layout */
+        layout: ILayout | undefined;
+    };
 };

package/dist/components/layouts/utils/lockLayout.d.ts

@@ -1,8 +1,9 @@
 import { ILayout } from '@esri/hub-common';
 /**
- * Utility that walks through the layout and lock all nodes
+ * Utility that walks through the layout and locks all nodes
  * by setting readOnly to true.
- * @param layout The layout to process.
- * @returns The processed layout.
+ *
+ * @param layout - The layout to lock.
+ * @returns The locked layout.
  */
 export declare function lockLayout(layout: ILayout): ILayout;

package/dist/components/layouts/utils/memoizeAsync.d.ts

@@ -1,6 +1,7 @@
 /**
  * Simple memoization for async functions.
- * @param fn The async function to memoize
+ *
+ * @param fn - The async function to memoize
  * @returns A memoized version of the async function
  */
 export declare function memoizeAsync<T extends (...args: any[]) => Promise<unknown>>(fn: T): (...args: Parameters<T>) => Promise<ReturnType<T>>;