@feltmaps/js-sdk 1.7.0-next.16 → 1.7.0-next.18

package/dist/controller-bundled.d.ts

@@ -9972,6 +9972,22 @@ declare const uiSelectElementSchema: ZodObject<objectUtil.extendShape<objectUtil
  * ```
  *
  * @example
+ * #### with label
+ * `label` is displayed above the select and used for screen readers.
+ * `placeholder` is displayed in the select when no value is selected.
+ *
+ * ```typescript
+ * {
+ *   type: "Select",
+ *   label: "Fruit",
+ *   options: [{ label: "Apple", value: "apple" }, { label: "Banana", value: "banana" }],
+ *   value: undefined,
+ *   placeholder: "Select a fruit",
+ *   onChange: (args) => console.log(args.value),
+ * }
+ * ```
+ *
+ * @example
  * #### with search
  * ```typescript
  * {
@@ -10363,6 +10379,16 @@ type ItemCreateClonableType = Exclude<UIPanelElementCreateClonable, {
  *
  * As part of CSS Grid Layout capabilities it is possible to create a horizontal stack.
  *
+ * #### Alignment & Distribution
+ *
+ * On horizontal stacks, it is possible to align and distribute the items.
+ *
+ * `verticalAlignment` is used to align the items vertically. By default, items are aligned to the top of the container.
+ * It follows the same values as CSS's `align-items` property. See [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/CSS/align-items) for more details.
+ *
+ * `horizontalDistribution` is used to justify the items horizontally. By default, items are justified to the start of the container.
+ * It follows the same values as CSS's `justify-content` property. See [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content) for more details.
+ *
  * #### Equal width columns
  *
  * <figure>
@@ -10450,6 +10476,20 @@ interface UIGridContainerElement extends UIElementBase {
      *
      */
     grid?: string;
+    /**
+     * The alignment of the items in the grid.
+     * Only takes effect on horizontal stacks.
+     *
+     * @defaultValue `"top"`
+     */
+    verticalAlignment?: "top" | "center" | "bottom";
+    /**
+     * The distribution of the items in the grid.
+     * Only takes effect on horizontal stacks.
+     *
+     * @defaultValue `"start"`
+     */
+    horizontalDistribution?: "start" | "center" | "end" | "space-between" | "space-around" | "space-evenly";
     /**
      * The items to add to the grid container.
      */
@@ -10521,7 +10561,7 @@ declare const placementForUiElementSchema: ZodUnion<[ZodObject<{
     at: "start" | "end";
 }>]>;
 /**
- * Used in {@link UiController.createPanel} to specify the position of a panel in the stack
+ * Used in {@link UiController.createOrUpdatePanel} to specify the position of a panel in the stack
  * and in {@link UiController.createPanelElements} to specify the position of an element in a panel.
  *
  * In both cases, the default value is `{ at: "end" }`.
@@ -10554,7 +10594,7 @@ declare const uiPanelSchema: ZodObject<objectUtil.extendShape<objectUtil.extendS
     /**
      * The elements to add to the panel body.
      */
-    body: ZodArray<ZodType<UIPanelElement, ZodTypeDef, UIPanelElement>, "many">;
+    body: ZodOptional<ZodArray<ZodType<UIPanelElement, ZodTypeDef, UIPanelElement>, "many">>;
     /**
      * The elements to add to the panel footer.
      */
@@ -10569,7 +10609,6 @@ declare const uiPanelSchema: ZodObject<objectUtil.extendShape<objectUtil.extendS
 }>, "strip", ZodTypeAny, {
     type: "Panel";
     id: string;
-    body: UIPanelElement[];
     onCreate?: ((args_0: {
         id: string;
     }, ...args: unknown[]) => void) | undefined;
@@ -10577,6 +10616,7 @@ declare const uiPanelSchema: ZodObject<objectUtil.extendShape<objectUtil.extendS
         id: string;
     }, ...args: unknown[]) => void) | undefined;
     title?: string | undefined;
+    body?: UIPanelElement[] | undefined;
     footer?: UIPanelElement[] | undefined;
     onClickClose?: ((args_0: {
         id: string;
@@ -10584,7 +10624,6 @@ declare const uiPanelSchema: ZodObject<objectUtil.extendShape<objectUtil.extendS
 }, {
     type: "Panel";
     id: string;
-    body: UIPanelElement[];
     onCreate?: ((args_0: {
         id: string;
     }, ...args: unknown[]) => void) | undefined;
@@ -10592,6 +10631,7 @@ declare const uiPanelSchema: ZodObject<objectUtil.extendShape<objectUtil.extendS
         id: string;
     }, ...args: unknown[]) => void) | undefined;
     title?: string | undefined;
