@vertigis/viewer-spec 46.1.0 → 46.4.0

package/messaging/registry/app.d.ts

@@ -57,6 +57,18 @@ export declare class AppCommands extends CommandRegistry {
      * @mobileOnly
      */
     get refresh(): Command;
+    /**
+     * Adds the currently loaded app to the user's Favorites collection.
+     *
+     * @mobileOnly
+     */
+    get favorite(): Command;
+    /**
+     * Removes the currently loaded app from the user's Favorites collection.
+     *
+     * @mobileOnly
+     */
+    get unfavorite(): Command;
     /**
      * Loads a project's app config and updates the application's current state,
      * accordingly. If more than one file is provided, only the first will be

package/messaging/registry/app.js

@@ -1 +1 @@
-import{CommandRegistry}from"../CommandRegistry.js";import{EventRegistry}from"../EventRegistry.js";import{OperationRegistry}from"../OperationRegistry.js";export class AppCommands extends CommandRegistry{get goToAppSelector(){return this._messages.command("app.go-to-app-selector")}get refresh(){return this._messages.command("app.refresh")}get loadProject(){return this._messages.command("app.load-project")}}export class AppEvents extends EventRegistry{constructor(){super(...arguments),this.custom=new AppCustomEvents(this._messages),this.generic=new AppGenericEvents(this._messages)}get activated(){return this._messages.event("app.activated")}get backgrounded(){return this._messages.event("app.backgrounded")}get specificAppStarted(){return this._messages.event("app.specific-app-started")}get interrupted(){return this._messages.event("app.interrupted")}}export class AppCustomEvents extends EventRegistry{get started(){return this._messages.event("app.custom.started")}}export class AppGenericEvents extends EventRegistry{get started(){return this._messages.event("app.generic.started")}get appsListed(){return this._messages.event("app.generic.apps-listed")}}export class AppOperations extends OperationRegistry{get getVersion(){return this._messages.operation("app.get-version")}get createProject(){return this._messages.operation("app.create-project")}}
+import{CommandRegistry}from"../CommandRegistry.js";import{EventRegistry}from"../EventRegistry.js";import{OperationRegistry}from"../OperationRegistry.js";export class AppCommands extends CommandRegistry{get goToAppSelector(){return this._messages.command("app.go-to-app-selector")}get refresh(){return this._messages.command("app.refresh")}get favorite(){return this._messages.command("app.favorite")}get unfavorite(){return this._messages.command("app.unfavorite")}get loadProject(){return this._messages.command("app.load-project")}}export class AppEvents extends EventRegistry{constructor(){super(...arguments),this.custom=new AppCustomEvents(this._messages),this.generic=new AppGenericEvents(this._messages)}get activated(){return this._messages.event("app.activated")}get backgrounded(){return this._messages.event("app.backgrounded")}get specificAppStarted(){return this._messages.event("app.specific-app-started")}get interrupted(){return this._messages.event("app.interrupted")}}export class AppCustomEvents extends EventRegistry{get started(){return this._messages.event("app.custom.started")}}export class AppGenericEvents extends EventRegistry{get started(){return this._messages.event("app.generic.started")}get appsListed(){return this._messages.event("app.generic.apps-listed")}}export class AppOperations extends OperationRegistry{get getVersion(){return this._messages.operation("app.get-version")}get createProject(){return this._messages.operation("app.create-project")}}

package/messaging/registry/map.d.ts

@@ -8,7 +8,7 @@ import type GeographicTransformation from "@arcgis/core/geometry/support/Geograp
 import type Layer from "@arcgis/core/layers/Layer";
 import type { LayerPreset } from "@vertigis/arcgis-extensions/layer-preset/LayerPreset";
 import type { LayerExtension } from "@vertigis/arcgis-extensions/mapping/LayerExtension";
-import type { MapExtension } from "@vertigis/arcgis-extensions/mapping/MapExtension";
+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 { Action } from "@vertigis/arcgis-extensions/support/Action";
@@ -34,6 +34,15 @@ export interface MapEvent {
      */
     maps?: MapsLike;
 }
+/**
+ * Arguments for the ViewModeChanged event.
+ */
+export interface ViewModeChangedEvent extends MapEvent {
+    /**
+     * The new ViewMode.
+     */
+    viewMode?: ViewMode;
+}
 /**
  * Arguments for the map.zoom-to-viewpoint command.
  */
