@vertigis/viewer-spec 48.7.1 → 48.8.0

package/messaging/common.d.ts

@@ -52,7 +52,7 @@ export interface CreateGraphicsResult {
      */
     graphics: Graphic[];
     /**
-     * The map that the graphics were created on.
+     * The map that the graphics were created on. Only available in Web.
      */
     maps: MapsLike;
 }

package/messaging/registry/drawing.d.ts

@@ -1,3 +1,4 @@
+import type Geometry from "@arcgis/core/geometry/Geometry";
 import type LineSymbol3D from "@arcgis/core/symbols/LineSymbol3D";
 import type PictureFillSymbol from "@arcgis/core/symbols/PictureFillSymbol";
 import type PictureMarkerSymbol from "@arcgis/core/symbols/PictureMarkerSymbol";
@@ -22,6 +23,7 @@ import { CommandRegistry } from "../CommandRegistry.js";
 import type { Operation } from "../Operation.js";
 import { OperationRegistry } from "../OperationRegistry.js";
 import type { CreateGraphicsResult, GeometryLike, HasFeatures, HasGraphics, HasLayers, HasMaps, HasSymbol, HasUITarget, SymbolLike } from "../common.js";
+import type { CaptureGeometryArgs } from "./sketching.js";
 /**
  * Symbols supported for drawing.
  */
@@ -70,7 +72,31 @@ export interface EditSymbolResult extends HasMaps, HasLayers, HasGraphics, HasFe
      */
     symbol: Symbol;
 }
+/**
+ * Arguments for the "drawing.create-graphics" operation. Only available in Mobile.
+ */
+export interface CreateGraphicsArgs {
+    /**
+     * The geometry that was captured.
+     */
+    geometry: Geometry;
+    /**
+     * The symbol that should be used to create the graphic. If null, a default
+     * is provided.
+     */
+    symbol?: Symbol;
+}
 export declare class DrawingCommands extends CommandRegistry {
+    /**
+     * Allows the user to draw on the map by capturing geometry, creating a
+     * graphic, and persisting the graphic on the map. This is a shortcut for
+     * the command chain ["sketching.capture-geometry",
+     * "drawing.create-graphics", "map.add-markup"]. Some default
+     * geometryEditorSettings are also applied.
+     *
+     * @mobileOnly
+     */
+    get draw(): Command<CaptureGeometryArgs>;
     /**
      * Sets a value that determines whether drawings will be synced
      * automatically across maps.
@@ -94,12 +120,16 @@ export declare class DrawingCommands extends CommandRegistry {
 }
 export declare class DrawingOperations extends OperationRegistry {
     /**
-     * Creates graphics out of geometries with the current symbols that are set
-     * on the DrawManager.
+     * Creates graphics.
      *
-     * @webOnly
+     * In Web, creates graphics out of GeometryLike args, with the current
+     * symbols that are set on the DrawManager.
+     *
+     * In Mobile, creates graphics from the given CreateGraphicsArgs or
+     * CreateGraphicsArgs[] (or some GeometryLike args). Any provided symbol
+     * parameter is used, otherwise a default symbol is used.
      */
-    get createGraphics(): Operation<GeometryLike, CreateGraphicsResult>;
+    get createGraphics(): Operation<CreateGraphicsArgs | CreateGraphicsArgs[] | GeometryLike, CreateGraphicsResult>;
     /**
      * Gets the value of the default point, line, or polygon symbol for the
      * provided geometry type.

package/messaging/registry/drawing.js

@@ -1 +1 @@
-import{CommandRegistry}from"../CommandRegistry.js";import{OperationRegistry}from"../OperationRegistry.js";export class DrawingCommands extends CommandRegistry{get setSync(){return this._messages.command("drawing.set-sync")}get setDefaultSymbol(){return this._messages.command("drawing.set-default-symbol")}get setSymbol(){return this._messages.command("drawing.set-symbol")}}export class DrawingOperations extends OperationRegistry{get createGraphics(){return this._messages.operation("drawing.create-graphics")}get getDefaultSymbol(){return this._messages.operation("drawing.get-default-symbol")}get getDefaultSymbol3D(){return this._messages.operation("drawing.get-default-symbol-3d")}get editSymbol(){return this._messages.operation("drawing.edit-symbol")}}
+import{CommandRegistry}from"../CommandRegistry.js";import{OperationRegistry}from"../OperationRegistry.js";export class DrawingCommands extends CommandRegistry{get draw(){return this._messages.command("drawing.draw")}get setSync(){return this._messages.command("drawing.set-sync")}get setDefaultSymbol(){return this._messages.command("drawing.set-default-symbol")}get setSymbol(){return this._messages.command("drawing.set-symbol")}}export class DrawingOperations extends OperationRegistry{get createGraphics(){return this._messages.operation("drawing.create-graphics")}get getDefaultSymbol(){return this._messages.operation("drawing.get-default-symbol")}get getDefaultSymbol3D(){return this._messages.operation("drawing.get-default-symbol-3d")}get editSymbol(){return this._messages.operation("drawing.edit-symbol")}}

package/messaging/registry/map.d.ts

@@ -1,3 +1,4 @@
+import type Graphic from "@arcgis/core/Graphic.js";
 import type EsriMap from "@arcgis/core/Map";
 import type Viewpoint from "@arcgis/core/Viewpoint";
 import type Extent from "@arcgis/core/geometry/Extent";
@@ -11,6 +12,7 @@ import type { LayerExtension } from "@vertigis/arcgis-extensions/mapping/LayerEx
 import type { MapExtension, ViewMode } from "@vertigis/arcgis-extensions/mapping/MapExtension";
 import type { GeometryType } from "@vertigis/arcgis-extensions/portal/Geometry";
 import type { OperationalLayer as OperationalLayerJson } from "@vertigis/arcgis-extensions/portal/OperationalLayer";
+import type { Symbol as SymbolJson } from "@vertigis/arcgis-extensions/portal/Symbol";
 import type { Action } from "@vertigis/arcgis-extensions/support/Action";
 import type { PortalItemLike } from "@vertigis/arcgis-extensions/utilities/portal";
 import type { Command } from "../Command.js";
@@ -583,7 +585,7 @@ export interface StartSketchArgs {
      */
     retainEditorSettings: boolean;
     /**
-     * The settings to be applied to the geometry editor.
+     * The settings to be applied to the sketch.
      */
     editorSettings: GeometryEditorSettings;
     /**
@@ -591,6 +593,19 @@ export interface StartSketchArgs {
      * sketch. Default is no limit. Mobile only.
      */
     maxSegments?: number;
+    /**
+     * An optional symbol to use.
+     */
+    symbol?: SymbolJson;
+}
+/**
+ * Arguments for the "map.add-markup" operation. Only available in Mobile.
+ */
+export interface AddMarkupArgs {
+    /**
+     * The graphics to add to the map.
+     */
+    graphics: Graphic[];
 }
 /**
  * Result of the "map.get-coordinate-transformation" operation.
@@ -627,9 +642,11 @@ export declare class MapCommands extends CommandRegistry {
     /**
      * Adds markup to the map(s).
      *
-     * @webOnly
+     * In Web, uses GraphicsLike args.
+     *
+     * In Mobile, uses AddMarkupArgs or some GraphicsLike args.
      */
