@vertigis/workflow 5.45.1 → 5.46.0

package/activities/core/WebRequest.d.ts

@@ -3,46 +3,35 @@ import type { ChannelInfo } from "./ChannelProvider";
 import type { IActivityHandler, IActivityContext } from "../../IActivityHandler";
 /** Defines inputs for the WebRequest activity. */
 export interface WebRequestInputs {
-    /** Indicates the URL for the request. */
     url: string;
-    /** Indicates the request method. */
     method?: "GET" | "POST" | string;
-    /** Indicates the headers for the request. */
     headers?: Record<string, any>;
-    /** Indicates the query for the request query string. */
     query?: Record<string, any>;
-    /** Indicates the form for the request content. */
     form?: Record<string, any>;
-    /** Indicates the blob for the request content. */
     blob?: ArrayBuffer | Blob;
-    /** Indicates the json for the request content. */
     json?: any;
-    /** Indicates the text for the request content. */
     text?: string;
-    /** Indicates what to expect in terms of a response. */
     expect?: "blob" | "json" | "text" | string;
     /** Indicates the channel to use to send the request. */
     channel?: ChannelProvider;
-    /** Indicates the channel to use to send the request by name. */
     channelName?: "default" | "arcgis" | "geocortex" | string;
-    /** Indicates the timeout for the request/response. */
     timeout?: number;
-    /** Indicates whether to send credentials with a CORS request */
     corsWithCredentials?: boolean;
     failForNonSuccessStatusCodes?: boolean;
 }
 /** Defines outputs for the WebRequest activity. */
 export interface WebRequestOutputs {
-    /** Indicates the channel that was used. */
+    /** @description The channel that was used for the request. The channel provides access the raw request and response objects. */
     channel: ChannelInfo;
-    /** Indicates the time taken for the response to arrive. */
+    /** @description The elapsed time (in milliseconds) of the request. */
     elapsed: number;
-    /** Indicates the blob taken from the response content. */
+    /** @description The binary/blob content of the response. */
     blob?: ArrayBuffer;
-    /** Indicates the json taken from the response content. */
+    /** @description The JSON content of the response. */
     json?: any;
+    /** @description The HTTP status code of the response. */
     status?: number;
-    /** Indicates the text taken from the response content. */
+    /** @description The text content of the response. */
     text?: string;
 }
 export declare class WebRequest implements IActivityHandler {

package/activities/csv/ConvertCsvToDataTable.d.ts

@@ -6,6 +6,7 @@ export interface ConvertCsvToDataTableInputs {
 }
 /** Defines outputs from the ConvertCsvToDataTable activity. */
 export interface ConvertCsvToDataTableOutputs {
+    /** @description A DataTable representing the data from the Comma Separated Values string. */
     result: object;
 }
 export declare class ConvertCsvToDataTable implements IActivityHandler {

package/activities/csv/ConvertDataTableToCsv.d.ts

@@ -6,6 +6,7 @@ export interface ConvertDataTableToCsvInputs {
 }
 /** Defines outputs from the ConvertDataTableToCsv activity. */
 export interface ConvertDataTableToCsvOutputs {
+    /** @description The result Comma Separated Values (.csv) string. */
     result: string;
 }
 export declare class ConvertDataTableToCsv implements IActivityHandler {

package/activities/csv/ParseCsv.d.ts

@@ -0,0 +1,20 @@
+import type { IActivityHandler } from "../../IActivityHandler";
+/** Defines outputs for the ParseCsv activity. */
+export interface ParseCsvInputs {
+    csv: string;
+    delimiter?: string;
+    quoteCharacter?: string;
+    headerPresent?: boolean;
+    parseNumbers?: boolean;
+    parseBooleans?: boolean;
+}
+/** Defines outputs for the ParseCsv activity. */
+export interface ParseCsvOutputs {
+    /** @description An array of objects corresponding to the given CSV text. /*/
+    result: any[];
+}
+export declare class ParseCsv implements IActivityHandler {
+    static readonly action = "gcx:wf:csv::ParseCsv";
+    static readonly suite = "gcx:wf:builtin";
+    execute(inputs: ParseCsvInputs): ParseCsvOutputs;
+}

package/activities/csv/ParseCsv.js

@@ -0,0 +1 @@
+import{ActivityInputError}from"../../Errors.js";import{validation}from"../../Validation.js";class ParseCsv{execute(e){const i=validation.string("csv",e.csv,validation.never);var t=validation.boolean("headerPresent",e.headerPresent,!0);const o=validation.string("quoteCharacter",e.quoteCharacter,'"'),u=validation.string("delimiter",e.delimiter,","),r=validation.boolean("parseBooleans",e.parseBooleans,!0),n=validation.boolean("parseNumbers",e.parseNumbers,!0);var a=(t=0)=>{const r=[];let n="",a="before";for(let e=t;e<i.length;e++){var s=i[e];if(s===o)switch(a){case"before":if(""!==n)throw new ActivityInputError("csv","Opening quote found within a value. Quotes must occur at the start and end, and be escaped when in between.");a="in";continue;case"in":i[e+1]===o?(n+=o,e++):a="after";continue}else if(s!==u)if("\r"===s&&"\n"===i[e+1]){if("in"!==a)return r.push(n),{values:r,startIndex:e+2};n+="\r\n",e++}else if("\n"===s){if("in"!==a)return r.push(n),{values:r,startIndex:e+1};n+=s}else{if("after"===a)throw new ActivityInputError("csv","Character found after closing quote. Quotes must occur at the start and end, and be escaped when in between.");n+=s}else"in"===a?n+=u:(r.push(n),n="",a="before")}return r.push(n),t=i.length,{values:r,startIndex:t}};let s=[],l=0;t&&(t=a(),s=t.values,l=t.startIndex);const c=[];for(;l<i.length;){const h=a(l);var v=h.values.map(e=>{if(n){if(""===e.trim())return e;var t=Number(e);if(!isNaN(t))return t}if(r){if("true"===e.toLowerCase())return!0;if("false"===e.toLowerCase())return!1}return e});const p={};for(let e=0;e<v.length;e++){var f=s[e]||e,d=v[e];p[f]=d}c.push(p),l=h.startIndex}return{result:c}}}ParseCsv.action="gcx:wf:csv::ParseCsv",ParseCsv.suite="gcx:wf:builtin";export{ParseCsv};

package/activities/essentials/GetEssentialsSite.d.ts

@@ -215,7 +215,7 @@ export interface Workflow {
 }
 /** Defines outputs from the GetEssentialsSite activity. */
 export interface GetEssentialsSiteOutputs {
-    /** The Essentials site. */
+    /** @description The Essentials site. */
     site: Site;
 }
 export declare class GetEssentialsSite implements IActivityHandler {

package/activities/essentials/RunEssentialsWorkflow.d.ts

@@ -2,16 +2,13 @@ import { ChannelProvider } from "../core/ChannelProvider";
 import type { IActivityHandler, IActivityContext } from "../../IActivityHandler";
 /** Defines inputs for the RunEssentialsWorkflow activity. */
 export interface RunEssentialsWorkflowInputs {
-    /** The URL of the Essentials Workflow, without the "/run" ending. */
     url: string;
-    /** The input arguments of the Essentials workflow. */
     arguments?: Record<string, any>;
-    /** The timeout for the request/response. */
     timeout?: number;
 }
 /** Defines outputs for the RunEssentialsWorkflow activity. */
 export interface RunEssentialsWorkflowOutputs {
-    /** The resulting values of the Out and In/Out Arguments from the Essentials workflow. */
+    /** @description The resulting values of the Out and In/Out Arguments from the Essentials workflow. */
     result: Record<string, any>;
 }
 export declare class RunEssentialsWorkflow implements IActivityHandler {

package/activities/essentials/RunEssentialsWorkflowActivity.d.ts

@@ -2,14 +2,14 @@ import type { IActivityHandler } from "../../IActivityHandler";
 /** Defines inputs for the RunEssentialsWorkflowActivity activity. */
 export interface RunEssentialsWorkflowActivityInputs {
     action: "Alert" | "CaptureGeometry" | "Confirm" | "ExportMap" | "GetBrowserUrl" | "GetExternalTimeInfo" | "GetExternalValue" | "GetSelectedFeatures" | "PrintMap" | "Prompt" | "Report" | "SetExternalValue" | string;
-    /** The input arguments to the activity. */
     inputs: any;
 }
 /** Defines outputs for the RunEssentialsWorkflow activity. */
 export interface RunEssentialsWorkflowActivityOutputs {
-    /** The output arguments of the Essentials workflow activity. */
+    /** @description The output arguments of the Essentials workflow activity. */
     result: Record<string, any>;
 }
+/** Runs a Geocortex Essentials (client-side) workflow activity. */
 export declare class RunEssentialsWorkflowActivity implements IActivityHandler {
     static readonly action = "gcx:wf:essentials::RunEssentialsWorkflowActivity";
     static readonly suite = "gcx:wf:builtin";

package/activities/forms/AddFormElement.d.ts

@@ -3,11 +3,8 @@ import type { IActivityHandler, EmptyOutputs } from "../../IActivityHandler";
 import type * as defs from "../../forms/FormDefinition";
 export interface AddFormElementInputs {
     form: DisplayFormOutputs;
-    /** The ID of the form element to add. */
     elementName: string;
-    /** The type of form element to add. */
     elementType: "AutoComplete" | "ButtonBar" | "CheckBox" | "CheckGroup" | "Custom" | "DatePicker" | "DateRangePicker" | "DateTimePicker" | "DropDownList" | "FilePicker" | "GeometryPicker" | "HorizontalRule" | "Image" | "ItemPicker" | "ListBox" | "Number" | "NumberRangeSlider" | "NumberSlider" | "PasswordBox" | "RadioGroup" | "Scanner" | "Section" | "Signature" | "Sketch" | "Text" | "TextArea" | "TextBox" | "TimePicker" | string;
-    /** The definition of the form element to add. */
     element: defs.Element;
     targetForm?: DisplayFormOutputs;
     targetElement?: string | defs.Element;

package/activities/forms/DisplayForm.d.ts

@@ -9,7 +9,6 @@ export interface DisplayFormInputs {
     form: defs.Form;
     /** Indicates the form template to load if not yet loaded. */
     template?: defs.Form;
-    /** Indicates what container to use when displaying the form. */
     container?: "default" | "modal" | string;
     /** Indicates what region to use when activating the form's container. */
     region?: string;
@@ -21,12 +20,11 @@ export interface DisplayFormInputs {
  * @public
  */
 export interface DisplayFormOutputs {
-    /** Indicates the state of the form. */
+    /** @description The state of the form. Use this to update or access the values of form elements. */
     state: Record<string, defs.Element>;
-    /** Indicates the result for the form (if set, causes the form to exit on the next pass). */
+    /** @description The result of the form. */
     result?: string;
 }
-/** Displays a form. */
 export declare class DisplayForm implements IActivityHandler {
     static renderers: Record<string, FormRenderer | undefined>;
     /**

package/activities/forms/FilterFormElementItems.d.ts

@@ -7,6 +7,7 @@ export interface FilterFormElementItemsInputs {
     phrase?: string;
 }
 export interface FilterFormElementItemsOutputs {
+    /** @description The result indicates if any items remain after filtering. */
     result: boolean;
 }
 export declare class FilterFormElementItems implements IActivityHandler {

package/activities/forms/FormRenderer.js

@@ -1 +1 @@
-import{ActivityAbortedError}from"../../Errors.js";import{FormHost,defs}from"../../forms/FormHost.js";import{FormElementTypes}from"../../forms/constants.js";import{getContent}from"../../forms/textUtilities.js";import{text}from"../../forms/utils.js";import{FormElementNotFoundError,NoFormElementAvailableError}from"./Errors.js";function toMarkdownRef(e,t){return"string"!=typeof t?t:{markdown:t}}const guid="F889738A-EBE2-4D52-8B46-3E24CC6E30F6:";class FormRenderer extends FormHost{static create(){return new this}static createCustom(){const e=new this;return e.custom=!0,e}static register(e){e.factories.push(e=>e===this.type?this:void 0)}addElement(e,r,t,o){if(r===FormElementTypes.HEADER)throw new Error("A form cannot contain more than one header element.");const n=this.form["elements"];if(n[e])throw new Error(`Element already present: ${e}`);const s={};if("object"==typeof t)for(const E in t)s[E]=t[E];s.type=r;var i=o?.targetElementName;let m=o?.relativePosition,a=!0;o=()=>{let e=-1;for(const t of Object.values(n))void 0!==t.rowNumber&&(e=Math.max(e,t.rowNumber));return e};let l,f;if(i&&m&&n[i]){let e=0,t=0;i=n[i];switch("header"===i.section?m="above":"footer"===i.section?(m="below",e=o()):(e=i.rowNumber,t=i.rowIndex,i.type!==FormElementTypes.SECTION&&r!==FormElementTypes.SECTION||(t=0,"before"===m?m="above":"after"===m&&(m="below"))),m){case"before":a=!1,l=e,f=t;break;case"after":a=!1,l=e,f=t+1;break;case"above":a=!0,l=e,f=0;break;default:a=!0,l=e+1,f=0}}else f=void 0!==s.rowNumber&&void 0!==s.rowIndex?(l=s.rowNumber||0,s.rowIndex||0):(l=o()+1,0);s.rowNumber=l,s.rowIndex=f;for(const t of Object.values(n)){var{rowNumber:c,rowIndex:u}=t;void 0!==c&&void 0!==u&&(a?c>=l&&t.rowNumber++:c===l&&u>=f&&t.rowIndex++)}n[e]=s;const d=[];for(const e of Object.keys(n)){const t=n[e];t.type===FormElementTypes.SECTION&&(d[t.rowNumber]={name:e})}for(const t of Object.values(n))void 0===t.rowNumber||t.rowNumber<l||t.type!==FormElementTypes.SECTION&&(t.section=(e=>{for(;0<=e;){var t=d[e];if(t)return t;e--}})(t.rowNumber));return this.invalidate(),s}assignElementProperty(t,r,o,e=!1,n=!0){e&&(o=toMarkdownRef(r,o));const s=this.getElement(t);if(s[r]!==o){const i={},m=this.getElementRegistration(s);if(m?.onPropertyChange)try{const a=(e,t)=>{i[e]!==t&&(i[e]=t,m.onPropertyChange({properties:{...s,...i},property:e,setProperty:a}))};a(r,o)}catch(e){throw console.error(`Error setting element property.\nElement: "${t}"\nProperty: "${r}"\nValue: ${o}\n`,e),e}else i[r]=o;for(const l of Object.keys(i))s[l]=i[l];m&&"value"in i&&!1!==n&&(t={..."object"==typeof n?n:{},name:t,value:i.value},this.post("changed",t)),this.refresh()}}assignElementItemProperty(e,t,r,o,n){const s=this.getElement(e),i=s.items||{};if(i[t][r]=n?toMarkdownRef(r,o):o,"checked"===r&&[FormElementTypes.CHECKGROUP,FormElementTypes.ITEMPICKER,FormElementTypes.LISTBOX].includes(s.type)){const a=[];for(const t in i){var m=i[t];m.checked&&a.push(m)}s.value=0===a.length?void 0:{refValueType:"items",items:a}}this.refresh(e)}assignItemsToElement(e,t,r){const o=this.getElement(e);let n=o.items||{};!1!==r&&(n={});for(const s in t)n[s]=t[s];o.items=n,o.type!==FormElementTypes.GEOMETRYPICKER&&o.type!==FormElementTypes.ITEMPICKER||delete o.state,this.invalidate(e)}cancelTool(){}deriveLocale(){return this.state?.locale||super.deriveLocale()}dispose(){if(super.dispose()){const e=this.state;return void 0!==e&&null!==e&&e.completion.isPending()&&e.reject(new ActivityAbortedError),!0}return!1}filterItems(e,t){const r=this.find(e);if(void 0===r||null===r)return!1;var o=r.items;if(null==o)return!1;if("string"!=typeof t)return t;let n=!1;const s={};var i=t.toLowerCase().split(/\s+/);for(const l in o){var m=o[l];const f=this.renderText(m.label);var a=f.toLowerCase().split(/\s+/);for(const c of i)if(0<c.length)for(const u of a)0<u.length&&0===u.indexOf(c)&&(n=!0,s[l]=m)}return r.items=s,this.invalidate(e),n}getElement(e,t){let r;if(e){if("string"!=typeof e)return e;r=e}else t?.name&&(r=t.name);if(r){t=this.form.elements[r];if(!t)throw new FormElementNotFoundError(r);return t}throw new NoFormElementAvailableError}getElementName(e,t){if(e){if("string"==typeof e)return e;for(const r in this.form.elements)if(this.form.elements[r]===e)return r;throw new FormElementNotFoundError(e)}if(t?.name)return t.name;throw new NoFormElementAvailableError}getElementRegistration(e){return this.state?.trivia?.getFormElementRegistration?.(e.customType??e.type)}getText(e){var t=this.state;if(void 0!==t){const r=t.environment.getText;if("function"==typeof r){if(text.isMarkdown(e))return{markdown:r(e.markdown)};if(text.isStatus(e))return{markdown:r(`@form-element-status-${e.status}`)};if(e&&"@"===e[0]){t=r(e);if(t)return t}}}return e}hideElement(e){e.visible=!1,this.invalidate()}isRelated(e){return this.state?.trivia?.isDescendantOf?.(e.state)}load(e,t){t=super.load(e,t);if(t&&this.form?.elements)for(const o in this.form.elements){var r=this.form.elements[o];const n=this.getElementRegistration(r);n&&n.getInitialProperties&&(r={...r,...n.getInitialProperties()},this.form.elements[o]=r)}return t}renderText(e){return super.renderText(this.getText(e))}setCurrentItem(e,t,r){const n=this.getElement(e);if(!n||!n.items)return!1;let o;switch(r){case"index":o=(e,t,r)=>{var o=Object.keys(n.items);return 0<o.length&&e===o[r]};break;case"item":o=(e,t,r)=>r===t;break;case"key":o=(e,t,r)=>r===e;break;case"label":o=(e,t,r)=>getContent(r)===getContent(t.label);break;case"value":o=(e,t,r)=>r===t.value;break;default:throw new Error("Unsupported value for itemMatchType: "+r)}for(const s in n.items)if(o(s,n.items[s],t))return n.current=s,[FormElementTypes.AUTOCOMPLETE,FormElementTypes.DROPDOWNLIST,FormElementTypes.RADIOGROUP].includes(n.type)&&(n.label=n.items[s].label,n.value=n.items[s].value),this.invalidate(e),this.cascade(e),!0;return!1}setElementError(e,t,r=!1){this.errors[e]=r?toMarkdownRef("error",t):t}showElement(e){e.visible=!0,this.invalidate()}spinNoBlock(){return this.spin()}translateText(e){return super.translateText(this.getText(e))}}FormRenderer.type=guid+"FormRenderer";export{defs,FormRenderer};
+import{ActivityAbortedError}from"../../Errors.js";import{FormHost,defs}from"../../forms/FormHost.js";import{FormElementTypes}from"../../forms/constants.js";import{getContent}from"../../forms/textUtilities.js";import{text}from"../../forms/utils.js";import{FormElementNotFoundError,NoFormElementAvailableError}from"./Errors.js";function toMarkdownRef(e,t){return"string"!=typeof t?t:{markdown:t}}const guid="F889738A-EBE2-4D52-8B46-3E24CC6E30F6:";class FormRenderer extends FormHost{static create(){return new this}static createCustom(){const e=new this;return e.custom=!0,e}static register(e){e.factories.push(e=>e===this.type?this:void 0)}addElement(e,r,t,o){if(r===FormElementTypes.HEADER)throw new Error("A form cannot contain more than one header element.");const n=this.form["elements"];if(n[e])throw new Error(`Element already present: ${e}`);const s={};if("object"==typeof t)for(const E in t)s[E]=t[E];s.type=r;var i=o?.targetElementName;let m=o?.relativePosition,a=!1;o=()=>{let e=-1;for(const t of Object.values(n))void 0!==t.rowNumber&&(e=Math.max(e,t.rowNumber));return e};let l,f;if(i&&m&&n[i]){let e=0,t=0;i=n[i];switch("header"===i.section?m="above":"footer"===i.section?(m="below",e=o()):(e=i.rowNumber,t=i.rowIndex,i.type!==FormElementTypes.SECTION&&r!==FormElementTypes.SECTION||(t=0,"before"===m?m="above":"after"===m&&(m="below"))),m){case"before":a=!1,l=e,f=t;break;case"after":a=!1,l=e,f=t+1;break;case"above":a=!0,l=e,f=0;break;default:a=!0,l=e+1,f=0}}else f=void 0!==s.rowNumber&&void 0!==s.rowIndex?(l=s.rowNumber||0,s.rowIndex||0):(l=o()+1,0);s.rowNumber=l,s.rowIndex=f;for(const t of Object.values(n)){var{rowNumber:c,rowIndex:u}=t;void 0!==c&&void 0!==u&&(a?c>=l&&t.rowNumber++:c===l&&u>=f&&t.rowIndex++)}n[e]=s;const d=[];for(const e of Object.keys(n)){const t=n[e];t.type===FormElementTypes.SECTION&&(d[t.rowNumber]={name:e})}for(const t of Object.values(n))void 0===t.rowNumber||t.rowNumber<l||t.type!==FormElementTypes.SECTION&&(t.section=(e=>{for(;0<=e;){var t=d[e];if(t)return t;e--}})(t.rowNumber));return this.invalidate(),s}assignElementProperty(t,r,o,e=!1,n=!0){e&&(o=toMarkdownRef(r,o));const s=this.getElement(t);if(s[r]!==o){const i={},m=this.getElementRegistration(s);if(m?.onPropertyChange)try{const a=(e,t)=>{i[e]!==t&&(i[e]=t,m.onPropertyChange({properties:{...s,...i},property:e,setProperty:a}))};a(r,o)}catch(e){throw console.error(`Error setting element property.\nElement: "${t}"\nProperty: "${r}"\nValue: ${o}\n`,e),e}else i[r]=o;for(const l of Object.keys(i))s[l]=i[l];m&&"value"in i&&!1!==n&&(t={..."object"==typeof n?n:{},name:t,value:i.value},this.post("changed",t)),this.refresh()}}assignElementItemProperty(e,t,r,o,n){const s=this.getElement(e),i=s.items||{};if(i[t][r]=n?toMarkdownRef(r,o):o,"checked"===r&&[FormElementTypes.CHECKGROUP,FormElementTypes.ITEMPICKER,FormElementTypes.LISTBOX].includes(s.type)){const a=[];for(const t in i){var m=i[t];m.checked&&a.push(m)}s.value=0===a.length?void 0:{refValueType:"items",items:a}}this.refresh(e)}assignItemsToElement(e,t,r){const o=this.getElement(e);let n=o.items||{};!1!==r&&(n={});for(const s in t)n[s]=t[s];o.items=n,o.type!==FormElementTypes.GEOMETRYPICKER&&o.type!==FormElementTypes.ITEMPICKER||delete o.state,this.invalidate(e)}cancelTool(){}deriveLocale(){return this.state?.locale||super.deriveLocale()}dispose(){if(super.dispose()){const e=this.state;return void 0!==e&&null!==e&&e.completion.isPending()&&e.reject(new ActivityAbortedError),!0}return!1}filterItems(e,t){const r=this.find(e);if(void 0===r||null===r)return!1;var o=r.items;if(null==o)return!1;if("string"!=typeof t)return t;let n=!1;const s={};var i=t.toLowerCase().split(/\s+/);for(const l in o){var m=o[l];const f=this.renderText(m.label);var a=f.toLowerCase().split(/\s+/);for(const c of i)if(0<c.length)for(const u of a)0<u.length&&0===u.indexOf(c)&&(n=!0,s[l]=m)}return r.items=s,this.invalidate(e),n}getElement(e,t){let r;if(e){if("string"!=typeof e)return e;r=e}else t?.name&&(r=t.name);if(r){t=this.form.elements[r];if(!t)throw new FormElementNotFoundError(r);return t}throw new NoFormElementAvailableError}getElementName(e,t){if(e){if("string"==typeof e)return e;for(const r in this.form.elements)if(this.form.elements[r]===e)return r;throw new FormElementNotFoundError(e)}if(t?.name)return t.name;throw new NoFormElementAvailableError}getElementRegistration(e){return this.state?.trivia?.getFormElementRegistration?.(e.customType??e.type)}getText(e){var t=this.state;if(void 0!==t){const r=t.environment.getText;if("function"==typeof r){if(text.isMarkdown(e))return{markdown:r(e.markdown)};if(text.isStatus(e))return{markdown:r(`@form-element-status-${e.status}`)};if(e&&"@"===e[0]){t=r(e);if(t)return t}}}return e}hideElement(e){e.visible=!1,this.invalidate()}isRelated(e){return this.state?.trivia?.isDescendantOf?.(e.state)}load(e,t){t=super.load(e,t);if(t&&this.form?.elements)for(const o in this.form.elements){var r=this.form.elements[o];const n=this.getElementRegistration(r);n&&n.getInitialProperties&&(r={...r,...n.getInitialProperties()},this.form.elements[o]=r)}return t}renderText(e){return super.renderText(this.getText(e))}setCurrentItem(e,t,r){const n=this.getElement(e);if(!n||!n.items)return!1;let o;switch(r){case"index":o=(e,t,r)=>{var o=Object.keys(n.items);return 0<o.length&&e===o[r]};break;case"item":o=(e,t,r)=>r===t;break;case"key":o=(e,t,r)=>r===e;break;case"label":o=(e,t,r)=>getContent(r)===getContent(t.label);break;case"value":o=(e,t,r)=>r===t.value;break;default:throw new Error("Unsupported value for itemMatchType: "+r)}for(const s in n.items)if(o(s,n.items[s],t))return n.current=s,[FormElementTypes.AUTOCOMPLETE,FormElementTypes.DROPDOWNLIST,FormElementTypes.RADIOGROUP].includes(n.type)&&(n.label=n.items[s].label,n.value=n.items[s].value),this.invalidate(e),this.cascade(e),!0;return!1}setElementError(e,t,r=!1){this.errors[e]=r?toMarkdownRef("error",t):t}showElement(e){e.visible=!0,this.invalidate()}spinNoBlock(){return this.spin()}translateText(e){return super.translateText(this.getText(e))}}FormRenderer.type=guid+"FormRenderer";export{defs,FormRenderer};

package/activities/forms/GetFormElementItemsFromCollection.d.ts

@@ -1,15 +1,12 @@
 import type { IActivityHandler } from "../../IActivityHandler";
 import type { Item } from "../../forms/FormDefinition";
 export interface GetFormElementItemsFromCollectionInputs {
-    /** The collection to be converted to the items collection. */
     collection: any[];
-    /** The name of the field used to populate the items' labels. If not provided, the item itself will be used as the label. */
     labelFieldName?: string;
-    /** The name of the field used to populate the items' values. If not provided, the item itself is used in a DataRef object. */
     valueFieldName?: string;
 }
 export interface GetFormElementItemsFromCollectionOutputs {
-    /** The result items collection. */
+    /** @description The result items collection. */
     items: Record<string, Item>;
 }
 export declare class GetFormElementItemsFromCollection implements IActivityHandler {

package/activities/forms/GetFormElementProperty.d.ts

@@ -5,11 +5,10 @@ export interface GetFormElementPropertyInputs {
     form: DisplayFormOutputs;
     /** The name of the form element. */
     elementName?: string | defs.Element;
-    /** The name of the element property to get. */
     name: string;
 }
 export interface GetFormElementPropertyOutputs {
-    /** The value of the property. */
+    /** @description The value of the property. */
     value: any;
 }
 export declare class GetFormElementProperty implements IActivityHandler {

package/activities/forms/GetFormElementValue.d.ts

@@ -7,7 +7,7 @@ export interface GetFormElementValueInputs {
     elementName?: string | defs.Element;
 }
 export interface GetFormElementValueOutputs {
-    /** The value of the form element. */
+    /** @description The value of the form element. */
     value: any;
 }
 export declare class GetFormElementValue implements IActivityHandler {

package/activities/forms/GetFormEventData.d.ts

@@ -4,10 +4,15 @@ export interface GetFormEventDataInputs {
     form: DisplayFormOutputs;
 }
 export interface GetFormEventDataOutputs {
+    /** @description The id of the form element that raised the event. */
     elementId?: string;
+    /** @description The id of the form element item that raised the event. */
     itemId?: string;
+    /** @description The type of event. */
     type?: string;
+    /** @description The argument for the event. */
     argument?: any;
+    /** @description The current value of the form element or item that raised the event. */
     value?: any;
 }
 export declare class GetFormEventData implements IActivityHandler {

package/activities/forms/SetCurrentFormElementItem.d.ts

@@ -9,6 +9,7 @@ export interface SetCurrentFormElementItemInputs {
     value: any;
 }
 export interface SetCurrentFormElementItemOutputs {
+    /** @description True if a match was found, false otherwise. */
     result: boolean;
 }
 export declare class SetCurrentFormElementItem implements IActivityHandler {

package/activities/forms/SetFormElementError.d.ts

@@ -5,9 +5,7 @@ export interface SetFormElementErrorInputs {
     form: DisplayFormOutputs;
     /** The ID of the form element to apply the error to. */
     elementName?: string | defs.Element;
-    /** The error message to apply to the form element. */
     error: string;
-    /** Controls when strings are interpreted as markdown. */
     markdown?: boolean;
 }
 export declare class SetFormElementError implements IActivityHandler {

package/activities/forms/SetFormElementEvent.d.ts

@@ -2,13 +2,10 @@ import type { DisplayFormOutputs } from "./DisplayForm";
 import type { IActivityHandler, IActivityContext, EmptyOutputs } from "../../IActivityHandler";
 export interface SetFormElementEventInputs {
     form: DisplayFormOutputs;
-    /** The id of the Display Form activity that contains the element to add the event to. */
     displayFormId: string;
     /** The ID of the form element to apply the event to. */
     elementName?: string;
-    /** The name of the event to add to the Element. */
     eventName: "cancel" | "changed" | "clicked" | "custom" | "dragged" | "load" | "populate" | "submit" | "suggest" | "validate" | string;
-    /** The id of the activity to be used as the event handler. This can be a Container, Function, or Try Catch. */
     targetActivityId: string;
 }
 export declare class SetFormElementEvent implements IActivityHandler {

package/activities/forms/SetFormElementEvent.js

@@ -1 +1 @@
-import{GenericActivityError}from"../../Errors.js";import{validation}from"../../Validation.js";class SetFormElementEvent{execute(e,t){const{eventName:i,form:r}=e;let{displayFormId:n,elementName:o,targetActivityId:m}=e;if(n=validation.string("displayFormId",n),o=validation.string("elementName",o),m=validation.string("targetActivityId",m,validation.never),n&&"$"===n[0]&&(n=n.substring(1)),n=n||t.ambient.activityContexts.$$form.activity.id,!n)throw new GenericActivityError(`No form could be found. displayFormId=${e.displayFormId}`);if(!(o=r.actor.getElementName(o,r.event)))throw new GenericActivityError(`No form element could be found to assign the event to. elementName=${e.elementName}`);return"$"===m[0]&&(m=m.substring(1)),t.ambient.trivia.setFormElementEvent(n,m,o,i),{}}}SetFormElementEvent.action="gcx:wf:forms::SetFormElementEvent",SetFormElementEvent.suite="gcx:wf:builtin";export{SetFormElementEvent};
+import{GenericActivityError}from"../../Errors.js";import{validation}from"../../Validation.js";class SetFormElementEvent{execute(e,t){const{eventName:i,form:r}=e;let{displayFormId:n,elementName:o,targetActivityId:m}=e;if(n=validation.string("displayFormId",n),o=validation.string("elementName",o),m=validation.string("targetActivityId",m,validation.never),n&&"$"===n[0]&&(n=n.substring(1)),n=n||t.ambient.activityContexts.$$form.activity.id,!n)throw new GenericActivityError(void 0,`No form could be found. displayFormId=${e.displayFormId}`);if(!(o=r.actor.getElementName(o,r.event)))throw new GenericActivityError(void 0,`No form element could be found to assign the event to. elementName=${e.elementName}`);return"$"===m[0]&&(m=m.substring(1)),t.ambient.trivia.setFormElementEvent(n,m,o,i),{}}}SetFormElementEvent.action="gcx:wf:forms::SetFormElementEvent",SetFormElementEvent.suite="gcx:wf:builtin";export{SetFormElementEvent};

package/activities/forms/SetFormElementItemProperty.d.ts

@@ -5,13 +5,9 @@ export interface SetFormElementItemPropertyInputs {
     form: DisplayFormOutputs;
     /** The ID of the form element bearing the items. */
     elementName?: string | defs.Element;
-    /** The key of the item to modify. */
     itemKey: string | number;
-    /** The name of the property to modify. */
     propertyName: "checked" | "default" | "enabled" | "index" | "label" | "styleName" | "tooltip" | "validates" | "value" | "visible" | string;
-    /** The value of the property to assign. */
     propertyValue: any;
-    /** Controls when strings are interpreted as markdown. */
     markdown?: boolean;
 }
 export declare class SetFormElementItemProperty implements IActivityHandler {

package/activities/forms/SetFormElementItems.d.ts

@@ -6,9 +6,7 @@ export interface SetFormElementItemsInputs {
     form: DisplayFormOutputs;
     /** The ID of the fom element to assign items to. */
     elementName?: string | defs.Element;
-    /** The collection of items to assign to the element. */
     items: Record<string, Item>;
-    /** Controls if the collection is cleared prior to assigning the items. */
     reset?: boolean;
 }
 export declare class SetFormElementItems implements IActivityHandler {

package/activities/forms/SetFormElementProperty.d.ts

@@ -5,11 +5,8 @@ export interface SetFormElementPropertyInputs {
     form: DisplayFormOutputs;
     /** The ID of the form element to modify. */
     elementName?: string | defs.Element;
-    /** The name of the element property to modify. */
     propertyName: "accessibleDescription" | "autoActivate" | "checked" | "collapsed" | "current" | "delay" | "dependsOn" | "description" | "enabled" | "error" | "fileTypes" | "format" | "itemLabel" | "items" | "label" | "manualEntry" | "maxLength" | "minLength" | "orientation" | "prompt" | "readOnly" | "require" | "rowIndex" | "rowNumber" | "selectionMode" | "showFilter" | "showMinMaxLabels" | "showTickMarks" | "size" | "source" | "styleName" | "title" | "titleLocation" | "tooltip" | "type" | "validates" | "value" | "visible" | "wrap" | string;
-    /** The value to assign to the property. */
     propertyValue: any;
-    /** Controls when strings are interpreted as markdown. */
     markdown?: boolean;
 }
 export declare class SetFormElementProperty implements IActivityHandler {

package/activities/forms/ShowFormElement.d.ts

@@ -3,9 +3,7 @@ import type { IActivityHandler, EmptyOutputs } from "../../IActivityHandler";
 import type * as defs from "../../forms/FormDefinition";
 export interface ShowFormElementInputs {
     form: DisplayFormOutputs;
-    /** The ID of the form element to show. */
     elementName?: string | defs.Element;
-    /** Whether to make the element visible. */
     visible?: boolean;
 }
 export declare class ShowFormElement implements IActivityHandler {

package/activities/image/GetImageMetadata.d.ts

@@ -5,8 +5,11 @@ export interface GetImageMetadataInputs {
 }
 /** Defines outputs from the GetImageMetadata activity. */
 export interface GetImageMetadataOutputs {
+    /** @description The latitude where the image was captured. */
     latitude?: number | string;
+    /** @description The longitude where the image was captured. */
     longitude?: number | string;
+    /** @description All of the metadata from the image. */
     metadata: object;
 }
 export declare class GetImageMetadata implements IActivityHandler {

package/activities/image/RotateImage.d.ts

@@ -6,6 +6,7 @@ export interface RotateImageInputs {
 }
 /** Defines outputs from the RotateImage activity. */
 export interface RotateImageOutputs {
+    /** @description The byte content of the rotated image. */
     result: number[];
 }
 export declare class RotateImage implements IActivityHandler {