@feltmaps/js-sdk 1.7.0-next.15 → 1.7.0-next.17

package/dist/controller-bundled.d.ts

@@ -9670,245 +9670,7 @@ interface UIButtonElementCreateClonable extends MakeClonableSchema<UIButtonEleme
 interface UIButtonElementUpdate extends MakeUpdateSchema<UIButtonElement, UIButtonElementCreate> {
 }
 
-declare const uiFlexibleSpaceElementSchema: ZodObject<objectUtil.extendShape<objectUtil.extendShape<{
-    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;
-}>, {
-    type: ZodLiteral<"FlexibleSpace">;
-}>, "strip", ZodTypeAny, {
-    type: "FlexibleSpace";
-    id: string;
-    onCreate?: ((args_0: {
-        id: string;
-    }, ...args: unknown[]) => void) | undefined;
-    onDestroy?: ((args_0: {
-        id: string;
-    }, ...args: unknown[]) => void) | undefined;
-}, {
-    type: "FlexibleSpace";
-    id: string;
-    onCreate?: ((args_0: {
-        id: string;
-    }, ...args: unknown[]) => void) | undefined;
-    onDestroy?: ((args_0: {
-        id: string;
-    }, ...args: unknown[]) => void) | undefined;
-}>;
-/**
- * Represents a flexible space element in a container.
- *
- * When rendered...
- *
- * - inside {@link UIGridContainerElement}, it will add extra gap between items. It can be controlled by `grid` property.
- * - inside {@link UIPanelElement} `body` or `footer`, since they work as vertically stacks, it will add extra gap between items.
- * - inside {@link UIButtonGroupElement}, it will take the remaining space.
- *
- * @example
- * Buttons with a flexible space between makes them more visually separated.
- * ```typescript
- * {
- *   type: "ButtonGroup",
- *   items: [
- *     { type: "Button", label: "Button 1", onClick: () => {} },
- *     { type: "FlexibleSpace" },
- *     { type: "Button", label: "Button 2", onClick: () => {} },
- *   ],
- * }
- * ```
- *
- * @example
- * Paragraphs with a flexible space between makes them more visually separated.
- * ```typescript
- * {
- *   type: "Panel",
- *   body: [
- *     { type: "Paragraph", text: "Paragraph 1" },
- *     { type: "FlexibleSpace" },
- *     { type: "Paragraph", text: "Paragraph 2" },
- *   ],
- * }
- * ```
- *
- * @example
- * Horizontal stack of buttons with a flexible space between makes them more visually separated.
- * ```typescript
- * {
- *   type: "Grid",
- *   grid: "auto-flow / auto 1fr auto",
- *   items: [
- *     { type: "Button", label: "Button 1", onClick: () => {} },
- *     { type: "FlexibleSpace" },
- *     { type: "Button", label: "Button 2", onClick: () => {} },
- *   ],
- * }
- * ```
- */
-interface UIFlexibleSpaceElement extends UIElementBase, Omit<zInfer<typeof uiFlexibleSpaceElementSchema>, "onCreate" | "onDestroy"> {
-}
-/**
- * The parameters for creating a flexible space element.
- *
- * @remarks
- * `id` is optional but recommended if you want to be able to perform updates.
- */
-interface UIFlexibleSpaceElementCreate extends Omit<UIFlexibleSpaceElement, "id">, UIElementBaseCreateParams {
-}
-type UIFlexibleSpaceElementCreateClonable = MakeClonableSchema<UIFlexibleSpaceElementCreate>;
-/**
- * The parameters for updating a flexible space element.
- *
- * See {@link UIFlexibleSpaceElement} for more details.
- *
- * @remarks
- * `id` and `type` are required to identify the element to update.
- */
-interface UIFlexibleSpaceElementUpdate extends MakeUpdateSchema<UIFlexibleSpaceElement, UIFlexibleSpaceElementCreate> {
-}
-
-declare const uiTextElementSchema: ZodObject<objectUtil.extendShape<objectUtil.extendShape<{
-    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;
-}>, {
-    type: ZodLiteral<"Text">;
-    /**
-     * The text to display in the element.
-     */
-    content: ZodString;
-}>, "strip", ZodTypeAny, {
-    type: "Text";
-    id: string;
-    content: string;
-    onCreate?: ((args_0: {
-        id: string;
-    }, ...args: unknown[]) => void) | undefined;
-    onDestroy?: ((args_0: {
-        id: string;
-    }, ...args: unknown[]) => void) | undefined;
-}, {
-    type: "Text";
-    id: string;
-    content: string;
-    onCreate?: ((args_0: {
-        id: string;
-    }, ...args: unknown[]) => void) | undefined;
-    onDestroy?: ((args_0: {
-        id: string;
-    }, ...args: unknown[]) => void) | undefined;
-}>;
-/**
- * Represents a text element in a panel.
- * Markdown is supported.
- *
- * @example
- * #### simple
- * ```typescript
- * {
- *   type: "Text",
- *   content: "Hello, world!",
- * }
- * ```
- *
- * @example
- * #### with links
- * ```typescript
- * {
- *   type: "Text",
- *   content: "Fill the form https://www.google.com.",
- * }
- * ```
- *
- * @example
- * #### markdown
- * ```typescript
- * {
- *   type: "Text",
- *   content: "**Hello**, _world_!",
- * }
- * ```
- *
- * @example
- * #### complex markdown
- * Complex markdown syntax is supported like tables, images, quotes, etc.
- * ```typescript
- * {
- *   type: "Text",
- *   content: `
- *
- * ## Heading
- *
- * This is a paragraph.
- *
- * ### Subheading
- *
- * This is a paragraph.
- *
- * | Name | Age |
- * | ---- | --- |
- * | John | 25 |
- * | Jane | 30 |
- *
- * ![Image](https://via.placeholder.com/150)
- *
- * > This is a quote.
- *
- * [Link](https://www.google.com)
- * `,
- * }
- * ```
- */
-interface UITextElement extends UIElementBase, Omit<zInfer<typeof uiTextElementSchema>, "onCreate" | "onDestroy"> {
-}
-/**
- * The parameters for creating a text element.
- *
- * See {@link UITextElement} for more details.
- *
- * @remarks
- * `id` is optional but recommended if you want to be able to perform updates.
- */
-interface UITextElementCreate extends Omit<UITextElement, "id">, UIElementBaseCreateParams {
-}
-type UITextElementCreateClonable = MakeClonableSchema<UITextElementCreate>;
-/**
- * The parameters for updating a text element.
- *
- * See {@link UITextElement} for more details.
- *
- * @remarks
- * `id` and `type` are required to identify the element to update.
- */
-interface UITextElementUpdate extends MakeUpdateSchema<UITextElement, UITextElementCreate> {
-}
-
-declare const uiButtonGroupElementSchema: ZodObject<objectUtil.extendShape<objectUtil.extendShape<{
+declare const uiDividerElementSchema: ZodObject<objectUtil.extendShape<objectUtil.extendShape<{
     onCreate: ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
         id: ZodString;
     }, "strip", ZodTypeAny, {
@@ -9926,239 +9688,19 @@ declare const uiButtonGroupElementSchema: ZodObject<objectUtil.extendShape<objec
 }, {
     id: ZodString;
 }>, {
-    type: ZodLiteral<"ButtonGroup">;
-    /**
-     * The alignment of the button group.
-     *
-     * @defaultValue `"end"`
-     */
-    align: ZodOptional<ZodEnum<["start", "end"]>>;
-    items: ZodArray<ZodUnion<[ZodObject<objectUtil.extendShape<objectUtil.extendShape<{
-        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;
-    }>, {
-        type: ZodLiteral<"Button">;
-        label: ZodString;
-        variant: ZodOptional<ZodEnum<["filled", "transparent", "outlined"]>>;
-        tint: ZodOptional<ZodEnum<["default", "primary", "accent", "danger"]>>;
-        disabled: ZodOptional<ZodBoolean>;
-        onClick: ZodFunction<ZodTuple<[ZodObject<{
-            id: ZodString;
-        }, "strip", ZodTypeAny, {
-            id: string;
-        }, {
-            id: string;
-        }>], ZodUnknown>, ZodVoid>;
-    }>, "strip", ZodTypeAny, {
-        type: "Button";
-        id: string;
-        label: string;
-        onClick: (args_0: {
-            id: string;
-        }, ...args: unknown[]) => void;
-        onCreate?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        onDestroy?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        disabled?: boolean | undefined;
-        variant?: "filled" | "transparent" | "outlined" | undefined;
-        tint?: "default" | "primary" | "accent" | "danger" | undefined;
-    }, {
-        type: "Button";
-        id: string;
-        label: string;
-        onClick: (args_0: {
-            id: string;
-        }, ...args: unknown[]) => void;
-        onCreate?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        onDestroy?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        disabled?: boolean | undefined;
-        variant?: "filled" | "transparent" | "outlined" | undefined;
-        tint?: "default" | "primary" | "accent" | "danger" | undefined;
-    }>, ZodObject<objectUtil.extendShape<objectUtil.extendShape<{
-        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;
-    }>, {
-        type: ZodLiteral<"Text">;
-        content: ZodString;
-    }>, "strip", ZodTypeAny, {
-        type: "Text";
-        id: string;
-        content: string;
-        onCreate?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        onDestroy?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-    }, {
-        type: "Text";
-        id: string;
-        content: string;
-        onCreate?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        onDestroy?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-    }>, ZodObject<objectUtil.extendShape<objectUtil.extendShape<{
-        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;
-    }>, {
-        type: ZodLiteral<"FlexibleSpace">;
-    }>, "strip", ZodTypeAny, {
-        type: "FlexibleSpace";
-        id: string;
-        onCreate?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        onDestroy?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-    }, {
-        type: "FlexibleSpace";
-        id: string;
-        onCreate?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        onDestroy?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-    }>]>, "many">;
+    type: ZodLiteral<"Divider">;
 }>, "strip", ZodTypeAny, {
-    type: "ButtonGroup";
+    type: "Divider";
     id: string;
-    items: ({
-        type: "Button";
-        id: string;
-        label: string;
-        onClick: (args_0: {
-            id: string;
-        }, ...args: unknown[]) => void;
-        onCreate?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        onDestroy?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        disabled?: boolean | undefined;
-        variant?: "filled" | "transparent" | "outlined" | undefined;
-        tint?: "default" | "primary" | "accent" | "danger" | undefined;
-    } | {
-        type: "Text";
-        id: string;
-        content: string;
-        onCreate?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        onDestroy?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-    } | {
-        type: "FlexibleSpace";
-        id: string;
-        onCreate?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        onDestroy?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-    })[];
-    align?: "start" | "end" | undefined;
     onCreate?: ((args_0: {
         id: string;
     }, ...args: unknown[]) => void) | undefined;
     onDestroy?: ((args_0: {
         id: string;
-    }, ...args: unknown[]) => void) | undefined;
-}, {
-    type: "ButtonGroup";
-    id: string;
-    items: ({
-        type: "Button";
-        id: string;
-        label: string;
-        onClick: (args_0: {
-            id: string;
-        }, ...args: unknown[]) => void;
-        onCreate?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        onDestroy?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        disabled?: boolean | undefined;
-        variant?: "filled" | "transparent" | "outlined" | undefined;
-        tint?: "default" | "primary" | "accent" | "danger" | undefined;
-    } | {
-        type: "Text";
-        id: string;
-        content: string;
-        onCreate?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        onDestroy?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-    } | {
-        type: "FlexibleSpace";
-        id: string;
-        onCreate?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-        onDestroy?: ((args_0: {
-            id: string;
-        }, ...args: unknown[]) => void) | undefined;
-    })[];
-    align?: "start" | "end" | undefined;
+    }, ...args: unknown[]) => void) | undefined;
+}, {
+    type: "Divider";
+    id: string;
     onCreate?: ((args_0: {
         id: string;
     }, ...args: unknown[]) => void) | undefined;
@@ -10167,60 +9709,50 @@ declare const uiButtonGroupElementSchema: ZodObject<objectUtil.extendShape<objec
     }, ...args: unknown[]) => void) | undefined;
 }>;
 /**
- * Represents a button group element in a panel.
- * A button group is an horizontal container of buttons and text elements.
+ * Represents a divider element in a panel.
+ * This element is used to separate other elements in a panel.
+ * It is rendered as a gray horizontal line of 1px height.
  *
  * @example
- * Thanks to the FlexibleSpace element, button 1 and text 1 are aligned to the start of the panel,
- * while button 2 is aligned to the end.
- *
+ * Divider element is useful to separate sections of a panel.
  * ```typescript
  * {
- *   type: "ButtonGroup",
- *   items: [
- *     { type: "Button", label: "Button 1", onClick: () => {} },
- *     { type: "Text", content: "Text 1" },
- *     { type: "FlexibleSpace" },
- *     { type: "Button", label: "Button 2", onClick: () => {} },
+ *   body: [
+ *     { type: "Text", content: "Contact" },
+ *     { type: "TextInput", placeholder: "Enter your name", ... },
+ *     { type: "TextInput", placeholder: "Enter your email", ... },
+ *     { type: "Divider" },
+ *     { type: "Text", content: "Address" },
+ *     { type: "TextInput", placeholder: "Enter your address", ... },
  *   ],
  * }
  * ```
  */
