@vertigis/viewer-spec 51.3.0 → 51.5.0

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

@@ -1,6 +1,6 @@
 import type Color from "@arcgis/core/Color";
 import type { LayerExtension } from "@vertigis/arcgis-extensions/mapping/LayerExtension";
-import type { SublayerExtension } from "@vertigis/arcgis-extensions/mapping/_SublayerExtension";
+import type { SublayerExtension } from "@vertigis/arcgis-extensions/mapping/SublayerExtension";
 /**
  * Well known connection points for Snapping.
  */

package/messaging/common.d.ts

@@ -17,11 +17,12 @@ import type { FeatureList } from "@vertigis/arcgis-extensions/data/FeatureList";
 import type { FeatureSet } from "@vertigis/arcgis-extensions/data/FeatureSet";
 import type { FeatureSource } from "@vertigis/arcgis-extensions/data/FeatureSource";
 import type { FeatureStream } from "@vertigis/arcgis-extensions/data/FeatureStream";
+import type { TableExtension, TableReference as TableReferenceObject } from "@vertigis/arcgis-extensions/data/TableExtension";
 import type { BasemapExtension } from "@vertigis/arcgis-extensions/mapping/BasemapExtension";
 import type { Bookmark, BookmarkProperties } from "@vertigis/arcgis-extensions/mapping/Bookmark";
+import type { LayerExtension, LayerReference as LayerReferenceObject } from "@vertigis/arcgis-extensions/mapping/LayerExtension";
 import type { MapExtension } from "@vertigis/arcgis-extensions/mapping/MapExtension";
 import type { SublayerExtension } from "@vertigis/arcgis-extensions/mapping/SublayerExtension";
-import type { LayerExtension, LayerReference as LayerReferenceObject } from "@vertigis/arcgis-extensions/mapping/_LayerExtension";
 import type { Feature as GraphicJson } from "@vertigis/arcgis-extensions/portal/Feature";
 import type { Geometry as GeometryJson } from "@vertigis/arcgis-extensions/portal/Geometry";
 import type { LineSymbol3D as LineSymbol3DProperties } from "@vertigis/arcgis-extensions/portal/LineSymbol3D";
@@ -152,10 +153,15 @@ export declare type Maps = MapsLike | HasMaps;
  * both).
  */
 export declare type LayerReference = string | LayerReferenceObject;
+/**
+ * A reference to an existing table, which is the ID or title of the table (or
+ * both).
+ */
+export declare type TableReference = string | TableReferenceObject;
 /**
  * A (sub)layer extension, or an object that is convertible to one.
  */
-export declare type LayerLike = Layer | LayerExtension | SublayerLike | SublayerExtension | LayerReference;
+export declare type LayerLike = Layer | LayerExtension | SublayerLike | SublayerExtension | LayerReference | TableExtension | TableReference;
 /**
  * One or more objects that are convertible to layer extensions.
  */

package/messaging/registry/arcade.d.ts

@@ -1,11 +1,11 @@
 import type { ItemRef } from "app-config/common/ItemRef.js";
 import type { Operation } from "../Operation.js";
 import { OperationRegistry } from "../OperationRegistry.js";
-import type { Model } from "../common.js";
+import type { HasFeatures, HasLayers, HasMaps, Model } from "../common.js";
 /**
  * The arguments for the arcade.run operation.
  */
