@luzmo/analytics-components-kit 1.0.1-alpha.140 → 1.0.1-alpha.142

package/custom-elements.json

@@ -141,6 +141,26 @@
               "description": "AI model preference for chart generation",
               "attribute": "model-preference"
             },
+            {
+              "kind": "field",
+              "name": "requestMode",
+              "type": {
+                "text": "'internal' | 'external'"
+              },
+              "default": "'internal'",
+              "description": "Controls if API calls are handled internally or by the host application.",
+              "attribute": "request-mode"
+            },
+            {
+              "kind": "field",
+              "name": "isGenerating",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Used only in external request mode to reflect request lifecycle in the UI.",
+              "attribute": "is-generating"
+            },
             {
               "kind": "field",
               "name": "conversationId",
@@ -160,6 +180,16 @@
               "default": "null",
               "description": "vizItem",
               "attribute": "chart"
+            },
+            {
+              "kind": "field",
+              "name": "apiVersion",
+              "type": {
+                "text": "string"
+              },
+              "default": "'0.1.0'",
+              "description": "API version",
+              "attribute": "api-version"
             }
           ],
           "events": [
@@ -183,6 +213,19 @@
                 "text": "CustomEvent"
               },
               "description": "Fired when an AI text response is received. For chart responses, this event is only fired if the response includes a `message` field. For error responses, this event is always fired with the error explanation."
+            },
+            {
+              "name": "luzmo-datasets-changed",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "name": "luzmo-prompt-submitted",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when request-mode is set to external so the host can execute the API request lifecycle."
             }
           ],
           "attributes": [
@@ -294,6 +337,24 @@
               "description": "AI model preference for chart generation",
               "fieldName": "modelPreference"
             },
+            {
+              "name": "request-mode",
+              "type": {
+                "text": "'internal' | 'external'"
+              },
+              "default": "'internal'",
+              "description": "Controls if API calls are handled internally or by the host application.",
+              "fieldName": "requestMode"
+            },
+            {
+              "name": "is-generating",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Used only in external request mode to reflect request lifecycle in the UI.",
+              "fieldName": "isGenerating"
+            },
             {
               "name": "conversation-id",
               "type": {
@@ -311,6 +372,15 @@
               "default": "null",
               "description": "vizItem",
               "fieldName": "chart"
+            },
+            {
+              "name": "api-version",
+              "type": {
+                "text": "string"
+              },
+              "default": "'0.1.0'",
+              "description": "API version",
+              "fieldName": "apiVersion"
             }
           ],
           "superclass": {
@@ -318,6 +388,19 @@
             "package": "@utils/base"
           },
           "summary": "A complete AI chat interface combining messages display and input"