-    get addMarkup(): Command<GraphicsLike>;
+    get addMarkup(): Command<AddMarkupArgs | GraphicsLike>;
     /**
      * Add the specified layer(s) to the maps(s). Layers will be inserted in the
      * order specified and will be added above existing layers in the drawing

package/messaging/registry/sketching.d.ts

@@ -224,6 +224,10 @@ export interface CaptureGeometryArgs {
      * sketch. Default is no limit. Mobile only.
      */
     maxSegments?: number;
+    /**
+     * The settings to be applied to the sketch. Mobile only.
+     */
+    editorSettings?: GeometryEditorSettings;
 }
 /**
  * Result of the "sketching.capture-geometry" operation.
@@ -521,7 +525,7 @@ export declare type EditorGeometryMode = "line" | "area";
  */
 export declare type EditorInteractionMode = "centerCrosshair" | "freehand";
 /**
- * Settings for the geometry editor.
+ * Settings for a sketch.
  */
 export interface GeometryEditorSettings {
     /**
@@ -540,6 +544,19 @@ export interface GeometryEditorSettings {
      * The editor interaction mode.
      */
     editorInteractionMode?: EditorInteractionMode;
+    /**
+     * A value indicating whether the sketch is using freehand or segment sketching.
+     */
+    freehand?: boolean;
+    /**
+     * A value indicating whether the sketch should stop when double clicking.
+     */
+    finishOnDoubleClick?: boolean;
+    /**
+     * A value indicating whether the sketch should commit its geometry if
+     * another sketch is activated.
+     */
+    finishIfInterrupted?: boolean;
 }
 /**
  * Result returned from the 'sketching.get-active-points' operation.

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

@@ -514,6 +514,23 @@
             ],
             "type": "object"
         },
+        "AddMarkupArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the \"map.add-markup\" operation. Only available in Mobile.",
+            "properties": {
+                "graphics": {
+                    "description": "The graphics to add to the map.",
+                    "items": {
+                        "$ref": "#/definitions/esri.Graphic"
+                    },
+                    "type": "array"
+                }
+            },
+            "required": [
+                "graphics"
+            ],
+            "type": "object"
+        },
         "AddNodeOrder": {
             "description": "Indicates whether a new point should be added before or after the active point in a sketch.",
             "enum": [
@@ -599,6 +616,10 @@
             "additionalProperties": false,
             "description": "Arguments for the \"sketching.capture-geometry\" operation.",
             "properties": {
+                "editorSettings": {
+                    "$ref": "#/definitions/GeometryEditorSettings",
+                    "description": "The settings to be applied to the sketch. Mobile only."
+                },
                 "geometryType": {
                     "anyOf": [
                         {
@@ -723,6 +744,24 @@
             },
             "type": "object"
         },
+        "CreateGraphicsArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the \"drawing.create-graphics\" operation. Only available in Mobile.",
+            "properties": {
+                "geometry": {
+                    "$ref": "#/definitions/esri.Geometry",
+                    "description": "The geometry that was captured."
+                },
+                "symbol": {
+                    "$ref": "#/definitions/esri.Symbol",
+                    "description": "The symbol that should be used to create the graphic. If null, a default is provided."
+                }
+            },
+            "required": [
+                "geometry"
+            ],
+            "type": "object"
+        },
         "CreateGraphicsResult": {
             "additionalProperties": false,
             "description": "Result of the \"drawing.create-graphics\" and \"measurement.create-graphics\" operations.",
@@ -736,7 +775,7 @@
                 },
                 "maps": {
                     "$ref": "MapsLike",
-                    "description": "The map that the graphics were created on."
+                    "description": "The map that the graphics were created on. Only available in Web."
                 }
             },
             "required": [
@@ -1130,6 +1169,22 @@
             },
             "type": "object"
         },
+        "EditorGeometryMode": {
+            "description": "The editor geometry mode.",
+            "enum": [
+                "area",
+                "line"
+            ],
+            "type": "string"
+        },
+        "EditorInteractionMode": {
+            "description": "The editor interaction mode.",
+            "enum": [
+                "centerCrosshair",
+                "freehand"
+            ],
+            "type": "string"
+        },
         "Features": {
             "anyOf": [
                 {
@@ -1297,6 +1352,41 @@
             ],
             "type": "object"
         },
+        "GeometryEditorSettings": {
+            "additionalProperties": false,
+            "description": "Settings for a sketch.",
+            "properties": {
+                "editorGeometryMode": {
+                    "$ref": "#/definitions/EditorGeometryMode",
+                    "description": "The editor geometry mode."
+                },
+                "editorInteractionMode": {
+                    "$ref": "#/definitions/EditorInteractionMode",
+                    "description": "The editor interaction mode."
+                },
+                "finishIfInterrupted": {
+                    "description": "A value indicating whether the sketch should commit its geometry if another sketch is activated.",
+                    "type": "boolean"
+                },
+                "finishOnDoubleClick": {
+                    "description": "A value indicating whether the sketch should stop when double clicking.",
+                    "type": "boolean"
+                },
+                "freehand": {
+                    "description": "A value indicating whether the sketch is using freehand or segment sketching.",
+                    "type": "boolean"
+                },
+                "showBearings": {
+                    "description": "A value indicating whether bearing labels should be shown on the map.",
+                    "type": "boolean"
+                },
+                "snappingEnabled": {
+                    "description": "A value indicating whether snapping should be enabled.",
+                    "type": "boolean"
+                }
+            },
+            "type": "object"
+        },
         "GeometryLike": {
             "anyOf": [
                 {
@@ -2432,6 +2522,121 @@
         "basemap.set:input": {
             "$ref": "#/definitions/SetBasemapArgs"
         },
+        "drawing.create-graphics": {
+            "description": "Creates graphics. In Web, creates graphics out of GeometryLike args, with the current symbols that are set on the DrawManager. In Mobile, creates graphics from the given CreateGraphicsArgs or CreateGraphicsArgs[] (or some GeometryLike args). Any provided symbol parameter is used, otherwise a default symbol is used.",
+            "enum": [
+                "drawing.create-graphics"
+            ]
+        },
+        "drawing.create-graphics:input": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/esri.Geometry"
+                },
+                {
+                    "$ref": "#/definitions/esri.Graphic"
+                },
+                {
+                    "$ref": "#/definitions/esri.FeatureSet"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Extent.Extent"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Multipoint.Multipoint"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Polygon.Polygon"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Polyline.Polyline"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Point.Point"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Feature.Feature"
+                },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data.FeatureSet.FeatureSet"
+                },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data.Feature.Feature"
+                },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data.FeatureStream.FeatureStream"
+                },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data.FeatureList.FeatureList"
+                },
+                {
+                    "$ref": "#/definitions/CreateGraphicsResult"
+                },
+                {
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "@vertigis.arcgis-extensions.data.Feature.Feature"
+                            },
+                            {
+                                "$ref": "@vertigis.arcgis-extensions.data.Feature.FeatureProperties"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                {
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "#/definitions/esri.Graphic"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Feature.Feature"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                {
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "#/definitions/esri.Geometry"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Extent.Extent"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Multipoint.Multipoint"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Polygon.Polygon"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Polyline.Polyline"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Point.Point"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                {
+                    "$ref": "#/definitions/CreateGraphicsArgs"
+                },
+                {
+                    "items": {
+                        "$ref": "#/definitions/CreateGraphicsArgs"
+                    },
+                    "type": "array"
+                }
+            ]
+        },
+        "drawing.create-graphics:output": {
+            "$ref": "#/definitions/CreateGraphicsResult"
+        },
         "drawing.set-sync": {
             "description": "Sets a value that determines whether drawings will be synced automatically across maps.",
             "enum": [
@@ -11085,6 +11290,44 @@
         "highlights.remove:input": {
             "$ref": "#/definitions/Features"
         },
+        "map.add-markup": {
+            "description": "Adds markup to the map(s). In Web, uses GraphicsLike args. In Mobile, uses AddMarkupArgs or some GraphicsLike args.",
+            "enum": [
+                "map.add-markup"
+            ]
+        },
+        "map.add-markup:input": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/esri.Graphic"
+                },
+                {
+                    "$ref": "#/definitions/esri.FeatureSet"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Feature.Feature"
+                },
+                {
+                    "$ref": "#/definitions/CreateGraphicsResult"
+                },
+                {
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "#/definitions/esri.Graphic"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Feature.Feature"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                {
+                    "$ref": "#/definitions/AddMarkupArgs"
+                }
+            ]
+        },
         "map.get-spatial-reference": {
             "description": "If a map extension ID is specified, returns the spatial reference for that map. If no map extension ID is specified, returns the spatial reference of the first available map.",
             "enum": [
@@ -12055,6 +12298,22 @@
                     ],
                     "type": "object"
                 },
+                {
+                    "additionalProperties": false,
+                    "properties": {
+                        "arguments": {
+                            "$ref": "#/definitions/map.add-markup:input"
+                        },
+                        "name": {
+                            "$ref": "#/definitions/map.add-markup"
+                        }
+                    },
+                    "required": [
+                        "name",
+                        "arguments"
+                    ],
+                    "type": "object"
+                },
                 {
                     "additionalProperties": false,
                     "properties": {
@@ -12565,6 +12824,9 @@
                 {
                     "$ref": "#/definitions/highlights.remove-focus"
                 },
+                {
+                    "$ref": "#/definitions/map.add-markup"
+                },
                 {
                     "$ref": "#/definitions/map.pan-to-features"
                 },
@@ -12688,6 +12950,22 @@
                     ],
                     "type": "object"
                 },
+                {
+                    "additionalProperties": false,
+                    "properties": {
+                        "arguments": {
+                            "$ref": "#/definitions/drawing.create-graphics:input"
+                        },
+                        "name": {
+                            "$ref": "#/definitions/drawing.create-graphics"
+                        }
+                    },
+                    "required": [
+                        "name",
+                        "arguments"
+                    ],
+                    "type": "object"
+                },
                 {
                     "additionalProperties": false,
                     "properties": {
@@ -12857,6 +13135,9 @@
                 {
                     "$ref": "#/definitions/basemap.get-current"
                 },
+                {
+                    "$ref": "#/definitions/drawing.create-graphics"
+                },
                 {
                     "$ref": "#/definitions/geolocation.get-current-state"
                 },

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

@@ -487,6 +487,23 @@
             ],
             "type": "object"
         },
+        "AddMarkupArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the \"map.add-markup\" operation. Only available in Mobile.",
+            "properties": {
+                "graphics": {
+                    "description": "The graphics to add to the map.",
+                    "items": {
+                        "$ref": "#/definitions/esri.Graphic"
+                    },
+                    "type": "array"
+                }
+            },
+            "required": [
+                "graphics"
+            ],
+            "type": "object"
+        },
         "AddNodeOrder": {
             "description": "Indicates whether a new point should be added before or after the active point in a sketch.",
             "enum": [
@@ -689,6 +706,10 @@
             "additionalProperties": false,
             "description": "Arguments for the \"sketching.capture-geometry\" operation.",
             "properties": {
+                "editorSettings": {
+                    "$ref": "#/definitions/GeometryEditorSettings",
+                    "description": "The settings to be applied to the sketch. Mobile only."
+                },
                 "geometryType": {
                     "anyOf": [
                         {
@@ -856,6 +877,24 @@
             ],
             "type": "object"
         },
+        "CreateGraphicsArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the \"drawing.create-graphics\" operation. Only available in Mobile.",
+            "properties": {
+                "geometry": {
+                    "$ref": "#/definitions/esri.Geometry",
+                    "description": "The geometry that was captured."
+                },
+                "symbol": {
+                    "$ref": "#/definitions/esri.Symbol",
+                    "description": "The symbol that should be used to create the graphic. If null, a default is provided."
+                }
+            },
+            "required": [
+                "geometry"
+            ],
+            "type": "object"
+        },
         "CreateGraphicsResult": {
             "additionalProperties": false,
             "description": "Result of the \"drawing.create-graphics\" and \"measurement.create-graphics\" operations.",
@@ -869,7 +908,7 @@
                 },
                 "maps": {
                     "$ref": "MapsLike",
-                    "description": "The map that the graphics were created on."
+                    "description": "The map that the graphics were created on. Only available in Web."
                 }
             },
             "required": [
@@ -1590,7 +1629,7 @@
         },
         "GeometryEditorSettings": {
             "additionalProperties": false,
-            "description": "Settings for the geometry editor.",
+            "description": "Settings for a sketch.",
             "properties": {
                 "editorGeometryMode": {
                     "$ref": "#/definitions/EditorGeometryMode",
@@ -1600,6 +1639,18 @@
                     "$ref": "#/definitions/EditorInteractionMode",
                     "description": "The editor interaction mode."
                 },
+                "finishIfInterrupted": {
+                    "description": "A value indicating whether the sketch should commit its geometry if another sketch is activated.",
+                    "type": "boolean"
+                },
+                "finishOnDoubleClick": {
+                    "description": "A value indicating whether the sketch should stop when double clicking.",
+                    "type": "boolean"
+                },
+                "freehand": {
+                    "description": "A value indicating whether the sketch is using freehand or segment sketching.",
+                    "type": "boolean"
+                },
                 "showBearings": {
                     "description": "A value indicating whether bearing labels should be shown on the map.",
                     "type": "boolean"
@@ -2888,7 +2939,7 @@
                 },
                 "editorSettings": {
                     "$ref": "#/definitions/GeometryEditorSettings",
-                    "description": "The settings to be applied to the geometry editor."
+                    "description": "The settings to be applied to the sketch."
                 },
                 "geometry": {
                     "$ref": "#/definitions/esri.Geometry",
@@ -2913,6 +2964,10 @@
                 "retainEditorSettings": {
                     "description": "A value indicating whether the previous geometry editor settings should be restored after this sketch is stopped.",
                     "type": "boolean"
+                },
+                "symbol": {
+                    "$ref": "#/definitions/esri.rest-api.Symbol.Symbol",
+                    "description": "An optional symbol to use."
                 }
             },
             "required": [
@@ -3349,6 +3404,130 @@
                 "debug-console.display"
             ]
         },
+        "drawing.create-graphics": {
+            "description": "Creates graphics. In Web, creates graphics out of GeometryLike args, with the current symbols that are set on the DrawManager. In Mobile, creates graphics from the given CreateGraphicsArgs or CreateGraphicsArgs[] (or some GeometryLike args). Any provided symbol parameter is used, otherwise a default symbol is used.",
+            "enum": [
+                "drawing.create-graphics"
+            ]
+        },
+        "drawing.create-graphics:input": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/esri.Geometry"
+                },
+                {
+                    "$ref": "#/definitions/esri.Graphic"
+                },
+                {
+                    "$ref": "#/definitions/esri.FeatureSet"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Extent.Extent"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Multipoint.Multipoint"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Polygon.Polygon"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Polyline.Polyline"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Point.Point"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Feature.Feature"
+                },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data.FeatureSet.FeatureSet"
+                },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data.Feature.Feature"
+                },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data.FeatureStream.FeatureStream"
+                },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data.FeatureList.FeatureList"
+                },
+                {
+                    "$ref": "#/definitions/CreateGraphicsResult"
+                },
+                {
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "@vertigis.arcgis-extensions.data.Feature.Feature"
+                            },
+                            {
+                                "$ref": "@vertigis.arcgis-extensions.data.Feature.FeatureProperties"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                {
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "#/definitions/esri.Graphic"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Feature.Feature"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                {
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "#/definitions/esri.Geometry"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Extent.Extent"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Multipoint.Multipoint"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Polygon.Polygon"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Polyline.Polyline"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Point.Point"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                {
+                    "$ref": "#/definitions/CreateGraphicsArgs"
+                },
+                {
+                    "items": {
+                        "$ref": "#/definitions/CreateGraphicsArgs"
+                    },
+                    "type": "array"
+                }
+            ]
+        },
+        "drawing.create-graphics:output": {
+            "$ref": "#/definitions/CreateGraphicsResult"
+        },
+        "drawing.draw": {
+            "description": "Allows the user to draw on the map by capturing geometry, creating a graphic, and persisting the graphic on the map. This is a shortcut for the command chain [\"sketching.capture-geometry\", \"drawing.create-graphics\", \"map.add-markup\"]. Some default geometryEditorSettings are also applied.",
+            "enum": [
+                "drawing.draw"
+            ]
+        },
+        "drawing.draw:input": {
+            "$ref": "#/definitions/CaptureGeometryArgs"
+        },
         "drawing.set-sync": {
             "description": "Sets a value that determines whether drawings will be synced automatically across maps.",
             "enum": [
@@ -12271,6 +12450,44 @@
                 "log-viewer.display"
             ]
         },
+        "map.add-markup": {
+            "description": "Adds markup to the map(s). In Web, uses GraphicsLike args. In Mobile, uses AddMarkupArgs or some GraphicsLike args.",
+            "enum": [
+                "map.add-markup"
+            ]
+        },
+        "map.add-markup:input": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/esri.Graphic"
+                },
+                {
+                    "$ref": "#/definitions/esri.FeatureSet"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Feature.Feature"
+                },
+                {
+                    "$ref": "#/definitions/CreateGraphicsResult"
+                },
+                {
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "#/definitions/esri.Graphic"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Feature.Feature"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                {
+                    "$ref": "#/definitions/AddMarkupArgs"
+                }
+            ]
+        },
         "map.disable-map-click": {
             "description": "Disables the click event handler on the map, so that if the user clicks on the map, the configured handler will not be invoked.",
             "enum": [
@@ -13666,6 +13883,22 @@
                     ],
                     "type": "object"
                 },
+                {
+                    "additionalProperties": false,
+                    "properties": {
+                        "arguments": {
+                            "$ref": "#/definitions/drawing.draw:input"
+                        },
+                        "name": {
+                            "$ref": "#/definitions/drawing.draw"
+                        }
+                    },
+                    "required": [
+                        "name",
+                        "arguments"
+                    ],
+                    "type": "object"
+                },
                 {
                     "additionalProperties": false,
                     "properties": {
@@ -14226,6 +14459,22 @@
                     ],
                     "type": "object"
                 },
+                {
+                    "additionalProperties": false,
+                    "properties": {
+                        "arguments": {
+                            "$ref": "#/definitions/map.add-markup:input"
+                        },
+                        "name": {
+                            "$ref": "#/definitions/map.add-markup"
+                        }
+                    },
+                    "required": [
+                        "name",
+                        "arguments"
+                    ],
+                    "type": "object"
+                },
                 {
                     "additionalProperties": false,
                     "properties": {
@@ -15357,6 +15606,9 @@
                 {
                     "$ref": "#/definitions/debug-console.display"
                 },
+                {
+                    "$ref": "#/definitions/drawing.draw"
+                },
                 {
                     "$ref": "#/definitions/drawing.set-sync"
                 },
@@ -15480,6 +15732,9 @@
                 {
                     "$ref": "#/definitions/log-viewer.display"
                 },
+                {
+                    "$ref": "#/definitions/map.add-markup"
+                },
                 {
                     "$ref": "#/definitions/map.disable-map-click"
                 },
@@ -15763,6 +16018,22 @@
                     ],
                     "type": "object"
                 },
+                {
+                    "additionalProperties": false,
+                    "properties": {
+                        "arguments": {
+                            "$ref": "#/definitions/drawing.create-graphics:input"
+                        },
+                        "name": {
+                            "$ref": "#/definitions/drawing.create-graphics"
+                        }
+                    },
+                    "required": [
+                        "name",
+                        "arguments"
+                    ],
+                    "type": "object"
+                },
                 {
                     "additionalProperties": false,
                     "properties": {
@@ -16367,6 +16638,9 @@
                 {
                     "$ref": "#/definitions/basemap.get-current"
                 },
+                {
+                    "$ref": "#/definitions/drawing.create-graphics"
+                },
                 {
                     "$ref": "#/definitions/file.pick-file"
                 },

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

@@ -766,6 +766,23 @@
             ],
             "type": "object"
         },
+        "AddMarkupArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the \"map.add-markup\" operation. Only available in Mobile.",
+            "properties": {
+                "graphics": {
+                    "description": "The graphics to add to the map.",
+                    "items": {
+                        "$ref": "#/definitions/esri.Graphic"
+                    },
+                    "type": "array"
+                }
+            },
+            "required": [
+                "graphics"
+            ],
+            "type": "object"
+        },
         "AddNodeOrder": {
             "description": "Indicates whether a new point should be added before or after the active point in a sketch.",
             "enum": [
@@ -1039,6 +1056,10 @@
             "additionalProperties": false,
             "description": "Arguments for the \"sketching.capture-geometry\" operation.",
             "properties": {
+                "editorSettings": {
+                    "$ref": "#/definitions/GeometryEditorSettings",
+                    "description": "The settings to be applied to the sketch. Mobile only."
+                },
                 "geometryType": {
                     "anyOf": [
                         {
@@ -1240,6 +1261,24 @@
             },
             "type": "object"
         },
+        "CreateGraphicsArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the \"drawing.create-graphics\" operation. Only available in Mobile.",
+            "properties": {
+                "geometry": {
+                    "$ref": "#/definitions/esri.Geometry",
+                    "description": "The geometry that was captured."
+                },
+                "symbol": {
+                    "$ref": "#/definitions/esri.Symbol",
+                    "description": "The symbol that should be used to create the graphic. If null, a default is provided."
+                }
+            },
+            "required": [
+                "geometry"
+            ],
+            "type": "object"
+        },
         "CreateGraphicsResult": {
             "additionalProperties": false,
             "description": "Result of the \"drawing.create-graphics\" and \"measurement.create-graphics\" operations.",
@@ -1253,7 +1292,7 @@
                 },
                 "maps": {
                     "$ref": "MapsLike",
-                    "description": "The map that the graphics were created on."
+                    "description": "The map that the graphics were created on. Only available in Web."
                 }
             },
             "required": [
@@ -1313,7 +1352,7 @@
                 },
                 "maps": {
                     "$ref": "MapsLike",
-                    "description": "The map that the graphics were created on."
+                    "description": "The map that the graphics were created on. Only available in Web."
                 }
             },
             "required": [
@@ -1903,6 +1942,22 @@
             ],
             "type": "object"
         },
+        "EditorGeometryMode": {
+            "description": "The editor geometry mode.",
+            "enum": [
+                "area",
+                "line"
+            ],
+            "type": "string"
+        },
+        "EditorInteractionMode": {
+            "description": "The editor interaction mode.",
+            "enum": [
+                "centerCrosshair",
+                "freehand"
+            ],
+            "type": "string"
+        },
         "Features": {
             "anyOf": [
                 {
@@ -2542,6 +2597,41 @@
             ],
             "description": "An object that is convertible to one or more geometries, or an object that has geometry."
         },
+        "GeometryEditorSettings": {
+            "additionalProperties": false,
+            "description": "Settings for a sketch.",
+            "properties": {
+                "editorGeometryMode": {
+                    "$ref": "#/definitions/EditorGeometryMode",
+                    "description": "The editor geometry mode."
+                },
+                "editorInteractionMode": {
+                    "$ref": "#/definitions/EditorInteractionMode",
+                    "description": "The editor interaction mode."
+                },
+                "finishIfInterrupted": {
+                    "description": "A value indicating whether the sketch should commit its geometry if another sketch is activated.",
+                    "type": "boolean"
+                },
+                "finishOnDoubleClick": {
+                    "description": "A value indicating whether the sketch should stop when double clicking.",
+                    "type": "boolean"
+                },
+                "freehand": {
+                    "description": "A value indicating whether the sketch is using freehand or segment sketching.",
+                    "type": "boolean"
+                },
+                "showBearings": {
+                    "description": "A value indicating whether bearing labels should be shown on the map.",
+                    "type": "boolean"
+                },
+                "snappingEnabled": {
+                    "description": "A value indicating whether snapping should be enabled.",
+                    "type": "boolean"
+                }
+            },
+            "type": "object"
+        },
         "GeometryLike": {
             "anyOf": [
                 {
@@ -5773,13 +5863,116 @@
             "$ref": "#/definitions/UpdateChartDefinitionArgs"
         },
         "drawing.create-graphics": {
-            "description": "Creates graphics out of geometries with the current symbols that are set on the DrawManager.",
+            "description": "Creates graphics. In Web, creates graphics out of GeometryLike args, with the current symbols that are set on the DrawManager. In Mobile, creates graphics from the given CreateGraphicsArgs or CreateGraphicsArgs[] (or some GeometryLike args). Any provided symbol parameter is used, otherwise a default symbol is used.",
             "enum": [
                 "drawing.create-graphics"
             ]
         },
         "drawing.create-graphics:input": {
-            "$ref": "#/definitions/GeometryLike"
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/esri.Geometry"
+                },
+                {
+                    "$ref": "#/definitions/esri.Graphic"
+                },
+                {
+                    "$ref": "#/definitions/esri.FeatureSet"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Extent.Extent"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Multipoint.Multipoint"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Polygon.Polygon"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Polyline.Polyline"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Point.Point"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Feature.Feature"
+                },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data.FeatureSet.FeatureSet"
+                },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data.Feature.Feature"
+                },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data.FeatureStream.FeatureStream"
+                },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data.FeatureList.FeatureList"
+                },
+                {
+                    "$ref": "#/definitions/CreateGraphicsResult"
+                },
+                {
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "@vertigis.arcgis-extensions.data.Feature.Feature"
+                            },
+                            {
+                                "$ref": "@vertigis.arcgis-extensions.data.Feature.FeatureProperties"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                {
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "#/definitions/esri.Graphic"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Feature.Feature"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                {
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "#/definitions/esri.Geometry"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Extent.Extent"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Multipoint.Multipoint"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Polygon.Polygon"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Polyline.Polyline"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Point.Point"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                {
+                    "$ref": "#/definitions/CreateGraphicsArgs"
+                },
+                {
+                    "items": {
+                        "$ref": "#/definitions/CreateGraphicsArgs"
+                    },
+                    "type": "array"
+                }
+            ]
         },
         "drawing.create-graphics:output": {
             "$ref": "#/definitions/CreateGraphicsResult"
@@ -15204,13 +15397,42 @@
             "$ref": "#/definitions/AddLayersArgs"
         },
         "map.add-markup": {
-            "description": "Adds markup to the map(s).",
+            "description": "Adds markup to the map(s). In Web, uses GraphicsLike args. In Mobile, uses AddMarkupArgs or some GraphicsLike args.",
             "enum": [
                 "map.add-markup"
             ]
         },
         "map.add-markup:input": {
-            "$ref": "#/definitions/GraphicsLike"
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/esri.Graphic"
+                },
+                {
+                    "$ref": "#/definitions/esri.FeatureSet"
+                },
+                {
+                    "$ref": "#/definitions/esri.rest-api.Feature.Feature"
+                },
+                {
+                    "$ref": "#/definitions/CreateGraphicsResult"
+                },
+                {
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "#/definitions/esri.Graphic"
+                            },
+                            {
+                                "$ref": "#/definitions/esri.rest-api.Feature.Feature"
+                            }
+                        ]
+                    },
+                    "type": "array"
+                },
+                {
+                    "$ref": "#/definitions/AddMarkupArgs"
+                }
+            ]
         },
         "map.apply-filter-effect": {
             "description": "Applies a Filter Effect to the map(s).",

package/messaging/schema/web-event.schema.json

@@ -390,7 +390,7 @@
                 },
                 "maps": {
                     "$ref": "MapsLike",
-                    "description": "The map that the graphics were created on."
+                    "description": "The map that the graphics were created on. Only available in Web."
                 }
             },
             "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertigis/viewer-spec",
-  "version": "48.7.1",
+  "version": "48.8.0",
   "license": "SEE LICENSE IN LICENSE",
   "description": "VertiGIS Viewer Specification",
   "type": "module",

package/version.d.ts

@@ -1,4 +1,4 @@
 /**
  * The current version of the Geocortex Viewer Specification.
  */
-export declare const version = "48.7.1";
+export declare const version = "48.8.0";

package/version.js

@@ -1,4 +1,4 @@
 /**
  * The current version of the Geocortex Viewer Specification.
  */
-export const version = "48.7.1";
+export const version = "48.8.0";