-export interface RunArcadeArgs {
+export interface RunArcadeArgs extends HasMaps, HasLayers, HasFeatures {
     /**
      * The stringified Arcade script to run. If this property is included, the
      * operation will return the result of the script.
@@ -15,14 +15,18 @@ export interface RunArcadeArgs {
      * The stringified Arcade script used to determine whether or not the
      * executeScript can/should be run. If no executeScript is provided and the
      * canExecuteScript returns a truthy value, the operation will return its
-     * input arguments; otherwise, if the canEecuteScript returns a falsey
+     * input arguments; otherwise, if the canExecuteScript returns a falsey
      * value, it will throw a {@link Cancellation}.
      */
     canExecuteScript?: string;
     /**
      * An arguments object that provides named variables and associated values,
      * which can be referenced from within the executeScript and
-     * canExecuteScript.
+     * canExecuteScript. Note that context variables will be passed in if
+     * available under the well known arcade variable names: $feature,
+     * $features, $map, and $layer and $featuremap a constructed arcade
+     * dictionary that exposes a feature mapping dictionary keyed via feature
+     * source ID with the following values: id, title and features.
      *
      * NOTE: All variable keys must consist of only lowercase letters;
      * camel-cased context variables will break the script when they are
@@ -53,7 +57,7 @@ export interface ItemPropertyPath {
 export declare class ArcadeOperations extends OperationRegistry {
     /**
      * Runs a stringified Arcade script. If only a string is passed in as an
-     * argument, it is interpreted as an executeScript. If an executeSript is
+     * argument, it is interpreted as an executeScript. If an executeScript is
      * provided, the operation will return its result. If only a canExecute
      * script is provided and it returns a truthy result, the operation will
      * return its input arguments. If a canExecuteScript returns a falsey value,

package/messaging/registry/edit.d.ts

@@ -147,8 +147,9 @@ export interface UpdateSessionArgs extends HasGeometry {
     attachments?: Attachment[];
 }
 /**
- * Arguments for the "edit.create-feature" operation. A valid feature layer is
- * required. The geometry is required for non-tabular features. Web only.
+ * Arguments for the "edit.create-feature" operation. A valid feature layer,
+ * subtype group layer, or subtype sublayer is required. The geometry is
+ * required for non-tabular features. Web only.
  */
 export interface CreateFeatureArgs extends HasGeometry, HasLayers, HasMaps, EditUIOptions {
     /**

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

@@ -423,6 +423,21 @@
             },
             "type": "object"
         },
+        "@vertigis.arcgis-extensions.data._TableExtension.TableReference": {
+            "additionalProperties": false,
+            "description": "Matches an existing table in a map.",
+            "properties": {
+                "id": {
+                    "description": "The table's ID.",
+                    "type": "string"
+                },
+                "title": {
+                    "description": "The table's title.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "@vertigis.arcgis-extensions.mapping.Bookmark.BookmarkProperties": {
             "additionalProperties": false,
             "description": "Properties that can be passed into the constructor for{@linkmapping /Bookmark!Bookmark}.",
@@ -1833,6 +1848,9 @@
                 {
                     "$ref": "#/definitions/@vertigis.arcgis-extensions.mapping._LayerExtension.LayerReference"
                 },
+                {
+                    "$ref": "#/definitions/@vertigis.arcgis-extensions.data._TableExtension.TableReference"
+                },
                 {
                     "$ref": "#/definitions/esri.Layer"
                 },
@@ -1845,12 +1863,18 @@
                 {
                     "$ref": "@vertigis.arcgis-extensions.mapping._SublayerExtension.SublayerExtension"
                 },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data._TableExtension.TableExtension"
+                },
                 {
                     "items": {
                         "anyOf": [
                             {
                                 "$ref": "#/definitions/@vertigis.arcgis-extensions.mapping._LayerExtension.LayerReference"
                             },
+                            {
+                                "$ref": "#/definitions/@vertigis.arcgis-extensions.data._TableExtension.TableReference"
+                            },
                             {
                                 "$ref": "#/definitions/esri.Layer"
                             },
@@ -1863,6 +1887,9 @@
                             {
                                 "$ref": "@vertigis.arcgis-extensions.mapping._SublayerExtension.SublayerExtension"
                             },
+                            {
+                                "$ref": "@vertigis.arcgis-extensions.data._TableExtension.TableExtension"
+                            },
                             {
                                 "type": "string"
                             }

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

@@ -423,6 +423,21 @@
             },
             "type": "object"
         },
+        "@vertigis.arcgis-extensions.data._TableExtension.TableReference": {
+            "additionalProperties": false,
+            "description": "Matches an existing table in a map.",
+            "properties": {
+                "id": {
+                    "description": "The table's ID.",
+                    "type": "string"
+                },
+                "title": {
+                    "description": "The table's title.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "@vertigis.arcgis-extensions.mapping._LayerExtension.LayerReference": {
             "additionalProperties": false,
             "description": "Matches an existing layer.",
@@ -2337,6 +2352,9 @@
                 {
                     "$ref": "#/definitions/@vertigis.arcgis-extensions.mapping._LayerExtension.LayerReference"
                 },
+                {
+                    "$ref": "#/definitions/@vertigis.arcgis-extensions.data._TableExtension.TableReference"
+                },
                 {
                     "$ref": "#/definitions/esri.Layer"
                 },
@@ -2349,12 +2367,18 @@
                 {
                     "$ref": "@vertigis.arcgis-extensions.mapping._SublayerExtension.SublayerExtension"
                 },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data._TableExtension.TableExtension"
+                },
                 {
                     "items": {
                         "anyOf": [
                             {
                                 "$ref": "#/definitions/@vertigis.arcgis-extensions.mapping._LayerExtension.LayerReference"
                             },
+                            {
+                                "$ref": "#/definitions/@vertigis.arcgis-extensions.data._TableExtension.TableReference"
+                            },
                             {
                                 "$ref": "#/definitions/esri.Layer"
                             },
@@ -2367,6 +2391,9 @@
                             {
                                 "$ref": "@vertigis.arcgis-extensions.mapping._SublayerExtension.SublayerExtension"
                             },
+                            {
+                                "$ref": "@vertigis.arcgis-extensions.data._TableExtension.TableExtension"
+                            },
                             {
                                 "type": "string"
                             }

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

@@ -423,6 +423,21 @@
             },
             "type": "object"
         },
+        "@vertigis.arcgis-extensions.data._TableExtension.TableReference": {
+            "additionalProperties": false,
+            "description": "Matches an existing table in a map.",
+            "properties": {
+                "id": {
+                    "description": "The table's ID.",
+                    "type": "string"
+                },
+                "title": {
+                    "description": "The table's title.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "@vertigis.arcgis-extensions.mapping.Bookmark.BookmarkProperties": {
             "additionalProperties": false,
             "description": "Properties that can be passed into the constructor for{@linkmapping /Bookmark!Bookmark}.",
@@ -1364,7 +1379,7 @@
         },
         "CreateFeatureArgs": {
             "additionalProperties": false,
-            "description": "Arguments for the \"edit.create-feature\" operation. A valid feature layer is required. The geometry is required for non-tabular features. Web only.",
+            "description": "Arguments for the \"edit.create-feature\" operation. A valid feature layer, subtype group layer, or subtype sublayer is required. The geometry is required for non-tabular features. Web only.",
             "properties": {
                 "featureAttributes": {
                     "description": "A collection of attributes to apply to the new feature."
@@ -3497,6 +3512,9 @@
                 {
                     "$ref": "#/definitions/@vertigis.arcgis-extensions.mapping._LayerExtension.LayerReference"
                 },
+                {
+                    "$ref": "#/definitions/@vertigis.arcgis-extensions.data._TableExtension.TableReference"
+                },
                 {
                     "$ref": "#/definitions/esri.Layer"
                 },
@@ -3509,12 +3527,18 @@
                 {
                     "$ref": "@vertigis.arcgis-extensions.mapping._SublayerExtension.SublayerExtension"
                 },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data._TableExtension.TableExtension"
+                },
                 {
                     "items": {
                         "anyOf": [
                             {
                                 "$ref": "#/definitions/@vertigis.arcgis-extensions.mapping._LayerExtension.LayerReference"
                             },
+                            {
+                                "$ref": "#/definitions/@vertigis.arcgis-extensions.data._TableExtension.TableReference"
+                            },
                             {
                                 "$ref": "#/definitions/esri.Layer"
                             },
@@ -3527,6 +3551,9 @@
                             {
                                 "$ref": "@vertigis.arcgis-extensions.mapping._SublayerExtension.SublayerExtension"
                             },
+                            {
+                                "$ref": "@vertigis.arcgis-extensions.data._TableExtension.TableExtension"
+                            },
                             {
                                 "type": "string"
                             }
@@ -3549,6 +3576,9 @@
                 {
                     "$ref": "#/definitions/@vertigis.arcgis-extensions.mapping._LayerExtension.LayerReference"
                 },
+                {
+                    "$ref": "#/definitions/@vertigis.arcgis-extensions.data._TableExtension.TableReference"
+                },
                 {
                     "$ref": "#/definitions/esri.Layer"
                 },
@@ -3561,12 +3591,18 @@
                 {
                     "$ref": "@vertigis.arcgis-extensions.mapping._SublayerExtension.SublayerExtension"
                 },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data._TableExtension.TableExtension"
+                },
                 {
                     "items": {
                         "anyOf": [
                             {
                                 "$ref": "#/definitions/@vertigis.arcgis-extensions.mapping._LayerExtension.LayerReference"
                             },
+                            {
+                                "$ref": "#/definitions/@vertigis.arcgis-extensions.data._TableExtension.TableReference"
+                            },
                             {
                                 "$ref": "#/definitions/esri.Layer"
                             },
@@ -3579,6 +3615,9 @@
                             {
                                 "$ref": "@vertigis.arcgis-extensions.mapping._SublayerExtension.SublayerExtension"
                             },
+                            {
+                                "$ref": "@vertigis.arcgis-extensions.data._TableExtension.TableExtension"
+                            },
                             {
                                 "type": "string"
                             }
@@ -4249,16 +4288,28 @@
             "description": "The arguments for the arcade.run operation.",
             "properties": {
                 "arguments": {
-                    "description": "An arguments object that provides named variables and associated values, which can be referenced from within the executeScript and canExecuteScript. NOTE: All variable keys must consist of only lowercase letters; camel-cased context variables will break the script when they are referenced at runtime."
+                    "description": "An arguments object that provides named variables and associated values, which can be referenced from within the executeScript and canExecuteScript. Note that context variables will be passed in if available under the well known arcade variable names: $feature, $features, $map, and $layer and $featuremap a constructed arcade dictionary that exposes a feature mapping dictionary keyed via feature source ID with the following values: id, title and features. NOTE: All variable keys must consist of only lowercase letters; camel-cased context variables will break the script when they are referenced at runtime."
                 },
                 "canExecuteScript": {
-                    "description": "The stringified Arcade script used to determine whether or not the executeScript can/should be run. If no executeScript is provided and the canExecuteScript returns a truthy value, the operation will return its input arguments; otherwise, if the canEecuteScript returns a falsey value, it will throw a{@linkCancellation}.",
+                    "description": "The stringified Arcade script used to determine whether or not the executeScript can/should be run. If no executeScript is provided and the canExecuteScript returns a truthy value, the operation will return its input arguments; otherwise, if the canExecuteScript returns a falsey value, it will throw a{@linkCancellation}.",
                     "type": "string"
                 },
                 "executeScript": {
                     "description": "The stringified Arcade script to run. If this property is included, the operation will return the result of the script.",
                     "type": "string"
                 },
+                "features": {
+                    "$ref": "#/definitions/FeaturesLike",
+                    "description": "Features 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."
+                },
                 "watchHandles": {
                     "description": "Properties used to set a series of watch handles and/or event listeners on an item that will trigger the canExecuteChanged event for the 'arcade.run' operation.",
                     "items": {
@@ -6026,7 +6077,7 @@
             ]
         },
         "arcade.run": {
-            "description": "Runs a stringified Arcade script. If only a string is passed in as an argument, it is interpreted as an executeScript. If an executeSript is provided, the operation will return its result. If only a canExecute script is provided and it returns a truthy result, the operation will return its input arguments. If a canExecuteScript returns a falsey value, the operation will throw a {@link Cancellation }.",
+            "description": "Runs a stringified Arcade script. If only a string is passed in as an argument, it is interpreted as an executeScript. If an executeScript is provided, the operation will return its result. If only a canExecute script is provided and it returns a truthy result, the operation will return its input arguments. If a canExecuteScript returns a falsey value, the operation will throw a {@link Cancellation }.",
             "enum": [
                 "arcade.run"
             ]
@@ -17039,6 +17090,9 @@
                 {
                     "$ref": "#/definitions/@vertigis.arcgis-extensions.mapping._LayerExtension.LayerReference"
                 },
+                {
+                    "$ref": "#/definitions/@vertigis.arcgis-extensions.data._TableExtension.TableReference"
+                },
                 {
                     "$ref": "#/definitions/esri.Layer"
                 },
@@ -17051,12 +17105,18 @@
                 {
                     "$ref": "@vertigis.arcgis-extensions.mapping._SublayerExtension.SublayerExtension"
                 },
+                {
+                    "$ref": "@vertigis.arcgis-extensions.data._TableExtension.TableExtension"
+                },
                 {
                     "items": {
                         "anyOf": [
                             {
                                 "$ref": "#/definitions/@vertigis.arcgis-extensions.mapping._LayerExtension.LayerReference"
                             },
+                            {
+                                "$ref": "#/definitions/@vertigis.arcgis-extensions.data._TableExtension.TableReference"
+                            },
                             {
                                 "$ref": "#/definitions/esri.Layer"
                             },
@@ -17069,6 +17129,9 @@
                             {
                                 "$ref": "@vertigis.arcgis-extensions.mapping._SublayerExtension.SublayerExtension"
                             },
+                            {
+                                "$ref": "@vertigis.arcgis-extensions.data._TableExtension.TableExtension"
+                            },
                             {
                                 "type": "string"
                             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertigis/viewer-spec",
-  "version": "51.3.0",
+  "version": "51.5.0",
   "license": "SEE LICENSE IN LICENSE",
   "description": "VertiGIS Viewer Specification",
   "type": "module",
@@ -35,16 +35,16 @@
   },
   "author": "VertiGIS Ltd.",
   "peerDependencies": {
-    "@vertigis/arcgis-extensions": ">= 37.3.0  < 38.0.0"
+    "@vertigis/arcgis-extensions": ">= 37.5.0  < 38.0.0"
   },
   "devDependencies": {
-    "@arcgis/core": "4.24.7",
+    "@arcgis/core": "^4.25.5",
     "@prettier/plugin-xml": "2.2.0",
     "@types/glob": "8.0.0",
     "@types/node": "14.14.41",
     "@typescript-eslint/eslint-plugin": "5.42.1",
     "@typescript-eslint/parser": "5.42.1",
-    "@vertigis/arcgis-extensions": "37.3.0",
+    "@vertigis/arcgis-extensions": "37.5.0",
     "del-cli": "5.0.0",
     "eslint": "8.27.0",
     "eslint-config-prettier": "8.5.0",

package/version.d.ts

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

package/version.js

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