+    body?: UIPanelElement[] | undefined;
     footer?: UIPanelElement[] | undefined;
     onClickClose?: ((args_0: {
         id: string;
@@ -10599,7 +10639,7 @@ declare const uiPanelSchema: ZodObject<objectUtil.extendShape<objectUtil.extendS
 }>;
 /**
  * Represents a panel in the UI.
- * It can be added to the map by using the {@link UiController.createPanel} method.
+ * It can be added to the map by using the {@link UiController.createOrUpdatePanel} method.
  *
  * A panel is a container for other UI elements.
  * It can have a title, a body, a footer as well as a close button.
@@ -10663,11 +10703,18 @@ declare const uiPanelSchema: ZodObject<objectUtil.extendShape<objectUtil.extendS
  * ```
  *
  */
-interface UIPanel extends UIElementBase, Omit<zInfer<typeof uiPanelSchema>, "onClickClose" | "body" | "footer" | "onCreate" | "onDestroy"> {
+interface UIPanel extends UIElementBase, Omit<zInfer<typeof uiPanelSchema>, "onClickClose" | "body" | "footer" | "onCreate" | "onDestroy" | "id"> {
+    /**
+     * The ID of the panel obtained from {@link UiController.createPanelId}.
+     *
+     * @remarks
+     * Custom IDs are not supported.
+     */
+    id: string;
     /**
      * The elements to add to the panel body.
      */
-    body: UIPanelElement[];
+    body?: UIPanelElement[];
     /**
      * The elements to add to the panel footer.
      */
@@ -10685,7 +10732,7 @@ interface UIPanel extends UIElementBase, Omit<zInfer<typeof uiPanelSchema>, "onC
 declare const uiPanelCreateSchema: {
     params: ZodObject<objectUtil.extendShape<Omit<{
         type: ZodOptional<ZodLiteral<"Panel">>;
-        id: ZodOptional<ZodString>;
+        id: ZodString;
         onCreate: ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
             id: ZodString;
         }, "strip", ZodTypeAny, {
@@ -10701,7 +10748,7 @@ declare const uiPanelCreateSchema: {
             id: string;
         }>], ZodUnknown>, ZodVoid>>;
         title: ZodOptional<ZodString>;
-        body: ZodArray<ZodType<UIPanelElement, ZodTypeDef, UIPanelElement>, "many">;
+        body: ZodOptional<ZodArray<ZodType<UIPanelElement, ZodTypeDef, UIPanelElement>, "many">>;
         footer: ZodOptional<ZodArray<ZodType<UIPanelElement, ZodTypeDef, UIPanelElement>, "many">>;
         onClickClose: ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
             id: ZodString;
@@ -10711,12 +10758,11 @@ declare const uiPanelCreateSchema: {
             id: string;
         }>], ZodUnknown>, ZodVoid>>;
     }, "body" | "footer">, {
-        body: ZodArray<ZodType<UIPanelElementCreate, ZodTypeDef, UIPanelElementCreate>, "many">;
+        body: ZodOptional<ZodArray<ZodType<UIPanelElementCreate, ZodTypeDef, UIPanelElementCreate>, "many">>;
         footer: ZodOptional<ZodArray<ZodType<UIPanelElementCreate, ZodTypeDef, UIPanelElementCreate>, "many">>;
     }>, "strip", ZodTypeAny, {
-        body: UIPanelElementCreate[];
+        id: string;
         type?: "Panel" | undefined;
-        id?: string | undefined;
         onCreate?: ((args_0: {
             id: string;
         }, ...args: unknown[]) => void) | undefined;
@@ -10724,14 +10770,14 @@ declare const uiPanelCreateSchema: {
             id: string;
         }, ...args: unknown[]) => void) | undefined;
         title?: string | undefined;
+        body?: UIPanelElementCreate[] | undefined;
         footer?: UIPanelElementCreate[] | undefined;
         onClickClose?: ((args_0: {
             id: string;
         }, ...args: unknown[]) => void) | undefined;
     }, {
-        body: UIPanelElementCreate[];
+        id: string;
         type?: "Panel" | undefined;
-        id?: string | undefined;
         onCreate?: ((args_0: {
             id: string;
         }, ...args: unknown[]) => void) | undefined;
@@ -10739,51 +10785,21 @@ declare const uiPanelCreateSchema: {
             id: string;
         }, ...args: unknown[]) => void) | undefined;
         title?: string | undefined;
+        body?: UIPanelElementCreate[] | undefined;
         footer?: UIPanelElementCreate[] | undefined;
         onClickClose?: ((args_0: {
             id: string;
         }, ...args: unknown[]) => void) | undefined;
     }>;
-    clonable: ZodObject<objectUtil.extendShape<objectUtil.extendShape<objectUtil.extendShape<Omit<{
+    clonable: ZodObject<objectUtil.extendShape<{
         type: ZodOptional<ZodLiteral<"Panel">>;
-        id: ZodOptional<ZodString>;
-        onCreate: ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
-            id: ZodString;
-        }, "strip", ZodTypeAny, {
-            id: string;
-        }, {
-            id: string;
-        }>], ZodUnknown>, ZodVoid>>;
-        onDestroy: ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
-            id: ZodString;
-        }, "strip", ZodTypeAny, {
-            id: string;
-        }, {
-            id: string;
-        }>], ZodUnknown>, ZodVoid>>;
+        id: ZodString;
+        onCreate: ZodOptional<ZodString>;
+        onDestroy: ZodOptional<ZodString>;
         title: ZodOptional<ZodString>;
