@vertigis/viewer-spec 47.3.0 → 47.5.0

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

@@ -10,6 +10,11 @@ export interface FeatureInfoModelProperties extends CommonFeatureDetailsModelPro
      * collection.
      */
     onFeatureAdd?: Action;
+    /**
+     * A command or set of commands to execute when an interactive feature
+     * editing session begins.
+     */
+    onFeatureEdit?: Action;
     /**
      * A command or set of commands to execute when a feature is removed from
      * the collection.
@@ -19,4 +24,14 @@ export interface FeatureInfoModelProperties extends CommonFeatureDetailsModelPro
      * A command or set of commands to execute when a related record is clicked.
      */
     onRelatedRecordClick?: Action;
+    /**
+     * If true, the feature details instance will show a button that runs the
+     * action that places the feature in edit mode.
+     */
+    showEditButton?: boolean;
+    /**
+     * If true, the feature details instance will show a button that deletes the
+     * feature permanently.
+     */
+    showDeleteButton?: boolean;
 }

package/messaging/common.d.ts

@@ -2,6 +2,7 @@ import type Graphic from "@arcgis/core/Graphic";
 import type Viewpoint from "@arcgis/core/Viewpoint";
 import type Geometry from "@arcgis/core/geometry/Geometry";
 import type Layer from "@arcgis/core/layers/Layer";
+import type EsriFeatureSet from "@arcgis/core/rest/support/FeatureSet";
 import type LineSymbol3D from "@arcgis/core/symbols/LineSymbol3D";
 import type PictureFillSymbol from "@arcgis/core/symbols/PictureFillSymbol";
 import type PictureMarkerSymbol from "@arcgis/core/symbols/PictureMarkerSymbol";
@@ -10,7 +11,6 @@ import type PolygonSymbol3D from "@arcgis/core/symbols/PolygonSymbol3D";
 import type SimpleFillSymbol from "@arcgis/core/symbols/SimpleFillSymbol";
 import type SimpleLineSymbol from "@arcgis/core/symbols/SimpleLineSymbol";
 import type SimpleMarkerSymbol from "@arcgis/core/symbols/SimpleMarkerSymbol";
-import type EsriFeatureSet from "@arcgis/core/tasks/support/FeatureSet";
 import type { Entity } from "@vertigis/arcgis-extensions/Entity";
 import type { Feature, FeatureProperties } from "@vertigis/arcgis-extensions/data/Feature";
 import type { FeatureList } from "@vertigis/arcgis-extensions/data/FeatureList";

package/messaging/registry/edit.d.ts

