@vertigis/viewer-spec 58.10.1 → 58.11.0

package/app-config/web/FeatureSetProperties.d.ts

@@ -1,6 +1,6 @@
 import type { FeatureProperties } from "@vertigis/arcgis-extensions/data/Feature";
 import type { FeatureSetProperties as ApiFeatureSetProperties } from "@vertigis/arcgis-extensions/data/FeatureSet";
-import type { ItemRef } from "app-config/common/ItemRef";
+import type { ItemRef } from "../common/ItemRef";
 /**
  * Properties for a FeatureSet.
  */

package/app-config/web/ResultsModelProperties.d.ts

@@ -1,5 +1,5 @@
 import type { Action } from "@vertigis/arcgis-extensions/support/Action";
-import type { ItemRef } from "app-config/common/ItemRef.js";
+import type { ItemRef } from "../common/ItemRef.js";
 import type { ResultsModelProperties as CommonResultsModelProperties } from "../common/ResultsModelProperties.js";
 import type { ComponentModelProperties } from "./ComponentModelProperties.js";
 import type { FeatureListProperties } from "./FeatureListProperties.js";

package/messaging/common.d.ts

@@ -31,8 +31,12 @@ import type { LayerExtension, LayerReference as LayerReferenceObject } from "@ve
 import type { MapExtension } from "@vertigis/arcgis-extensions/mapping/MapExtension";
 import type { SublayerExtension } from "@vertigis/arcgis-extensions/mapping/SublayerExtension";
 import type { SublayerLike } from "@vertigis/arcgis-extensions/support/esri";
-import type { ItemRef } from "app-config/common/ItemRef";
+import type { ItemRef } from "../app-config/common/ItemRef";
 import type { TimeSpan } from "./DotNetTypes";
+/**
+ * A component's ID in the layout.
+ */
+export type ComponentId = string;
 /**
  * A model belonging to a component.
  */
