jmapcloud-ng-types 1.0.1001 → 1.1.0

package/public/app.d.ts

@@ -16,8 +16,8 @@ declare namespace JMap {
      *
      * Returns the application build version.
      *
-     * @example ```ts
-     *
+     * @example
+     * ```ts
      * // return the build version, for example "1.0.1"
      * JMap.Application.getVersion()
      * ```
@@ -31,8 +31,8 @@ declare namespace JMap {
      *
      * For the same API version, multiple implementation versions can exist.
      *
-     * @example ```ts
-     *
+     * @example
+     * ```ts
      * // return the build version, for example "1.0.1"
      * JMap.Application.getApiVersion()
      * ```
@@ -44,8 +44,8 @@ declare namespace JMap {
      *
      * Opens JMap Cloud NG's online JS API documentation, in a new tab.
      *
-     * @example ```ts
-     *
+     * @example
+     * ```ts
      * // open JMap Cloud NG's online documentation, in a new tab
      * JMap.Application.openDocumentation()
      * ```
@@ -57,8 +57,8 @@ declare namespace JMap {
      *
      * Opens JMap Cloud NG's online user manual, in a new tab.
      *
-     * @example ```ts
-     *
+     * @example
+     * ```ts
      * // Open JMap Cloud NG's online user manual, in a new tab
      * JMap.Application.openUserManual()
      * ```
@@ -76,8 +76,8 @@ declare namespace JMap {
        *
        * Returns the current draw mode.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return the current draw mode
        * JMap.Application.Annotation.getDrawMode()
        * ```
@@ -90,8 +90,8 @@ declare namespace JMap {
        * Sets the annotation draw mode.
        *
        * @param drawMode the new draw mode
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Set the annotation draw mode to "draw"
        * JMap.Application.Annotation.setDrawMode("draw")
        * ```
@@ -103,8 +103,8 @@ declare namespace JMap {
        *
        * Returns the current draw type.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return the current draw type
        * JMap.Application.Annotation.getDrawType()
        * ```
@@ -117,8 +117,8 @@ declare namespace JMap {
        * Sets the annotation draw mode.
        *
        * @param drawType the new draw type
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Set the annotation draw mode to "draw"
        * JMap.Application.Annotation.setDrawMode("draw")
        * ```
@@ -132,8 +132,8 @@ declare namespace JMap {
        *
        * @throws if the annotationId param is not a valid string
        * @param annotationId the given annotation id
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return true if annotation exists, else false
        * JMap.Application.Annotation.existsById("d68385b01be3c241c7b6298b2788839d")
        * ```
@@ -147,8 +147,8 @@ declare namespace JMap {
        *
        * @throws if the annotationId param is not a valid string, or annotation is not found
        * @param annotationId the given annotation id
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return the annotation for the given id
        * JMap.Application.Annotation.getById("d68385b01be3c241c7b6298b2788839d")
        * ```
@@ -160,8 +160,8 @@ declare namespace JMap {
        *
        * Returns all annotations.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return all annotations
        * JMap.Application.Annotation.getAll()
        * ```
@@ -175,8 +175,8 @@ declare namespace JMap {
        *
        * Empty array if no annotation is selected
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return ids of selected annotations
        * JMap.Application.Annotation.getSelectedIds()
        * ```
@@ -190,8 +190,8 @@ declare namespace JMap {
        *
        * Does nothing if no annotation exists.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Delete all annotations
        * JMap.Application.Annotation.deleteAll()
        * ```
@@ -207,8 +207,8 @@ declare namespace JMap {
        *
        * @param annotationType the annotation type : "point", "polygon", "line_string", "rectangle", "circle", or "text"
        * @throws if the annotation type is not correct
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Delete all text annotations if exist
        * JMap.Application.Annotation.deleteByType("text")
        * ```
@@ -222,8 +222,8 @@ declare namespace JMap {
        *
        * @param annotationIds an array of annotation id
        * @throws if an annotation array is empty or an annotation is not found for the given ids.
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Delete two annotations
        * JMap.Application.Annotation.deleteByIds([
        *  "d68385b01be3c241c7b6298b2788839d",
@@ -240,8 +240,8 @@ declare namespace JMap {
        *
        * Does nothing if no selection.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Delete selected annotations
        * JMap.Application.Annotation.deleteSelected()
        * ```
@@ -253,8 +253,8 @@ declare namespace JMap {
        *
        * Returns the current style in use for annotation drawing.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return the current style in use for annotation drawing
        * JMap.Application.Annotation.getStyle()
        * ```
@@ -268,8 +268,8 @@ declare namespace JMap {
        *
        * Merges the new options with current one.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Set the line width as 3px
        * JMap.Application.Annotation.updateStyle({
        *  lineWidth: 3
@@ -283,8 +283,8 @@ declare namespace JMap {
        *
        * For given ids, updates annotation style.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * const annotationIds = [
        *  "d68385b01be3c241c7b6298b2788839d",
        *  "98ef8ad4476f0e6fa26be416d58d0734"
@@ -306,8 +306,8 @@ declare namespace JMap {
        * Set the preset colors of color pickers using the given colors.
        * @param presetColors A array of preset hex colors
        * @throws if presetColors not an array, does not contain string or is too big
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Set the preset colors with 2 color
        * const presetColors = [
        *  "#29D1EA",
@@ -326,8 +326,8 @@ declare namespace JMap {
        *
        * @param presetColor A hex color
        * @throws if presetColor not an string or is empty
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Add the color #D2FDDF to the preset colors
        * const presetColor = "#D2FDDF"
        *
@@ -343,8 +343,8 @@ declare namespace JMap {
        *
        * @param presetColor A hex color
        * @throws if presetColor not an string or is empty
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Delete the color #D2FDDF from the preset colors
        * const presetColor = "#D2FDDF"
        *
@@ -358,13 +358,43 @@ declare namespace JMap {
        *
        * Return the preset colors used by the application's color pickers.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Get the current preset colors
        * JMap.Application.Annotation.getPresetColors()
        * ```
        */
       function getPresetColors(): string[]
+
+      /**
+       * **JMap.Application.Annotation.setSnapEnabled**
+       *
+       * Enables or disables snap mode.
+       *
+       * @param isEnabled true to enable snap mode, false to disable
+       * @throws if isEnabled is not a boolean
+       * @example
+       * ```ts
+       * // enable snap mode
+       * JMap.Application.Annotation.setSnapEnabled(true)
+       * ```
+       */
+      function setSnapEnabled(isEnabled: boolean): void
+
+      /**
+       * **JMap.Application.Annotation.setSnapLayerId**
+       *
+       * set the layer id to snap on.
+       *
+       * @param layerId the JMap layer id
+       * @throws if layer not found
+       * @example
+       * ```ts
+       * // snap will target the features of the layer having id="36885146-7eed-4071-9f86-8e29c505af91"
+       * JMap.Application.Annotation.setSnapLayerId("36885146-7eed-4071-9f86-8e29c505af91")
+       * ```
+       */
+      function setSnapLayerId(layerId: JId): void
     }
     /**
      * **JMap.Application.Panel**
@@ -379,8 +409,8 @@ declare namespace JMap {
        *
        * Returns the active panel.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return the currently active panel
        * JMap.Application.Panel.getActive()
        * ```
@@ -392,8 +422,8 @@ declare namespace JMap {
        *
        * Returns all application panels available.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return all available application panels
        * JMap.Application.Panel.getAll()
        * ```
@@ -406,8 +436,8 @@ declare namespace JMap {
        * Returns true if the panel exists for a given panel id.
        *
        * @param panelId The panel id to test
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return true if panel id="layer" exists
        * JMap.Application.Panel.existById("custom-panel")
        * ```
@@ -425,8 +455,8 @@ declare namespace JMap {
        * @throws if panel is not found
        * @param panelId The new application panel to activate
        * @param params optionnal parameters
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // will activate and display the panel id="layer"
        * JMap.Application.Panel.activateById("layer")
        * ```
@@ -439,8 +469,8 @@ declare namespace JMap {
        * Deactivates the current panel, except if the current panel is the layer panel, or if there is only one panel available.
        *
        * @param params optionnal parameters
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // will activate the current panel
        * JMap.Application.Panel.deactivateCurrent()
        * ```
@@ -454,8 +484,8 @@ declare namespace JMap {
        *
        * @throws if panel format is not correct
        * @param panel an object that is the definition of the new panel
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * const customPanelId = "custom-panel"
        * // will add the new panel, here an empty panel just for the example
        * JMap.Application.Panel.add({
@@ -481,8 +511,8 @@ declare namespace JMap {
        *
        * @throws if panel is not found or if this is the last panel
        * @param panelId The application panel id to remove
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // will remove the "custom-panel" panel
        * JMap.Application.Panel.removeById("custom-panel")
        * ```
@@ -503,8 +533,8 @@ declare namespace JMap {
        *
        * @param layerId the JMap layer id
        * @param featureId the feature id
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // open edit menu (single feature) for layer id=5, and feature id=234
        * JMap.Application.Feature.openEditMenuById(5, 234)
        * ```
@@ -518,8 +548,8 @@ declare namespace JMap {
        *
        * @param layerId the JMap layer id
        * @param featureIds an array of features ids
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // open edit menu (multiple edition) for layer id=5, and features id=234, 452 and 176
        * JMap.Application.Feature.openEditMenuByIds(5, [234, 452, 176])
        * ```
@@ -533,10 +563,8 @@ declare namespace JMap {
        *
        * If not visible, does nothing.
        *
-       * @param layerId the JMap layer id
-       * @param featureIds an array of features ids
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // close the edit menu if visible
        * JMap.Application.Feature.closeEditMenu()
        * ```
@@ -550,8 +578,8 @@ declare namespace JMap {
        *
        * @param layerId the JMap layer id
        * @param featureIds an array of features ids
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // delete 2 features on layer id=4
        * JMap.Application.Feature.deleteByIds(4, [23, 76]).then(result => console.log("Delete result", result))
        * ```
@@ -571,8 +599,8 @@ declare namespace JMap {
        * Opens the geometry panel in order to create a new feature.
        *
        * @throws if no layer is editable
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // will open the geometry panel
        * JMap.Application.Geometry.openPanelForCreation()
        * ```
@@ -585,9 +613,9 @@ declare namespace JMap {
        * Opens the geometry panel in order to update a feature geometry.
        *
        * @throws if the given layer or feature are not editable
-       * @param JAppGeometryUpdateParams function parameters
-       * @example ```ts
-       *
+       * @param params function parameters
+       * @example
+       * ```ts
        * // will open the geometry panel in order to update the feature geometry
        * JMap.Application.Geometry.openPanelForUpdate()
        * ```
@@ -601,8 +629,8 @@ declare namespace JMap {
        *
        * @throws if layer not found
        * @param layerId The JMap layer id
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // will select the layer id=3
        * JMap.Application.Geometry.selectLayer(3)
        * ```
@@ -615,8 +643,8 @@ declare namespace JMap {
        * Enables drawing of the geometry on the map.
        *
        * @throws if no layer is selected
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // enable drawing of the geometry on the map
        * JMap.Application.Geometry.startCreationDrawing()
        * ```
@@ -628,8 +656,8 @@ declare namespace JMap {
        *
        * Stops the geometry creation, when drawing on the map, and displays the layer selection panel.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // stop drawing the geometry on the map
        * JMap.Application.Geometry.stopCreationDrawing()
        * ```
@@ -642,8 +670,8 @@ declare namespace JMap {
        * Finishes geometry creation.
        *
        * @throws if panel is not in creation mode, or if geometry has not yet been created.
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // finishe creating or updating the geometry
        * JMap.Application.Geometry.finishCreate()
        * ```
@@ -656,8 +684,8 @@ declare namespace JMap {
        * Finishes geometry update.
        *
        * @throws if panel is not in update mode
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // finishe updating the geometry
        * JMap.Application.Geometry.finishUpdate()
        * ```
@@ -669,13 +697,43 @@ declare namespace JMap {
        *
        * Closes the geometry creation or update panel without confirmation message.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // close the geometry panel
        * JMap.Application.Geometry.closePanel()
        * ```
        */
       function closePanel(): void
+
+      /**
+       * **JMap.Application.Geometry.setSnapEnabled**
+       *
+       * Enables or disables snap mode.
+       *
+       * @param isEnabled true to enable snap mode, false to disable
+       * @throws if isEnabled is not a boolean
+       * @example
+       * ```ts
+       * // enable snap mode
+       * JMap.Application.Geometry.setSnapEnabled(true)
+       * ```
+       */
+      function setSnapEnabled(isEnabled: boolean): void
+
+      /**
+       * **JMap.Application.Geometry.setSnapLayerId**
+       *
+       * set the layer id to snap on.
+       *
+       * @param layerId the JMap layer id
+       * @throws if layer not found
+       * @example
+       * ```ts
+       * // snap will target the features of the layer having id="36885146-7eed-4071-9f86-8e29c505af91"
+       * JMap.Application.Geometry.setSnapLayerId("36885146-7eed-4071-9f86-8e29c505af91")
+       * ```
+       */
+      function setSnapLayerId(layerId: JId): void
     }
 
     /**
@@ -689,8 +747,8 @@ declare namespace JMap {
        *
        * Returns all measures.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return currently drawn measures
        * JMap.Application.Measure.getAll()
        * ```
@@ -703,8 +761,8 @@ declare namespace JMap {
        * Returns true if a measure exists for the given id, else false.
        *
        * @throws Error if measureId is not a string or an empty string
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return true if the measure exists, else false
        * JMap.Application.Measure.existsById("ac57b1bd83ca6d8e0013e4cf9f06847e")
        *
@@ -723,8 +781,8 @@ declare namespace JMap {
        * Returns the measure for the given id.
        *
        * @throws Error if measureId is not a string or an empty string, or if measure is not found
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return the measure for the given id
        * JMap.Application.Measure.getById("ac57b1bd83ca6d8e0013e4cf9f06847e")
        *
@@ -742,8 +800,8 @@ declare namespace JMap {
        *
        * Returns all "line" measures. Result contains no polygon or circle measures.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return all line measures
        * JMap.Application.Measure.getAllLineMeasures()
        * ```
@@ -755,8 +813,8 @@ declare namespace JMap {
        *
        * Returns all "polygon" measures. Result contains no line or circle measures.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return all polygon measures
        * JMap.Application.Measure.getAllPolygonMeasures()
        * ```
@@ -768,8 +826,8 @@ declare namespace JMap {
        *
        * Returns all "circle" measures. Result contains no line or polygon measures.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return all circle measures
        * JMap.Application.Measure.getAllCircleMeasures()
        * ```
@@ -781,8 +839,8 @@ declare namespace JMap {
        *
        * Resets measures with provided measures.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // remove all measures
        * JMap.Application.Measure.setAllMeasures([])
        * ```
@@ -794,8 +852,8 @@ declare namespace JMap {
        *
        * Activates a measure type for the drawing measurement tool.
        * @param measureType The new measure type to apply
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // change the measure type to length
        * JMap.Application.Measure.activateMeasureType("length")
        * ```
@@ -807,8 +865,8 @@ declare namespace JMap {
        *
        * Returns the current active measure type.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return active mesure type
        * JMap.Application.Measure.getActiveMeasureType([])
        * ```
@@ -820,8 +878,8 @@ declare namespace JMap {
        *
        * Returns the current measure selection.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return current measure selection
        * JMap.Application.Measure.getSelectedIds([])
        * ```
@@ -836,8 +894,8 @@ declare namespace JMap {
        * If active, measures can be selected by clicking on the map (then changed or removed).
        *
        * @param isSelectionActive true to activate selection mode, false to deactivate
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // activate selection of measures
        * JMap.Application.Measure.setSelectionActive(true)
        *
@@ -854,8 +912,8 @@ declare namespace JMap {
        *
        * Returns deleted measure count.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // delete all measures
        * const deletedMeasuresCount = JMap.Application.Measure.deleteAll()
        * ```
@@ -869,8 +927,8 @@ declare namespace JMap {
        *
        * Returns deleted measure count.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // delete all selected measures
        * const deletedMeasuresCount = JMap.Application.Measure.deleteSelected()
        * ```
@@ -884,8 +942,8 @@ declare namespace JMap {
        *
        * @throws if measure is not found
        * @param measureIds list of measure ids
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // delete measure having id="bc4fc07f2e84eb50f5962d3d41c836cb"
        * const deletedMeasuresCount = JMap.Application.Measure.deleteMeasuresById("bc4fc07f2e84eb50f5962d3d41c836cb")
        * ```
@@ -899,8 +957,8 @@ declare namespace JMap {
        *
        * Returns deleted measure count.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // delete all line measures (if exist)
        * const deletedMeasuresCount = JMap.Application.Measure.deleteAllLines()
        * ```
@@ -914,8 +972,8 @@ declare namespace JMap {
        *
        * Returns deleted measure count.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // delete all polygon measures (if exist)
        * const deletedMeasuresCount = JMap.Application.Measure.deleteAllPolygons()
        * ```
@@ -929,8 +987,8 @@ declare namespace JMap {
        *
        * Returns deleted measure count.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // delete all circle measures (if exist)
        * const deletedMeasuresCount = JMap.Application.Measure.deleteAllCircles()
        * ```
@@ -942,8 +1000,8 @@ declare namespace JMap {
        *
        * Returns the current measurement system used by the Measurements Panel
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // get the current measurement system
        * console.log(JMap.Application.Measure.getMeasurementSystem())
        * // "geodetic"
@@ -965,13 +1023,43 @@ declare namespace JMap {
        * Be warned that lengths or areas in planar context are not representative of the real dimensions on the earth's surface. The only supported planar projection for measurements is EPSG:3857.
        *
        * @param measurementSystem "geodetic" (default) or "planar"
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // set the current measurement system to "geodetic"
        * JMap.Application.Measure.setMeasurementSystem("geodetic")
        * ```
        */
       function setMeasurementSystem(measurementSystem: JAPP_MEASUREMENT_SYSTEMS): void
+
+      /**
+       * **JMap.Application.Measure.setSnapEnabled**
+       *
+       * Enables or disables snap mode.
+       *
+       * @param isEnabled true to enable snap mode, false to disable
+       * @throws if isEnabled is not a boolean
+       * @example
+       * ```ts
+       * // enable snap mode
+       * JMap.Application.Measure.setSnapEnabled(true)
+       * ```
+       */
+      function setSnapEnabled(isEnabled: boolean): void
+
+      /**
+       * **JMap.Application.Measure.setSnapLayerId**
+       *
+       * set the layer id to snap on.
+       *
+       * @param layerId the JMap layer id
+       * @throws if layer not found
+       * @example
+       * ```ts
+       * // snap will target the features of the layer having id="36885146-7eed-4071-9f86-8e29c505af91"
+       * JMap.Application.Measure.setSnapLayerId("36885146-7eed-4071-9f86-8e29c505af91")
+       * ```
+       */
+      function setSnapLayerId(layerId: JId): void
     }
 
     /**
@@ -987,8 +1075,8 @@ declare namespace JMap {
        *
        * This function returns the id of the layer for which the selection is displayed.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return the layer id of the displayed selection
        * JMap.Application.Selection.getDisplayedLayerId()
        * ```
@@ -1003,8 +1091,8 @@ declare namespace JMap {
        * If layer selection has no selection, hides the layer selection list.
        *
        * @throws if layer not found for the given layer id
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // display the layer id=2 selection
        * JMap.Application.Selection.setDisplayedLayerId(2)
        * ```
@@ -1016,8 +1104,8 @@ declare namespace JMap {
        *
        * Changes the current type of selection
        * @param selectionType The new selection type to apply
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // change the selection type to rectangle
        * JMap.Application.Selection.activateSelectionType("rectangle")
        * ```
@@ -1029,8 +1117,8 @@ declare namespace JMap {
        *
        * Returns the current active type of selection
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return the current active selection type
        * JMap.Application.Selection.getActiveSelectionType()
        * ```
@@ -1042,8 +1130,8 @@ declare namespace JMap {
        *
        * Returns true if the selection data table is diaplayed.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // return true if the selection data table is visible
        * JMap.Application.Selection.getTableVisibility()
        * ```
@@ -1055,8 +1143,8 @@ declare namespace JMap {
        *
        * Hides or shows the selection data table.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // make selection data table visible
        * JMap.Application.Selection.setTableVisibility(true)
        *
@@ -1071,8 +1159,8 @@ declare namespace JMap {
        *
        * Returns true if the selection table is displayed in an external browser tab.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // returns true if the selection table is displayed in an external browser tab.
        * JMap.Application.Selection.isTableDisplayedInTab()
        * ```
@@ -1086,8 +1174,8 @@ declare namespace JMap {
        *
        * If the table is not visible, make it visible.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // displays the selection table in another tab.
        * JMap.Application.Selection.openTableInTab()
        * ```
@@ -1103,8 +1191,8 @@ declare namespace JMap {
        *
        * If the table is opened in another tab, close the tab and display the table over the map.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // closes the selection table tab.
        * JMap.Application.Selection.closeTableTab()
        * ```
@@ -1117,8 +1205,8 @@ declare namespace JMap {
        * Unselects all features for a given layer id.
        *
        * @param layerId the JMap layer id
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // clear the layer id=2 selection
        * JMap.Application.Selection.clearSelectionForLayer(2)
        * ```
@@ -1130,7 +1218,8 @@ declare namespace JMap {
        *
        * Clears the current selection
        *
-       * @example ```ts
+       * @example
+       * ```ts
        * // Clear the current selection
        * JMap.Application.Selection.clearSelection()
        * ```
@@ -1144,7 +1233,8 @@ declare namespace JMap {
        *
        * @param feature the given feature
        * @param selectionType if not provided the method use
-       * @example ```ts
+       * @example
+       * ```ts
        * // will select all features that intersect the provided line feature
        * JMap.Application.Selection.selectFromFeature(lineFeature)
        * ```
@@ -1158,7 +1248,8 @@ declare namespace JMap {
        *
        * If no selection, export an empty file.
        *
-       * @example ```ts
+       * @example
+       * ```ts
        * // download the current selection as an excel file
        * JMap.Application.Selection.exportAsExcelFile()
        * ```
@@ -1171,7 +1262,8 @@ declare namespace JMap {
        * Pans and zooms the map to display the current selection.
        *
        * @param options optional options
-       * @example ```ts
+       * @example
+       * ```ts
        * // fit the map to display selected features
        * JMap.Application.Selection.fitMapToDisplayLayerSelection()
        * ```
@@ -1197,8 +1289,8 @@ declare namespace JMap {
        * @throws if project id invalid or project not found
        * @param projectId the JMap project id
        * @returns the project
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // activate project id=33
        * JMap.Application.Project.activateById(33)
        * ```
@@ -1210,8 +1302,8 @@ declare namespace JMap {
        *
        * Displays or hides the project list selection panel.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // display the project list selection panel
        * JMap.Application.Project.setSelectionPanelVisibility(true)
        * ```
@@ -1246,8 +1338,8 @@ declare namespace JMap {
            * diacritical characters insensitive.
            *
            * @param nameFilter the name filter to apply
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // In the layer panel will display only layers whose name matches "pro" (case-insensitive)
            * JMap.Application.Layer.setName("pro")
            * ```
@@ -1265,8 +1357,8 @@ declare namespace JMap {
            * a) the name filter contains at least 2 characters
            * b) one of the layer filters has been added to the filtering configuration
            *
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // filter configuration is initially empty
            *
            * // activate the filters
@@ -1290,8 +1382,8 @@ declare namespace JMap {
            * or by calling a JMap Cloud NG API method to activate it.
            * See {@link JMap.Application.Layer.Tree.Filter.isApplied} for more details.
            *
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // activate the filters
            * JMap.Application.Layer.Tree.Filter.setActive(false)
            *
@@ -1311,8 +1403,8 @@ declare namespace JMap {
            * See {@link JMap.Application.Layer.Tree.Filter.isApplied} for more details
            *
            * @param active a boolean
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // activate the filters
            * JMap.Application.Layer.Tree.Filter.setActive(false)
            *
@@ -1328,8 +1420,8 @@ declare namespace JMap {
            * Applies the current filter configuration on the map. All layers not matching the filter will be hidden, and only those
            * that match the filter will stay visible on the map. If no filter is defined (or appliable), no change is applied on the map.
            *
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // Apply the current filter
            * JMap.Application.Layer.Tree.Filter.applyToMap()
            * ```
@@ -1342,8 +1434,8 @@ declare namespace JMap {
            * Tests if the specified filter exists.
            *
            * @param filterId the filter id
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // create a filter
            * JMap.Application.Layer.Tree.Filter.add({
            *  1,
@@ -1365,8 +1457,8 @@ declare namespace JMap {
            * Tests if at least one filter associated with the specified metadata id exists.
            *
            * @param metadataId the metadata id
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // filter collection is initially empty
            *
            * // create a filter
@@ -1389,8 +1481,8 @@ declare namespace JMap {
            *
            * Returns an object containing the current name filter and an array of all current filters.
            *
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // get filters configuration
            * console.log(JMap.Application.Layer.Tree.Filter.getAll())
            * // {
@@ -1417,8 +1509,8 @@ declare namespace JMap {
            * Retrieves the specified filter by id.
            *
            * @param filterId the filter id
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // get filter id=1
            * JMap.Application.Layer.Tree.Filter.getById(1)
            * // {"id":1,
@@ -1440,8 +1532,8 @@ declare namespace JMap {
            * Adds a filter. The list of available metadata schema items can be retieved by calling {@link JMap.Layer.getMetadataSchema}.
            *
            * @param filter a JAppAnyLayerFilter object
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // add a filter to the config
            * JMap.Application.Layer.Tree.Filter.add({
            *  1,
@@ -1460,8 +1552,8 @@ declare namespace JMap {
            * Removes the specified filter from the filter configuration.
            *
            * @param filterId the id of the filter to delete
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // delete filter id=1
            * JMap.Application.Layer.Tree.Filter.deleteById(1)
            * ```
@@ -1473,8 +1565,8 @@ declare namespace JMap {
            *
            * Opens the Add Filter dialog box, and activates the Layer panel if it is not already active.
            *
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // open Add Filter UI
            * JMap.Application.Layer.Tree.Filter.openAddFilterDialog()
            * ```
@@ -1486,8 +1578,8 @@ declare namespace JMap {
            *
            * Closes the Add Filter dialog box (without saving the filter).
            *
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // close Add Filter UI
            * JMap.Application.Layer.Tree.Filter.closeAddFilterDialog()
            * ```
@@ -1515,8 +1607,8 @@ declare namespace JMap {
            *
            * @throws if layer not found
            * @param layerId the JMap layer id
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // opens the edition panel, with the "dynamic-filter" tab activated, for layer id=3.
            * JMap.Application.Layer.Edition.DynamicFilter.openPanel(3)
            * ```
@@ -1528,8 +1620,8 @@ declare namespace JMap {
            *
            * If open, closes the edition panel.
            *
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // closes the dynamic filter panel if open.
            * JMap.Application.Layer.Edition.DynamicFilter.closePanel()
            * ```
@@ -1543,8 +1635,8 @@ declare namespace JMap {
            *
            * @throws if layer not found
            * @param layerId the JMap layer id
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // opens the dynamic filter creation dialog for layer id=3
            * JMap.Application.Layer.Edition.DynamicFilter.openCreateDialog(3)
            * ```
@@ -1559,8 +1651,8 @@ declare namespace JMap {
            * @throws if layer or condition not found
            * @param layerId the JMap layer id
            * @param conditionId the JMap dynamic filter condition id
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // opens the dynamic filter condition creation dialog for layer id=3
            * JMap.Application.Layer.Edition.DynamicFilter.openUpdateDialog(3)
            * ```
@@ -1572,8 +1664,8 @@ declare namespace JMap {
            *
            * If open, close the dynamic filter dialog (as well for creation or update).
            *
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // closes the edition (any tab) panel if open.
            * JMap.Application.Layer.Edition.DynamicFilter.closeDialog()
            * ```
@@ -1594,8 +1686,8 @@ declare namespace JMap {
            *
            * @throws if layer not found
            * @param layerId the JMap layer id
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // open the edition panel, with "info" tab activated, for layer id=3.
            * JMap.Application.Layer.Edition.Info.openPanel(3)
            * ```
@@ -1607,8 +1699,8 @@ declare namespace JMap {
            *
            * If open, closes the edition panel.
            *
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // closes the edition (any tab) panel if open.
            * JMap.Application.Layer.Edition.DynamicFilter.closePanel()
            * ```
@@ -1629,8 +1721,8 @@ declare namespace JMap {
            *
            * @throws if layer not found
            * @param layerId the JMap layer id
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // opens the edition panel, with "thematics" tab activated, for layer id=3.
            * JMap.Application.Layer.Edition.Thematic.openPanel(3)
            * ```
@@ -1642,8 +1734,8 @@ declare namespace JMap {
            *
            * If open, closes the edition panel.
            *
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // closes the edition (any tab) panel if open.
            * JMap.Application.Layer.Edition.DynamicFilter.closePanel()
            * ```
@@ -1663,8 +1755,8 @@ declare namespace JMap {
          * @throws If layer is not found or layerId is correspond to a layer group, if activeTab is incorrect
          * @param layerId JMap layer id
          * @param activeTab the tab to display: "thematics" or "dynamic-filter"
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // edits the layer's id="3" thematics (if layer 3 has at least one thematic set)
          * JMap.Application.Layer.Edition.openPanel(3, "thematics")
          *
@@ -1679,8 +1771,8 @@ declare namespace JMap {
          *
          * If layer edition panel is opened, will close it. Will stop edition and show the layer tree panel.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // closes the layer edition panel
          * JMap.Application.Layer.Edition.closePanel()
          * ```
@@ -1706,8 +1798,8 @@ declare namespace JMap {
          *
          * Returns the DOM div element id where application UI has been inserted.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // return the dom container id, ex : "jmapcloud-ng-types"
          * JMap.Application.UI.Container.getId()
          * ```
@@ -1719,8 +1811,8 @@ declare namespace JMap {
          *
          * Returns the dom container width in pixel.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // return the dom container width, ex : 1230
          * JMap.Application.UI.Container.getWidth()
          * ```
@@ -1732,8 +1824,8 @@ declare namespace JMap {
          *
          * Returns the dom container height in pixel.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // return the dom container height, ex : 966
          * JMap.Application.UI.Container.getHeight()
          * ```
@@ -1746,8 +1838,8 @@ declare namespace JMap {
          * Returns a polygon geometry representing the visible coordinates on the map.
          * Works fine even if the map is pitched or rotated.
          * @throws if map is not loaded
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns the polygon geometry representing the visible coordinates on the map.
          * // ex :
          * // {
@@ -1776,8 +1868,8 @@ declare namespace JMap {
          * Sets the application left side panel visibility.
          *
          * @param isVisible if true, shows the panel, else hides it
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // Show the left side panel
          * JMap.Application.UI.Sidepanel.setVisible(true)
          *
@@ -1792,8 +1884,8 @@ declare namespace JMap {
          *
          * Returns true if the JMap Cloud NG main panel on the left is opened.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns true if side panel is opened
          * JMap.Application.UI.SidePanel.isVisible()
          * ```
@@ -1809,8 +1901,8 @@ declare namespace JMap {
          *
          * If the panel is closed, it will open.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // change the side panel visibility
          * JMap.Application.UI.SidePanel.toggleVisibility()
          * ```
@@ -1822,8 +1914,8 @@ declare namespace JMap {
          *
          * Returns the width of the opened side panel in rem.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns "28.125rem"
          * JMap.Application.UI.SidePanel.getWidthOpenInRem()
          * ```
@@ -1835,8 +1927,8 @@ declare namespace JMap {
          *
          * Returns the width of the opened side panel in pixel.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns 450
          * JMap.Application.UI.SidePanel.getWidthOpenInPixel()
          * ```
@@ -1848,8 +1940,8 @@ declare namespace JMap {
          *
          * Returns the minimum side panel width.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns the minimum side panel width
          * JMap.Application.UI.SidePanel.getMinimumWidthOpenInPixel()
          * ```
@@ -1862,9 +1954,9 @@ declare namespace JMap {
          * Returns the minimum side panel width.
          *
          * @throws if new width is not a number, or lower than minimum width
-         * @param width: new panel width in pixel
-         * @example ```ts
-         *
+         * @param width new panel width in pixel
+         * @example
+         * ```ts
          * const newWidth = 500
          * if (JMap.Application.UI.SidePanel.getMinimumWidthOpenInPixel() <= newWidth) {
          *  // returns the minimum side panel width
@@ -1879,8 +1971,8 @@ declare namespace JMap {
          *
          * Returns the width of the closed side panel in rem.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns "3.75rem"
          * JMap.Application.UI.SidePanel.getWidthCloseInRem()
          * ```
@@ -1892,8 +1984,8 @@ declare namespace JMap {
          *
          * Returns the width of the closed side panel in pixel.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns 60
          * JMap.Application.UI.SidePanel.getWidthCloseInPixel()
          * ```
@@ -1905,8 +1997,8 @@ declare namespace JMap {
          *
          * Returns the width of the main panel (side panel width minus menu width) in rem.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns "24.375rem"
          * JMap.Application.UI.SidePanel.getMainPanelWidthInRem()
          * ```
@@ -1918,8 +2010,8 @@ declare namespace JMap {
          *
          * Returns the width of the main panel (side panel width minus menu width) in pixel.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns 390
          * JMap.Application.UI.SidePanel.getMainPanelWidthInPixel()
          * ```
@@ -1931,8 +2023,8 @@ declare namespace JMap {
          *
          * Returns the min height of the Panel header section (where the project name is displayed) in rem.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns "5rem"
          * JMap.Application.UI.SidePanel.getHeaderMinHeightInRem()
          * ```
@@ -1944,8 +2036,8 @@ declare namespace JMap {
          *
          * Returns the min height of the Panel header section (where the project name is displayed) in pixels.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns 80
          * JMap.Application.UI.SidePanel.getHeaderMinHeightInPixel()
          * ```
@@ -1957,8 +2049,8 @@ declare namespace JMap {
          *
          * Returns the min height of the Panel title section (where the panel name is displayed) in rem.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns "4rem"
          * JMap.Application.UI.SidePanel.getTitleMinHeightInRem()
          * ```
@@ -1970,14 +2062,80 @@ declare namespace JMap {
          *
          * Returns the min height of the Panel title section (where the panel name is displayed) in pixels.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // returns 64
          * JMap.Application.UI.SidePanel.getTitleMinHeightInPixel()
          * ```
          */
         function getTitleMinHeightInPixel(): number
       }
+      /**
+       * **JMap.Application.UI.Map**
+       *
+       * You can manage the Map UI here.
+       */
+      namespace Map {
+        /**
+         * **JMap.Application.UI.Map.isGeocodingControlVisible**
+         *
+         * Returns true if the geocoding control is currently visible.
+         *
+         * @example
+         * ```ts
+         * // true or false
+         * JMap.Application.UI.Map.isGeocodingControlVisible()
+         * ```
+         */
+        function isGeocodingControlVisible(): boolean
+
+        /**
+         * **JMap.Application.UI.Map.setGeocodingControlVisibility**
+         *
+         * Displays or hides the geocoding control.
+         *
+         * @param isVisible true to display, false to hide
+         * @example
+         * ```ts
+         * // Display the geocoding control
+         * JMap.Application.UI.Map.setGeocodingControlVisibility(true)
+         *
+         * // Hide the geocoding control
+         * JMap.Application.UI.Map.setGeocodingControlVisibility(false)
+         * ```
+         */
+        function setGeocodingControlVisibility(isVisible: boolean): void
+
+        /**
+         * **JMap.Application.UI.Map.isSimpleSearchControlVisible**
+         *
+         * Returns true if the Simple Search control is currently visible.
+         *
+         * @example
+         * ```ts
+         * // true or false
+         * JMap.Application.UI.Map.isSimpleSearchControlVisible()
+         * ```
+         */
+        function isSimpleSearchControlVisible(): boolean
+
+        /**
+         * **JMap.Application.UI.Map.setSimpleSearchControlVisibility**
+         *
+         * Displays or hides the Simple Search control.
+         *
+         * @param isVisible true to display, false to hide
+         * @example
+         * ```ts
+         * // Display the Simple Search control
+         * JMap.Application.UI.Map.setSimpleSearchControlVisibility(true)
+         *
+         * // Hide the Simple Search control
+         * JMap.Application.UI.Map.setSimpleSearchControlVisibility(false)
+         * ```
+         */
+        function setSimpleSearchControlVisibility(isVisible: boolean): void
+      }
 
       /**
        * **JMap.Application.UI.Theme**
@@ -1990,8 +2148,8 @@ declare namespace JMap {
          *
          * Returns true if the theme is currently dark.
          *
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // true or false
          * JMap.Application.UI.Theme.isDark()
          * ```
@@ -2004,8 +2162,8 @@ declare namespace JMap {
          * Changes the UI color theme in dark or light.
          *
          * @param isDark if true make the theme dark, else light
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // make the theme dark
          * JMap.Application.UI.Theme.setDark()
          *
@@ -2032,8 +2190,8 @@ declare namespace JMap {
        * Displays or hides the scale control widget.
        *
        * @param isVisible true to display, false to hide
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Display the scale
        * JMap.Application.Print.setScaleControlVisibility(true)
        *
@@ -2048,8 +2206,8 @@ declare namespace JMap {
        *
        * Returns true if the scale control widget is visible, else false.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // true if the scale controle widget is displayed
        * JMap.Application.Print.isScaleControlVisible()
        * ```
@@ -2065,8 +2223,8 @@ declare namespace JMap {
        *
        * @throws if title is not a string
        * @param title The title displayed in the bottom of the print layout
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // set title
        * JMap.Application.Print.setPageTitle("My custom title")
        * ```
@@ -2078,8 +2236,8 @@ declare namespace JMap {
        *
        * Returns the title displayed in the bottom of the print layout.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // returns the displayed title
        * JMap.Application.Print.getPageTitle()
        * ```
@@ -2093,8 +2251,8 @@ declare namespace JMap {
        *
        * @throws if subTitle is not a string
        * @param subTitle The subtitle displayed in the bottom of the print layout
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // set subtitle
        * JMap.Application.Print.setPageSubTitle("My custom subtitle")
        * ```
@@ -2106,8 +2264,8 @@ declare namespace JMap {
        *
        * Returns the subtitle displayed in the bottom of the print layout.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // returns the displayed subtitle
        * JMap.Application.Print.getPageSubTitle()
        * ```
@@ -2119,8 +2277,8 @@ declare namespace JMap {
        *
        * Returns true if the date is displayed in the bottom of the print layout.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // returns true if the date is visible
        * JMap.Application.Print.isDateVisibile()
        * ```
@@ -2133,8 +2291,8 @@ declare namespace JMap {
        * Sets the date visible or hidden in the bottom of the print layout.
        *
        * @param isVisible true to display, false to hide
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Hide the date
        * JMap.Application.Print.setDateVisibility(false)
        *
@@ -2149,8 +2307,8 @@ declare namespace JMap {
        *
        * Returns true if the north arrow is displayed in the bottom of the print layout.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // returns true if the north arrow is visible
        * JMap.Application.Print.isNorthArrowVisible()
        * ```
@@ -2163,8 +2321,8 @@ declare namespace JMap {
        * Sets the north arrow visible or hidden in the bottom of the print layout.
        *
        * @param isVisible true to display, false to hide
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Hide the north arrow
        * JMap.Application.Print.setNorthArrowVisibility(false)
        *
@@ -2181,9 +2339,8 @@ declare namespace JMap {
        *
        * Different sizes are available: "letter" | "legal" | "a3" | "a4".
        *
-       * @deprecated will be removed in the futur
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // returns all available paper formats
        * JMap.Application.Print.getAllPaperFormats()
        * ```
@@ -2197,11 +2354,10 @@ declare namespace JMap {
        *
        * Technical method, you should not use it.
        *
-       * @deprecated will be removed in the futur
        * @throws if format is incorrect
-       * @param the paper format object or a {@link JAPP_PRINT_PAPER_SIZES}
-       * @example ```ts
-       *
+       * @param format the paper format object or a {@link JAPP_PRINT_PAPER_SIZES}
+       * @example
+       * ```ts
        * // set the letter paper format
        * JMap.Application.Print.setPaperFormat("letter")
        * ```
@@ -2213,9 +2369,8 @@ declare namespace JMap {
        *
        * Returns the active paper format.
        *
-       * @deprecated will be removed in the futur
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // returns active paper format
        * JMap.Application.Print.getPaperFormat()
        * ```
@@ -2227,8 +2382,8 @@ declare namespace JMap {
        *
        * Returns true if the print layout is portrait, else false (landscape).
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // returns true if the print layout is portrait, else false (landscape)
        * JMap.Application.Print.isOrientationPortrait()
        * ```
@@ -2242,8 +2397,8 @@ declare namespace JMap {
        *
        * @throws if isPortrait is not a boolean
        * @param isPortrait true to display as portrait, false as landscape
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // set the layout as portrait
        * JMap.Application.Print.setOrientation(true)
        *
@@ -2260,8 +2415,8 @@ declare namespace JMap {
        *
        * One of the following: "png" | "jpeg" | "pdf"
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // returns "png", "jpeg", or "pdf"
        * JMap.Application.Print.getFileType()
        * ```
@@ -2275,8 +2430,8 @@ declare namespace JMap {
        *
        * @throws if fileType is not correct
        * @param fileType "png", "jpeg", or "pdf"
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // set the layout as portrait
        * JMap.Application.Print.setFileType("pdf")
        * ```
@@ -2290,8 +2445,8 @@ declare namespace JMap {
        *
        * @throws if isHiResolution is not a boolean
        * @param isHiResolution true or false
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // set export mode to hi resolution
        * JMap.Application.Print.setHiResolution(true)
        * ```
@@ -2303,8 +2458,8 @@ declare namespace JMap {
        *
        * Returns true if the map export is set to hi resolution, false otherwise.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // get export resolution
        * JMap.Application.Print.getHiResolution()
        * // true
@@ -2315,155 +2470,43 @@ declare namespace JMap {
       /**
        * **JMap.Application.Print.takeCapture**
        *
-       * Builds print image and launches downwnload of the file
-       *
-       * @example ```ts
-       *
-       * // build print image and launch downwnload of the file
-       * JMap.Application.Print.takeCapture()
-       * ```
-       */
-      function takeCapture(): void
-    }
-
-    /**
-     * **JMap.Application.Query**
-     *
-     * You can manage everything related to query here.
-     */
-    namespace Query {
-      /**
-       * **JMap.Application.Query.activateQuery**
-       *
-       * Activates a query by id and group id.
-       *
-       * It displays the query form (replacing the list of queries) in the query panel.
-       *
-       * @param groupId the query group id
-       * @param queryId the query id
-       * @example ```ts
-       *
-       * // activate query id=43 on group id=23
-       * JMap.Application.Print.activateQuery(23, 43)
-       * ```
-       */
-      function activateQuery(groupId: JId, queryId: string): void
-
-      /**
-       * **JMap.Application.Query.deactivateQuery**
-       *
-       * Deactivatea the current query. If no query is active, does nothing.
-       *
-       * If a query form is active (= its form is displayed), hidea it and returns to the query list.
-       *
-       * @example ```ts
-       *
-       * // if a query form is displayed, hide it and return to the query list.
-       * JMap.Application.Print.deactivateQuery()
-       * ```
-       */
-      function deactivateQuery(): void
-
-      /**
-       * **JMap.Application.Query.getDefaultData**
-       *
-       * Returns the current query form data.
-       *
-       * If there is no active form, warns in the console and returns an empty object {}.
+       * Builds a screen capture of the map and launches the download of the file, or returns the screen capture as a data url embeded in a {@link JAppPrintCaptureResult}
+       * @param returnAsScreenCaptureResult if true, the method will resolve with a {@link JAppPrintCaptureResult} that you can use to embed the image in an HTML page, otherwise the method will resolve with no result
+       * @param customRatioWidth The custom ratio width. When both customRatioWidth and customRatioHeight are specified, the captured image will be using a custom paper format having the aspect ratio defined by the specified width/height. returnAsScreenCaptureResult must be set to "true" for this parameter to be taken into account
+       * @param customRatioHeight The custom ratio height. returnAsScreenCaptureResult must be set to "true" for this parameters to be taken into account
        *
-       * @example ```ts
+       * When passing `returnAsScreenCaptureResult = true`, the screen capture process will take into account all Print parameters defined in the Print panel, including page format, scale, North arrow, title, sub-title, etc, but with the following limitations:
        *
-       * // returns the current query form data
-       * JMap.Application.Print.getDefaultData()
-       * ```
-       */
-      function getDefaultData(): { [id: string]: any }
-
-      /**
-       * **JMap.Application.Query.setDefaultData**
-       *
-       * Sets active query form data. If there is no active form, this function throws.
-       *
-       * @throws if no query is active
-       * @param values the form data, depends on the form
-       * @example ```ts
-       *
-       * // set the current query form data
-       * JMap.Application.Print.setDefaultData({
-       *  $param1: "black",
-       *  $param2: "white"
-       * })
-       * ```
-       */
-      function setDefaultData(values: any): void
-
-      /**
-       * **JMap.Application.Query.clearDefaultData**
-       *
-       * Resets the current query form data.
-       *
-       * If there is no active form, does nothing.
-       *
-       * @example ```ts
-       *
-       * // clear the current query form data
-       * JMap.Application.Print.clearDefaultData()
-       * ```
-       */
-      function clearDefaultData(): void
-
-      /**
-       * **JMap.Application.Query.displayInDialog**
+       * * the image format returned will always be PNG
+       * * If you want the Print panel overlays be present in the screen capture, you must programaticaly switch to the Print panel before calling JMap.Application.Print.takeCapture(true), otherwise only the map will be captured
        *
-       * By default, the query form is displayed in the left panel with a simple layout, one field per line.
        *
-       * But it is possible to display it in a modal window, with the layout defined in the project.
-       *
-       * @throws if isVisibleInDialog is not a boolean
-       * @param isVisibleInDialog true in modal window, false in left panel
-       * @example ```ts
-       *
-       * // display the current form in a modal window
-       * JMap.Application.Print.displayInDialog(true)
-       *
-       * // display the current form in the left panel
-       * JMap.Application.Print.displayInDialog(false)
-       * ```
-       */
-      function displayInDialog(isVisibleInDialog: boolean): void
-
-      /**
-       * **JMap.Application.Query.processQuery**
-       *
-       * Processes the active query form with the given values.
-       *
-       * Throws if no query is active.
-       *
-       * Resolves only if some features are found.
-       *
-       * If features are found, makes the layer selectable and visible if needed, then selects and zooms on found features.
-       *
-       * If no feature is found, the Promise rejects with a human readable error in the current user's locale.
-       *
-       * @throws if no query is active
-       * @param value the form data, depends on the form
-       * @example ```ts
+       * @example
+       * ```ts
+       * // build print image and launch download of the file
+       * JMap.Application.Print.takeCapture()
        *
-       * // display the current form in a modal window
-       * JMap.Application.Print
-       *   .processQuery({
-       *    $param1: "black",
-       *    $param2: "white"
-       *   })
-       *   .then(features => console.info(`Found ${features.length} feature(s)`, features))
-       *   .catch(error => {
-       *     // pass here if no features are found, or other error
-       *     // thrown error is a readable error using the user locale
-       *     console.error(error)
-       *   })
+       * // add an image to a document with the print result
+       * JMap.Application.Print.takeCapture(true, 400, 200).then(
+       *    printCaptureResult => {
+       *      const img = document.createElement("img")
+       *      img.src = printCaptureResult.dataUrl
+       *      img.style.position = "absolute"
+       *      img.width = printCaptureResult.width / 4
+       *      img.height = printCaptureResult.height / 4
+       *      img.style.top = "10px"
+       *      img.style.left = "10px"
+       *      img.style.zIndex = 1000
+       *      document.body.appendChild(img)
+       *  }
+       * )
        * ```
        */
-      function processQuery(values: any): Promise<GeoJSON.Feature[]>
+      function takeCapture(
+        returnAsScreenCaptureResult?: boolean,
+        customRatioWidth?: number,
+        customRatioHeight?: number
+      ): Promise<void | JAppPrintCaptureResult>
     }
 
     /**
@@ -2512,8 +2555,8 @@ declare namespace JMap {
            *
            * @param listenerId Your listener id (must be unique)
            * @param fn Your listener function
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // log a message in the console once the application is loaded
            * JMap.Application.Event.Main.on.appReady(
            *   "custom-app-ready",
@@ -2540,8 +2583,8 @@ declare namespace JMap {
          * If the listener is inactive, it will be reactivated and will be called again ...
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // activate the listener "my-main-listener"
          * JMap.Application.Event.Main.activate("my-main-listener")
          * ```
@@ -2558,8 +2601,8 @@ declare namespace JMap {
          * If the listener is active, it will be deactivated and will be ignored ...
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // deactivate the listener "my-main-listener"
          * JMap.Application.Event.Main.deactivate("my-main-listener")
          * ```
@@ -2576,8 +2619,8 @@ declare namespace JMap {
          * Removes the listener from JMap Cloud NG. The listener is deleted and never called again after that.
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // remove the listener "my-main-listener"
          * JMap.Application.Event.Main.remove("my-main-listener")
          * ```
@@ -2608,8 +2651,8 @@ declare namespace JMap {
            *
            * @param listenerId Your listener id (must be unique)
            * @param fn Your listener function
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // Triggered when a user double clicks on a layer name
            * JMap.Application.Event.Layer.on.doubleClick("my-layer-double-click-listener", params => {
            *   const layer = params.layer
@@ -2635,8 +2678,8 @@ declare namespace JMap {
          * If the listener is inactive, it will be reactivated and will be called again ...
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // activate the listener "my-layer-listener"
          * JMap.Application.Event.Layer.activate("my-layer-listener")
          * ```
@@ -2653,8 +2696,8 @@ declare namespace JMap {
          * If the listener is active, it will be deactivated and will be ignored ...
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // deactivate the listener "my-layer-listener"
          * JMap.Application.Event.Layer.deactivate("my-layer-listener")
          * ```
@@ -2671,8 +2714,8 @@ declare namespace JMap {
          * Removes the listener from JMap Cloud NG. The listener is deleted and never called again after that.
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // remove the listener "my-layer-listener"
          * JMap.Application.Event.Layer.remove("my-layer-listener")
          * ```
@@ -2703,8 +2746,8 @@ declare namespace JMap {
            *
            * @param listenerId Your listener id (must be unique)
            * @param fn Your listener function
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // Triggered when a user register a new extension
            * JMap.Application.Event.Extension.on.registration("my-extension-listener", params => {
            *   const extensionId = params.extensionId
@@ -2724,8 +2767,8 @@ declare namespace JMap {
          * If the listener is inactive, it will be reactivated and will be called again ...
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // activate the listener "my-extension-listener"
          * JMap.Application.Event.Extension.activate("my-extension-listener")
          * ```
@@ -2742,8 +2785,8 @@ declare namespace JMap {
          * If the listener is active, it will be deactivated and will be ignored ...
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // deactivate the listener "my-extension-listener"
          * JMap.Application.Event.Extension.deactivate("my-extension-listener")
          * ```
@@ -2760,8 +2803,8 @@ declare namespace JMap {
          * Removes the listener from JMap Cloud NG. The listener is deleted and never called again after that.
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // remove the listener "my-extension-listener"
          * JMap.Application.Event.Extension.remove("my-extension-listener")
          * ```
@@ -2790,8 +2833,8 @@ declare namespace JMap {
            *
            * @param listenerId Your listener id (must be unique)
            * @param fn Your listener function
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // log a message in the console when the side panel is closed or opened
            * JMap.Application.Event.UI.on.sidePanelVisibilityChanged(
            *   "custom-side-panel-visibility-changed",
@@ -2811,8 +2854,8 @@ declare namespace JMap {
            *
            * @param listenerId Your listener id (must be unique)
            * @param fn Your listener function
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // log a message in the console when the side panel width changes
            * JMap.Application.Event.UI.on.sidePanelWidthChanged(
            *   "custom-side-panel-width-changed",
@@ -2836,8 +2879,8 @@ declare namespace JMap {
          * If the listener is inactive, it will be reactivated and will be called again ...
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // activate the listener "my-ui-listener"
          * JMap.Application.Event.UI.activate("my-ui-listener")
          * ```
@@ -2854,8 +2897,8 @@ declare namespace JMap {
          * If the listener is active, it will be deactivated and will be ignored ...
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // deactivate the listener "my-ui-listener"
          * JMap.Application.Event.UI.deactivate("my-ui-listener")
          * ```
@@ -2872,8 +2915,8 @@ declare namespace JMap {
          * Removes the listener from JMap Cloud NG. The listener is deleted and never called again after that.
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // remove the listener "my-ui-listener"
          * JMap.Application.Event.UI.remove("my-ui-listener")
          * ```
@@ -2906,8 +2949,8 @@ declare namespace JMap {
            *
            * @param listenerId Your listener id (must be unique)
            * @param fn Your listener function
-           * @example ```ts
-           *
+           * @example
+           * ```ts
            * // Triggered after a map-context is applied
            * JMap.Application.Event.MapContext.on.afterApply("my-after-apply-listener", params => {
            *   console.info(`After apply map context id="${params.context.title}"`, params.context)
@@ -2933,8 +2976,8 @@ declare namespace JMap {
          * If the listener is inactive, it will be reactivated and will be called again ...
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // activate the listener "my-mapcontext-listener"
          * JMap.Application.Event.MapContext.activate("my-mapcontext-listener")
          * ```
@@ -2951,8 +2994,8 @@ declare namespace JMap {
          * If the listener is active, it will be deactivated and will be ignored ...
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // deactivate the listener "my-mapcontext-listener"
          * JMap.Application.Event.MapContext.deactivate("my-mapcontext-listener")
          * ```
@@ -2969,8 +3012,8 @@ declare namespace JMap {
          * Remove the listener from JMap Cloud NG Core library. The listener is deleted and never called again after that.
          *
          * @param listenerId The listener id
-         * @example ```ts
-         *
+         * @example
+         * ```ts
          * // remove the listener "my-mapcontext-listener"
          * JMap.Application.Event.MapContext.remove("my-mapcontext-listener")
          * ```
@@ -2999,11 +3042,11 @@ declare namespace JMap {
        *
        * @param action : the action to add
        * @param index : will insert at a specific index in the menu. Start at 0. If index is not correct insert at the end
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * JMap.Application.User.addPopupMenuAction({
        *   id: "my-unique-id",
-       *   icon: "fas fa-info-circle",
+       *   icon: "https://link.to.my/image",
        *   label: {  key: "my.custom.menu.item.translation.key", bundleId: "myTranslationBundleId"}, // label can also be a simple string
        *   isHelp: true, // if true will be displayed in the JMap help menu
        *   onClick: () => window.open("https://link-to-my-documentation", "_blanck")
@@ -3019,8 +3062,8 @@ declare namespace JMap {
        *
        * @param actionId the action menu id
        * @throws if actionId is not a string (non empty)
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // returns true if the action menu id="my-custom-action-menu" exists, else false
        * JMap.Application.User.existsPopupMenuActionById("my-custom-action-menu")
        * ```
@@ -3034,8 +3077,8 @@ declare namespace JMap {
        *
        * @param actionId the action menu id
        * @throws if actionId is not valid, or not found
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // remove the action menu id="my-custom-action-menu"
        * JMap.Application.User.removePopupMenuActionById("my-custom-action-menu")
        * ```
@@ -3055,9 +3098,9 @@ declare namespace JMap {
        * Registers your own JMap Cloud NG extension.
        *
        * @throws Error if a parameter is not correct
-       * @param extensionModel The extension model
-       * @example ```ts
-       *
+       * @param extension The extension
+       * @example
+       * ```ts
        * JMap.Application.Extension.register({
        *  id: "MyExtension", // Unique id
        *  initFn: () => {
@@ -3087,8 +3130,8 @@ declare namespace JMap {
        *
        * @throws Error if extensionId format is not correct
        * @param extensionId The extension id
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // returns true if extension id="my-extension" is in use or not
        * JMap.Extension.isRegistered("my-extension")
        * ```
@@ -3102,8 +3145,8 @@ declare namespace JMap {
        *
        * Desn't list JMap Cloud NG Core extensions, only JMap Cloud NG extensions.
        *
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // Could returns [ "my-first-extension", "my-second-extension" ]
        * JMap.Extension.getAllRegisteredIds()
        * ```
@@ -3124,8 +3167,8 @@ declare namespace JMap {
        *
        * @param message the text of the message
        * @param options a JAppMessageOptions object
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * const message = "This operation is not allowed"
        * JMap.Application.Message.error(message, { duration: 5000 })
        * ```
@@ -3139,8 +3182,8 @@ declare namespace JMap {
        *
        * @param message the text of the message
        * @param options a JAppMessageOptions object
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * const message = "This operation has no effect"
        * JMap.Application.Message.warning(message, { duration: 5000 })
        * ```
@@ -3154,8 +3197,8 @@ declare namespace JMap {
        *
        * @param message the text of the message
        * @param options a JAppMessageOptions object
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * const message = "You are here"
        * JMap.Application.Message.info(message, { duration: 5000 })
        * ```
@@ -3169,8 +3212,8 @@ declare namespace JMap {
        *
        * @param message the text of the message
        * @param options a JAppMessageOptions object
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * const message = "The operation was successful"
        * JMap.Application.Message.success(message, { duration: 5000 })
        * ```
@@ -3189,8 +3232,8 @@ declare namespace JMap {
        * The optional onCancel callback is called when the cancel button is clicked.
        *
        * @param params message parameters
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * JMap.Application.Message.confirmMessage({
        *   message: "Are you sure to do a given action ?",
        *   onSuccess: () => console.log(`The user is sure`),
@@ -3215,8 +3258,8 @@ declare namespace JMap {
        *
        * @param message the text of the message
        * @param options a JAppMessageOptions object
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * const message = "The operation has failed"
        * const level = "error"
        * JMap.Application.Message.display(message, { duration: 5000 , severity: level})
@@ -3242,8 +3285,8 @@ declare namespace JMap {
        * @param message the message to display
        * @throws if message is not a non empty string
        * @returns the message id, usefull when you display multiple messages at the same time, but want to close only one.
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // display a waiting overlay, making the app unavailable for user as long it is displayed
        * const messageId = JMap.Application.Message.displayWaitingOverlay("Please wait, processing data")
        * // NG app is now unavailable for the user
@@ -3275,8 +3318,8 @@ declare namespace JMap {
        *
        * @param messageId the message to close
        * @throws if you pass a message id that is not found
-       * @example ```ts
-       *
+       * @example
+       * ```ts
        * // display a waiting overlay, making the app unavailable for user as long it is displayed
        * const messageId = JMap.Application.Message.displayWaitingOverlay("Please wait, processing data")
        * // NG app is now unavailable for the user
@@ -3307,101 +3350,49 @@ declare namespace JMap {
      */
     namespace Form {
       /**
-       * ***JMap.Application.Form.render***
-       *
-       * Renders a form with given params in a container.
-       *
-       * @param containerId id of the container where the form will be rendered
-       * @param formParams a JFormParams object
-       * @example ```ts
-       *
-       * // this example will show you how to create a custom form in an extension
-       * // it will render the form in the extension panel
-       * window.JMAP_OPTIONS = {
-       *   ...
-       *   application: {
-       *     extensions: [{
-       *       id: "test-form",
-       *       panelTitle: "Test of form component API",
-       *       initFn: () => {},
-       *       onPanelCreation: panelContainerId => {
-       *         document.getElementById(panelContainerId).style.padding = "1rem"
-       *         // create a custom form in the extension panel container
-       *         JMap.Application.Form.render(panelContainerId, {
-       *           id: "search-form",
-       *           schema: {
-       *             properties: {
-       *               name: {
-       *                 title: "Office Name",
-       *                 type: "string",
-       *                 isRequired: true,
-       *                 maxLength: 255
-       *               },
-       *               type: {
-       *                 title: "Office type",
-       *                 type: "number",
-       *                 // default: 2,
-       *                 enum: [1, 2, 3],
-       *                 enumNames: ["Local", "External", "Mixte"]
-       *               }
-       *             }
-       *           },
-       *           uiSchema: [
-       *            {
-       *              type: "Tab",
-       *              controls: [
-       *                {
-       *                  id: "name",
-       *                  label: "Office name",
-       *                  widget: "input",
-       *                  scope: "#/properties/name"
-       *                },
-       *                {
-       *                  id: "type",
-       *                  label: "Office type",
-       *                  widget: "select",
-       *                  scope: "#/properties/type"
-       *                 }
-       *               ]
-       *             }
-       *           ],
-       *           defaultValueById: { // defaultValueById is optional
-       *             name: "default value",
-       *             type: 2
-       *           },
-       *           validate: (values, formMetaData) => JMap.Form.validateData(formMetaData, JMap.Form.getPreparedData(formMetaData, values)),
-       *           onSubmit: values => {
-       *             // saving your data
-       *             // return a string if an error occurred
-       *             // return a promise, and the form will display a loading button until the promise resolved
-       *             JMap.Application.Message.info(`Submitted values: ${JSON.stringify(values)}`)
-       *           }
-       *         })
-       *       },
-       *       onPanelDestroy: panelContainerId => {
-       *         JMap.Application.Form.destroyByContainerId(panelContainerId)
-       *       }
-       *     }]
+       * **JMap.Application.Form.openForm**
+       *
+       * Opens a form dialog in the application. Depending on the shape of `params`, this will open either:
+       *  - a layer-based form (when `layerId` is provided), or
+       *  - a table-based form (when `tableId` is provided).
+       *
+       * When opening a layer form:
+       *  - `layerId` is required.
+       *  - You can optionally pass `featureId` or a full `feature` (GeoJSON.Feature) to edit an existing feature.
+       *  - `isReadOnly` controls whether the form is editable.
+       *  - `onSubmit` (if provided) is called after the user submits the form.
+       *
+       * When opening a table form:
+       *  - `tableId` is required.
+       *  - You can optionally pass `row` (an object of key/value pairs) to edit an existing row.
+       *  - `isReadOnly` controls whether the form is editable.
+       *  - `onSubmit` (if provided) is called after the user submits the form.
+       *
+       * @param params The parameters that configure which form to open:
+       *   - For a **layer form**:
+       *     - `layerId` (string): The ID of the layer to open the form for.
+       *     - `featureId?` (string): (Optional) The ID of the feature in that layer to load.
+       *     - `feature?` (GeoJSON.Feature): (Optional) A full GeoJSON feature to load instead of just an ID.
+       *   - For a **table form**:
+       *     - `tableId` (string): The ID of the table to open the form for.
+       *     - `row?` ({ [key: string]: any }): (Optional) The row data to load into the form.
+       *   - Common to both shapes:
+       *     - `isReadOnly` (boolean): If `true`, the form will be displayed in read‐only mode.
+       *     - `onSubmit?` (() => void): (Optional) Callback invoked after the form is successfully submitted.
+       * @example
+       * ```ts
+       * // Example: Open a layer form for editing an existing feature
+       * formSVC.openForm({
+       *   layerId: "db4bc79b-03fe-4cf7-a4bc-fb76d69cabdf",
+       *   featureId: "3022",
+       *   isReadOnly: false,
+       *   onSubmit: () => {
+       *     console.log("Layer form submitted successfully");
        *   }
-       * }
-       * ```
-       *
-       */
-      function render(containerId: string, formParams: JFormParams): JFormMetaData
-
-      /**
-       *
-       * ***JMap.Application.Form.destroyByContainerId***
-       *
-       * Unmounts form by using container Id where it was rendered
-       *
-       * @param containerId id of the container to unmount
-       * @example ```ts
-       *
-       * JMap.Application.Form.destroy("new-form")
+       * });
        * ```
        */
-      function destroyByContainerId(containerId: string): void
+      function openForm(params: JFormDialogParams): void
     }
   }
 }