@@ -85,7 +85,7 @@ export interface AttachmentEventArgs {
     attachment: Attachment;
 }
 /**
- * Options for editing operations that display a UI.
+ * Options for interactive feature editing sessions.
  */
 export interface EditUIOptions {
     /**
@@ -114,18 +114,29 @@ export interface EditOptions {
      * Whether to allow editing of feature attributes.
      */
     editAttributes?: boolean;
-    /**
-     * Whether to allow editing of feature attachments.
-     */
-    editAttachments?: boolean;
     /**
      * Options for the geometry editing session.
      */
     editGeometryOptions?: EditGeometryOptions;
 }
 /**
- * Arguments for the "edit.create-feature" operation. Also may be supplied to
- * augment an interactive editing session. A valid feature layer is required.
+ * Used to update an in-progress interactive feature editing session with new
+ * attributes, attachments or geometry. Web only.
+ */
+export interface UpdateSessionArgs extends HasGeometry {
+    /**
+     * A collection of attributes that apply or are to be applied to the
+     * currently edited feature.
+     */
+    attributes?: Record<string, string | number>;
+    /**
+     * A collection of attachments that apply or are to be applied to the
+     * currently edited feature.
+     */
+    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.
  */
 export interface CreateFeatureArgs extends HasGeometry, HasLayers, HasMaps, EditUIOptions {
@@ -138,20 +149,37 @@ export interface CreateFeatureArgs extends HasGeometry, HasLayers, HasMaps, Edit
      * layer. The default or first template will be used if not set.
      */
     templateName?: string;
+    /**
+     * A type id to use as a starting point for this feature. This may return
+     * one or more templates and requires a layer with types defined.
+     */
+    typeId?: string;
 }
 /**
  * Arguments for the "edit.display-add-features" command. Web only.
  */
-export interface DisplayAddFeatureArgs extends CreateFeatureArgs, HasMaps, HasUITarget, EditOptions, EditUIOptions {
+export interface DisplayAddFeatureArgs extends CreateFeatureArgs, HasMaps, EditOptions, EditUIOptions {
+    /**
+     * Arguments for the display of the attribute editing form.
+     */
+    formUITarget?: HasUITarget;
+    /**
+     * Arguments for the display of the template picker.
+     */
+    templateUITarget?: HasUITarget;
 }
 /**
  * Arguments for the "edit.display-update-features" operation. Web only.
  */
-export interface DisplayUpdateFeatureArgs extends EditCommandArgs, HasGeometry, HasMaps, EditOptions {
+export interface DisplayUpdateFeatureArgs extends EditCommandArgs, HasGeometry, HasMaps, HasUITarget, EditOptions {
     /**
      * A collection of attributes to automatically apply to the updated feature.
      */
     featureAttributes?: Record<string, unknown>;
+    /**
+     * Whether to allow editing of feature attachments. Web only.
+     */
+    editAttachments?: boolean;
 }
 /**
  * Arguments for the "edit.add-features", "edit.update-features" and
@@ -176,34 +204,60 @@ export declare class EditCommands extends CommandRegistry {
      */
     get deleteAttachment(): Command<DeleteAttachmentArgs>;
     /**
-     * Adds a feature to a particular layer. `Feature[]` and
+     * Adds a feature to a particular layer. `Features` and
      * `EditCommandArgs` are not supported on Mobile.
      */
-    get addFeature(): Command<Feature | Feature[] | EditCommandArgs>;
+    get addFeature(): Command<Feature | Features | EditCommandArgs>;
+    /**
+     * Cancels active editing sessions and discards any changes. If a feature is
+     * supplied only the sessions using that feature will be cancelled.
+     *
+     * @webOnly
+     */
+    get cancel(): Command<Features>;
+    /**
+     * Completes active editing sessions and submits any changes made to the
+     * attributes, attachments or geometry to the feature source. If a feature
+     * is supplied, only sessions using that feature will close.
+     *
+     * @webOnly
+     */
+    get complete(): Command<Features>;
     /**
      * Deletes the given feature or features from their feature sources.
      * `EditCommandArgs` is not supported on Mobile.
      */
-    get deleteFeatures(): Command<Feature | Feature[] | EditCommandArgs>;
+    get deleteFeatures(): Command<Features | EditCommandArgs>;
     /**
-     * Display a form for adding a feature. `DisplayAddFeatureArgs` is not
-     * supported on Mobile.
+     * Begin an interactive feature editing session with a new feature.
+     * `DisplayAddFeatureArgs` is not supported on Mobile.
      */
     get displayAddFeature(): Command<FeatureSource | DisplayAddFeatureArgs>;
     /**
-     * Display a form for updating a feature. `DisplayUpdateFeatureArgs` is not
-     * supported on Mobile.
+     * Begin an interactive feature editing session with an existing feature.
+     * `DisplayUpdateFeatureArgs` is not supported on Mobile.
      */
     get displayUpdateFeature(): Command<Feature | DisplayUpdateFeatureArgs>;
     /**
-     * Updates a feature. `Feature[]` and `EditCommandArgs` are not
-     * supported on Mobile.
+     * Updates a layer feature or features. Edits to the geometry and attributes
+     * of the supplied features will be committed to their respective feature sources.
+     * `Features` and `EditCommandArgs` are not supported on Mobile.
      */
-    get updateFeature(): Command<Feature | Feature[] | EditCommandArgs>;
+    get updateFeature(): Command<Feature | Features | EditCommandArgs>;
+    /**
+     * Updates an in-progress interactive feature editing session with new
+     * attributes, attachments, or geometry. These will be immediately applied
+     * to the current session, if one is active.
+     *
+     * @webOnly
+     */
+    get updateSession(): Command<UpdateSessionArgs>;
 }
 export declare class EditOperations extends OperationRegistry {
     /**
-     * Creates a new `Feature` for the supplied layer from the supplied data.
+     * Creates a new feature for the supplied feature source from the supplied
+     * configuration. This operation does not add the feature to the source, but
+     * returns the feature for further processing.
      *
      * @webOnly
      */
@@ -229,15 +283,25 @@ export declare class EditEvents extends EventRegistry {
      */
     get attachmentDeleted(): Event<AttachmentEventArgs>;
     /**
-     * Raised when a feature is added.
+     * Raised when a new feature is added to a feature source.
      */
     get featureAdded(): Event<Feature>;
     /**
-     * Raised when a feature is deleted.
+     * Raised when a feature is deleted from a feature source.
      */
     get featureDeleted(): Event<Feature>;
     /**
-     * Raised when a feature is updated.
+     * Raised when the attributes or geometry of a feature from a feature source
+     * are updated.
      */
     get featureUpdated(): Event<Feature>;
+    /**
+     * Raised when an interactive feature editing session is updated with new
+     * attributes, attachments, or feature geometry. The payload of this event
+     * represents the current state of that session and has not yet been applied
+     * to the feature.
+     *
+     * @webOnly
+     */
+    get sessionUpdated(): Event<UpdateSessionArgs>;
 }

package/messaging/registry/edit.js

@@ -1 +1 @@
-import{CommandRegistry}from"../CommandRegistry.js";import{EventRegistry}from"../EventRegistry.js";import{OperationRegistry}from"../OperationRegistry.js";export class EditCommands extends CommandRegistry{get addAttachment(){return this._messages.command("edit.add-attachment")}get deleteAttachment(){return this._messages.command("edit.delete-attachment")}get addFeature(){return this._messages.command("edit.add-feature")}get deleteFeatures(){return this._messages.command("edit.delete-features")}get displayAddFeature(){return this._messages.command("edit.display-add-feature")}get displayUpdateFeature(){return this._messages.command("edit.display-update-feature")}get updateFeature(){return this._messages.command("edit.update-feature")}}export class EditOperations extends OperationRegistry{get createFeature(){return this._messages.operation("edit.create-feature")}}export class EditEvents extends EventRegistry{get attachmentAdded(){return this._messages.event("edit.attachment-added")}get attachmentUpdated(){return this._messages.event("edit.attachment-updated")}get attachmentDeleted(){return this._messages.event("edit.attachment-deleted")}get featureAdded(){return this._messages.event("edit.feature-added")}get featureDeleted(){return this._messages.event("edit.feature-deleted")}get featureUpdated(){return this._messages.event("edit.feature-updated")}}
+import{CommandRegistry}from"../CommandRegistry.js";import{EventRegistry}from"../EventRegistry.js";import{OperationRegistry}from"../OperationRegistry.js";export class EditCommands extends CommandRegistry{get addAttachment(){return this._messages.command("edit.add-attachment")}get deleteAttachment(){return this._messages.command("edit.delete-attachment")}get addFeature(){return this._messages.command("edit.add-feature")}get cancel(){return this._messages.command("edit.cancel")}get complete(){return this._messages.command("edit.complete")}get deleteFeatures(){return this._messages.command("edit.delete-features")}get displayAddFeature(){return this._messages.command("edit.display-add-feature")}get displayUpdateFeature(){return this._messages.command("edit.display-update-feature")}get updateFeature(){return this._messages.command("edit.update-feature")}get updateSession(){return this._messages.command("edit.update-session")}}export class EditOperations extends OperationRegistry{get createFeature(){return this._messages.operation("edit.create-feature")}}export class EditEvents extends EventRegistry{get attachmentAdded(){return this._messages.event("edit.attachment-added")}get attachmentUpdated(){return this._messages.event("edit.attachment-updated")}get attachmentDeleted(){return this._messages.event("edit.attachment-deleted")}get featureAdded(){return this._messages.event("edit.feature-added")}get featureDeleted(){return this._messages.event("edit.feature-deleted")}get featureUpdated(){return this._messages.event("edit.feature-updated")}get sessionUpdated(){return this._messages.event("edit.session-updated")}}

package/messaging/registry/results.d.ts

@@ -261,9 +261,10 @@ export declare type ShowResultsArgs = Features | (UpdateResultsFeaturesArgs & {
  */
 export interface SetDisplayComponentArgs {
     /**
-     * Sets the current selector for the results components to display results
-     * using `results.display`. Additionally, any components that do not match
-     * the current selector are deactivated.
+     * Sets the selector, using CSS selector syntax, which queries for results
+     * components in the app layout XML, such as the Results List or Results
+     * Table components. The selector is used to determine which components will
+     * be activated when displaying results using `results.display`.
      */
     selector: string;
     /**
@@ -283,9 +284,12 @@ export declare class ResultsCommands extends CommandRegistry {
      */
     get display(): Command<Features | UpdateResultsFeaturesArgs>;
     /**
-     * Sets the current selector for the results components to display results
-     * using `results.display`. Additionally, any components that do not match
-     * the current selector are deactivated.
+     * Sets the selector, using CSS selector syntax, which queries for results
+     * components in the app layout XML, such as the Results List or Results
+     * Table components. The selector is used to determine which components will
+     * be activated when displaying results using `results.display`. All other
+     * components that do not match the selector are deactivated after running
+     * this command.
      *
      * @webOnly
      */

package/messaging/registry/ui.d.ts

@@ -282,8 +282,6 @@ export declare class UICommands extends CommandRegistry {
     get hideBusyState(): Command;
     /**
      * Hides a notification previously shown to the user.
-     *
-     * @mobileOnly
      */
     get hideNotification(): Command;
     /**