@vertigis/viewer-spec 45.0.0 → 46.0.0

package/messaging/schema/common-action.schema.json

@@ -463,7 +463,7 @@
         },
         "AddNodeToGeometryArgs": {
             "additionalProperties": false,
-            "description": "Arguments for the \"sketching.add-node-to-geometry\" operation.",
+            "description": "Deprecated - Mobile users should rather use \"geometry.add-point\"; Web users should use \"sketching.add-point\" with {@link AddPointArgs} or \"sketching.insert-point\" with {@link InsertPointArgs} instead.",
             "properties": {
                 "geometry": {
                     "$ref": "#/definitions/esri.Geometry",
@@ -493,6 +493,28 @@
             ],
             "type": "object"
         },
+        "AddPointArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the \"sketching.add-point\" command.",
+            "properties": {
+                "geometry": {
+                    "$ref": "#/definitions/esri.Geometry",
+                    "description": "The geometry to add the point to, if multiple are present in an active editing session. Not supported by Mobile."
+                },
+                "maps": {
+                    "$ref": "MapsLike",
+                    "description": "Map(s) to use for the command/operation."
+                },
+                "newPoint": {
+                    "$ref": "#/definitions/esri.Point",
+                    "description": "The new point to be added."
+                }
+            },
+            "required": [
+                "newPoint"
+            ],
+            "type": "object"
+        },
         "AlertCommandArgs": {
             "additionalProperties": false,
             "description": "Arguments for the 'ui.alert' command.",
@@ -555,6 +577,10 @@
                     "$ref": "MapsLike",
                     "description": "The maps to activate drawing on. By default it will be all maps."
                 },
+                "maxSegments": {
+                    "description": "The maximum number of segments permitted for a polyline or polygon sketch. Default is no limit. Mobile only.",
+                    "type": "number"
+                },
                 "symbol": {
                     "anyOf": [
                         {
@@ -660,12 +686,24 @@
             "description": "Arguments for the \"sketching.delete\" command.",
             "properties": {
                 "geometry": {
-                    "$ref": "#/definitions/esri.Point",
-                    "description": "The point to delete from the active sketch. Not supported in Geocortex Mobile."
+                    "$ref": "#/definitions/esri.Geometry",
+                    "description": "The geometry to remove a point from. If this property is not specified, any active vertices will be deleted."
                 },
                 "maps": {
                     "$ref": "MapsLike",
                     "description": "Map(s) to use for the command/operation."
+                },
+                "partIndex": {
+                    "description": "The index of the part of the geometry that the point should be removed from. Required for polyline and polygon geometry types when the geometry and pointIndex properties are defined.",
+                    "type": "number"
+                },
+                "point": {
+                    "$ref": "#/definitions/esri.Point",
+                    "description": "The point to remove from the geometry. If this property is defined, the 'pointIndex' and 'partIndex' properties are ignored. If no point nor pointIndex/partIndex are specified, any active points will be deleted. If there are no active points, the entire geometry will be deleted."
+                },
+                "pointIndex": {
+                    "description": "The index of the point that should be removed from the geometry. If this property is defined, the geometry property must also be defined.",
+                    "type": "number"
                 }
             },
             "type": "object"
@@ -683,8 +721,8 @@
                     "type": "boolean"
                 },
                 "message": {
-                    "description": "The message to be displayed in the notification.",
-                    "type": "string"
+                    "$ref": "#/definitions/TranslatableText",
+                    "description": "The message to be displayed in the notification. Mobile only supports a string for this property."
                 },
                 "notificationGroup": {
                     "description": "Notifications in the same notification group are mutually exclusive, and will supersede one another. Mobile only.",
@@ -793,6 +831,10 @@
                     "description": "Whether to allow scaling of the edited geometry. Defaults to true.",
                     "type": "boolean"
                 },
+                "enableVertexEditing": {
+                    "description": "Whether to allow the user to add, move, and remove vertices from a geometry. Defaults to true.",
+                    "type": "boolean"
+                },
                 "scaleMode": {
                     "description": "Setting \"free\" allows independent scaling on the x and y axis, \"preserve-aspect-ratio\" constrains scaling to the original aspect ratio. Defaults to \"preserve-aspect-ratio\".",
                     "enum": [
@@ -800,6 +842,10 @@
                         "preserve-aspect-ratio"
                     ],
                     "type": "string"
+                },
+                "validateGeometry": {
+                    "description": "Whether the resulting geometry is validated before it's returned from the operation. If the geometry is invalid upon completion, an error is thrown. Defaults to true.",
+                    "type": "boolean"
                 }
             },
             "type": "object"
@@ -1220,6 +1266,36 @@
             ],
             "type": "object"
         },
