@esri/hub-web-components 0.17.0 → 0.18.0

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>>;

package/dist/docs/api.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-01-21T23:16:30",
+  "timestamp": "2026-01-27T17:52:45",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
     "version": "4.33.24",
@@ -2086,7 +2086,7 @@
           "customElement": true,
           "name": "ArcgisHubEntityViewLayout",
           "tagName": "arcgis-hub-entity-view-layout",
-          "description": "Component that renders a Hub entity view\nusing the layout system.",
+          "description": "Component that renders a Hub entity view\nusing the layout system.\n\nIf an entity does not have a layout defined, we\nbuild a type-specific default layout from the entity's\nmetadata. The layout does not get persisted to the\nunderlying item until the user makes changes and\npublishes them.",
           "superclass": {
             "name": "LitElement",
             "package": "@arcgis/lumina"
@@ -2283,7 +2283,7 @@
           "events": [
             {
               "name": "arcgisHubEntityViewPublished",
-              "description": "Event emitted when the layout is published.\nNote: only relevant for entities that are\nrendered via a layout.",
+              "description": "Event emitted when the layout is published.",
               "type": {
                 "text": "void"
               }
@@ -2309,126 +2309,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/layouts/components/layout-node-overlay/layout-node-overlay.tsx",
-      "declarations": [
-        {
-          "kind": "class",
-          "customElement": true,
-          "name": "ArcgisLayoutNodeOverlay",
-          "tagName": "arcgis-layout-node-overlay",
-          "description": "A component for rendering overlay content on\nlayout nodes. Overlays are used to indicate\nspecial states of layout nodes (e.g., hidden).",
-          "superclass": {
-            "name": "LitElement",
-            "package": "@arcgis/lumina"
-          },
-          "pascalCaseName": "ArcgisLayoutNodeOverlay",
-          "importPath": "components/arcgis-layout-node-overlay",
-          "members": [
-            {
-              "kind": "method",
-              "name": "componentOnReady",
-              "return": {
-                "type": {
-                  "text": "Promise<void>",
-                  "references": [
-                    {
-                      "module": "lib/lib.es5.d.ts",
-                      "name": "Promise",
-                      "package": "typescript",
-                      "start": 0,
-                      "end": 7
-                    }
-                  ]
-                }
-              },
-              "description": "Create a promise that resolves once component is fully loaded.",
-              "signature": "(): Promise<void>",
-              "async": true,
-              "inheritedFrom": {
-                "name": "LitElement",
-                "package": "@arcgis/lumina"
-              },
-              "docsTags": [
-                {
-                  "name": "example",
-                  "text": "```js\nconst arcgisLayoutNodeOverlay = document.querySelector(\"arcgis-layout-node-overlay\");\ndocument.body.append(arcgisLayoutNodeOverlay);\nawait arcgisLayoutNodeOverlay.componentOnReady();\nconsole.log(\"arcgis-layout-node-overlay is ready to go!\");\n```"
-                }
-              ]
-            },
-            {
-              "kind": "field",
-              "name": "nodeId",
-              "description": "The ID of the layout node this overlay\nis anchored to.",
-              "type": {
-                "text": "string",
-                "values": [
-                  {
-                    "type": "string"
-                  }
-                ]
-              },
-              "attribute": "node-id"
-            },
-            {
-              "kind": "field",
-              "name": "type",
-              "description": "The type of overlay to display. For now, we'll\nsupport a predefined set of overlay types\n(rather than allowing content to be slotted\nin) to keep the UI consistent, and to\nsimplify implementation.\n\nAdd additional types as needed.",
-              "type": {
-                "text": "\"hidden\"",
-                "values": [
-                  {
-                    "value": "hidden",
-                    "type": "string"
-                  }
-                ]
-              },
-              "attribute": "type"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "node-id",
-              "description": "The ID of the layout node this overlay\nis anchored to.",
-              "type": {
-                "text": "string",
-                "values": [
-                  {
-                    "type": "string"
-                  }
-                ]
-              },
-              "fieldName": "nodeId"
-            },
-            {
-              "name": "type",
-              "description": "The type of overlay to display. For now, we'll\nsupport a predefined set of overlay types\n(rather than allowing content to be slotted\nin) to keep the UI consistent, and to\nsimplify implementation.\n\nAdd additional types as needed.",
-              "type": {
-                "text": "\"hidden\"",
-                "values": [
-                  {
-                    "value": "hidden",
-                    "type": "string"
-                  }
-                ]
-              },
-              "fieldName": "type"
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "custom-element-definition",
-          "name": "arcgis-layout-node-overlay",
-          "declaration": {
-            "name": "ArcgisLayoutNodeOverlay",
-            "module": "src/components/layouts/components/layout-node-overlay/layout-node-overlay.tsx"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/components/layouts/layout/layout.tsx",
@@ -2438,7 +2318,7 @@
           "customElement": true,
           "name": "ArcgisLayout",
           "tagName": "arcgis-layout",
-          "description": "A web component for rendering an ILayout",
+          "description": "Web component for rendering an ILayout. Orchestrates\nthe rendering of sections, rows, columns, and cards\nas defined by the layout JSON.",
           "superclass": {
             "name": "LitElement",
             "package": "@arcgis/lumina"
@@ -2480,7 +2360,7 @@
             {
               "kind": "field",
               "name": "debug",
-              "description": "Enables debug mode",
+              "description": "Enables debug mode.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2496,6 +2376,7 @@
             {
               "kind": "method",
               "name": "getCardEl",
+              "description": "Public method that returns the DOM element for a\nlayout node by id. Used for highlighting or\nscrolling to a node in the layout.",
               "parameters": [
                 {
                   "name": "nodeId",
@@ -2538,13 +2419,23 @@
                   ]
                 }
               },
+              "docsTags": [
+                {
+                  "name": "param",
+                  "text": "nodeId - The id of the node"
+                },
+                {
+                  "name": "returns",
+                  "text": "The HTML element for the node, if found"
+                }
+              ],
               "signature": "(nodeId: string): Promise<HTMLConfigurableLayoutNodeElement | undefined>",
               "async": true
             },
             {
               "kind": "field",
               "name": "highlightedNode",
-              "description": "The currently focused/hovered node. This is\ntracked in order to show the node's configuration\ncontrols and \"active\" state in the UI.",
+              "description": "The currently focused/hovered node. Used to show\nconfiguration controls and active state in the UI.",
               "type": {
                 "text": "ILayoutNode",
                 "references": [
@@ -2561,7 +2452,7 @@
             {
               "kind": "field",
               "name": "isEditMode",
-              "description": "Whether the layout is in edit mode",
+              "description": "Whether the layout is in edit mode.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2577,7 +2468,7 @@
             {
               "kind": "field",
               "name": "layout",
-              "description": "The layout to render",
+              "description": "The layout to render.",
               "type": {
                 "text": "ILayoutV2",
                 "references": [
@@ -2594,7 +2485,7 @@
             {
               "kind": "field",
               "name": "options",
-              "description": "Options for processing the layout",
+              "description": "Options for processing the layout.",
               "type": {
                 "text": "IProcessLayoutOptions",
                 "references": [
@@ -2612,7 +2503,7 @@
           "attributes": [
             {
               "name": "debug",
-              "description": "Enables debug mode",
+              "description": "Enables debug mode.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2626,7 +2517,7 @@
             },
             {
               "name": "is-edit-mode",
-              "description": "Whether the layout is in edit mode",
+              "description": "Whether the layout is in edit mode.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2642,6 +2533,7 @@
           "events": [
             {
               "name": "arcgisHubLayoutRendered",
+              "description": "Event emitted when the layout has finished\nrendering.",
               "type": {
                 "text": "void"
               }
@@ -2669,6 +2561,12 @@
           "customElement": true,
           "name": "ArcgisLayoutContainer",
           "tagName": "arcgis-layout-container",
+          "docsTags": [
+            {
+              "name": "internal",
+              "text": "Main container component for rendering and managing\nan ILayout and its nodes. Orchestrates layout\ncomposition, editing, and interaction logic."
+            }
+          ],
           "superclass": {
             "name": "LitElement",
             "package": "@arcgis/lumina"
@@ -2742,7 +2640,7 @@
             {
               "kind": "field",
               "name": "isPublishing",
-              "description": "Whether the layout is currently being\npublished.",
+              "description": "Whether the layout is currently being published.\nWe use this to disable and show a loading state\non the \"Publish\" button in the edit toolbar.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2834,7 +2732,7 @@
             },
             {
               "name": "is-publishing",
-              "description": "Whether the layout is currently being\npublished.",
+              "description": "Whether the layout is currently being published.\nWe use this to disable and show a loading state\non the \"Publish\" button in the edit toolbar.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2850,12 +2748,14 @@
           "events": [
             {
               "name": "arcgisHubLayoutChanged",
+              "description": "Event emitted when the layout is edited",
               "type": {
                 "text": "void"
               }
             },
             {
               "name": "arcgisHubLayoutEditorExit",
+              "description": "Event emitted when the layout editor is exited",
               "type": {
                 "text": "void"
               }

package/dist/docs/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-01-21T23:16:30",
+  "timestamp": "2026-01-27T17:52:45",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
     "version": "4.33.24",
@@ -1877,7 +1877,7 @@
       "overview": "",
       "readme": "",
       "usage": {},
-      "docs": "Component that renders a Hub entity view\nusing the layout system.",
+      "docs": "Component that renders a Hub entity view\nusing the layout system.\n\nIf an entity does not have a layout defined, we\nbuild a type-specific default layout from the entity's\nmetadata. The layout does not get persisted to the\nunderlying item until the user makes changes and\npublishes them.",
       "docsTags": [
         {
           "name": "superclass",
@@ -2064,7 +2064,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Event emitted when the layout is published.\nNote: only relevant for entities that are\nrendered via a layout.",
+          "docs": "Event emitted when the layout is published.",
           "docsTags": []
         },
         {
@@ -2087,115 +2087,13 @@
       "parts": [],
       "listeners": []
     },
-    {
-      "filePath": "src/components/layouts/components/layout-node-overlay/layout-node-overlay.tsx",
-      "tag": "arcgis-layout-node-overlay",
-      "overview": "",
-      "readme": "",
-      "usage": {},
-      "docs": "A component for rendering overlay content on\nlayout nodes. Overlays are used to indicate\nspecial states of layout nodes (e.g., hidden).",
-      "docsTags": [
-        {
-          "name": "superclass",
-          "text": "{\"name\":\"LitElement\",\"package\":\"@arcgis/lumina\"}"
-        }
-      ],
-      "encapsulation": "shadow",
-      "dependents": [],
-      "dependencies": [],
-      "dependencyGraph": {},
-      "props": [
-        {
-          "name": "nodeId",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": true,
-          "attr": "node-id",
-          "reflectToAttr": false,
-          "docs": "The ID of the layout node this overlay\nis anchored to.",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": true,
-          "required": false
-        },
-        {
-          "name": "type",
-          "type": "\"hidden\"",
-          "complexType": {
-            "original": "\"hidden\"",
-            "resolved": "\"hidden\"",
-            "references": {}
-          },
-          "mutable": true,
-          "attr": "type",
-          "reflectToAttr": false,
-          "docs": "The type of overlay to display. For now, we'll\nsupport a predefined set of overlay types\n(rather than allowing content to be slotted\nin) to keep the UI consistent, and to\nsimplify implementation.\n\nAdd additional types as needed.",
-          "docsTags": [],
-          "values": [
-            {
-              "value": "hidden",
-              "type": "string"
-            }
-          ],
-          "optional": true,
-          "required": false
-        }
-      ],
-      "methods": [
-        {
-          "name": "componentOnReady",
-          "returns": {
-            "type": "Promise<void>",
-            "docs": ""
-          },
-          "complexType": {
-            "signature": "(): Promise<void>",
-            "parameters": [],
-            "return": "Promise<void>",
-            "references": {
-              "Promise": {
-                "location": "import",
-                "path": "typescript/lib/lib.es5.d.ts",
-                "id": "notImplemented"
-              }
-            }
-          },
-          "signature": "componentOnReady(): Promise<void>",
-          "parameters": [],
-          "docs": "Create a promise that resolves once component is fully loaded.",
-          "docsTags": [
-            {
-              "name": "example",
-              "text": "```js\nconst arcgisLayoutNodeOverlay = document.querySelector(\"arcgis-layout-node-overlay\");\ndocument.body.append(arcgisLayoutNodeOverlay);\nawait arcgisLayoutNodeOverlay.componentOnReady();\nconsole.log(\"arcgis-layout-node-overlay is ready to go!\");\n```"
-            },
-            {
-              "name": "inheritedFrom",
-              "text": "{\"name\":\"LitElement\",\"package\":\"@arcgis/lumina\"}"
-            }
-          ]
-        }
-      ],
-      "events": [],
-      "styles": [],
-      "slots": [],
-      "parts": [],
-      "listeners": []
-    },
     {
       "filePath": "src/components/layouts/layout/layout.tsx",
       "tag": "arcgis-layout",
       "overview": "",
       "readme": "",
       "usage": {},
-      "docs": "A web component for rendering an ILayout",
+      "docs": "Web component for rendering an ILayout. Orchestrates\nthe rendering of sections, rows, columns, and cards\nas defined by the layout JSON.",
       "docsTags": [
         {
           "name": "superclass",
@@ -2218,7 +2116,7 @@
           "mutable": true,
           "attr": "debug",
           "reflectToAttr": true,
-          "docs": "Enables debug mode",
+          "docs": "Enables debug mode.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -2245,7 +2143,7 @@
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The currently focused/hovered node. This is\ntracked in order to show the node's configuration\ncontrols and \"active\" state in the UI.",
+          "docs": "The currently focused/hovered node. Used to show\nconfiguration controls and active state in the UI.",
           "docsTags": [],
           "values": [],
           "optional": true,
@@ -2262,7 +2160,7 @@
           "mutable": true,
           "attr": "is-edit-mode",
           "reflectToAttr": true,
-          "docs": "Whether the layout is in edit mode",
+          "docs": "Whether the layout is in edit mode.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -2289,7 +2187,7 @@
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The layout to render",
+          "docs": "The layout to render.",
           "docsTags": [],
           "values": [],
           "optional": true,
@@ -2311,7 +2209,7 @@
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Options for processing the layout",
+          "docs": "Options for processing the layout.",
           "docsTags": [],
           "values": [],
           "optional": true,
@@ -2355,7 +2253,7 @@
           "name": "getCardEl",
           "returns": {
             "type": "Promise<(HTMLElement & IConfigurableLayoutNode) | undefined>",
-            "docs": ""
+            "docs": "The HTML element for the node, if found"
           },
           "complexType": {
             "signature": "(nodeId: string): Promise<HTMLConfigurableLayoutNodeElement | undefined>",
@@ -2393,8 +2291,17 @@
               "docs": ""
             }
           ],
-          "docs": "",
-          "docsTags": []
+          "docs": "Public method that returns the DOM element for a\nlayout node by id. Used for highlighting or\nscrolling to a node in the layout.",
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "nodeId - The id of the node"
+            },
+            {
+              "name": "returns",
+              "text": "The HTML element for the node, if found"
+            }
+          ]
         }
       ],
       "events": [
@@ -2409,7 +2316,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "",
+          "docs": "Event emitted when the layout has finished\nrendering.",
           "docsTags": []
         }
       ],
@@ -2426,6 +2333,10 @@
       "usage": {},
       "docs": "",
       "docsTags": [
+        {
+          "name": "internal",
+          "text": "Main container component for rendering and managing\nan ILayout and its nodes. Orchestrates layout\ncomposition, editing, and interaction logic."
+        },
         {
           "name": "superclass",
           "text": "{\"name\":\"LitElement\",\"package\":\"@arcgis/lumina\"}"
@@ -2491,7 +2402,7 @@
           "mutable": true,
           "attr": "is-publishing",
           "reflectToAttr": false,
-          "docs": "Whether the layout is currently being\npublished.",
+          "docs": "Whether the layout is currently being published.\nWe use this to disable and show a loading state\non the \"Publish\" button in the edit toolbar.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -2605,7 +2516,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "",
+          "docs": "Event emitted when the layout is edited",
           "docsTags": []
         },
         {
@@ -2619,7 +2530,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "",
+          "docs": "Event emitted when the layout editor is exited",
           "docsTags": []
         },
         {