-interface UIButtonGroupElement extends UIElementBase, Omit<zInfer<typeof uiButtonGroupElementSchema>, "onCreate" | "onDestroy"> {
-    /**
-     * The items to add to the button group.
-     */
-    items: Array<UIButtonElement | UITextElement | UIFlexibleSpaceElement>;
+interface UIDividerElement extends UIElementBase, Omit<zInfer<typeof uiDividerElementSchema>, "onCreate" | "onDestroy"> {
 }
 /**
- * The parameters for creating a button group element.
+ * The parameters for creating a divider element.
  *
- * See {@link UIButtonGroupElement} for more details.
+ * See {@link UIDividerElement} for more details.
  *
  * @remarks
- * `id` is optional but recommended if you want to be able to perform updates.
+ * `id` is optional but recommended if you want to be able to delete the element.
  */
-interface UIButtonGroupElementCreate extends Omit<UIButtonGroupElement, "id" | "items">, UIElementBaseCreateParams {
-    /**
-     * The items to add to the button group.
-     */
-    items: Array<UIButtonElementCreate | UITextElementCreate | UIFlexibleSpaceElementCreate>;
+interface UIDividerElementCreate extends Omit<UIDividerElement, "id">, UIElementBaseCreateParams {
 }
-type UIButtonGroupElementCreateClonable = Omit<MakeClonableSchema<UIButtonGroupElementCreate>, "items"> & {
-    items: Array<UIButtonElementCreateClonable | UITextElementCreateClonable | UIFlexibleSpaceElementCreateClonable>;
-};
+type UIDividerElementCreateClonable = MakeClonableSchema<UIDividerElementCreate>;
 /**
- * The parameters for updating a button group element.
+ * The parameters for updating a divider element.
  *
- * See {@link UIButtonGroupElement} for more details.
+ * See {@link UIDividerElement} for more details.
  *
  * @remarks
- * `id` and `type` are required to update the button group element.
+ * `id` and `type` are required to identify the element to update.
  */
-interface UIButtonGroupElementUpdate extends MakeUpdateSchema<UIButtonGroupElement, UIButtonGroupElementCreate> {
+interface UIDividerElementUpdate extends MakeUpdateSchema<UIDividerElement, UIDividerElementCreate> {
 }
 
-declare const uiDividerElementSchema: ZodObject<objectUtil.extendShape<objectUtil.extendShape<{
+declare const uiFlexibleSpaceElementSchema: ZodObject<objectUtil.extendShape<objectUtil.extendShape<{
     onCreate: ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
         id: ZodString;
     }, "strip", ZodTypeAny, {
@@ -10238,9 +9770,9 @@ declare const uiDividerElementSchema: ZodObject<objectUtil.extendShape<objectUti
 }, {
     id: ZodString;
 }>, {
-    type: ZodLiteral<"Divider">;
+    type: ZodLiteral<"FlexibleSpace">;
 }>, "strip", ZodTypeAny, {
-    type: "Divider";
+    type: "FlexibleSpace";
     id: string;
     onCreate?: ((args_0: {
         id: string;
@@ -10249,7 +9781,7 @@ declare const uiDividerElementSchema: ZodObject<objectUtil.extendShape<objectUti
         id: string;
     }, ...args: unknown[]) => void) | undefined;
 }, {
-    type: "Divider";
+    type: "FlexibleSpace";
     id: string;
     onCreate?: ((args_0: {
         id: string;
@@ -10259,47 +9791,60 @@ declare const uiDividerElementSchema: ZodObject<objectUtil.extendShape<objectUti
     }, ...args: unknown[]) => void) | undefined;
 }>;
 /**
- * Represents a divider element in a panel.
- * This element is used to separate other elements in a panel.
- * It is rendered as a gray horizontal line of 1px height.
+ * Represents a flexible space element in a container.
+ *
+ * When rendered...
+ *
+ * - inside {@link UIGridContainerElement}, it will add extra gap between items. It can be controlled by `grid` property.
+ * - inside {@link UIPanelElement} `body` or `footer`, since they work as vertically stacks, it will add extra gap between items.
  *
  * @example
- * Divider element is useful to separate sections of a panel.
+ * Paragraphs with a flexible space between makes them more visually separated.
  * ```typescript
  * {
+ *   type: "Panel",
  *   body: [
- *     { type: "Text", content: "Contact" },
- *     { type: "TextInput", placeholder: "Enter your name", ... },
- *     { type: "TextInput", placeholder: "Enter your email", ... },
- *     { type: "Divider" },
- *     { type: "Text", content: "Address" },
- *     { type: "TextInput", placeholder: "Enter your address", ... },
+ *     { type: "Paragraph", text: "Paragraph 1" },
+ *     { type: "FlexibleSpace" },
+ *     { type: "Paragraph", text: "Paragraph 2" },
+ *   ],
+ * }
+ * ```
+ *
+ * @example
+ * Horizontal stack of buttons with a flexible space between makes them more visually separated.
+ * ```typescript
+ * {
+ *   type: "Grid",
+ *   grid: "auto-flow / auto 1fr auto",
+ *   items: [
+ *     { type: "Button", label: "Button 1", onClick: () => {} },
+ *     { type: "FlexibleSpace" },
+ *     { type: "Button", label: "Button 2", onClick: () => {} },
  *   ],
  * }
  * ```
  */
-interface UIDividerElement extends UIElementBase, Omit<zInfer<typeof uiDividerElementSchema>, "onCreate" | "onDestroy"> {
+interface UIFlexibleSpaceElement extends UIElementBase, Omit<zInfer<typeof uiFlexibleSpaceElementSchema>, "onCreate" | "onDestroy"> {
 }
 /**
- * The parameters for creating a divider element.
- *
- * See {@link UIDividerElement} for more details.
+ * The parameters for creating a flexible space element.
  *
  * @remarks
- * `id` is optional but recommended if you want to be able to delete the element.
+ * `id` is optional but recommended if you want to be able to perform updates.
  */
-interface UIDividerElementCreate extends Omit<UIDividerElement, "id">, UIElementBaseCreateParams {
+interface UIFlexibleSpaceElementCreate extends Omit<UIFlexibleSpaceElement, "id">, UIElementBaseCreateParams {
 }
-type UIDividerElementCreateClonable = MakeClonableSchema<UIDividerElementCreate>;
+type UIFlexibleSpaceElementCreateClonable = MakeClonableSchema<UIFlexibleSpaceElementCreate>;
 /**
- * The parameters for updating a divider element.
+ * The parameters for updating a flexible space element.
  *
- * See {@link UIDividerElement} for more details.
+ * See {@link UIFlexibleSpaceElement} for more details.
  *
  * @remarks
  * `id` and `type` are required to identify the element to update.
  */
-interface UIDividerElementUpdate extends MakeUpdateSchema<UIDividerElement, UIDividerElementCreate> {
+interface UIFlexibleSpaceElementUpdate extends MakeUpdateSchema<UIFlexibleSpaceElement, UIFlexibleSpaceElementCreate> {
 }
 
 declare const uiSelectElementSchema: ZodObject<objectUtil.extendShape<objectUtil.extendShape<objectUtil.extendShape<{
@@ -10427,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
  * {
@@ -10601,72 +10162,201 @@ declare const uiTextInputElementSchema: ZodObject<objectUtil.extendShape<objectU
  * ```
  *
  * @example
- * #### with label
+ * #### with label
+ * ```typescript
+ * {
+ *   type: "TextInput",
+ *   label: "Name",
+ *   value: "Hello",
+ *   onChange: (args) => console.log(args.value),
+ *   placeholder: "Enter your name",
+ * }
+ * ```
+ */
+interface UITextInputElement extends UILabelReadyElement, Omit<zInfer<typeof uiTextInputElementSchema>, "onChange" | "onBlur" | "onFocus" | "onCreate" | "onDestroy"> {
+    /**
+     * The function to call when the value of the input changes.
+     *
+     * @param args - The arguments passed to the function.
+     * @param args.value - The value of the input.
+     * @param args.id - The id of the input element.
+     */
+    onChange?: (args: {
+        value: string;
+        id: string;
+    }) => void;
+    /**
+     * The function to call when the input is blurred.
+     *
+     * @param args - The arguments passed to the function.
+     * @param args.value - The value of the input.
+     * @param args.id - The id of the input element.
+     */
+    onBlur?: (args: {
+        value: string;
+        id: string;
+    }) => void;
+    /**
+     * The function to call when the input is focused.
+     *
+     * @param args - The arguments passed to the function.
+     * @param args.value - The value of the input.
+     * @param args.id - The id of the input element.
+     */
+    onFocus?: (args: {
+        value: string;
+        id: string;
+    }) => void;
+}
+/**
+ * The parameters for creating a text input element.
+ *
+ * See {@link UITextInputElement} for more details.
+ *
+ * @remarks
+ * `id` is optional but recommended if you want to be able to perform updates.
+ */
+interface UITextInputElementCreate extends Omit<UITextInputElement, "id">, UILabelReadyElementCreateParams {
+}
+type UITextInputElementCreateClonable = MakeClonableSchema<UITextInputElementCreate>;
+/**
+ * The parameters for updating a text input element.
+ *
+ * See {@link UITextInputElement} for more details.
+ *
+ * @remarks
+ * `id` and `type` are required to identify the element to update.
+ */
+interface UITextInputElementUpdate extends MakeUpdateSchema<UITextInputElement, UITextInputElementCreate> {
+}
+
+declare const uiTextElementSchema: ZodObject<objectUtil.extendShape<objectUtil.extendShape<{
+    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;
+}>, {
+    type: ZodLiteral<"Text">;
+    /**
+     * The text to display in the element.
+     */
+    content: ZodString;
+}>, "strip", ZodTypeAny, {
+    type: "Text";
+    id: string;
+    content: string;
+    onCreate?: ((args_0: {
+        id: string;
+    }, ...args: unknown[]) => void) | undefined;
+    onDestroy?: ((args_0: {
+        id: string;
+    }, ...args: unknown[]) => void) | undefined;
+}, {
+    type: "Text";
+    id: string;
+    content: string;
+    onCreate?: ((args_0: {
+        id: string;
+    }, ...args: unknown[]) => void) | undefined;
+    onDestroy?: ((args_0: {
+        id: string;
+    }, ...args: unknown[]) => void) | undefined;
+}>;
+/**
+ * Represents a text element in a panel.
+ * Markdown is supported.
+ *
+ * @example
+ * #### simple
+ * ```typescript
+ * {
+ *   type: "Text",
+ *   content: "Hello, world!",
+ * }
+ * ```
+ *
+ * @example
+ * #### with links
+ * ```typescript
+ * {
+ *   type: "Text",
+ *   content: "Fill the form https://www.google.com.",
+ * }
+ * ```
+ *
+ * @example
+ * #### markdown
+ * ```typescript
+ * {
+ *   type: "Text",
+ *   content: "**Hello**, _world_!",
+ * }
+ * ```
+ *
+ * @example
+ * #### complex markdown
+ * Complex markdown syntax is supported like tables, images, quotes, etc.
  * ```typescript
  * {
- *   type: "TextInput",
- *   label: "Name",
- *   value: "Hello",
- *   onChange: (args) => console.log(args.value),
- *   placeholder: "Enter your name",
+ *   type: "Text",
+ *   content: `
+ *
+ * ## Heading
+ *
+ * This is a paragraph.
+ *
+ * ### Subheading
+ *
+ * This is a paragraph.
+ *
+ * | Name | Age |
+ * | ---- | --- |
+ * | John | 25 |
+ * | Jane | 30 |
+ *
+ * ![Image](https://via.placeholder.com/150)
+ *
+ * > This is a quote.
+ *
+ * [Link](https://www.google.com)
+ * `,
  * }
  * ```
  */
-interface UITextInputElement extends UILabelReadyElement, Omit<zInfer<typeof uiTextInputElementSchema>, "onChange" | "onBlur" | "onFocus" | "onCreate" | "onDestroy"> {
-    /**
-     * The function to call when the value of the input changes.
-     *
-     * @param args - The arguments passed to the function.
-     * @param args.value - The value of the input.
-     * @param args.id - The id of the input element.
-     */
-    onChange?: (args: {
-        value: string;
-        id: string;
-    }) => void;
-    /**
-     * The function to call when the input is blurred.
-     *
-     * @param args - The arguments passed to the function.
-     * @param args.value - The value of the input.
-     * @param args.id - The id of the input element.
-     */
-    onBlur?: (args: {
-        value: string;
-        id: string;
-    }) => void;
-    /**
-     * The function to call when the input is focused.
-     *
-     * @param args - The arguments passed to the function.
-     * @param args.value - The value of the input.
-     * @param args.id - The id of the input element.
-     */
-    onFocus?: (args: {
-        value: string;
-        id: string;
-    }) => void;
+interface UITextElement extends UIElementBase, Omit<zInfer<typeof uiTextElementSchema>, "onCreate" | "onDestroy"> {
 }
 /**
- * The parameters for creating a text input element.
+ * The parameters for creating a text element.
  *
- * See {@link UITextInputElement} for more details.
+ * See {@link UITextElement} for more details.
  *
  * @remarks
  * `id` is optional but recommended if you want to be able to perform updates.
  */
-interface UITextInputElementCreate extends Omit<UITextInputElement, "id">, UILabelReadyElementCreateParams {
+interface UITextElementCreate extends Omit<UITextElement, "id">, UIElementBaseCreateParams {
 }
-type UITextInputElementCreateClonable = MakeClonableSchema<UITextInputElementCreate>;
+type UITextElementCreateClonable = MakeClonableSchema<UITextElementCreate>;
 /**
- * The parameters for updating a text input element.
+ * The parameters for updating a text element.
  *
- * See {@link UITextInputElement} for more details.
+ * See {@link UITextElement} for more details.
  *
  * @remarks
  * `id` and `type` are required to identify the element to update.
  */
-interface UITextInputElementUpdate extends MakeUpdateSchema<UITextInputElement, UITextInputElementCreate> {
+interface UITextElementUpdate extends MakeUpdateSchema<UITextElement, UITextElementCreate> {
 }
 
 type ItemCreateClonableType = Exclude<UIPanelElementCreateClonable, {
@@ -10810,22 +10500,22 @@ type UIGridContainerElementCreateClonable = Omit<MakeClonableSchema<UIGridContai
 interface UIGridContainerElementUpdate extends MakeUpdateSchema<UIGridContainerElement, UIGridContainerElementCreate> {
 }
 
-type UIPanelElement = UIButtonElement | UITextElement | UIButtonGroupElement | UIDividerElement | UITextInputElement | UISelectElement | UIFlexibleSpaceElement | UIGridContainerElement;
+type UIPanelElement = UIButtonElement | UITextElement | UIDividerElement | UITextInputElement | UISelectElement | UIFlexibleSpaceElement | UIGridContainerElement;
 /**
  * This is a union of all the possible elements that can be created inside panel's body or footer.
  *
  * @remarks
  * For the sake of convenience, `id` is optional but recommended if you want to be able to perform updates.
  */
-type UIPanelElementCreate = UIButtonElementCreate | UITextElementCreate | UIButtonGroupElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate | UIGridContainerElementCreate;
-type UIPanelElementCreateClonable = UIButtonElementCreateClonable | UITextElementCreateClonable | UIButtonGroupElementCreateClonable | UIDividerElementCreateClonable | UITextInputElementCreateClonable | UISelectElementCreateClonable | UIFlexibleSpaceElementCreateClonable | UIGridContainerElementCreateClonable;
+type UIPanelElementCreate = UIButtonElementCreate | UITextElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate | UIGridContainerElementCreate;
+type UIPanelElementCreateClonable = UIButtonElementCreateClonable | UITextElementCreateClonable | UIDividerElementCreateClonable | UITextInputElementCreateClonable | UISelectElementCreateClonable | UIFlexibleSpaceElementCreateClonable | UIGridContainerElementCreateClonable;
 /**
  * This is a union of all the possible elements that can be updated inside panel's body or footer (excluding Divider and FlexibleSpace elements because they cannot be updated).
  *
  * @remarks
  * `id` and `type` are required to identify the element to update.
  */
-type UIPanelElementUpdate = UIButtonElementUpdate | UITextElementUpdate | UIButtonGroupElementUpdate | UITextInputElementUpdate | UISelectElementUpdate | UIDividerElementUpdate | UIGridContainerElementUpdate | UIFlexibleSpaceElementUpdate;
+type UIPanelElementUpdate = UIButtonElementUpdate | UITextElementUpdate | UITextInputElementUpdate | UISelectElementUpdate | UIDividerElementUpdate | UIGridContainerElementUpdate | UIFlexibleSpaceElementUpdate;
 
 declare const placementForUiElementSchema: ZodUnion<[ZodObject<{
     after: ZodString;
@@ -10847,7 +10537,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" }`.
@@ -10880,7 +10570,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.
      */
@@ -10895,7 +10585,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;
@@ -10903,6 +10592,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;
@@ -10910,7 +10600,6 @@ declare const uiPanelSchema: ZodObject<objectUtil.extendShape<objectUtil.extendS
 }, {
     type: "Panel";
     id: string;
-    body: UIPanelElement[];
     onCreate?: ((args_0: {
         id: string;
     }, ...args: unknown[]) => void) | undefined;
@@ -10918,6 +10607,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;
@@ -10925,7 +10615,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.
@@ -10943,8 +10633,6 @@ declare const uiPanelSchema: ZodObject<objectUtil.extendShape<objectUtil.extendS
  *
  * #### Footer
  * Footer is sticky to the bottom of the panel, and can be used to add actions to the panel (e.g. save, cancel, etc.).
- * Normally, it should contain a `ButtonGroup` element with a `Cancel` and `Save` button. Using `ButtonGroup` is recommended
- * because it will automatically align the buttons to the end of the panel giving it a nice look.
  *
  * @example
  * #### basic
@@ -10977,20 +10665,32 @@ declare const uiPanelSchema: ZodObject<objectUtil.extendShape<objectUtil.extendS
  *     { type: "TextInput", label: "Last name", value: "", placeholder: "Doe", onChange: (value) => setLastName(value) },
  *   ],
  *   footer: [
- *     { type: "ButtonGroup", items: [
- *       { type: "Button", label: "Reset", onClick: () => alert("Reset") },
- *       { type: "Button", label: "Save", onClick: () => alert("Save") },
- *     ] },
+ *     {
+ *       type: "Grid",
+ *       grid: "auto-flow / 1fr auto auto",
+ *       items: [
+ *         { type: "FlexibleSpace" }, // this will make the buttons to be aligned to the end of the panel
+ *         { type: "Button", label: "Reset", onClick: () => alert("Reset") },
+ *         { type: "Button", label: "Save", onClick: () => alert("Save") },
+ *       ],
+ *     },
  *   ],
  * }
  * ```
  *
  */
-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.
      */
@@ -11008,7 +10708,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, {
@@ -11024,7 +10724,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;
@@ -11034,12 +10734,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;
@@ -11047,14 +10746,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;
@@ -11062,51 +10761,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;
@@ -11114,46 +10783,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.
      */
@@ -11548,10 +11211,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, {
@@ -11567,7 +11230,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;
@@ -11577,12 +11240,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;
@@ -11590,14 +11252,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;
@@ -11605,6 +11267,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;
@@ -11631,9 +11294,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;
@@ -11641,6 +11303,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;
@@ -11655,9 +11318,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;
@@ -11665,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;
@@ -11679,26 +11342,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;
@@ -11795,7 +11453,7 @@ interface CreatePanelElementsParams extends zInfer<typeof CreatePanelElementsPar
         /**
          * The section of the panel to add the element to.
          * It can be either one of the top-level sections of the panel (`"body"` or `"footer"`)
-         * or a specific container (like `ButtonGroup`) in the panel (`{ id: string }`).
+         * or a specific container (like {@link UIGridContainerElement}) in the panel (`{ id: string }`).
          *
          * @defaultValue `"body"`
          */
@@ -11914,286 +11572,6 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
             content?: string | undefined;
-        }>, ZodObject<{
-            type: ZodLiteral<"ButtonGroup">;
-            id: ZodString;
-            align: ZodOptional<ZodOptional<ZodEnum<["start", "end"]>>>;
-            onCreate: ZodOptional<ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
-                id: ZodString;
-            }, "strip", ZodTypeAny, {
-                id: string;
-            }, {
-                id: string;
-            }>], ZodUnknown>, ZodVoid>>>;
-            onDestroy: ZodOptional<ZodOptional<ZodFunction<ZodTuple<[ZodObject<{
-                id: ZodString;
-            }, "strip", ZodTypeAny, {
-                id: string;
-            }, {
-                id: string;
-            }>], ZodUnknown>, ZodVoid>>>;
-            items: ZodOptional<ZodArray<ZodUnion<[ZodObject<objectUtil.extendShape<objectUtil.extendShape<objectUtil.extendShape<{
-                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;
-            }>, {
-                type: ZodLiteral<"Button">;
-                label: ZodString;
-                variant: ZodOptional<ZodEnum<["filled", "transparent", "outlined"]>>;
-                tint: ZodOptional<ZodEnum<["default", "primary", "accent", "danger"]>>;
-                disabled: ZodOptional<ZodBoolean>;
-                onClick: ZodFunction<ZodTuple<[ZodObject<{
-                    id: ZodString;
-                }, "strip", ZodTypeAny, {
-                    id: string;
-                }, {
-                    id: string;
-                }>], ZodUnknown>, ZodVoid>;
-            }>, {
-                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>>;
-            }>, "strip", ZodTypeAny, {
-                type: "Button";
-                label: string;
-                onClick: (args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                disabled?: boolean | undefined;
-                variant?: "filled" | "transparent" | "outlined" | undefined;
-                tint?: "default" | "primary" | "accent" | "danger" | undefined;
-            }, {
-                type: "Button";
-                label: string;
-                onClick: (args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                disabled?: boolean | undefined;
-                variant?: "filled" | "transparent" | "outlined" | undefined;
-                tint?: "default" | "primary" | "accent" | "danger" | undefined;
-            }>, ZodObject<objectUtil.extendShape<objectUtil.extendShape<objectUtil.extendShape<{
-                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;
-            }>, {
-                type: ZodLiteral<"Text">;
-                content: ZodString;
-            }>, {
-                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>>;
-            }>, "strip", ZodTypeAny, {
-                type: "Text";
-                content: string;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            }, {
-                type: "Text";
-                content: string;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            }>, ZodObject<{
-                type: ZodLiteral<"FlexibleSpace">;
-                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>>;
-            }, "strip", ZodTypeAny, {
-                type: "FlexibleSpace";
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            }, {
-                type: "FlexibleSpace";
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            }>]>, "many">>;
-        }, UnknownKeysParam, ZodTypeAny, {
-            type: "ButtonGroup";
-            id: string;
-            align?: "start" | "end" | undefined;
-            items?: ({
-                type: "Button";
-                label: string;
-                onClick: (args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                disabled?: boolean | undefined;
-                variant?: "filled" | "transparent" | "outlined" | undefined;
-                tint?: "default" | "primary" | "accent" | "danger" | undefined;
-            } | {
-                type: "Text";
-                content: string;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            } | {
-                type: "FlexibleSpace";
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            })[] | undefined;
-            onCreate?: ((args_0: {
-                id: string;
-            }, ...args: unknown[]) => void) | undefined;
-            onDestroy?: ((args_0: {
-                id: string;
-            }, ...args: unknown[]) => void) | undefined;
-        }, {
-            type: "ButtonGroup";
-            id: string;
-            align?: "start" | "end" | undefined;
-            items?: ({
-                type: "Button";
-                label: string;
-                onClick: (args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                disabled?: boolean | undefined;
-                variant?: "filled" | "transparent" | "outlined" | undefined;
-                tint?: "default" | "primary" | "accent" | "danger" | undefined;
-            } | {
-                type: "Text";
-                content: string;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            } | {
-                type: "FlexibleSpace";
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            })[] | undefined;
-            onCreate?: ((args_0: {
-                id: string;
-            }, ...args: unknown[]) => void) | undefined;
-            onDestroy?: ((args_0: {
-                id: string;
-            }, ...args: unknown[]) => void) | undefined;
         }>, ZodObject<{
             type: ZodLiteral<"TextInput">;
             value: ZodOptional<ZodString>;
@@ -12463,11 +11841,11 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }>], ZodUnknown>, ZodVoid>>>;
             grid: ZodOptional<ZodOptional<ZodString>>;
-            items: ZodOptional<ZodType<(UIButtonElementCreate | UITextElementCreate | UIButtonGroupElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[], ZodTypeDef, (UIButtonElementCreate | UITextElementCreate | UIButtonGroupElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[]>>;
+            items: ZodOptional<ZodType<(UIButtonElementCreate | UITextElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[], ZodTypeDef, (UIButtonElementCreate | UITextElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[]>>;
         }, UnknownKeysParam, ZodTypeAny, {
             type: "Grid";
             id: string;
-            items?: (UIButtonElementCreate | UITextElementCreate | UIButtonGroupElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[] | undefined;
+            items?: (UIButtonElementCreate | UITextElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[] | undefined;
             onCreate?: ((args_0: {
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
@@ -12478,7 +11856,7 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
         }, {
             type: "Grid";
             id: string;
-            items?: (UIButtonElementCreate | UITextElementCreate | UIButtonGroupElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[] | undefined;
+            items?: (UIButtonElementCreate | UITextElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[] | undefined;
             onCreate?: ((args_0: {
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
@@ -12514,52 +11892,6 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
             content?: string | undefined;
-        } | {
-            type: "ButtonGroup";
-            id: string;
-            align?: "start" | "end" | undefined;
-            items?: ({
-                type: "Button";
-                label: string;
-                onClick: (args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                disabled?: boolean | undefined;
-                variant?: "filled" | "transparent" | "outlined" | undefined;
-                tint?: "default" | "primary" | "accent" | "danger" | undefined;
-            } | {
-                type: "Text";
-                content: string;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            } | {
-                type: "FlexibleSpace";
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            })[] | undefined;
-            onCreate?: ((args_0: {
-                id: string;
-            }, ...args: unknown[]) => void) | undefined;
-            onDestroy?: ((args_0: {
-                id: string;
-            }, ...args: unknown[]) => void) | undefined;
         } | {
             type: "TextInput";
             id: string;
@@ -12626,7 +11958,7 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
         } | {
             type: "Grid";
             id: string;
-            items?: (UIButtonElementCreate | UITextElementCreate | UIButtonGroupElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[] | undefined;
+            items?: (UIButtonElementCreate | UITextElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[] | undefined;
             onCreate?: ((args_0: {
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
@@ -12662,52 +11994,6 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
             content?: string | undefined;
-        } | {
-            type: "ButtonGroup";
-            id: string;
-            align?: "start" | "end" | undefined;
-            items?: ({
-                type: "Button";
-                label: string;
-                onClick: (args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                disabled?: boolean | undefined;
-                variant?: "filled" | "transparent" | "outlined" | undefined;
-                tint?: "default" | "primary" | "accent" | "danger" | undefined;
-            } | {
-                type: "Text";
-                content: string;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            } | {
-                type: "FlexibleSpace";
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            })[] | undefined;
-            onCreate?: ((args_0: {
-                id: string;
-            }, ...args: unknown[]) => void) | undefined;
-            onDestroy?: ((args_0: {
-                id: string;
-            }, ...args: unknown[]) => void) | undefined;
         } | {
             type: "TextInput";
             id: string;
@@ -12774,7 +12060,7 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
         } | {
             type: "Grid";
             id: string;
-            items?: (UIButtonElementCreate | UITextElementCreate | UIButtonGroupElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[] | undefined;
+            items?: (UIButtonElementCreate | UITextElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[] | undefined;
             onCreate?: ((args_0: {
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
@@ -12813,52 +12099,6 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
             content?: string | undefined;
-        } | {
-            type: "ButtonGroup";
-            id: string;
-            align?: "start" | "end" | undefined;
-            items?: ({
-                type: "Button";
-                label: string;
-                onClick: (args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                disabled?: boolean | undefined;
-                variant?: "filled" | "transparent" | "outlined" | undefined;
-                tint?: "default" | "primary" | "accent" | "danger" | undefined;
-            } | {
-                type: "Text";
-                content: string;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            } | {
-                type: "FlexibleSpace";
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            })[] | undefined;
-            onCreate?: ((args_0: {
-                id: string;
-            }, ...args: unknown[]) => void) | undefined;
-            onDestroy?: ((args_0: {
-                id: string;
-            }, ...args: unknown[]) => void) | undefined;
         } | {
             type: "TextInput";
             id: string;
@@ -12925,7 +12165,7 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
         } | {
             type: "Grid";
             id: string;
-            items?: (UIButtonElementCreate | UITextElementCreate | UIButtonGroupElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[] | undefined;
+            items?: (UIButtonElementCreate | UITextElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[] | undefined;
             onCreate?: ((args_0: {
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
@@ -12964,52 +12204,6 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
             content?: string | undefined;
-        } | {
-            type: "ButtonGroup";
-            id: string;
-            align?: "start" | "end" | undefined;
-            items?: ({
-                type: "Button";
-                label: string;
-                onClick: (args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                disabled?: boolean | undefined;
-                variant?: "filled" | "transparent" | "outlined" | undefined;
-                tint?: "default" | "primary" | "accent" | "danger" | undefined;
-            } | {
-                type: "Text";
-                content: string;
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            } | {
-                type: "FlexibleSpace";
-                id?: string | undefined;
-                onCreate?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-                onDestroy?: ((args_0: {
-                    id: string;
-                }, ...args: unknown[]) => void) | undefined;
-            })[] | undefined;
-            onCreate?: ((args_0: {
-                id: string;
-            }, ...args: unknown[]) => void) | undefined;
-            onDestroy?: ((args_0: {
-                id: string;
-            }, ...args: unknown[]) => void) | undefined;
         } | {
             type: "TextInput";
             id: string;
@@ -13076,7 +12270,7 @@ declare const UpdatePanelElementsParamsSchema: ZodObject<{
         } | {
             type: "Grid";
             id: string;
-            items?: (UIButtonElementCreate | UITextElementCreate | UIButtonGroupElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[] | undefined;
+            items?: (UIButtonElementCreate | UITextElementCreate | UIDividerElementCreate | UITextInputElementCreate | UISelectElementCreate | UIFlexibleSpaceElementCreate)[] | undefined;
             onCreate?: ((args_0: {
                 id: string;
             }, ...args: unknown[]) => void) | undefined;
@@ -13328,29 +12522,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`.
@@ -13358,9 +12567,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: [
      *          {
@@ -13383,32 +12594,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.
      *
@@ -13444,7 +12634,7 @@ interface UiController {
      * @example
      * ```typescript
      * await felt.createPanelElements({
-     *   panelId: "panel-1",
+     *   panelId,
      *   elements: [
      *     {
      *       element: { type: "Text", content: "Hello, world!" },
@@ -13466,7 +12656,7 @@ interface UiController {
      * @example
      * ```typescript
      * await felt.updatePanelElements({
-     *   panelId: "panel-1",
+     *   panelId,
      *   elements: [
      *     {
      *       element: {
@@ -13489,7 +12679,7 @@ interface UiController {
      * @example
      * ```typescript
      * await felt.deletePanelElements({
-     *   panelId: "panel-1",
+     *   panelId,
      *   elements: ["element-1", "element-2"],
      * });
      * ```
@@ -13913,4 +13103,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 UIActionTriggerCreate 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 UIButtonGroupElement as bG, type UIButtonGroupElementCreate as bH, type UIButtonGroupElementUpdate as bI, type UIFlexibleSpaceElement as bJ, type UIFlexibleSpaceElementCreate as bK, type UIFlexibleSpaceElementUpdate as bL, type UIDividerElement as bM, type UIDividerElementCreate as bN, type UIDividerElementUpdate as bO, type UITextInputElement as bP, type UITextInputElementCreate as bQ, type UITextInputElementUpdate as bR, type UISelectElement as bS, type UISelectElementCreate as bT, type UISelectElementUpdate as bU, type UIPanelElement as bV, type UIPanelElementCreate as bW, type UIPanelElementUpdate as bX, type UIGridContainerElement as bY, type UIGridContainerElementCreate as bZ, type UIGridContainerElementUpdate 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 UiController as c0, type SetViewportCenterZoomParams as c1, type ViewportConstraints as c2, type ViewportFitBoundsParams as c3, type ViewportState as c4, type ViewportController as c5, type UnwrapPromise as c6, uiActionTriggerSchema as c7, type UIPanelElementCreateClonable as c8, uiPanelCreateSchema as c9, type UIButtonElementCreateClonable as ca, type MakeClonableSchema as cb, type UIButtonGroupElementCreateClonable as cc, type PromiseOrNot as cd, type UnionToIntersection as ce, 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 };