+        },
+        {
+          "kind": "variable",
+          "name": "url",
+          "default": "`${this.apiUrl}/${this.apiVersion}/aimessage`"
+        },
+        {
+          "kind": "variable",
+          "name": "datasetIds"
+        },
+        {
+          "kind": "variable",
+          "name": "request"
         }
       ],
       "exports": [
@@ -331,6 +414,39 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/request-contract.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "buildAiMessageRequest",
+          "return": {
+            "type": {
+              "text": "AiMessageRequestBody"
+            }
+          },
+          "parameters": [
+            {
+              "name": "options",
+              "type": {
+                "text": "BuildAiMessageRequestOptions"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "buildAiMessageRequest",
+          "declaration": {
+            "name": "buildAiMessageRequest",
+            "module": "src/components/ai-chat/request-contract.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/ai-interaction-textarea/ai-interaction-textarea.ts",
@@ -470,6 +586,16 @@
               "description": "The current value of the textarea (can be controlled from parent to clear or set text)",
               "attribute": "value"
             },
+            {
+              "kind": "field",
+              "name": "retainOnSubmit",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, retains the input value after submitting a prompt (default: false)\nWhen false (default), clears the textarea value after submission",
+              "attribute": "retain-on-submit"
+            },
             {
               "type": {
                 "text": "boolean"
@@ -494,6 +620,14 @@
               "name": "is-generating",
               "kind": "field"
             },
+            {
+              "type": {
+                "text": "boolean"
+              },
+              "description": "When true, retains the input value after submission (default: false, clears on submit)",
+              "name": "retain-on-submit",
+              "kind": "field"
+            },
             {
               "type": {
                 "text": "string"
@@ -796,6 +930,15 @@
               "default": "''",
               "description": "The current value of the textarea (can be controlled from parent to clear or set text)",
               "fieldName": "value"
+            },
+            {
+              "name": "retain-on-submit",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, retains the input value after submitting a prompt (default: false)\nWhen false (default), clears the textarea value after submission",
+              "fieldName": "retainOnSubmit"
             }
           ],
           "superclass": {
@@ -8669,7 +8812,7 @@
               "kind": "field",
               "name": "theme",
               "type": {
-                "text": "any | undefined"
+                "text": "ThemeConfig | undefined"
               },
               "description": "Grid options configuration",
               "attribute": "theme",
@@ -8698,25 +8841,16 @@
           ],
           "events": [
             {
-              "name": "luzmo-grid-item-action",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Fired when an item action is performed"
+              "description": "Fired when an item action is performed",
+              "name": "luzmo-grid-item-action"
             },
             {
-              "name": "luzmo-grid-changed",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Fired when the grid is changed"
+              "description": "Fired when the grid is changed",
+              "name": "luzmo-grid-changed"
             },
             {
-              "name": "luzmo-grid-ready",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Fired when the grid is ready"
+              "description": "Fired when the grid is ready",
+              "name": "luzmo-grid-ready"
             }
           ],
           "attributes": [
@@ -8829,7 +8963,7 @@
             {
               "name": "theme",
               "type": {
-                "text": "any | undefined"
+                "text": "ThemeConfig | undefined"
               },
               "description": "Grid options configuration",
               "fieldName": "theme"
@@ -8878,6 +9012,1413 @@
       "declarations": [],
       "exports": []
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-effects.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "updateLuzmoVizItemsLanguage",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "gridItemElements",
+              "type": {
+                "text": "NodeListOf<HTMLElement>"
+              }
+            },
+            {
+              "name": "contentLanguage",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "updateLuzmoVizItemsLanguage",
+          "declaration": {
+            "name": "updateLuzmoVizItemsLanguage",
+            "module": "src/components/grid/helpers/grid-effects.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-events.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "createGridItemActionDetail",
+          "return": {
+            "type": {
+              "text": "GridItemActionEventDetail"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  action,\n  actionType,\n  active,\n  items,\n  element,\n  itemId,\n  item,\n  deletedId,\n  originalElement\n}",
+              "type": {
+                "text": "CreateGridItemActionDetailArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "dispatchGridItemActionEvent",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  target,\n  action,\n  actionType,\n  active,\n  items,\n  element,\n  itemId,\n  item,\n  deletedId,\n  originalElement\n}",
+              "type": {
+                "text": "DispatchGridItemActionEventArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "dispatchGridLifecycleEvent",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{ target, eventName, detail }",
+              "type": {
+                "text": "DispatchGridLifecycleEventArgs"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "createGridItemActionDetail",
+          "declaration": {
+            "name": "createGridItemActionDetail",
+            "module": "src/components/grid/helpers/grid-events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "dispatchGridItemActionEvent",
+          "declaration": {
+            "name": "dispatchGridItemActionEvent",
+            "module": "src/components/grid/helpers/grid-events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "dispatchGridLifecycleEvent",
+          "declaration": {
+            "name": "dispatchGridLifecycleEvent",
+            "module": "src/components/grid/helpers/grid-events.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-interactions.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "getGridItemElementFromTarget",
+          "return": {
+            "type": {
+              "text": "HTMLElement | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "target",
+              "type": {
+                "text": "EventTarget | null"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "shouldRemovePopoverOnMouseout",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{ event, gridItem }",
+              "type": {
+                "text": "ShouldRemovePopoverOnMouseoutArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "applyGridItemFocus",
+          "return": {
+            "type": {
+              "text": "HTMLElement | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  event,\n  focusedItemElement,\n  removeItemActionsMenuPopover\n}",
+              "type": {
+                "text": "ApplyGridItemFocusArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "clearGridItemFocus",
+          "return": {
+            "type": {
+              "text": "ClearGridItemFocusResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  event,\n  focusedItemElement,\n  removeItemActionsMenuPopover\n}",
+              "type": {
+                "text": "ClearGridItemFocusArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "resolveGridItemForDelete",
+          "return": {
+            "type": {
+              "text": "HTMLElement | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "event",
+              "type": {
+                "text": "Event"
+              }
+            },
+            {
+              "name": "fallback",
+              "optional": true,
+              "type": {
+                "text": "HTMLElement"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "cleanupActiveGridItem",
+          "return": {
+            "type": {
+              "text": "HTMLElement | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  item,\n  activeItemElement,\n  gridElement,\n  removeItemActionsMenuPopover\n}",
+              "type": {
+                "text": "CleanupActiveGridItemArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "handleGridAction",
+          "return": {
+            "type": {
+              "text": "GridInteractionState"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  event,\n  gridElement,\n  items,\n  state,\n  cleanupActiveItem,\n  dispatchItemActionEvent,\n  handleDeleteItem,\n  handleCloneItem,\n  createItemActionsMenuPopover\n}",
+              "type": {
+                "text": "HandleGridActionArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "handleGridClick",
+          "return": {
+            "type": {
+              "text": "GridInteractionState"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  event,\n  gridElement,\n  hostElement,\n  items,\n  activeItemActionToggle,\n  cleanupActiveItem,\n  dispatchItemActionEvent\n}",
+              "type": {
+                "text": "HandleGridClickArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "triggerGridItemAction",
+          "return": {
+            "type": {
+              "text": "TriggerGridItemActionResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  gridElement,\n  items,\n  gridItemData,\n  itemId,\n  action,\n  options,\n  state,\n  cleanupActiveItem,\n  dispatchItemActionEvent,\n  createItemActionsMenuPopover\n}",
+              "type": {
+                "text": "TriggerGridItemActionArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "deactivateGridItems",
+          "return": {
+            "type": {
+              "text": "DeactivateGridItemsResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  gridElement,\n  items,\n  state,\n  cleanupActiveItem,\n  dispatchItemActionEvent\n}",
+              "type": {
+                "text": "DeactivateGridItemsArgs"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "getGridItemElementFromTarget",
+          "declaration": {
+            "name": "getGridItemElementFromTarget",
+            "module": "src/components/grid/helpers/grid-interactions.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "shouldRemovePopoverOnMouseout",
+          "declaration": {
+            "name": "shouldRemovePopoverOnMouseout",
+            "module": "src/components/grid/helpers/grid-interactions.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "applyGridItemFocus",
+          "declaration": {
+            "name": "applyGridItemFocus",
+            "module": "src/components/grid/helpers/grid-interactions.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "clearGridItemFocus",
+          "declaration": {
+            "name": "clearGridItemFocus",
+            "module": "src/components/grid/helpers/grid-interactions.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "resolveGridItemForDelete",
+          "declaration": {
+            "name": "resolveGridItemForDelete",
+            "module": "src/components/grid/helpers/grid-interactions.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "cleanupActiveGridItem",
+          "declaration": {
+            "name": "cleanupActiveGridItem",
+            "module": "src/components/grid/helpers/grid-interactions.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "handleGridAction",
+          "declaration": {
+            "name": "handleGridAction",
+            "module": "src/components/grid/helpers/grid-interactions.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "handleGridClick",
+          "declaration": {
+            "name": "handleGridClick",
+            "module": "src/components/grid/helpers/grid-interactions.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "triggerGridItemAction",
+          "declaration": {
+            "name": "triggerGridItemAction",
+            "module": "src/components/grid/helpers/grid-interactions.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "deactivateGridItems",
+          "declaration": {
+            "name": "deactivateGridItems",
+            "module": "src/components/grid/helpers/grid-interactions.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-item-management.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "mapGridItems",
+          "return": {
+            "type": {
+              "text": "GridItemLookup[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "items",
+              "type": {
+                "text": "GridItemData[]"
+              }
+            },
+            {
+              "name": "gridElement",
+              "type": {
+                "text": "HTMLElement"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "addGridItem",
+          "return": {
+            "type": {
+              "text": "AddGridItemResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{ newItem, gridElement, grid, createId }",
+              "type": {
+                "text": "AddGridItemArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "variable",
+          "name": "item"
+        },
+        {
+          "kind": "function",
+          "name": "removeGridItemById",
+          "return": {
+            "type": {
+              "text": "RemoveGridItemByIdResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  id,\n  grid,\n  items,\n  getGridItemById,\n  removeItemActionsMenuPopover,\n  activeItemElement,\n  cleanupActiveItem\n}",
+              "type": {
+                "text": "RemoveGridItemByIdArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "handleCloneItem",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  event,\n  hasGrid,\n  items,\n  createId,\n  addGridItem: addGridItemToComponent,\n  dispatchItemActionEvent\n}",
+              "type": {
+                "text": "HandleCloneItemArgs"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "mapGridItems",
+          "declaration": {
+            "name": "mapGridItems",
+            "module": "src/components/grid/helpers/grid-item-management.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "addGridItem",
+          "declaration": {
+            "name": "addGridItem",
+            "module": "src/components/grid/helpers/grid-item-management.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "removeGridItemById",
+          "declaration": {
+            "name": "removeGridItemById",
+            "module": "src/components/grid/helpers/grid-item-management.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "handleCloneItem",
+          "declaration": {
+            "name": "handleCloneItem",
+            "module": "src/components/grid/helpers/grid-item-management.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-item-popover.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "createItemActionsMenuPopover",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  element,\n  activeAction,\n  getGridItemById,\n  placementItemActionsMenu,\n  renderOverlayContent,\n  removeItemActionsMenuPopover\n}",
+              "type": {
+                "text": "CreateItemActionsMenuPopoverArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "removeItemActionsMenuPopover",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "gridItem",
+              "type": {
+                "text": "HTMLElement"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "createItemActionsMenuPopover",
+          "declaration": {
+            "name": "createItemActionsMenuPopover",
+            "module": "src/components/grid/helpers/grid-item-popover.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "removeItemActionsMenuPopover",
+          "declaration": {
+            "name": "removeItemActionsMenuPopover",
+            "module": "src/components/grid/helpers/grid-item-popover.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-items.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "normalizeGridItems",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "items",
+              "type": {
+                "text": "GridItemData[]"
+              }
+            },
+            {
+              "name": "createId",
+              "type": {
+                "text": "() => string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "ensureGridItemId",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "item",
+              "type": {
+                "text": "GridItemData"
+              }
+            },
+            {
+              "name": "createId",
+              "type": {
+                "text": "() => string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "buildGridWidgetOptions",
+          "return": {
+            "type": {
+              "text": "GridStackWidget"
+            }
+          },
+          "parameters": [
+            {
+              "name": "item",
+              "type": {
+                "text": "GridItemData | undefined"
+              }
+            },
+            {
+              "name": "id",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "createGridItemFromInput",
+          "return": {
+            "type": {
+              "text": "GridItemData"
+            }
+          },
+          "parameters": [
+            {
+              "name": "newItem",
+              "type": {
+                "text": "GridItemData"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "createOrphanGridItemElement",
+          "return": {
+            "type": {
+              "text": "HTMLDivElement"
+            }
+          },
+          "parameters": [
+            {
+              "name": "itemId",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "readGridItemPosition",
+          "return": {
+            "type": {
+              "text": "GridItemData['position']"
+            }
+          },
+          "parameters": [
+            {
+              "name": "gridItemElement",
+              "type": {
+                "text": "HTMLElement"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "findGridItemElementById",
+          "return": {
+            "type": {
+              "text": "HTMLElement | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "elements",
+              "type": {
+                "text": "Iterable<HTMLElement>"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "text": "string | undefined"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "normalizeGridItems",
+          "declaration": {
+            "name": "normalizeGridItems",
+            "module": "src/components/grid/helpers/grid-items.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ensureGridItemId",
+          "declaration": {
+            "name": "ensureGridItemId",
+            "module": "src/components/grid/helpers/grid-items.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildGridWidgetOptions",
+          "declaration": {
+            "name": "buildGridWidgetOptions",
+            "module": "src/components/grid/helpers/grid-items.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createGridItemFromInput",
+          "declaration": {
+            "name": "createGridItemFromInput",
+            "module": "src/components/grid/helpers/grid-items.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createOrphanGridItemElement",
+          "declaration": {
+            "name": "createOrphanGridItemElement",
+            "module": "src/components/grid/helpers/grid-items.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "readGridItemPosition",
+          "declaration": {
+            "name": "readGridItemPosition",
+            "module": "src/components/grid/helpers/grid-items.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "findGridItemElementById",
+          "declaration": {
+            "name": "findGridItemElementById",
+            "module": "src/components/grid/helpers/grid-items.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-keyboard-updates.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "isGridArrowKey",
+          "return": {
+            "type": {
+              "text": "key is GridArrowKey"
+            }
+          },
+          "parameters": [
+            {
+              "name": "key",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "getGridKeyboardUpdate",
+          "return": {
+            "type": {
+              "text": "GridKeyboardUpdate | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  key,\n  node,\n  maxColumns,\n  shiftKey,\n  ctrlKey,\n  metaKey\n}",
+              "type": {
+                "text": "GridKeyboardUpdateArgs"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "isGridArrowKey",
+          "declaration": {
+            "name": "isGridArrowKey",
+            "module": "src/components/grid/helpers/grid-keyboard-updates.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getGridKeyboardUpdate",
+          "declaration": {
+            "name": "getGridKeyboardUpdate",
+            "module": "src/components/grid/helpers/grid-keyboard-updates.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-keydown-event.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "handleGridKeyDown",
+          "return": {
+            "type": {
+              "text": "HandleGridKeyDownResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  event,\n  viewMode,\n  focusedItemElement,\n  activeItemElement,\n  gridElement,\n  grid,\n  columns,\n  handleDeleteItem,\n  removeItemActionsMenuPopover,\n  createItemActionsMenuPopover\n}",
+              "type": {
+                "text": "HandleGridKeyDownArgs"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "handleGridKeyDown",
+          "declaration": {
+            "name": "handleGridKeyDown",
+            "module": "src/components/grid/helpers/grid-keydown-event.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-popover-cleanup.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "setPopoverCleanup",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "cleanup",
+              "type": {
+                "text": "CleanupCallback"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "clearPopoverCleanup",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "setPopoverCleanup",
+          "declaration": {
+            "name": "setPopoverCleanup",
+            "module": "src/components/grid/helpers/grid-popover-cleanup.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "clearPopoverCleanup",
+          "declaration": {
+            "name": "clearPopoverCleanup",
+            "module": "src/components/grid/helpers/grid-popover-cleanup.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-rendering.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderOverlayContent",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  item,\n  activeAction,\n  defaultItemActionsMenu,\n  placementItemActionsMenu,\n  language,\n  handleAction\n}",
+              "type": {
+                "text": "RenderOverlayContentArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "renderGridItem",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  item,\n  index,\n  initialized,\n  viewMode,\n  contentLanguage,\n  fullTheme,\n  appServer,\n  apiHost,\n  authKey,\n  authToken,\n  handleMouseover,\n  handleMouseout,\n  handleFocus,\n  handleBlur\n}",
+              "type": {
+                "text": "RenderGridItemArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "renderGridItems",
+          "return": {
+            "type": {
+              "text": "ReturnType<typeof repeat>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  items,\n  initialized,\n  viewMode,\n  contentLanguage,\n  fullTheme,\n  appServer,\n  apiHost,\n  authKey,\n  authToken,\n  renderItem\n}",
+              "type": {
+                "text": "RenderGridItemsArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "renderGrid",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  items,\n  initialized,\n  viewMode,\n  contentLanguage,\n  fullTheme,\n  appServer,\n  apiHost,\n  authKey,\n  authToken,\n  columns,\n  ensureGridItemId,\n  handleMouseover,\n  handleMouseout,\n  handleFocus,\n  handleBlur\n}",
+              "type": {
+                "text": "RenderGridArgs"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderOverlayContent",
+          "declaration": {
+            "name": "renderOverlayContent",
+            "module": "src/components/grid/helpers/grid-rendering.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "renderGridItem",
+          "declaration": {
+            "name": "renderGridItem",
+            "module": "src/components/grid/helpers/grid-rendering.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "renderGridItems",
+          "declaration": {
+            "name": "renderGridItems",
+            "module": "src/components/grid/helpers/grid-rendering.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "renderGrid",
+          "declaration": {
+            "name": "renderGrid",
+            "module": "src/components/grid/helpers/grid-rendering.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-stack-lifecycle.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "initializeGridStack",
+          "return": {
+            "type": {
+              "text": "GridStack"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  gridElement,\n  gridItemElements,\n  items,\n  columns,\n  rowHeight,\n  viewMode,\n  fullTheme,\n  onCreateOrUpdateDimensionsHint,\n  onRemoveDimensionsHint,\n  onChange\n}",
+              "type": {
+                "text": "InitializeGridStackArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "applyGridStackChanges",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "items",
+              "type": {
+                "text": "GridItemData[]"
+              }
+            },
+            {
+              "name": "changedItems",
+              "type": {
+                "text": "GridStackNode[]"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "createOrUpdateDimensionsHint",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  element,\n  numberOfColumns,\n  numberOfRows,\n  offsetHint\n}",
+              "type": {
+                "text": "CreateOrUpdateDimensionsHintArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "removeDimensionsHint",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "initializeGridStack",
+          "declaration": {
+            "name": "initializeGridStack",
+            "module": "src/components/grid/helpers/grid-stack-lifecycle.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "applyGridStackChanges",
+          "declaration": {
+            "name": "applyGridStackChanges",
+            "module": "src/components/grid/helpers/grid-stack-lifecycle.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createOrUpdateDimensionsHint",
+          "declaration": {
+            "name": "createOrUpdateDimensionsHint",
+            "module": "src/components/grid/helpers/grid-stack-lifecycle.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "removeDimensionsHint",
+          "declaration": {
+            "name": "removeDimensionsHint",
+            "module": "src/components/grid/helpers/grid-stack-lifecycle.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-theme.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "resolveGridTheme",
+          "return": {
+            "type": {
+              "text": "Promise<ThemeConfig | undefined>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{ theme, currentTheme }",
+              "type": {
+                "text": "GridThemeResolutionArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "getGridHalfMargins",
+          "return": {
+            "type": {
+              "text": "[number, number]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "theme",
+              "optional": true,
+              "type": {
+                "text": "{ margins?: number[] }"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "getDimensionsHintOffset",
+          "return": {
+            "type": {
+              "text": "number"
+            }
+          },
+          "parameters": [
+            {
+              "name": "theme",
+              "optional": true,
+              "type": {
+                "text": "{ margins?: number[] }"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "getGridBoxShadow",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "theme",
+              "optional": true,
+              "type": {
+                "text": "ThemeConfig"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "getGridCssVariables",
+          "return": {
+            "type": {
+              "text": "ReadonlyMap<string, string | undefined>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "theme",
+              "optional": true,
+              "type": {
+                "text": "ThemeConfig"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "isGridDarkBackground",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "theme",
+              "optional": true,
+              "type": {
+                "text": "ThemeConfig"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "applyThemeProperties",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "style",
+              "type": {
+                "text": "CSSStyleDeclaration"
+              }
+            },
+            {
+              "name": "fullTheme",
+              "optional": true,
+              "type": {
+                "text": "ThemeConfig"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "resolveGridTheme",
+          "declaration": {
+            "name": "resolveGridTheme",
+            "module": "src/components/grid/helpers/grid-theme.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getGridHalfMargins",
+          "declaration": {
+            "name": "getGridHalfMargins",
+            "module": "src/components/grid/helpers/grid-theme.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getDimensionsHintOffset",
+          "declaration": {
+            "name": "getDimensionsHintOffset",
+            "module": "src/components/grid/helpers/grid-theme.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getGridBoxShadow",
+          "declaration": {
+            "name": "getGridBoxShadow",
+            "module": "src/components/grid/helpers/grid-theme.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getGridCssVariables",
+          "declaration": {
+            "name": "getGridCssVariables",
+            "module": "src/components/grid/helpers/grid-theme.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isGridDarkBackground",
+          "declaration": {
+            "name": "isGridDarkBackground",
+            "module": "src/components/grid/helpers/grid-theme.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "applyThemeProperties",
+          "declaration": {
+            "name": "applyThemeProperties",
+            "module": "src/components/grid/helpers/grid-theme.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/grid/helpers/grid-update-cycle.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "syncGridItems",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  initialized,\n  grid,\n  hasItemsChanged,\n  hasItemAdded,\n  gridItemElements,\n  items,\n  gridElement\n}",
+              "type": {
+                "text": "SyncGridItemsArgs"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "applyViewModeChange",
+          "return": {
+            "type": {
+              "text": "HTMLElement | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  initialized,\n  grid,\n  hasViewModeChanged,\n  viewMode,\n  previousViewMode,\n  activeItemElement,\n  gridElement,\n  cleanupActiveItem\n}",
+              "type": {
+                "text": "ApplyViewModeChangeArgs"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "syncGridItems",
+          "declaration": {
+            "name": "syncGridItems",
+            "module": "src/components/grid/helpers/grid-update-cycle.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "applyViewModeChange",
+          "declaration": {
+            "name": "applyViewModeChange",
+            "module": "src/components/grid/helpers/grid-update-cycle.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/item-data-drop-panel/item-data-drop-panel.ts",