+        "InsertPointArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the \"sketching.insert-point\" command.",
+            "properties": {
+                "geometry": {
+                    "$ref": "#/definitions/esri.Geometry",
+                    "description": "The geometry to add the point to, if multiple are present in an active editing session. Not supported by Mobile."
+                },
+                "maps": {
+                    "$ref": "MapsLike",
+                    "description": "Map(s) to use for the command/operation."
+                },
+                "newPoint": {
+                    "$ref": "#/definitions/esri.Point",
+                    "description": "The new point to be added."
+                },
+                "partIndex": {
+                    "description": "The index of the part to which the point will be added. If null, the last part will be used.",
+                    "type": "number"
+                },
+                "pointIndex": {
+                    "description": "The index at which the point will be added. If null, the point will be added as the last point.",
+                    "type": "number"
+                }
+            },
+            "required": [
+                "newPoint"
+            ],
+            "type": "object"
+        },
         "JobParameters": {
             "additionalProperties": false,
             "description": "A set of parameters used to run a job.",
@@ -1760,6 +1836,61 @@
             },
             "type": "object"
         },
+        "TranslatableText": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/TranslateOptions"
+                },
+                {
+                    "type": "string"
+                }
+            ],
+            "description": "A translatable string, either a language string or a language string with arguments to pass into it."
+        },
+        "TranslateOptions": {
+            "additionalProperties": false,
+            "description": "The available options for the Locale Service translate function.",
+            "properties": {
+                "args": {
+                    "description": "The values to substitute into the format string if it contains substitution placeholders (see utilities/string/format in Geocortex API).",
+                    "items": {
+                    },
+                    "type": "array"
+                },
+                "currency": {
+                    "description": "The default unit of currency to use when formatting currency. See {@link NumberSettings.currency}.",
+                    "type": "string"
+                },
+                "dateFormat": {
+                    "description": "The default format to use when formatting dates. See {@link DateFormatter.format}.",
+                    "type": "string"
+                },
+                "fractionalDigits": {
+                    "description": "The default number of digits to show after the decimal point when formatting numbers. See {@link NumberSettings.fractionalDigits}.",
+                    "type": "number"
+                },
+                "locale": {
+                    "description": "The locale to use for translation. If not specified, the current locale will be used.",
+                    "type": "string"
+                },
+                "numberFormat": {
+                    "description": "The default format to use when formatting numbers. See {@link NumberFormatter.format}.",
+                    "type": "string"
+                },
+                "text": {
+                    "description": "The string to translate. If the text is a language resource key, then a localized version of that resource will be used if one exists, otherwise the original text is returned.",
+                    "type": "string"
+                },
+                "timeZone": {
+                    "description": "The time zone of a date being formatted.",
+                    "type": "string"
+                }
+            },
+            "required": [
+                "text"
+            ],
+            "type": "object"
+        },
         "UpdateResultsFeaturesArgs": {
             "additionalProperties": false,
             "description": "Arguments for various commands that affect a result component's features.",
@@ -11124,7 +11255,7 @@
             ]
         },
         "sketching.add-node-to-geometry": {
-            "description": "Adds a point to a given polyline or polygon geometry. Returns the resulting geometry. Deprecated in Mobile, use geometry.add-point instead.",
+            "description": "Deprecated - Mobile users should rather use \"geometry.add-point\"; Web users should use \"sketching.add-point\" or \"sketching.insert-point\" instead.",
             "enum": [
                 "sketching.add-node-to-geometry"
             ]
@@ -11135,6 +11266,15 @@
         "sketching.add-node-to-geometry:output": {
             "$ref": "#/definitions/esri.Geometry"
         },
+        "sketching.add-point": {
+            "description": "Adds a point to polygon, polyline, or multipoint using the selected index as the point to insert after.",
+            "enum": [
+                "sketching.add-point"
+            ]
+        },
+        "sketching.add-point:input": {
+            "$ref": "#/definitions/AddPointArgs"
+        },
         "sketching.capture-geometry": {
             "description": "Allows the user to create geometry by sketching on a map. Returns the geometry that was drawn, along with the map that it was drawn on.",
             "enum": [
@@ -11148,13 +11288,20 @@
             "$ref": "#/definitions/CaptureGeometryResult"
         },
         "sketching.delete": {
-            "description": "If a point is supplied while a sketching or editing operation is active, the vertex at that point will be deleted from the current geometry. If no point is supplied and a geometry editing session is active, the entire geometry will be deleted.",
+            "description": "If a point is supplied while a sketching or editing operation is active, the vertex at that point will be deleted from the current geometry. If no point is supplied, any active points in the session will be deleted. If there are no active points in the session, the entire geometry will be deleted.",
             "enum": [
                 "sketching.delete"
             ]
         },
         "sketching.delete:input": {
-            "$ref": "#/definitions/DeleteGeometryArgs"
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/DeleteGeometryArgs"
+                },
+                {
+                    "type": "null"
+                }
+            ]
         },
         "sketching.edit-geometry": {
             "description": "Allows the user to edit an existing geometry by drawing on a map. Returns the geometry that was edited, or the supplied feature with the altered geometry applied, along with the map that it was drawn on.",
@@ -11168,6 +11315,15 @@
         "sketching.edit-geometry:output": {
             "$ref": "#/definitions/EditGeometryResult"
         },
+        "sketching.insert-point": {
+            "description": "Inserts a point into a polygon, polyline, or multipoint at the specified index. If the partIndex is null, then the last part is used. If the pointIndex is null, then the new point is inserted at the end.",
+            "enum": [
+                "sketching.insert-point"
+            ]
+        },
+        "sketching.insert-point:input": {
+            "$ref": "#/definitions/InsertPointArgs"
+        },
         "sketching.redo": {
             "description": "Redoes the last undone edit while editing a geometry.",
             "enum": [
@@ -11187,7 +11343,7 @@
             "$ref": "#/definitions/SetGeometryModeArgs"
         },
         "sketching.stop": {
-            "description": "Stops geometry capturing or editing on a given map. Returns the current geometry. If validateGeometry parameter is true and geometry is invalid, returns null.",
+            "description": "Stops geometry capturing or editing on a given map. Returns the current geometry. If validateGeometry parameter is true and geometry is invalid, the operation will return null.",
             "enum": [
                 "sketching.stop"
             ]
@@ -11830,6 +11986,22 @@
                     ],
                     "type": "object"
                 },
+                {
+                    "additionalProperties": false,
+                    "properties": {
+                        "arguments": {
+                            "$ref": "#/definitions/sketching.add-point:input"
+                        },
+                        "name": {
+                            "$ref": "#/definitions/sketching.add-point"
+                        }
+                    },
+                    "required": [
+                        "name",
+                        "arguments"
+                    ],
+                    "type": "object"
+                },
                 {
                     "additionalProperties": false,
                     "properties": {
@@ -11846,6 +12018,22 @@
                     ],
                     "type": "object"
                 },
+                {
+                    "additionalProperties": false,
+                    "properties": {
+                        "arguments": {
+                            "$ref": "#/definitions/sketching.insert-point:input"
+                        },
+                        "name": {
+                            "$ref": "#/definitions/sketching.insert-point"
+                        }
+                    },
+                    "required": [
+                        "name",
+                        "arguments"
+                    ],
+                    "type": "object"
+                },
                 {
                     "additionalProperties": false,
                     "properties": {
@@ -12092,9 +12280,15 @@
                 {
                     "$ref": "#/definitions/search.clear"
                 },
+                {
+                    "$ref": "#/definitions/sketching.add-point"
+                },
                 {
                     "$ref": "#/definitions/sketching.delete"
                 },
+                {
+                    "$ref": "#/definitions/sketching.insert-point"
+                },
                 {
                     "$ref": "#/definitions/sketching.redo"
                 },