@@ -892,6 +901,13 @@ export declare class MapEvents extends EventRegistry {
      * @mobileOnly
      */
     get rotating(): Event<MapEvent>;
+    /**
+     * Raised when a map's {@link ViewMode} is changed. This happens when the map
+     * view is changed between a WebMap and a WebScene.
+     *
+     * @webOnly
+     */
+    get viewModeChanged(): Event<ViewModeChangedEvent>;
     /**
      * Raised when the a map extent is changed. This event is raised in
      * extremely high frequency - for example, every few pixels the map is

package/messaging/registry/map.js

@@ -1 +1 @@
-import{CommandRegistry}from"../CommandRegistry.js";import{EventRegistry}from"../EventRegistry.js";import{OperationRegistry}from"../OperationRegistry.js";export class MapCommands extends CommandRegistry{get addMarkup(){return this._messages.command("map.add-markup")}get addLayers(){return this._messages.command("map.add-layers")}get applyFilterEffect(){return this._messages.command("map.apply-filter-effect")}get applyLayerPreset(){return this._messages.command("map.apply-layer-preset")}get createNote(){return this._messages.command("map.create-note")}get editNote(){return this._messages.command("map.edit-note")}get removeFilterEffects(){return this._messages.command("map.remove-filter-effects")}get clearFilterEffects(){return this._messages.command("map.clear-filter-effects")}get clearMarkup(){return this._messages.command("map.clear-markup")}get disableMapClick(){return this._messages.command("map.disable-map-click")}get displayExtentSelector(){return this._messages.command("map.display-extent-selector")}get enableMapClick(){return this._messages.command("map.enable-map-click")}get goToFeatures(){return this._messages.command("map.go-to-features")}get goToGeometry(){return this._messages.command("map.go-to-geometry")}get goToViewpoint(){return this._messages.command("map.go-to-viewpoint")}get goToScale(){return this._messages.command("map.go-to-scale")}get goToInitialViewpoint(){return this._messages.command("map.go-to-initial-viewpoint")}get goToLayerExtent(){return this._messages.command("map.go-to-layer-extent")}get hideExtentSelector(){return this._messages.command("map.hide-extent-selector")}get panToFeatures(){return this._messages.command("map.pan-to-features")}get panToGeometry(){return this._messages.command("map.pan-to-geometry")}get pauseSketch(){return this._messages.command("map.pause-sketch")}get removeLayers(){return this._messages.command("map.remove-layers")}get replace(){return this._messages.command("map.replace")}get replaceAdditionalLayers(){return this._messages.command("map.replace-additional-layers")}get replaceMmpk(){return this._messages.command("map.replace-mmpk")}get resumeSketch(){return this._messages.command("map.resume-sketch")}get rotateBy(){return this._messages.command("map.rotate-by")}get rotateTo(){return this._messages.command("map.rotate-to")}get refresh(){return this._messages.command("map.refresh")}get updateLayer(){return this._messages.command("map.update-layer")}get zoomToFeatures(){return this._messages.command("map.zoom-to-features")}get zoomToGeometry(){return this._messages.command("map.zoom-to-geometry")}get zoomIn(){return this._messages.command("map.zoom-in")}get zoomOut(){return this._messages.command("map.zoom-out")}get zoomToScale(){return this._messages.command("map.zoom-to-scale")}get zoomToInitialViewpoint(){return this._messages.command("map.zoom-to-initial-viewpoint")}get zoomToViewpoint(){return this._messages.command("map.zoom-to-viewpoint")}get zoomToLayerExtent(){return this._messages.command("map.zoom-to-layer-extent")}get zoomToLayerVisibleScale(){return this._messages.command("map.zoom-to-layer-visible-scale")}}export class MapEvents extends EventRegistry{get initialized(){return this._messages.event("map.initialized")}get initializing(){return this._messages.event("map.initializing")}get navigationCompleted(){return this._messages.event("map.navigation-completed")}get refreshed(){return this._messages.event("map.refreshed")}get refreshing(){return this._messages.event("map.refreshing")}get rotated(){return this._messages.event("map.rotated")}get rotating(){return this._messages.event("map.rotating")}get viewpointChanged(){return this._messages.event("map.viewpoint-changed")}}export class MapOperations extends OperationRegistry{get getUserCoordinatesInput(){return this._messages.operation("map.get-user-coordinates-input")}get getCoordinateTransformation(){return this._messages.operation("map.get-coordinate-transformation")}get exportImage(){return this._messages.operation("map.export-image")}get getMarkup(){return this._messages.operation("map.get-markup")}get getExtent(){return this._messages.operation("map.get-extent")}get getGeometryFromSelector(){return this._messages.operation("map.get-geometry-from-selector")}get getInitialViewpoint(){return this._messages.operation("map.get-initial-viewpoint")}get getViewpoint(){return this._messages.operation("map.get-viewpoint")}get getSpatialReference(){return this._messages.operation("map.get-spatial-reference")}get getVisibleCenter(){return this._messages.operation("map.get-visible-center")}get hide(){return this._messages.operation("map.hide")}get show(){return this._messages.operation("map.show")}get startSketch(){return this._messages.operation("map.start-sketch")}get stopSketch(){return this._messages.operation("map.stop-sketch")}get getViewInsets(){return this._messages.operation("map.get-view-insets")}}
+import{CommandRegistry}from"../CommandRegistry.js";import{EventRegistry}from"../EventRegistry.js";import{OperationRegistry}from"../OperationRegistry.js";export class MapCommands extends CommandRegistry{get addMarkup(){return this._messages.command("map.add-markup")}get addLayers(){return this._messages.command("map.add-layers")}get applyFilterEffect(){return this._messages.command("map.apply-filter-effect")}get applyLayerPreset(){return this._messages.command("map.apply-layer-preset")}get createNote(){return this._messages.command("map.create-note")}get editNote(){return this._messages.command("map.edit-note")}get removeFilterEffects(){return this._messages.command("map.remove-filter-effects")}get clearFilterEffects(){return this._messages.command("map.clear-filter-effects")}get clearMarkup(){return this._messages.command("map.clear-markup")}get disableMapClick(){return this._messages.command("map.disable-map-click")}get displayExtentSelector(){return this._messages.command("map.display-extent-selector")}get enableMapClick(){return this._messages.command("map.enable-map-click")}get goToFeatures(){return this._messages.command("map.go-to-features")}get goToGeometry(){return this._messages.command("map.go-to-geometry")}get goToViewpoint(){return this._messages.command("map.go-to-viewpoint")}get goToScale(){return this._messages.command("map.go-to-scale")}get goToInitialViewpoint(){return this._messages.command("map.go-to-initial-viewpoint")}get goToLayerExtent(){return this._messages.command("map.go-to-layer-extent")}get hideExtentSelector(){return this._messages.command("map.hide-extent-selector")}get panToFeatures(){return this._messages.command("map.pan-to-features")}get panToGeometry(){return this._messages.command("map.pan-to-geometry")}get pauseSketch(){return this._messages.command("map.pause-sketch")}get removeLayers(){return this._messages.command("map.remove-layers")}get replace(){return this._messages.command("map.replace")}get replaceAdditionalLayers(){return this._messages.command("map.replace-additional-layers")}get replaceMmpk(){return this._messages.command("map.replace-mmpk")}get resumeSketch(){return this._messages.command("map.resume-sketch")}get rotateBy(){return this._messages.command("map.rotate-by")}get rotateTo(){return this._messages.command("map.rotate-to")}get refresh(){return this._messages.command("map.refresh")}get updateLayer(){return this._messages.command("map.update-layer")}get zoomToFeatures(){return this._messages.command("map.zoom-to-features")}get zoomToGeometry(){return this._messages.command("map.zoom-to-geometry")}get zoomIn(){return this._messages.command("map.zoom-in")}get zoomOut(){return this._messages.command("map.zoom-out")}get zoomToScale(){return this._messages.command("map.zoom-to-scale")}get zoomToInitialViewpoint(){return this._messages.command("map.zoom-to-initial-viewpoint")}get zoomToViewpoint(){return this._messages.command("map.zoom-to-viewpoint")}get zoomToLayerExtent(){return this._messages.command("map.zoom-to-layer-extent")}get zoomToLayerVisibleScale(){return this._messages.command("map.zoom-to-layer-visible-scale")}}export class MapEvents extends EventRegistry{get initialized(){return this._messages.event("map.initialized")}get initializing(){return this._messages.event("map.initializing")}get navigationCompleted(){return this._messages.event("map.navigation-completed")}get refreshed(){return this._messages.event("map.refreshed")}get refreshing(){return this._messages.event("map.refreshing")}get rotated(){return this._messages.event("map.rotated")}get rotating(){return this._messages.event("map.rotating")}get viewModeChanged(){return this._messages.event("map.view-mode-changed")}get viewpointChanged(){return this._messages.event("map.viewpoint-changed")}}export class MapOperations extends OperationRegistry{get getUserCoordinatesInput(){return this._messages.operation("map.get-user-coordinates-input")}get getCoordinateTransformation(){return this._messages.operation("map.get-coordinate-transformation")}get exportImage(){return this._messages.operation("map.export-image")}get getMarkup(){return this._messages.operation("map.get-markup")}get getExtent(){return this._messages.operation("map.get-extent")}get getGeometryFromSelector(){return this._messages.operation("map.get-geometry-from-selector")}get getInitialViewpoint(){return this._messages.operation("map.get-initial-viewpoint")}get getViewpoint(){return this._messages.operation("map.get-viewpoint")}get getSpatialReference(){return this._messages.operation("map.get-spatial-reference")}get getVisibleCenter(){return this._messages.operation("map.get-visible-center")}get hide(){return this._messages.operation("map.hide")}get show(){return this._messages.operation("map.show")}get startSketch(){return this._messages.operation("map.start-sketch")}get stopSketch(){return this._messages.operation("map.stop-sketch")}get getViewInsets(){return this._messages.operation("map.get-view-insets")}}

package/messaging/registry/system.d.ts

@@ -2,7 +2,7 @@ import type { Command } from "../Command.js";
 import { CommandRegistry } from "../CommandRegistry.js";
 import type { Operation } from "../Operation.js";
 import { OperationRegistry } from "../OperationRegistry.js";
-import type { Blob, File, HasUITarget } from "../common.js";
+import type { Blob, File, HasFeatures, HasGeometry, HasLayers, HasMaps, HasUITarget } from "../common.js";
 /**
  * Arguments for the system.download-file operation.
  */
@@ -40,6 +40,24 @@ export interface ReadFileArgs extends HasUITarget {
      */
     promptMessage?: string;
 }
+/**
+ * Well-known location-based tokens that can be used in the system.open-url
+ * command arguments. Location.Map.ZoomLevel is not supported by Mobile; the
+ * supported levels and their associated numeric values can be found here:
+ * https://developers.arcgis.com/documentation/mapping-apis-and-services/reference/zoom-levels-and-scale/.
+ */
+export declare type LocationToken = "Location.Geolocation.Latitude" | "Location.Geolocation.Longitude" | "Location.Feature.Latitude" | "Location.Feature.Longitude" | "Location.Map.Center.Latitude" | "Location.Map.Center.Longitude" | "Location.Map.Scale" | "Location.Map.ZoomLevel" | "Location.Map.TopLeft.Latitude" | "Location.Map.TopLeft.Longitude" | "Location.Map.TopRight.Latitude" | "Location.Map.TopRight.Longitude" | "Location.Map.BottomLeft.Latitude" | "Location.Map.BottomLeft.Longitude" | "Location.Map.BottomRight.Latitude" | "Location.Map.BottomRight.Longitude";
+/**
+ * Well-known layer-based tokens that can be used in the system.open-url command
+ * arguments. NOTE: Not all layer types support extents, urls, min/max scales,
+ * and/or min/max zoom levels.
+ */
+export declare type LayerToken = "Layer.Extent.TopLeft.Latitude" | "Layer.Extent.TopLeft.Longitude" | "Layer.Extent.TopRight.Latitude" | "Layer.Extent.TopRight.Longitude" | "Layer.Extent.BottomLeft.Latitude" | "Layer.Extent.BottomLeft.Longitude" | "Layer.Extent.BottomRight.Latitude" | "Layer.Extent.BottomRight.Longitude" | "Layer.Extent.MaxScale" | "Layer.Extent.MinScale" | "Layer.Extent.MaxZoomLevel" | "Layer.Extent.MinZoomLevel" | "Layer.ID" | "Layer.Title" | "Layer.URL";
+/**
+ * VertiGIS Studio Web's arguments for the system.open-url command.
+ */
+export interface WebOpenUrlArgs extends Omit<OpenUrlArgs, "context">, HasMaps, HasFeatures, HasGeometry, HasLayers {
+}
 /**
  * Arguments for the system.open-url command.
  */
@@ -79,19 +97,22 @@ export declare class SystemCommands extends CommandRegistry {
     get downloadFile(): Command<DownloadArgs | Record<string, unknown> | string>;
     /**
      * Opens a URL, either in the system browser or whatever app is appropriate
-     * for the scheme of the URL. If the context is a {@link Features}, then the
-     * URL may contain substitution tokens in the format {FIELD_NAME} where
-     * FIELD_NAME is the name of a field in the first feature in the context. In
-     * this case, the {FIELD_NAME} is substituted with value of the FIELD_NAME
-     * field from the feature feature in the {@link Features}, e.g.
+     * for the scheme of the URL. If {@link Features} are included as context,
+     * then the URL may contain substitution tokens in the format {FIELD_NAME}
+     * where FIELD_NAME is the name of a field in the first feature in the
+     * context. In this case, the {FIELD_NAME} is substituted with value of the
+     * FIELD_NAME field from the feature feature in the {@link Features}, e.g.
      * https://www.google.com/search?q={NAME}, where the value of the NAME field
      * in the first feature from the context is 'Jasper National Park' would
      * produce the result https://www.google.com/search?q=Jasper National Park.
-     * Zero to many substitution tokens may be included.
+     * Zero to many substitution tokens may be included. If maps are included as
+     * context, {@link LocationToken} can be used to access properties on the
+     * first map's view. In Web, if both layers and maps are included as
+     * context, then {@link LayerToken} can be used to access properties on the
+     * first layer.
      *
-     * @mobileOnly
      */
-    get openUrl(): Command<OpenUrlArgs | string>;
+    get openUrl(): Command<OpenUrlArgs | WebOpenUrlArgs | string>;
     /**
      * Allows to control if the screen should be kept on. Passing true as parameter
      * will keep the screen on, ignoring possible system settings for screen timeouts.

package/messaging/registry/ui.d.ts

@@ -82,7 +82,7 @@ export interface DisplayNotificationArgs {
      */
     message: TranslatableText;
     /**
-     * The position of the notification on the screen.
+     * The position of the notification on the screen. Web only.
      */
     position?: Position;
     /**

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

@@ -822,7 +822,7 @@
                 },
                 "position": {
                     "$ref": "Position",
-                    "description": "The position of the notification on the screen."
+                    "description": "The position of the notification on the screen. Web only."
                 },
                 "title": {
                     "description": "The notification title - only shown for system notifications. Mobile only.",
@@ -1579,6 +1579,27 @@
             ],
             "type": "string"
         },
+        "OpenUrlArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the system.open-url command.",
+            "properties": {
+                "context": {
+                    "description": "An object containing arguments that this command was originally executed with. This property is populated automatically when using a bound action. The URL will be the configured value, and the context is automatically populated as the argument that was passed into the execute method when the command was executed in context."
+                },
+                "numberFormatterLocale": {
+                    "description": "The locale to use for number token substitution. Accepts a valid locale code (example: \"en\", \"fr\" or \"de-AT\"), or \"device\" or \"invariant\" which will use the device's current culture or the invariant culture, respectively. Default is invariant culture.",
+                    "type": "string"
+                },
+                "url": {
+                    "description": "The URL to open.",
+                    "type": "string"
+                }
+            },
+            "required": [
+                "url"
+            ],
+            "type": "object"
+        },
         "Results": {
             "additionalProperties": false,
             "description": "Feature results from an operation.",
@@ -2106,6 +2127,40 @@
             ],
             "type": "object"
         },
+        "WebOpenUrlArgs": {
+            "additionalProperties": false,
+            "description": "VertiGIS Studio Web's arguments for the system.open-url command.",
+            "properties": {
+                "features": {
+                    "$ref": "#/definitions/FeaturesLike",
+                    "description": "Features to use for the command/operation."
+                },
+                "geometry": {
+                    "$ref": "#/definitions/GeometryLike",
+                    "description": "The geometry to use for the command/operation."
+                },
+                "layers": {
+                    "$ref": "#/definitions/LayersLike",
+                    "description": "Layer(s) to use for the command/operation."
+                },
+                "maps": {
+                    "$ref": "MapsLike",
+                    "description": "Map(s) to use for the command/operation."
+                },
+                "numberFormatterLocale": {
+                    "description": "The locale to use for number token substitution. Accepts a valid locale code (example: \"en\", \"fr\" or \"de-AT\"), or \"device\" or \"invariant\" which will use the device's current culture or the invariant culture, respectively. Default is invariant culture.",
+                    "type": "string"
+                },
+                "url": {
+                    "description": "The URL to open.",
+                    "type": "string"
+                }
+            },
+            "required": [
+                "url"
+            ],
+            "type": "object"
+        },
         "ZoomToViewpointArgs": {
             "additionalProperties": false,
             "description": "Arguments for the map.zoom-to-viewpoint command.",
@@ -11665,6 +11720,25 @@
         "sketching.undo:input": {
             "$ref": "#/definitions/HasMaps"
         },
+        "system.open-url": {
+            "description": "Opens a URL, either in the system browser or whatever app is appropriate for the scheme of the URL. If {@link Features} are included as context, then the URL may contain substitution tokens in the format {FIELD_NAME} where FIELD_NAME is the name of a field in the first feature in the context. In this case, the {FIELD_NAME} is substituted with value of the FIELD_NAME field from the feature feature in the {@link Features}, e.g. https://www.google.com/search?q={NAME}, where the value of the NAME field in the first feature from the context is 'Jasper National Park' would produce the result https://www.google.com/search?q=Jasper National Park. Zero to many substitution tokens may be included. If maps are included as context, {@link LocationToken} can be used to access properties on the first map's view. In Web, if both layers and maps are included as context, then {@link LayerToken} can be used to access properties on the first layer.",
+            "enum": [
+                "system.open-url"
+            ]
+        },
+        "system.open-url:input": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/WebOpenUrlArgs"
+                },
+                {
+                    "$ref": "#/definitions/OpenUrlArgs"
+                },
+                {
+                    "type": "string"
+                }
+            ]
+        },
         "tasks.identify": {
             "description": "Returns features that intersect a given geometry.",
             "enum": [
@@ -12457,6 +12531,22 @@
                     ],
                     "type": "object"
                 },
+                {
+                    "additionalProperties": false,
+                    "properties": {
+                        "arguments": {
+                            "$ref": "#/definitions/system.open-url:input"
+                        },
+                        "name": {
+                            "$ref": "#/definitions/system.open-url"
+                        }
+                    },
+                    "required": [
+                        "name",
+                        "arguments"
+                    ],
+                    "type": "object"
+                },
                 {
                     "additionalProperties": false,
                     "properties": {
@@ -12688,6 +12778,9 @@
                 {
                     "$ref": "#/definitions/sketching.undo"
                 },
+                {
+                    "$ref": "#/definitions/system.open-url"
+                },
                 {
                     "$ref": "#/definitions/ui.activate"
                 },

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

@@ -1051,7 +1051,7 @@
                 },
                 "position": {
                     "$ref": "Position",
-                    "description": "The position of the notification on the screen."
+                    "description": "The position of the notification on the screen. Web only."
                 },
                 "title": {
                     "description": "The notification title - only shown for system notifications. Mobile only.",
@@ -2223,7 +2223,7 @@
                     "description": "An object containing arguments that this command was originally executed with. This property is populated automatically when using a bound action. The URL will be the configured value, and the context is automatically populated as the argument that was passed into the execute method when the command was executed in context."
                 },
                 "numberFormatterLocale": {
-                    "description": "The locale to use for number token substitution. Accepts a valid locale  code (example: \"en\", \"fr\" or \"de-AT\"), or \"device\" or \"invariant\" which will use the device's current culture or the invariant culture, respectively. Default is invariant culture.",
+                    "description": "The locale to use for number token substitution. Accepts a valid locale code (example: \"en\", \"fr\" or \"de-AT\"), or \"device\" or \"invariant\" which will use the device's current culture or the invariant culture, respectively. Default is invariant culture.",
                     "type": "string"
                 },
                 "url": {
@@ -3006,6 +3006,40 @@
             ],
             "type": "object"
         },
+        "WebOpenUrlArgs": {
+            "additionalProperties": false,
+            "description": "VertiGIS Studio Web's arguments for the system.open-url command.",
+            "properties": {
+                "features": {
+                    "$ref": "#/definitions/FeaturesLike",
+                    "description": "Features to use for the command/operation."
+                },
+                "geometry": {
+                    "$ref": "#/definitions/GeometryLike",
+                    "description": "The geometry to use for the command/operation."
+                },
+                "layers": {
+                    "$ref": "#/definitions/LayersLike",
+                    "description": "Layer(s) to use for the command/operation."
+                },
+                "maps": {
+                    "$ref": "MapsLike",
+                    "description": "Map(s) to use for the command/operation."
+                },
+                "numberFormatterLocale": {
+                    "description": "The locale to use for number token substitution. Accepts a valid locale code (example: \"en\", \"fr\" or \"de-AT\"), or \"device\" or \"invariant\" which will use the device's current culture or the invariant culture, respectively. Default is invariant culture.",
+                    "type": "string"
+                },
+                "url": {
+                    "description": "The URL to open.",
+                    "type": "string"
+                }
+            },
+            "required": [
+                "url"
+            ],
+            "type": "object"
+        },
         "ZoomToViewpointArgs": {
             "additionalProperties": false,
             "description": "Arguments for the map.zoom-to-viewpoint command.",
@@ -3040,6 +3074,12 @@
             ],
             "type": "object"
         },
+        "app.favorite": {
+            "description": "Adds the currently loaded app to the user's Favorites collection.",
+            "enum": [
+                "app.favorite"
+            ]
+        },
         "app.go-to-app-selector": {
             "description": "Returns to the Geocortex Go view where the user can select a different app. Only enabled if the current app was launched through Geocortex Go.",
             "enum": [
@@ -3052,6 +3092,12 @@
                 "app.refresh"
             ]
         },
+        "app.unfavorite": {
+            "description": "Removes the currently loaded app from the user's Favorites collection.",
+            "enum": [
+                "app.unfavorite"
+            ]
+        },
         "auth.get-current-user": {
             "description": "Gets the user that is currently signed into the application.",
             "enum": [
@@ -13578,13 +13624,16 @@
             "type": "boolean"
         },
         "system.open-url": {
-            "description": "Opens a URL, either in the system browser or whatever app is appropriate for the scheme of the URL. If the context is a {@link Features}, then the URL may contain substitution tokens in the format {FIELD_NAME} where FIELD_NAME is the name of a field in the first feature in the context. In this case, the {FIELD_NAME} is substituted with value of the FIELD_NAME field from the feature feature in the {@link Features}, e.g. https://www.google.com/search?q={NAME}, where the value of the NAME field in the first feature from the context is 'Jasper National Park' would produce the result https://www.google.com/search?q=Jasper National Park. Zero to many substitution tokens may be included.",
+            "description": "Opens a URL, either in the system browser or whatever app is appropriate for the scheme of the URL. If {@link Features} are included as context, then the URL may contain substitution tokens in the format {FIELD_NAME} where FIELD_NAME is the name of a field in the first feature in the context. In this case, the {FIELD_NAME} is substituted with value of the FIELD_NAME field from the feature feature in the {@link Features}, e.g. https://www.google.com/search?q={NAME}, where the value of the NAME field in the first feature from the context is 'Jasper National Park' would produce the result https://www.google.com/search?q=Jasper National Park. Zero to many substitution tokens may be included. If maps are included as context, {@link LocationToken} can be used to access properties on the first map's view. In Web, if both layers and maps are included as context, then {@link LayerToken} can be used to access properties on the first layer.",
             "enum": [
                 "system.open-url"
             ]
         },
         "system.open-url:input": {
             "anyOf": [
+                {
+                    "$ref": "#/definitions/WebOpenUrlArgs"
+                },
                 {
                     "$ref": "#/definitions/OpenUrlArgs"
                 },
@@ -15428,12 +15477,18 @@
                     ],
                     "type": "object"
                 },
+                {
+                    "$ref": "#/definitions/app.favorite"
+                },
                 {
                     "$ref": "#/definitions/app.go-to-app-selector"
                 },
                 {
                     "$ref": "#/definitions/app.refresh"
                 },
+                {
+                    "$ref": "#/definitions/app.unfavorite"
+                },
                 {
                     "$ref": "#/definitions/auth.sign-in"
                 },

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

@@ -1484,7 +1484,7 @@
                 },
                 "position": {
                     "$ref": "Position",
-                    "description": "The position of the notification on the screen."
+                    "description": "The position of the notification on the screen. Web only."
                 },
                 "title": {
                     "description": "The notification title - only shown for system notifications. Mobile only.",
@@ -3591,6 +3591,27 @@
             ],
             "type": "string"
         },
+        "OpenUrlArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the system.open-url command.",
+            "properties": {
+                "context": {
+                    "description": "An object containing arguments that this command was originally executed with. This property is populated automatically when using a bound action. The URL will be the configured value, and the context is automatically populated as the argument that was passed into the execute method when the command was executed in context."
+                },
+                "numberFormatterLocale": {
+                    "description": "The locale to use for number token substitution. Accepts a valid locale code (example: \"en\", \"fr\" or \"de-AT\"), or \"device\" or \"invariant\" which will use the device's current culture or the invariant culture, respectively. Default is invariant culture.",
+                    "type": "string"
+                },
+                "url": {
+                    "description": "The URL to open.",
+                    "type": "string"
+                }
+            },
+            "required": [
+                "url"
+            ],
+            "type": "object"
+        },
         "Orientation": {
             "description": "An orientation for the layout.",
             "enum": [
@@ -5303,6 +5324,40 @@
             ],
             "type": "object"
         },
+        "WebOpenUrlArgs": {
+            "additionalProperties": false,
+            "description": "VertiGIS Studio Web's arguments for the system.open-url command.",
+            "properties": {
+                "features": {
+                    "$ref": "#/definitions/FeaturesLike",
+                    "description": "Features to use for the command/operation."
+                },
+                "geometry": {
+                    "$ref": "#/definitions/GeometryLike",
+                    "description": "The geometry to use for the command/operation."
+                },
+                "layers": {
+                    "$ref": "#/definitions/LayersLike",
+                    "description": "Layer(s) to use for the command/operation."
+                },
+                "maps": {
+                    "$ref": "MapsLike",
+                    "description": "Map(s) to use for the command/operation."
+                },
+                "numberFormatterLocale": {
+                    "description": "The locale to use for number token substitution. Accepts a valid locale code (example: \"en\", \"fr\" or \"de-AT\"), or \"device\" or \"invariant\" which will use the device's current culture or the invariant culture, respectively. Default is invariant culture.",
+                    "type": "string"
+                },
+                "url": {
+                    "description": "The URL to open.",
+                    "type": "string"
+                }
+            },
+            "required": [
+                "url"
+            ],
+            "type": "object"
+        },
         "ZoomToLayerArgs": {
             "additionalProperties": false,
             "description": "Arguments for the map.zoom-to-layer-extent and map.zoom-to-layer-visible-scale commands.",
@@ -17509,6 +17564,25 @@
         "system.get-sharing-link:output": {
             "type": "string"
         },
+        "system.open-url": {
+            "description": "Opens a URL, either in the system browser or whatever app is appropriate for the scheme of the URL. If {@link Features} are included as context, then the URL may contain substitution tokens in the format {FIELD_NAME} where FIELD_NAME is the name of a field in the first feature in the context. In this case, the {FIELD_NAME} is substituted with value of the FIELD_NAME field from the feature feature in the {@link Features}, e.g. https://www.google.com/search?q={NAME}, where the value of the NAME field in the first feature from the context is 'Jasper National Park' would produce the result https://www.google.com/search?q=Jasper National Park. Zero to many substitution tokens may be included. If maps are included as context, {@link LocationToken} can be used to access properties on the first map's view. In Web, if both layers and maps are included as context, then {@link LayerToken} can be used to access properties on the first layer.",
+            "enum": [
+                "system.open-url"
+            ]
+        },
+        "system.open-url:input": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/WebOpenUrlArgs"
+                },
+                {
+                    "$ref": "#/definitions/OpenUrlArgs"
+                },
+                {
+                    "type": "string"
+                }
+            ]
+        },
         "system.read-file": {
             "description": "Initiates a file read, using the native browser file input.",
             "enum": [
@@ -19577,6 +19651,22 @@
                     ],
                     "type": "object"
                 },
+                {
+                    "additionalProperties": false,
+                    "properties": {
+                        "arguments": {
+                            "$ref": "#/definitions/system.open-url:input"
+                        },
+                        "name": {
+                            "$ref": "#/definitions/system.open-url"
+                        }
+                    },
+                    "required": [
+                        "name",
+                        "arguments"
+                    ],
+                    "type": "object"
+                },
                 {
                     "additionalProperties": false,
                     "properties": {
@@ -20145,6 +20235,9 @@
                 {
                     "$ref": "#/definitions/system.download-file"
                 },
+                {
+                    "$ref": "#/definitions/system.open-url"
+                },
                 {
                     "$ref": "#/definitions/ui.activate"
                 },

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

@@ -1,6 +1,14 @@
 {
     "$ref": "#/definitions/viewer-spec.Event",
     "definitions": {
+        "@vertigis.arcgis-extensions.mapping.MapExtension.ViewMode": {
+            "description": "Viewing mode for a map (2D map or 3D scene).",
+            "enum": [
+                "map",
+                "scene"
+            ],
+            "type": "string"
+        },
         "AuthenticationType": {
             "description": "A type of authentication.",
             "enum": [
@@ -446,6 +454,21 @@
             ],
             "type": "object"
         },
+        "ViewModeChangedEvent": {
+            "additionalProperties": false,
+            "description": "Arguments for the ViewModeChanged event.",
+            "properties": {
+                "maps": {
+                    "$ref": "#/definitions/MapsLike",
+                    "description": "The map from which the event was generated."
+                },
+                "viewMode": {
+                    "$ref": "#/definitions/@vertigis.arcgis-extensions.mapping.MapExtension.ViewMode",
+                    "description": "The new ViewMode."
+                }
+            },
+            "type": "object"
+        },
         "WorkflowErrorEventArgs": {
             "additionalProperties": false,
             "description": "Arguments for the \"workflow.workflow-error\" event.",
@@ -9107,6 +9130,15 @@
         "map.initialized:input": {
             "$ref": "#/definitions/MapEvent"
         },
+        "map.view-mode-changed": {
+            "description": "Raised when a map's {@link ViewMode} is changed. This happens when the map view is changed between a WebMap and a WebScene.",
+            "enum": [
+                "map.view-mode-changed"
+            ]
+        },
+        "map.view-mode-changed:input": {
+            "$ref": "#/definitions/ViewModeChangedEvent"
+        },
         "map.viewpoint-changed": {
             "description": "Raised when the a map extent is changed. This event is raised in extremely high frequency - for example, every few pixels the map is repositioned during a pan.",
             "enum": [
@@ -9377,6 +9409,9 @@
                 {
                     "$ref": "#/definitions/map.initialized"
                 },
+                {
+                    "$ref": "#/definitions/map.view-mode-changed"
+                },
                 {
                     "$ref": "#/definitions/map.viewpoint-changed"
                 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertigis/viewer-spec",
-  "version": "46.1.0",
+  "version": "46.4.0",
   "license": "SEE LICENSE IN LICENSE",
   "description": "VertiGIS Viewer Specification",
   "type": "module",
@@ -34,7 +34,7 @@
   },
   "author": "VertiGIS Ltd.",
   "peerDependencies": {
-    "@vertigis/arcgis-extensions": ">= 34.2.2  < 35.0.0"
+    "@vertigis/arcgis-extensions": ">= 34.2.3  < 35.0.0"
   },
   "devDependencies": {
     "@arcgis/core": "4.21.2",

package/version.d.ts

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

package/version.js

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