-        body: ZodArray<ZodType<UIPanelElement, ZodTypeDef, UIPanelElement>, "many">;
-        footer: ZodOptional<ZodArray<ZodType<UIPanelElement, ZodTypeDef, UIPanelElement>, "many">>;
-        onClickClose: ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
-            id: ZodString;
-        }, "strip", ZodTypeAny, {
-            id: string;
-        }, {
-            id: string;
-        }>], ZodUnknown>, ZodVoid>>;
-    }, "body" | "footer">, {
-        body: ZodArray<ZodType<UIPanelElementCreate, ZodTypeDef, UIPanelElementCreate>, "many">;
+        body: ZodOptional<ZodArray<ZodType<UIPanelElementCreate, ZodTypeDef, UIPanelElementCreate>, "many">>;
         footer: ZodOptional<ZodArray<ZodType<UIPanelElementCreate, ZodTypeDef, UIPanelElementCreate>, "many">>;
-    }>, objectUtil.extendShape<{
-        id: ZodOptional<ZodString>;
-        onCreate: ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
-            id: ZodString;
-        }, "strip", ZodTypeAny, {
-            id: string;
-        }, {
-            id: string;
-        }>], ZodUnknown>, ZodVoid>>;
-        onDestroy: ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
+        onClickClose: ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
             id: ZodString;
         }, "strip", ZodTypeAny, {
             id: string;
@@ -10791,46 +10807,40 @@ declare const uiPanelCreateSchema: {
             id: string;
         }>], ZodUnknown>, ZodVoid>>;
     }, {
-        onCreate: ZodOptional<ZodString>;
-        onDestroy: ZodOptional<ZodString>;
-    }>>, {
         onClickClose: ZodOptional<ZodString>;
-        body: ZodArray<ZodType<UIPanelElementCreateClonable, ZodTypeDef, UIPanelElementCreateClonable>, "many">;
+        body: ZodOptional<ZodArray<ZodType<UIPanelElementCreateClonable, ZodTypeDef, UIPanelElementCreateClonable>, "many">>;
         footer: ZodOptional<ZodArray<ZodType<UIPanelElementCreateClonable, ZodTypeDef, UIPanelElementCreateClonable>, "many">>;
     }>, "strip", ZodTypeAny, {
-        body: UIPanelElementCreateClonable[];
+        id: string;
         type?: "Panel" | undefined;
-        id?: string | undefined;
         onCreate?: string | undefined;
         onDestroy?: string | undefined;
         title?: string | undefined;
+        body?: UIPanelElementCreateClonable[] | undefined;
         footer?: UIPanelElementCreateClonable[] | undefined;
         onClickClose?: string | undefined;
     }, {
-        body: UIPanelElementCreateClonable[];
+        id: string;
         type?: "Panel" | undefined;
-        id?: string | undefined;
         onCreate?: string | undefined;
         onDestroy?: string | undefined;
         title?: string | undefined;
+        body?: UIPanelElementCreateClonable[] | undefined;
         footer?: UIPanelElementCreateClonable[] | undefined;
         onClickClose?: string | undefined;
     }>;
 };
 /**
- * The parameters for creating a panel by using {@link UiController.createPanel}.
+ * The parameters for creating a panel by using {@link UiController.createOrUpdatePanel}.
  *
  * @see {@link UIPanel} for more information about panels.
- *
- * @remarks
- * `id` is optional but recommended if you want to be able to perform updates.
  */
-interface UIPanelCreate extends Omit<UIPanel, "id" | "body" | "footer" | "type">, UIElementBaseCreateParams {
+interface UIPanelCreateOrUpdate extends Omit<UIPanel, "body" | "footer" | "type">, Omit<UIElementBaseCreateParams, "id"> {
     type?: "Panel";
     /**
      * The elements to add to the panel body.
      */
-    body: UIPanelElementCreate[];
+    body?: UIPanelElementCreate[];
     /**
      * The elements to add to the panel footer.
      */
@@ -11225,10 +11235,10 @@ declare const UpdateActionTriggerParamsSchema: ZodObject<{
 interface UpdateActionTriggerParams extends Omit<Partial<UIActionTriggerCreate>, "id"> {
     id: zInfer<typeof UpdateActionTriggerParamsSchema>["id"];
 }
-declare const CreatePanelParamsSchema: ZodObject<{
+declare const CreateOrUpdatePanelParamsSchema: ZodObject<{
     panel: ZodObject<objectUtil.extendShape<Omit<{
         type: ZodOptional<ZodLiteral<"Panel">>;
-        id: ZodOptional<ZodString>;
+        id: ZodString;
         onCreate: ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
             id: ZodString;
         }, "strip", ZodTypeAny, {
@@ -11244,7 +11254,7 @@ declare const CreatePanelParamsSchema: ZodObject<{
             id: string;
         }>], ZodUnknown>, ZodVoid>>;
         title: ZodOptional<ZodString>;
-        body: ZodArray<ZodType<UIPanelElement, ZodTypeDef, UIPanelElement>, "many">;
+        body: ZodOptional<ZodArray<ZodType<UIPanelElement, ZodTypeDef, UIPanelElement>, "many">>;
         footer: ZodOptional<ZodArray<ZodType<UIPanelElement, ZodTypeDef, UIPanelElement>, "many">>;
         onClickClose: ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
             id: ZodString;
@@ -11254,12 +11264,11 @@ declare const CreatePanelParamsSchema: ZodObject<{
             id: string;
         }>], ZodUnknown>, ZodVoid>>;
     }, "body" | "footer">, {
-        body: ZodArray<ZodType<UIPanelElementCreate, ZodTypeDef, UIPanelElementCreate>, "many">;
+        body: ZodOptional<ZodArray<ZodType<UIPanelElementCreate, ZodTypeDef, UIPanelElementCreate>, "many">>;
         footer: ZodOptional<ZodArray<ZodType<UIPanelElementCreate, ZodTypeDef, UIPanelElementCreate>, "many">>;
     }>, "strip", ZodTypeAny, {
-        body: UIPanelElementCreate[];
+        id: string;
         type?: "Panel" | undefined;
-        id?: string | undefined;
         onCreate?: ((args_0: {
             id: string;
         }, ...args: unknown[]) => void) | undefined;
@@ -11267,14 +11276,14 @@ declare const CreatePanelParamsSchema: ZodObject<{
             id: string;
         }, ...args: unknown[]) => void) | undefined;
         title?: string | undefined;
+        body?: UIPanelElementCreate[] | undefined;
         footer?: UIPanelElementCreate[] | undefined;
         onClickClose?: ((args_0: {
             id: string;
         }, ...args: unknown[]) => void) | undefined;
     }, {
-        body: UIPanelElementCreate[];
+        id: string;
         type?: "Panel" | undefined;
-        id?: string | undefined;
         onCreate?: ((args_0: {
             id: string;
         }, ...args: unknown[]) => void) | undefined;
@@ -11282,6 +11291,7 @@ declare const CreatePanelParamsSchema: ZodObject<{
             id: string;
         }, ...args: unknown[]) => void) | undefined;
         title?: string | undefined;