@@ -41,7 +45,7 @@ export interface Model extends Entity {
 /**
  * A reference to a model (using its ID or model instance).
  */
-export type ModelRef = string | Model;
+export type ModelRef = ItemRef | Model;
 /**
  * Result of the "drawing.create-graphics" and "measurement.create-graphics"
  * operations.
@@ -217,7 +221,7 @@ export interface HasUITarget {
      * component will be the parent of the temporary UI that will be removed
      * after the command/operation completes.
      */
-    parent?: string | ItemRef;
+    parent?: ComponentId | ModelRef;
     /**
      * Optional layout XML attributes to be used for the transient UI container.
      */

package/messaging/registry/arcade.d.ts

@@ -1,7 +1,6 @@
-import type { ItemRef } from "app-config/common/ItemRef.js";
 import type { Operation } from "../Operation.js";
 import { OperationRegistry } from "../OperationRegistry.js";
-import type { HasFeatures, HasLayers, HasMaps, Model } from "../common.js";
+import type { HasFeatures, HasLayers, HasMaps, ModelRef } from "../common.js";
 /**
  * The arguments for the arcade.run operation.
  */
@@ -59,7 +58,7 @@ export interface ItemPropertyPath {
     /**
      * The item from which to access a property value.
      */
-    item: ItemRef | Model;
+    item: ModelRef;
     /**
      * The path to a property on an item.
      */
@@ -102,7 +101,7 @@ export interface WatchEventHandleProperties {
     /**
      * The item whose properties will be watched for changes and/or events.
      */
-    item: ItemRef | Model;
+    item: ModelRef;
     /**
      * One or more properties on the item that will be watched for changes
      * and/or events. Any strings will be used as propertyPaths that will be

package/messaging/registry/system.d.ts

@@ -1,14 +1,13 @@
 import type Point from "@arcgis/core/geometry/Point.js";
 import type { Action } from "@vertigis/arcgis-extensions/support/Action.js";
-import type { ItemRef } from "app-config/common/ItemRef.js";
-import type { CoordinateOptionProperties } from "app-config/web/CoordinateModelProperties.js";
+import type { CoordinateOptionProperties } from "../../app-config/web/CoordinateModelProperties.js";
 import type { Command } from "../Command.js";
 import { CommandRegistry } from "../CommandRegistry.js";
 import type { Event } from "../Event.js";
 import { EventRegistry } from "../EventRegistry.js";
 import type { Operation } from "../Operation.js";
 import { OperationRegistry } from "../OperationRegistry.js";
-import type { Blob, File, HasFeatures, HasFiles, HasGeometry, HasLayers, HasMaps, HasUITarget } from "../common.js";
+import type { Blob, File, HasFeatures, HasFiles, HasGeometry, HasLayers, HasMaps, HasUITarget, ModelRef } from "../common.js";
 /**
  * Arguments for the system.download-file operation.
  */
@@ -117,7 +116,7 @@ export interface OpenUrlArgs {
      * existing 'coordinate-option' item, or inline JSON defining a coordinate
      * option item.
      */
-    coordinateOption?: ItemRef | CoordinateOptionProperties;
+    coordinateOption?: ModelRef | CoordinateOptionProperties;
     /**
      * An object containing arguments that this command was originally executed
      * with. This property is populated automatically when using a bound action.

package/messaging/registry/ui.d.ts

@@ -1,4 +1,3 @@
-import type { ItemRef } from "app-config/common/ItemRef.js";
 import type { UIDensity } from "../../app-config/common/BrandingModelProperties.js";
 import type { TranslatableText, TranslateOptions } from "../../app-config/common/TranslatableText.js";
 import type { Command } from "../Command.js";
@@ -7,7 +6,8 @@ import type { Event } from "../Event.js";
 import { EventRegistry } from "../EventRegistry.js";
 import type { Operation } from "../Operation.js";
 import { OperationRegistry } from "../OperationRegistry.js";
-import type { Model } from "../common.js";
+import type { ComponentId, Model } from "../common.js";
+export type { ComponentId };
 /**
  * A category for a notification that affects the color and icon used.
  */
@@ -211,10 +211,6 @@ export interface DisplayBusyStateArgs {
      */
     maximumDisplayDurationMs?: number;
 }
-/**
- * A component's ID in the layout.
- */
-export type ComponentId = string;
 /**
  * Arguments for the "ui.focus" command.
  */
@@ -296,13 +292,40 @@ export interface NarrateOptions extends TranslateOptions {
      */
     timeout?: number;
 }
+/**
+ * Arguments for the "ui.activate" and "ui.deactivate" commands.
+ *
+ * @webOnly
+ */
+export interface ActivationArgs {
+    /**
+     * The component to activate or deactivate. Can be identified by its ID or
+     * model.
+     */
+    component: ComponentId | Model;
+    /**
+     * Whether to validate the component's state before activation or
+     * deactivation. Defaults to `false` if not provided.
+     */
+    validateState?: boolean;
+}
+/**
+ * Arguments that can be passed to the "ui.activate" command. Supports a
+ * component's ID, its model, or detailed activation arguments.
+ */
+export type ActivateArgs = ActivationArgs | ComponentId | Model;
+/**
+ * Arguments that can be passed to the "ui.deactivate" command. Supports a
+ * component's ID, its model, or detailed deactivation arguments.
+ */
+export type DeactivateArgs = ActivationArgs | ComponentId | Model;
 export declare class UICommands extends CommandRegistry {
     protected readonly _prefix = "ui";
     /**
      * Activates a component with the given ID or model, causing it to become
      * visible. For VertiGIS Studio Mobile, only ID is supported.
      */
-    get activate(): Command<ComponentId | Model>;
+    get activate(): Command<ActivateArgs>;
     /**
      * Toggles the active state on a component with the given ID. Mobile only.
      *
@@ -325,7 +348,7 @@ export declare class UICommands extends CommandRegistry {
      * Deactivates a component with the given ID, causing it to disappear. For
      * VertiGIS Studio Mobile, only ID is supported.
      */
-    get deactivate(): Command<ComponentId | Model>;
+    get deactivate(): Command<DeactivateArgs>;
     /**
      * Displays a loading indicator and custom message to the user to indicate
      * that the UI is busy.
@@ -430,7 +453,7 @@ export declare class UIOperations extends OperationRegistry {
      *
      * @webOnly
      */
-    get getComponentIds(): Operation<ItemRef, string[]>;
+    get getComponentIds(): Operation<ComponentId | Model, string[]>;
     /**
      * Gets the current locale code for the application. (example: "en", "fr" or
      * "de-AT"). Web only.
@@ -457,13 +480,13 @@ export declare class UIOperations extends OperationRegistry {
      *
      * @webOnly
      */
-    get getVisualState(): Operation<ComponentId, VisualState | undefined>;
+    get getVisualState(): Operation<ComponentId | Model, VisualState | undefined>;
     /**
      * Gets the state of a component. Web only.
      *
      * @webOnly
      */
-    get getComponentState(): Operation<ComponentId, State | undefined>;
+    get getComponentState(): Operation<ComponentId | Model, State | undefined>;
     /**
      * Prompts the user to enter a value in a popup box. Web only.
      *

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

@@ -676,6 +676,45 @@
             ],
             "description": "A reference to a portal item."
         },
+        "ActivateArgs": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/Model"
+                },
+                {
+                    "$ref": "#/definitions/ActivationArgs"
+                },
+                {
+                    "type": "string"
+                }
+            ],
+            "description": "Arguments that can be passed to the \"ui.activate\" command. Supports a component's ID, its model, or detailed activation arguments."
+        },
+        "ActivationArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the \"ui.activate\" and \"ui.deactivate\" commands.",
+            "properties": {
+                "component": {
+                    "anyOf": [
+                        {
+                            "$ref": "#/definitions/Model"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ],
+                    "description": "The component to activate or deactivate. Can be identified by its ID or model."
+                },
+                "validateState": {
+                    "description": "Whether to validate the component's state before activation or deactivation. Defaults to `false` if not provided.",
+                    "type": "boolean"
+                }
+            },
+            "required": [
+                "component"
+            ],
+            "type": "object"
+        },
         "AddAttachmentArgs": {
             "additionalProperties": false,
             "description": "Arguments for the \"edit.add-attachment\" command. Supported by both Web and Mobile.",
@@ -1203,6 +1242,20 @@
             ],
             "type": "object"
         },
+        "DeactivateArgs": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/Model"
+                },
+                {
+                    "$ref": "#/definitions/ActivationArgs"
+                },
+                {
+                    "type": "string"
+                }
+            ],
+            "description": "Arguments that can be passed to the \"ui.deactivate\" command. Supports a component's ID, its model, or detailed deactivation arguments."
+        },
         "DeleteAttachmentArgs": {
             "additionalProperties": false,
             "description": "Arguments for the \"edit.delete-attachment\" command.",
@@ -1566,8 +1619,8 @@
                     "type": "string"
                 },
                 "parent": {
-                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes.",
-                    "type": "string"
+                    "$ref": "#/definitions/ModelRef",
+                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes."
                 },
                 "pluginSettings": {
                     "description": "Web only. Additional settings that are specific to sketching plugins, keyed by plugin ID. The only currently supported plugin is \"snapping\". A boolean value can also be assigned to completely disable, or enable with default settings."
@@ -2233,8 +2286,8 @@
                     "type": "string"
                 },
                 "parent": {
-                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes.",
-                    "type": "string"
+                    "$ref": "#/definitions/ModelRef",
+                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes."
                 }
             },
             "type": "object"
@@ -2537,6 +2590,9 @@
                         {
                             "$ref": "#/definitions/CoordinateOptionProperties"
                         },
+                        {
+                            "$ref": "#/definitions/Model"
+                        },
                         {
                             "type": "string"
                         }
@@ -3586,6 +3642,9 @@
                         {
                             "$ref": "#/definitions/CoordinateOptionProperties"
                         },
+                        {
+                            "$ref": "#/definitions/Model"
+                        },
                         {
                             "type": "string"
                         }
@@ -14289,14 +14348,7 @@
             ]
         },
         "ui.activate:input": {
-            "anyOf": [
-                {
-                    "$ref": "#/definitions/Model"
-                },
-                {
-                    "type": "string"
-                }
-            ]
+            "$ref": "#/definitions/ActivateArgs"
         },
         "ui.alert": {
             "description": "Shows an alert to the user.",
@@ -14326,14 +14378,7 @@
             ]
         },
         "ui.deactivate:input": {
-            "anyOf": [
-                {
-                    "$ref": "#/definitions/Model"
-                },
-                {
-                    "type": "string"
-                }
-            ]
+            "$ref": "#/definitions/DeactivateArgs"
         },
         "ui.display-busy-state": {
             "description": "Displays a loading indicator and custom message to the user to indicate that the UI is busy.",

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

@@ -660,6 +660,45 @@
             ],
             "description": "A reference to a portal item."
         },
+        "ActivateArgs": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/Model"
+                },
+                {
+                    "$ref": "#/definitions/ActivationArgs"
+                },
+                {
+                    "type": "string"
+                }
+            ],
+            "description": "Arguments that can be passed to the \"ui.activate\" command. Supports a component's ID, its model, or detailed activation arguments."
+        },
+        "ActivationArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the \"ui.activate\" and \"ui.deactivate\" commands.",
+            "properties": {
+                "component": {
+                    "anyOf": [
+                        {
+                            "$ref": "#/definitions/Model"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ],
+                    "description": "The component to activate or deactivate. Can be identified by its ID or model."
+                },
+                "validateState": {
+                    "description": "Whether to validate the component's state before activation or deactivation. Defaults to `false` if not provided.",
+                    "type": "boolean"
+                }
+            },
+            "required": [
+                "component"
+            ],
+            "type": "object"
+        },
         "AddAttachmentArgs": {
             "additionalProperties": false,
             "description": "Arguments for the \"edit.add-attachment\" command. Supported by both Web and Mobile.",
@@ -1407,6 +1446,20 @@
             ],
             "type": "object"
         },
+        "DeactivateArgs": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/Model"
+                },
+                {
+                    "$ref": "#/definitions/ActivationArgs"
+                },
+                {
+                    "type": "string"
+                }
+            ],
+            "description": "Arguments that can be passed to the \"ui.deactivate\" command. Supports a component's ID, its model, or detailed deactivation arguments."
+        },
         "DeleteAttachmentArgs": {
             "additionalProperties": false,
             "description": "Arguments for the \"edit.delete-attachment\" command.",
@@ -1821,8 +1874,8 @@
                     "type": "string"
                 },
                 "parent": {
-                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes.",
-                    "type": "string"
+                    "$ref": "#/definitions/ModelRef",
+                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes."
                 },
                 "pluginSettings": {
                     "description": "Web only. Additional settings that are specific to sketching plugins, keyed by plugin ID. The only currently supported plugin is \"snapping\". A boolean value can also be assigned to completely disable, or enable with default settings."
@@ -2689,8 +2742,8 @@
                     "type": "string"
                 },
                 "parent": {
-                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes.",
-                    "type": "string"
+                    "$ref": "#/definitions/ModelRef",
+                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes."
                 }
             },
             "type": "object"
@@ -3224,6 +3277,9 @@
                         {
                             "$ref": "#/definitions/CoordinateOptionProperties"
                         },
+                        {
+                            "$ref": "#/definitions/Model"
+                        },
                         {
                             "type": "string"
                         }
@@ -4608,6 +4664,9 @@
                         {
                             "$ref": "#/definitions/CoordinateOptionProperties"
                         },
+                        {
+                            "$ref": "#/definitions/Model"
+                        },
                         {
                             "type": "string"
                         }
@@ -16430,14 +16489,7 @@
             ]
         },
         "ui.activate:input": {
-            "anyOf": [
-                {
-                    "$ref": "#/definitions/Model"
-                },
-                {
-                    "type": "string"
-                }
-            ]
+            "$ref": "#/definitions/ActivateArgs"
         },
         "ui.active-toggle": {
             "description": "Toggles the active state on a component with the given ID. Mobile only.",
@@ -16485,14 +16537,7 @@
             ]
         },
         "ui.deactivate:input": {
-            "anyOf": [
-                {
-                    "$ref": "#/definitions/Model"
-                },
-                {
-                    "type": "string"
-                }
-            ]
+            "$ref": "#/definitions/DeactivateArgs"
         },
         "ui.display-busy-state": {
             "description": "Displays a loading indicator and custom message to the user to indicate that the UI is busy.",

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

@@ -835,6 +835,20 @@
             ],
             "description": "A reference to a portal item."
         },
+        "ActivateArgs": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/Model"
+                },
+                {
+                    "$ref": "#/definitions/ActivationArgs"
+                },
+                {
+                    "type": "string"
+                }
+            ],
+            "description": "Arguments that can be passed to the \"ui.activate\" command. Supports a component's ID, its model, or detailed activation arguments."
+        },
         "ActivateResultGroupArgs": {
             "additionalProperties": false,
             "description": "Arguments for the \"results.activate-group\" command.",
@@ -857,6 +871,31 @@
             },
             "type": "object"
         },
+        "ActivationArgs": {
+            "additionalProperties": false,
+            "description": "Arguments for the \"ui.activate\" and \"ui.deactivate\" commands.",
+            "properties": {
+                "component": {
+                    "anyOf": [
+                        {
+                            "$ref": "#/definitions/Model"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ],
+                    "description": "The component to activate or deactivate. Can be identified by its ID or model."
+                },
+                "validateState": {
+                    "description": "Whether to validate the component's state before activation or deactivation. Defaults to `false` if not provided.",
+                    "type": "boolean"
+                }
+            },
+            "required": [
+                "component"
+            ],
+            "type": "object"
+        },
         "AddAttachmentArgs": {
             "additionalProperties": false,
             "description": "Arguments for the \"edit.add-attachment\" command. Supported by both Web and Mobile.",
@@ -1533,8 +1572,8 @@
                     "description": "Map(s) to use for the command/operation."
                 },
                 "parent": {
-                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes.",
-                    "type": "string"
+                    "$ref": "#/definitions/ModelRef",
+                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes."
                 },
                 "sources": {
                     "description": "Optionally specify the sources that we want to expose. If specified this will overwrite the configured default in the Portal Model.",
@@ -1946,8 +1985,8 @@
                     "description": "The map that should show the created note."
                 },
                 "parent": {
-                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes.",
-                    "type": "string"
+                    "$ref": "#/definitions/ModelRef",
+                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes."
                 }
             },
             "required": [
@@ -2011,6 +2050,20 @@
             ],
             "type": "object"
         },
+        "DeactivateArgs": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/Model"
+                },
+                {
+                    "$ref": "#/definitions/ActivationArgs"
+                },
+                {
+                    "type": "string"
+                }
+            ],
+            "description": "Arguments that can be passed to the \"ui.deactivate\" command. Supports a component's ID, its model, or detailed deactivation arguments."
+        },
         "DeleteAttachmentArgs": {
             "additionalProperties": false,
             "description": "Arguments for the \"edit.delete-attachment\" command.",
@@ -2425,8 +2478,8 @@
                     "type": "string"
                 },
                 "parent": {
-                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes.",
-                    "type": "string"
+                    "$ref": "#/definitions/ModelRef",
+                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes."
                 },
                 "pluginSettings": {
                     "description": "Web only. Additional settings that are specific to sketching plugins, keyed by plugin ID. The only currently supported plugin is \"snapping\". A boolean value can also be assigned to completely disable, or enable with default settings."
@@ -2747,8 +2800,8 @@
                     "description": "The map on which to edit the result."
                 },
                 "parent": {
-                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes.",
-                    "type": "string"
+                    "$ref": "#/definitions/ModelRef",
+                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes."
                 }
             },
             "required": [
@@ -2788,8 +2841,8 @@
                     "description": "Map(s) to use for the command/operation."
                 },
                 "parent": {
-                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes.",
-                    "type": "string"
+                    "$ref": "#/definitions/ModelRef",
+                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes."
                 },
                 "showOnlySymbolPresets": {
                     "description": "If the fine-grain controls should be hidden and only the symbol presets should be shown. If no valid symbol presets are configured, this property will be ignored. Default is false. If defined, this will override the value of the DrawService's 'showOnlySymbolPresets' property.",
@@ -4156,8 +4209,8 @@
                     "description": "The map on which to select the result."
                 },
                 "parent": {
-                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes.",
-                    "type": "string"
+                    "$ref": "#/definitions/ModelRef",
+                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes."
                 }
             },
             "type": "object"
@@ -4472,8 +4525,8 @@
                     "type": "string"
                 },
                 "parent": {
-                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes.",
-                    "type": "string"
+                    "$ref": "#/definitions/ModelRef",
+                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes."
                 }
             },
             "type": "object"
@@ -5309,6 +5362,9 @@
                         {
                             "$ref": "#/definitions/CoordinateOptionProperties"
                         },
+                        {
+                            "$ref": "#/definitions/Model"
+                        },
                         {
                             "type": "string"
                         }
@@ -5713,8 +5769,8 @@
                     "type": "boolean"
                 },
                 "parent": {
-                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes.",
-                    "type": "string"
+                    "$ref": "#/definitions/ModelRef",
+                    "description": "The layout ID or ItemRef to target for the command/operation. This component will be the parent of the temporary UI that will be removed after the command/operation completes."
                 },
                 "promptMessage": {
                     "description": "If present, overrides the default message of the dialog that prompts the user for a file.",
@@ -8273,14 +8329,7 @@
             "description": "Properties used to set a series of watch handles and/or event listeners on an item.",
             "properties": {
                 "item": {
-                    "anyOf": [
-                        {
-                            "$ref": "#/definitions/Model"
-                        },
-                        {
-                            "type": "string"
-                        }
-                    ],
+                    "$ref": "#/definitions/ModelRef",
                     "description": "The item whose properties will be watched for changes and/or events."
                 },
                 "watch": {
@@ -8370,6 +8419,9 @@
                         {
                             "$ref": "#/definitions/CoordinateOptionProperties"
                         },
+                        {
+                            "$ref": "#/definitions/Model"
+                        },
                         {
                             "type": "string"
                         }
@@ -22656,14 +22708,7 @@
             ]
         },
         "ui.activate:input": {
-            "anyOf": [
-                {
-                    "$ref": "#/definitions/Model"
-                },
-                {
-                    "type": "string"
-                }
-            ]
+            "$ref": "#/definitions/ActivateArgs"
         },
         "ui.alert": {
             "description": "Shows an alert to the user.",
@@ -22693,14 +22738,7 @@
             ]
         },
         "ui.deactivate:input": {
-            "anyOf": [
-                {
-                    "$ref": "#/definitions/Model"
-                },
-                {
-                    "type": "string"
-                }
-            ]
+            "$ref": "#/definitions/DeactivateArgs"
         },
         "ui.display-busy-state": {
             "description": "Displays a loading indicator and custom message to the user to indicate that the UI is busy.",
@@ -22736,7 +22774,14 @@
             ]
         },
         "ui.get-component-ids:input": {
-            "type": "string"
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/Model"
+                },
+                {
+                    "type": "string"
+                }
+            ]
         },
         "ui.get-component-ids:output": {
             "items": {
@@ -22751,7 +22796,14 @@
             ]
         },
         "ui.get-component-state:input": {
-            "type": "string"
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/Model"
+                },
+                {
+                    "type": "string"
+                }
+            ]
         },
         "ui.get-component-state:output": {
             "$ref": "#/definitions/State"
@@ -22793,7 +22845,14 @@
             ]
         },
         "ui.get-visual-state:input": {
-            "type": "string"
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/Model"
+                },
+                {
+                    "type": "string"
+                }
+            ]
         },
         "ui.get-visual-state:output": {
             "type": "string"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertigis/viewer-spec",
-  "version": "58.10.1",
+  "version": "58.11.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 VertiGIS Studio Viewer Specification.
  */
-export declare const version = "58.10.1";
+export declare const version = "58.11.0";

package/version.js

@@ -1,4 +1,4 @@
 /**
  * The current version of the VertiGIS Studio Viewer Specification.
  */
-export const version = "58.10.1";
+export const version = "58.11.0";