+        body?: UIPanelElementCreate[] | undefined;
         footer?: UIPanelElementCreate[] | undefined;
         onClickClose?: ((args_0: {
             id: string;
@@ -11308,9 +11318,8 @@ declare const CreatePanelParamsSchema: ZodObject<{
     }>]>>;
 }, "strip", ZodTypeAny, {
     panel: {
-        body: UIPanelElementCreate[];
+        id: string;
         type?: "Panel" | undefined;
-        id?: string | undefined;
         onCreate?: ((args_0: {
             id: string;
         }, ...args: unknown[]) => void) | undefined;
@@ -11318,6 +11327,7 @@ declare const CreatePanelParamsSchema: ZodObject<{
             id: string;
         }, ...args: unknown[]) => void) | undefined;
         title?: string | undefined;
+        body?: UIPanelElementCreate[] | undefined;
         footer?: UIPanelElementCreate[] | undefined;
         onClickClose?: ((args_0: {
             id: string;
@@ -11332,9 +11342,8 @@ declare const CreatePanelParamsSchema: ZodObject<{
     } | undefined;
 }, {
     panel: {
-        body: UIPanelElementCreate[];
+        id: string;
         type?: "Panel" | undefined;
-        id?: string | undefined;
         onCreate?: ((args_0: {
             id: string;
         }, ...args: unknown[]) => void) | undefined;
@@ -11342,6 +11351,7 @@ declare const CreatePanelParamsSchema: ZodObject<{
             id: string;
         }, ...args: unknown[]) => void) | undefined;
         title?: string | undefined;
+        body?: UIPanelElementCreate[] | undefined;
         footer?: UIPanelElementCreate[] | undefined;
         onClickClose?: ((args_0: {
             id: string;
@@ -11356,26 +11366,21 @@ declare const CreatePanelParamsSchema: ZodObject<{
     } | undefined;
 }>;
 /**
- * The parameters for adding a panel to the map by using {@link UiController.createPanel}.
+ * The parameters for creating or updating a panel by using {@link UiController.createOrUpdatePanel}.
  *
  * @public
  */
-interface CreatePanelParams extends zInfer<typeof CreatePanelParamsSchema> {
+interface CreateOrUpdatePanelParams extends zInfer<typeof CreateOrUpdatePanelParamsSchema> {
     /**
      * The panel to add.
      */
-    panel: UIPanelCreate;
+    panel: UIPanelCreateOrUpdate;
     /**
      * The placement of the panel on the right sidebar stack.
      *
      * @defaultValue `{ at: "end" }`
      */
-    placement?: PlacementForUIElement;
-}
-/**
- * @public
- */
-interface UpdatePanelParams extends Omit<Partial<UIPanelCreate>, "id">, UIElementBase {
+    initialPlacement?: PlacementForUIElement;
 }
 declare const CreatePanelElementsParamsSchema: ZodObject<{
     panelId: ZodString;
@@ -11860,6 +11865,8 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }>], ZodUnknown>, ZodVoid>>>;
             grid: ZodOptional<ZodOptional<ZodString>>;
+            verticalAlignment: ZodOptional<ZodOptional<ZodEnum<["top", "center", "bottom"]>>>;
+            horizontalDistribution: ZodOptional<ZodOptional<ZodEnum<["start", "center", "end", "space-between", "space-around", "space-evenly"]>>>;
             items: ZodOptional<ZodType<(UIButtonElementCreate | UITextElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[], ZodTypeDef, (UIButtonElementCreate | UITextElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[]>>;
         }, UnknownKeysParam, ZodTypeAny, {
             type: "Grid";
@@ -11872,6 +11879,8 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
             grid?: string | undefined;
+            verticalAlignment?: "center" | "top" | "bottom" | undefined;
+            horizontalDistribution?: "center" | "start" | "end" | "space-between" | "space-around" | "space-evenly" | undefined;
         }, {
             type: "Grid";
             id: string;
@@ -11883,6 +11892,8 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
             grid?: string | undefined;
+            verticalAlignment?: "center" | "top" | "bottom" | undefined;
+            horizontalDistribution?: "center" | "start" | "end" | "space-between" | "space-around" | "space-evenly" | undefined;
         }>]>;
     }, "strip", ZodTypeAny, {
         element: {
@@ -11985,6 +11996,8 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
             grid?: string | undefined;
+            verticalAlignment?: "center" | "top" | "bottom" | undefined;
+            horizontalDistribution?: "center" | "start" | "end" | "space-between" | "space-around" | "space-evenly" | undefined;
         };
     }, {
         element: {
@@ -12087,6 +12100,8 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
             grid?: string | undefined;
+            verticalAlignment?: "center" | "top" | "bottom" | undefined;
+            horizontalDistribution?: "center" | "start" | "end" | "space-between" | "space-around" | "space-evenly" | undefined;
         };
     }>, "many">;
 }, "strip", ZodTypeAny, {
@@ -12192,6 +12207,8 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
             grid?: string | undefined;
+            verticalAlignment?: "center" | "top" | "bottom" | undefined;
+            horizontalDistribution?: "center" | "start" | "end" | "space-between" | "space-around" | "space-evenly" | undefined;
         };
     }[];
 }, {
@@ -12297,6 +12314,8 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
             grid?: string | undefined;
+            verticalAlignment?: "center" | "top" | "bottom" | undefined;
+            horizontalDistribution?: "center" | "start" | "end" | "space-between" | "space-around" | "space-evenly" | undefined;
         };
     }[];
 }>;
@@ -12541,29 +12560,44 @@ interface UiController {
      */
     deleteActionTrigger(id: string): void;
     /**
-     * Creates a panel on map's right sidebar.
+     * Creates a panel ID.
+     *
+     * In order to create a panel using {@link createOrUpdatePanel}, you need to create a panel ID first.
+     *
+     * @example
+     * ```typescript
+     * const panelId = await felt.createPanelId();
+     * ```
+     */
+    createPanelId(): Promise<string>;
+    /**
+     * Creates or updates a panel.
+     *
+     * Panels are rendered on map's right sidebar and are useful to extend Felt UI for your own use cases
+     * (e.g. a form, a settings panel, etc.) using Felt UI elements (e.g. Text, Button, etc.).
+     * This way it is possible to cover new use cases while keeping the user experience consistent with the rest of Felt.
      *
-     * Panels are useful to extend Felt UI for your own use cases (e.g. a form, a settings panel, etc.)
-     * by using Felt UI elements (e.g. Text, Button, etc.). This way the user experience is consistent
-     * with the rest of Felt.
+     * A panel is identified by its ID and must come from {@link createPanelId}.
+     * Custom IDs are not supported in order to prevent conflicts with other panels.
      *
      * Panels have two sections:
      *  - `body` - Body of the panel, scrollable.
      *  - `footer` - It sticks to the bottom of the panel, useful to add submit buttons.
      *
-     * By default, the panel will be added to the end of the stack but you can
-     * specify a placement to add it at a specific position in the stack.
+     * Regarding panel placement, by default it is added to the end of the panels stack but you can
+     * specify a different placement by using the `initialPlacement` parameter.
+     * This placement cannot be updated later.
      *
-     * Once created, you can add elements to the panel by using the {@link createPanelElements} method or
-     * perform partial updates of elements by using the {@link updatePanelElements} method.
-     *
-     * When adding a panel, its id is optional as well as its elements' ids.
-     * It is recommended to provide an id for the panel and its elements to make
+     * When adding a panel, its elements' ids are optional though it is recommended to make
      * it easier to update or delete them later.
      *
+     * Once created, you can add elements to the panel by using the {@link createPanelElements} method,
+     * perform partial updates of elements by using the {@link updatePanelElements} method or
+     * delete elements by using the {@link deletePanelElements} method.
+     *
      * @param args - The arguments for the method.
      * @param args.panel - The panel to add.
-     * @param args.placement - The placement of the panel. Optional. Defaults to `{ at: "end" }`.
+     * @param args.initialPlacement - The placement of the panel when added. Optional. Defaults to `{ at: "end" }`.
      * - `{ at: "start" }` - Add the panel to the start of the stack.
      * - `{ at: "end" }` - Add the panel to the end of the stack.
      * - `{ after: "panel-1" }` - Add the panel after the panel with the id `panel-1`.
@@ -12571,9 +12605,11 @@ interface UiController {
      *
      * @example
      * ```typescript
-     * await felt.createPanel({
+     * const id = await felt.createPanelId();
+     *
+     * await felt.createOrUpdatePanel({
      *    panel: {
-     *       id: "panel-1", // not required but useful for further updates
+     *       id,
      *       title: "My Panel",
      *       body: [
      *          {
@@ -12596,32 +12632,11 @@ interface UiController {
      *          },
      *       ],
      *    },
-     *    placement: { at: "start" }, // add the panel to the start of the stack
-     * });
-     * ```
-     */
-    createPanel(args: CreatePanelParams): Promise<UIPanel>;
-    /**
-     * Updates a panel.
-     *
-     * Panel to update is identified by the `id` property.
-     *
-     * @remarks
-     * Properties provided will override the existing properties.
-     * Override is done at Panel level, so if you want to update a specific element,
-     * you need to provide the entire element. For partial updates of elements, use
-     * {@link updatePanelElements} instead.
-     *
-     * @param panel - The panel to update.
-     * @example
-     * ```typescript
-     * await felt.updatePanel({
-     *   id: "panel-1",
-     *   title: "A new title for my panel", // only title changes
+     *    initialPlacement: { at: "start" }, // when added, the panel will be added to the start of the stack
      * });
      * ```
      */
-    updatePanel(panel: UpdatePanelParams): Promise<UIPanel>;
+    createOrUpdatePanel(args: CreateOrUpdatePanelParams): Promise<UIPanel>;
     /**
      * Deletes a panel.
      *
@@ -12657,7 +12672,7 @@ interface UiController {
      * @example
      * ```typescript
      * await felt.createPanelElements({
-     *   panelId: "panel-1",
+     *   panelId,
      *   elements: [
      *     {
      *       element: { type: "Text", content: "Hello, world!" },
@@ -12679,7 +12694,7 @@ interface UiController {
      * @example
      * ```typescript
      * await felt.updatePanelElements({
-     *   panelId: "panel-1",
+     *   panelId,
      *   elements: [
      *     {
      *       element: {
@@ -12702,7 +12717,7 @@ interface UiController {
      * @example
      * ```typescript
      * await felt.deletePanelElements({
-     *   panelId: "panel-1",
+     *   panelId,
      *   elements: ["element-1", "element-2"],
      * });
      * ```
@@ -13126,4 +13141,4 @@ interface FeltController extends ViewportController, UiController, LayersControl
     iframe: HTMLIFrameElement | null;
 }
 
-export { type LayerChangeCallbackParams as $, type TextElementUpdate as A, type ElementsController as B, type CircleElementCreate as C, type MapInteractionEvent as D, type Element as E, type FeltController as F, type GetElementGroupsConstraint as G, type HighlighterElementCreate as H, type ImageElementCreate as I, type InteractionsController as J, type CreateLayersFromGeoJsonParams as K, type LinkElementRead as L, type MarkerElementCreate as M, type NoteElementCreate as N, type DataOnlyLayer as O, type PathElementCreate as P, type FeltTiledVectorSource as Q, type GeoJsonDataVectorSource as R, type GeoJsonFileVectorSource as S, type TextElementCreate as T, type UiControlsOptions as U, type ViewportCenterZoom as V, type GeoJsonUrlVectorSource as W, type GetLayerGroupsConstraint as X, type GetLayersConstraint as Y, type GetRenderedFeaturesConstraint as Z, type Layer as _, type CircleElementRead as a, type LngLatTuple as a$, type LayerCommon as a0, type LayerGroup as a1, type LayerGroupChangeCallbackParams as a2, type LayerProcessingStatus as a3, type LegendItem as a4, type LegendItemChangeCallbackParams as a5, type LegendItemIdentifier as a6, type LegendItemsConstraint as a7, type RasterBand as a8, type RasterLayer as a9, type GetLayerCategoriesParams as aA, type GetLayerHistogramBin as aB, type GetLayerHistogramParams as aC, type GetLayerPrecomputedCalculationParams as aD, type GridConfig as aE, type GridType as aF, type MultiAggregationConfig as aG, type PrecomputedAggregationMethod as aH, type ValueConfiguration as aI, type LayersController as aJ, type MapDetails as aK, type MiscController as aL, type ElementGroupNode as aM, type ElementNode as aN, type EntityNode as aO, type FeatureNode as aP, type FeatureSelection as aQ, type LayerGroupNode as aR, type LayerNode as aS, type SelectionController as aT, type FeltBoundary as aU, type FeltZoom as aV, type GeoJsonFeature as aW, type GeoJsonGeometry as aX, type GeoJsonProperties as aY, type LatLng as aZ, type LineStringGeometry as a_, type RasterLayerSource as aa, type UpdateLayerParams as ab, type VectorLayer as ac, type LayerFeature as ad, type RasterValue as ae, type LayerSchema as af, type LayerSchemaAttribute as ag, type LayerSchemaBooleanAttribute as ah, type LayerSchemaCommonAttribute as ai, type LayerSchemaDateAttribute as aj, type LayerSchemaDateTimeAttribute as ak, type LayerSchemaNumericAttribute as al, type LayerSchemaTextAttribute as am, type FilterExpression as an, type FilterLogicGate as ao, type FilterTernary as ap, type Filters as aq, type GeometryFilter as ar, type LayerBoundaries as as, type LayerFilters as at, type AggregatedGridConfig as au, type AggregationConfig as av, type AggregationMethod as aw, type CountGridConfig as ax, type GetLayerCalculationParams as ay, type GetLayerCategoriesGroup as az, type CircleElementUpdate as b, type ViewportConstraints as b$, type MultiLineStringGeometry as b0, type MultiPointGeometry as b1, type MultiPolygonGeometry as b2, type PointGeometry as b3, type PolygonGeometry as b4, type SetVisibilityRequest as b5, type SortConfig as b6, type SortDirection as b7, type CircleToolSettings as b8, type ConfigurableToolType as b9, type UIButtonElement as bA, type UIButtonElementCreate as bB, type UIButtonElementUpdate as bC, type UITextElement as bD, type UITextElementCreate as bE, type UITextElementUpdate as bF, type UIFlexibleSpaceElement as bG, type UIFlexibleSpaceElementCreate as bH, type UIFlexibleSpaceElementUpdate as bI, type UIDividerElement as bJ, type UIDividerElementCreate as bK, type UIDividerElementUpdate as bL, type UITextInputElement as bM, type UITextInputElementCreate as bN, type UITextInputElementUpdate as bO, type UISelectElement as bP, type UISelectElementCreate as bQ, type UISelectElementUpdate as bR, type UIPanelElement as bS, type UIPanelElementCreate as bT, type UIPanelElementUpdate as bU, type UIGridContainerElement as bV, type UIGridContainerElementCreate as bW, type UIGridContainerElementUpdate as bX, type UIActionTriggerCreate as bY, type UiController as bZ, type SetViewportCenterZoomParams as b_, type HighlighterToolSettings as ba, type InputToolSettings as bb, type LineToolSettings as bc, type MarkerToolSettings as bd, type NoteToolSettings as be, type PinToolSettings as bf, type PlaceFrame as bg, type PlaceSymbol as bh, type PolygonToolSettings as bi, type RouteToolSettings as bj, type TextToolSettings as bk, type ToolSettingsChangeEvent as bl, type ToolSettingsMap as bm, type ToolType as bn, type ToolsController as bo, type CreateActionTriggerParams as bp, type CreatePanelElementsParams as bq, type CreatePanelParams as br, type DeletePanelElementsParams as bs, type UiOnMapInteractionsOptions as bt, type UpdateActionTriggerParams as bu, type UpdatePanelElementsParams as bv, type UpdatePanelParams as bw, type PlacementForUIElement as bx, type UIPanel as by, type UIPanelCreate as bz, type ElementChangeCallbackParams as c, type ViewportFitBoundsParams as c0, type ViewportState as c1, type ViewportController as c2, type UnwrapPromise as c3, uiActionTriggerSchema as c4, type UIPanelElementCreateClonable as c5, uiPanelCreateSchema as c6, type UIButtonElementCreateClonable as c7, type MakeClonableSchema as c8, type PromiseOrNot as c9, type UnionToIntersection as ca, type ElementCreate as d, type ElementGroup as e, type ElementGroupChangeCallbackParams as f, type ElementUpdate as g, type GetElementsConstraint as h, type HighlighterElementRead as i, type HighlighterElementUpdate as j, type ImageElementRead as k, type ImageElementUpdate as l, type MarkerElementRead as m, type MarkerElementUpdate as n, type NoteElementRead as o, type NoteElementUpdate as p, type PathElementRead as q, type PathElementUpdate as r, type PlaceElementCreate as s, type PlaceElementRead as t, type PlaceElementUpdate as u, type PolygonElementCreate as v, type PolygonElementRead as w, type PolygonElementUpdate as x, type TextElementRead as y, type zInfer as z };
+export { type LayerChangeCallbackParams as $, type TextElementUpdate as A, type ElementsController as B, type CircleElementCreate as C, type MapInteractionEvent as D, type Element as E, type FeltController as F, type GetElementGroupsConstraint as G, type HighlighterElementCreate as H, type ImageElementCreate as I, type InteractionsController as J, type CreateLayersFromGeoJsonParams as K, type LinkElementRead as L, type MarkerElementCreate as M, type NoteElementCreate as N, type DataOnlyLayer as O, type PathElementCreate as P, type FeltTiledVectorSource as Q, type GeoJsonDataVectorSource as R, type GeoJsonFileVectorSource as S, type TextElementCreate as T, type UiControlsOptions as U, type ViewportCenterZoom as V, type GeoJsonUrlVectorSource as W, type GetLayerGroupsConstraint as X, type GetLayersConstraint as Y, type GetRenderedFeaturesConstraint as Z, type Layer as _, type CircleElementRead as a, type LngLatTuple as a$, type LayerCommon as a0, type LayerGroup as a1, type LayerGroupChangeCallbackParams as a2, type LayerProcessingStatus as a3, type LegendItem as a4, type LegendItemChangeCallbackParams as a5, type LegendItemIdentifier as a6, type LegendItemsConstraint as a7, type RasterBand as a8, type RasterLayer as a9, type GetLayerCategoriesParams as aA, type GetLayerHistogramBin as aB, type GetLayerHistogramParams as aC, type GetLayerPrecomputedCalculationParams as aD, type GridConfig as aE, type GridType as aF, type MultiAggregationConfig as aG, type PrecomputedAggregationMethod as aH, type ValueConfiguration as aI, type LayersController as aJ, type MapDetails as aK, type MiscController as aL, type ElementGroupNode as aM, type ElementNode as aN, type EntityNode as aO, type FeatureNode as aP, type FeatureSelection as aQ, type LayerGroupNode as aR, type LayerNode as aS, type SelectionController as aT, type FeltBoundary as aU, type FeltZoom as aV, type GeoJsonFeature as aW, type GeoJsonGeometry as aX, type GeoJsonProperties as aY, type LatLng as aZ, type LineStringGeometry as a_, type RasterLayerSource as aa, type UpdateLayerParams as ab, type VectorLayer as ac, type LayerFeature as ad, type RasterValue as ae, type LayerSchema as af, type LayerSchemaAttribute as ag, type LayerSchemaBooleanAttribute as ah, type LayerSchemaCommonAttribute as ai, type LayerSchemaDateAttribute as aj, type LayerSchemaDateTimeAttribute as ak, type LayerSchemaNumericAttribute as al, type LayerSchemaTextAttribute as am, type FilterExpression as an, type FilterLogicGate as ao, type FilterTernary as ap, type Filters as aq, type GeometryFilter as ar, type LayerBoundaries as as, type LayerFilters as at, type AggregatedGridConfig as au, type AggregationConfig as av, type AggregationMethod as aw, type CountGridConfig as ax, type GetLayerCalculationParams as ay, type GetLayerCategoriesGroup as az, type CircleElementUpdate as b, type ViewportFitBoundsParams as b$, type MultiLineStringGeometry as b0, type MultiPointGeometry as b1, type MultiPolygonGeometry as b2, type PointGeometry as b3, type PolygonGeometry as b4, type SetVisibilityRequest as b5, type SortConfig as b6, type SortDirection as b7, type CircleToolSettings as b8, type ConfigurableToolType as b9, type UIButtonElementCreate as bA, type UIButtonElementUpdate as bB, type UITextElement as bC, type UITextElementCreate as bD, type UITextElementUpdate as bE, type UIFlexibleSpaceElement as bF, type UIFlexibleSpaceElementCreate as bG, type UIFlexibleSpaceElementUpdate as bH, type UIDividerElement as bI, type UIDividerElementCreate as bJ, type UIDividerElementUpdate as bK, type UITextInputElement as bL, type UITextInputElementCreate as bM, type UITextInputElementUpdate as bN, type UISelectElement as bO, type UISelectElementCreate as bP, type UISelectElementUpdate as bQ, type UIPanelElement as bR, type UIPanelElementCreate as bS, type UIPanelElementUpdate as bT, type UIGridContainerElement as bU, type UIGridContainerElementCreate as bV, type UIGridContainerElementUpdate as bW, type UIActionTriggerCreate as bX, type UiController as bY, type SetViewportCenterZoomParams as bZ, type ViewportConstraints as b_, type HighlighterToolSettings as ba, type InputToolSettings as bb, type LineToolSettings as bc, type MarkerToolSettings as bd, type NoteToolSettings as be, type PinToolSettings as bf, type PlaceFrame as bg, type PlaceSymbol as bh, type PolygonToolSettings as bi, type RouteToolSettings as bj, type TextToolSettings as bk, type ToolSettingsChangeEvent as bl, type ToolSettingsMap as bm, type ToolType as bn, type ToolsController as bo, type CreateActionTriggerParams as bp, type CreateOrUpdatePanelParams as bq, type CreatePanelElementsParams as br, type DeletePanelElementsParams as bs, type UiOnMapInteractionsOptions as bt, type UpdateActionTriggerParams as bu, type UpdatePanelElementsParams as bv, type PlacementForUIElement as bw, type UIPanel as bx, type UIPanelCreateOrUpdate as by, type UIButtonElement as bz, type ElementChangeCallbackParams as c, type ViewportState as c0, type ViewportController as c1, type UnwrapPromise as c2, uiActionTriggerSchema as c3, type UIPanelElementCreateClonable as c4, uiPanelCreateSchema as c5, type UIButtonElementCreateClonable as c6, type MakeClonableSchema as c7, type PromiseOrNot as c8, type UnionToIntersection as c9, type ElementCreate as d, type ElementGroup as e, type ElementGroupChangeCallbackParams as f, type ElementUpdate as g, type GetElementsConstraint as h, type HighlighterElementRead as i, type HighlighterElementUpdate as j, type ImageElementRead as k, type ImageElementUpdate as l, type MarkerElementRead as m, type MarkerElementUpdate as n, type NoteElementRead as o, type NoteElementUpdate as p, type PathElementRead as q, type PathElementUpdate as r, type PlaceElementCreate as s, type PlaceElementRead as t, type PlaceElementUpdate as u, type PolygonElementCreate as v, type PolygonElementRead as w, type PolygonElementUpdate as x, type TextElementRead as y, type zInfer as z };