@vertigis/workflow 5.42.0 → 5.44.0

package/activities/core/{Subworkflow.d.ts → Function.d.ts}

@@ -1,16 +1,16 @@
-import type { RunSubworkflowOutputs } from "./RunSubworkflow";
+import type { ExecuteFunctionOutputs } from "./ExecuteFunction";
 import type { IActivityContext, IActivityHandler } from "../../IActivityHandler";
-export interface SubworkflowInputs {
-    subworkflow: RunSubworkflowOutputs;
+export interface FunctionInputs {
+    subworkflow: ExecuteFunctionOutputs;
     argumentsType?: "any" | "{ addressCandidate: esri.AddressCandidate }" | "{ extent: esri.Extent }" | "{ featureSet: esri.FeatureSet }" | "{ geometry: esri.Geometry }" | "{ graphic: esri.Graphic }" | "{ id: number; name: string; location: esri.Point; }" | "{ layer: esri.Layer }" | "{ multiPoint: esri.Multipoint }" | "{ point: esri.Point }" | "{ polygon: esri.Polygon }" | "{ polyline: esri.Polyline }" | "{ portalGroup: esri.PortalGroup }" | "{ portalUser: esri.PortalUser }" | "{ spatialReference: esri.SpatialReference }" | "{ symbol: esri.Symbol }" | string;
     resultType?: "any" | "ArrayBuffer" | "boolean" | "Date" | "Error" | "Function" | "number" | "number[]" | "Object" | "string" | "string[]" | "esri.Graphic" | "esri.Extent" | "esri.Geometry" | "esri.Multipoint" | "esri.Point" | "esri.Polygon" | "esri.Polyline" | "esri.PortalGroup" | "esri.PortalUser" | "esri.SpatialReference" | "esri.Layer" | "esri.Symbol" | "esri.AddressCandidate" | "esri.FeatureSet" | "{ id: number; name: string; location: esri.Point; }" | string;
 }
-export interface SubworkflowOutputs {
+export interface FunctionOutputs {
     arguments?: Record<string, any>;
     setResult: (value: any) => void;
 }
-export declare class Subworkflow implements IActivityHandler {
+export declare class Function implements IActivityHandler {
     static readonly action = "gcx:wf:core::Subworkflow";
     static readonly suite = "gcx:wf:builtin";
-    execute(inputs: SubworkflowInputs, context: IActivityContext): SubworkflowOutputs;
+    execute(inputs: FunctionInputs, context: IActivityContext): FunctionOutputs;
 }

package/activities/core/Function.js

@@ -0,0 +1 @@
+class Function{execute(t,n){0===n.passes&&n.call("content");const e=t.subworkflow;return{arguments:e?.arguments,setResult:t=>{e&&(e.result=t)}}}}Function.action="gcx:wf:core::Subworkflow",Function.suite="gcx:wf:builtin";export{Function};

package/activities/core/GetWorkflowInputs.d.ts

@@ -8,5 +8,5 @@ export interface GetWorkflowInputsOutputs {
 export declare class GetWorkflowInputs implements IActivityHandler {
     static readonly action = "gcx:wf:core::GetWorkflowInputs";
     static readonly suite = "gcx:wf:builtin";
-    execute(inputs: EmptyInputs, context: IActivityContext): GetWorkflowInputsOutputs;
+    execute(_inputs: EmptyInputs, context: IActivityContext): GetWorkflowInputsOutputs;
 }

package/activities/core/Placeholder.d.ts

@@ -1,6 +1,6 @@
-import type { EmptyInputs, EmptyOutputs, IActivityHandler } from "../../IActivityHandler";
+import type { EmptyOutputs, IActivityHandler } from "../../IActivityHandler";
 export declare class Placeholder implements IActivityHandler {
     static readonly action = "gcx:wf:core::Placeholder";
     static readonly suite = "gcx:wf:builtin";
-    execute(inputs: EmptyInputs): EmptyOutputs;
+    execute(): EmptyOutputs;
 }

package/activities/core/Placeholder.js

@@ -1 +1 @@
-class Placeholder{execute(e){return{}}}Placeholder.action="gcx:wf:core::Placeholder",Placeholder.suite="gcx:wf:builtin";export{Placeholder};
+class Placeholder{execute(){return{}}}Placeholder.action="gcx:wf:core::Placeholder",Placeholder.suite="gcx:wf:builtin";export{Placeholder};

package/activities/core/TextReplace.d.ts

@@ -4,6 +4,7 @@ export interface TextReplaceInputs {
     text: string;
     oldValue: string;
     newValue: string;
+    ignoreCase?: boolean;
 }
 /** Defines outputs for the TextReplace activity. */
 export interface TextReplaceOutputs {

package/activities/core/TextReplace.js

@@ -1 +1 @@
-import{validation}from"../../Validation.js";class TextReplace{execute(e){const a=validation.string("text",e.text,validation.never),t=validation.string("oldValue",e.oldValue,validation.never);var l=validation.string("newValue",e.newValue,""),e=t.replace(/([.*+?^=!:${}()|\[\]\/\\])/g,"\\$1"),e=new RegExp(e,"g");return{result:a.replace(e,l)}}}TextReplace.action="gcx:wf:core::TextReplace",TextReplace.suite="gcx:wf:builtin";export{TextReplace};
+import{validation}from"../../Validation.js";class TextReplace{execute(e){const a=validation.string("text",e.text,validation.never),t=validation.string("oldValue",e.oldValue,validation.never);var i=validation.string("newValue",e.newValue,""),l=validation.boolean("ignoreCase",e.ignoreCase,!1),e=t.replace(/([.*+?^=!:${}()|\[\]\/\\])/g,"\\$1"),l=new RegExp(e,"g"+(l?"i":""));return{result:a.replace(l,i)}}}TextReplace.action="gcx:wf:core::TextReplace",TextReplace.suite="gcx:wf:builtin";export{TextReplace};

package/activities/core/TryCatch.d.ts

@@ -8,5 +8,5 @@ export interface TryCatchOutputs {
 export declare class TryCatch implements IActivityHandler {
     static readonly action = "gcx:wf:core::TryCatch";
     static readonly suite = "gcx:wf:builtin";
-    execute(inputs: EmptyInputs, context: IActivityContext): TryCatchOutputs;
+    execute(_inputs: EmptyInputs, context: IActivityContext): TryCatchOutputs;
 }

package/activities/core/WebRequest.d.ts

@@ -48,5 +48,5 @@ export interface WebRequestOutputs {
 export declare class WebRequest implements IActivityHandler {
     static readonly action = "gcx:wf:core:request:WebRequest";
     static readonly suite = "gcx:wf:builtin";
-    execute(inputs: WebRequestInputs, context: IActivityContext, type: typeof ChannelProvider): Promise<WebRequestOutputs>;
+    execute(inputs: WebRequestInputs, context: IActivityContext, ChannelProviderType: typeof ChannelProvider): Promise<WebRequestOutputs>;
 }

package/activities/essentials/GetEssentialsSite.d.ts

@@ -221,5 +221,5 @@ export interface GetEssentialsSiteOutputs {
 export declare class GetEssentialsSite implements IActivityHandler {
     static readonly action = "gcx:wf:essentials::GetEssentialsSite";
     static readonly suite = "gcx:wf:builtin";
-    execute(inputs: EmptyInputs, context: IActivityContext): GetEssentialsSiteOutputs;
+    execute(_inputs: EmptyInputs, context: IActivityContext): GetEssentialsSiteOutputs;
 }

package/activities/essentials/RunEssentialsWorkflow.d.ts

@@ -17,7 +17,7 @@ export interface RunEssentialsWorkflowOutputs {
 export declare class RunEssentialsWorkflow implements IActivityHandler {
     static readonly action = "gcx:wf:essentials::RunEssentialsWorkflow";
     static readonly suite = "gcx:wf:builtin";
-    execute(inputs: RunEssentialsWorkflowInputs, context: IActivityContext, type: typeof ChannelProvider): Promise<RunEssentialsWorkflowOutputs>;
+    execute(inputs: RunEssentialsWorkflowInputs, context: IActivityContext, ChannelProviderType: typeof ChannelProvider): Promise<RunEssentialsWorkflowOutputs>;
     private isString;
     private getWorkflowSchema;
     private validateInputs;

package/activities/forms/AddFormElement.d.ts

@@ -1,5 +1,5 @@
 import type { DisplayFormOutputs } from "./DisplayForm";
-import type { IActivityHandler, IActivityContext, EmptyOutputs } from "../../IActivityHandler";
+import type { IActivityHandler, EmptyOutputs } from "../../IActivityHandler";
 import type * as defs from "../../forms/FormDefinition";
 export interface AddFormElementInputs {
     form: DisplayFormOutputs;
@@ -10,9 +10,11 @@ export interface AddFormElementInputs {
     /** The definition of the form element to add. */
     element: defs.Element;
     targetForm?: DisplayFormOutputs;
+    targetElement?: string | defs.Element;
+    targetPosition?: "above" | "below" | "before" | "after" | string;
 }
 export declare class AddFormElement implements IActivityHandler {
     static readonly action = "gcx:wf:forms::AddFormElement";
     static readonly suite = "gcx:wf:builtin";
-    execute(inputs: AddFormElementInputs, context: IActivityContext): EmptyOutputs;
+    execute(inputs: AddFormElementInputs): EmptyOutputs;
 }

package/activities/forms/AddFormElement.js

@@ -1 +1 @@
-import{validation}from"../../Validation.js";import{setFormForElement}from"./FormElementMap.js";class AddFormElement{execute(e,t){var{elementName:n,elementType:r,element:m,targetForm:o}=e;let a=e["form"];if(a=o||a,validation.exists("form",a),validation.string("elementName",n,validation.never),validation.string("elementType",r,validation.never),"Header"===r)throw new Error("A form cannot contain more than one header element.");m=a.actor.addElement(n,r,m);return setFormForElement(m,a),{}}}AddFormElement.action="gcx:wf:forms::AddFormElement",AddFormElement.suite="gcx:wf:builtin";export{AddFormElement};
+import{validation}from"../../Validation.js";import{setFormForElement}from"./FormElementMap.js";class AddFormElement{execute(e){var{elementName:t,elementType:o,element:r,targetForm:n,targetPosition:a}=e;let{form:m,targetElement:i}=e;if(m=n||m,validation.exists("form",m),validation.string("elementName",t,validation.never),validation.string("elementType",o,validation.never),"Header"===o)throw new Error("A form cannot contain more than one header element.");i=m.actor.getElementName(i,m.event);let l;switch(a){case"above":case"below":case"before":case"after":l=a}n=l&&i?{relativePosition:l,targetElementName:i}:void 0,n=m.actor.addElement(t,o,r,n);return setFormForElement(n,m),{}}}AddFormElement.action="gcx:wf:forms::AddFormElement",AddFormElement.suite="gcx:wf:builtin";export{AddFormElement};

package/activities/forms/DisplayForm.d.ts

@@ -33,9 +33,9 @@ export declare class DisplayForm implements IActivityHandler {
      * Creates a form renderer if it does not exist.
      * @param inputs The inputs to create the renderer.
      * @param context The context to use to create the renderer.
-     * @param type The type of FormRenderer (subclass) to create.
+     * @param FormRendererType The type of FormRenderer (subclass) to create.
      */
-    static createRenderer(inputs: DisplayFormInputs, context: IActivityContext, type: typeof FormRenderer): FormRenderer;
+    static createRenderer(inputs: DisplayFormInputs, context: IActivityContext, FormRendererType: typeof FormRenderer): FormRenderer;
     static readonly action = "gcx:wf:forms:form:DisplayForm";
     static readonly suite = "gcx:wf:builtin";
     /** Performs the operation on behalf of the engine. */

package/activities/forms/FormActor.d.ts

@@ -0,0 +1,56 @@
+import { defs } from "../../forms/FormHost";
+import type { FormElementRegistration } from "../../forms/index";
+export { defs };
+/**
+ * Describes the position of something relative to something else.
+ * We use "before" and "after" instead of "left" and "right" to still make sense
+ * in a right-to-left environment.
+ */
+export type RelativePosition = "above" | "below" | "before" | "after";
+/**
+ * Details of where to position an element when adding it to the form.
+ */
+export interface ElementPosition {
+    /** The direction we move from the target element to determine the new position. */
+    relativePosition: RelativePosition;
+    /** The name of the element to use as a starting position. */
+    targetElementName: string;
+}
+/** Defines what the renderer exposes. */
+export default interface FormActor {
+    /** Returns the element with the given name. If the element does not exist an error will be thrown. */
+    getElement(element: string | defs.Element | undefined, event?: defs.Event): defs.Element;
+    getElementRegistration(element: defs.Element): FormElementRegistration | undefined;
+    /** Returns the name of the given element. If the element does not exist an error will be thrown. */
+    getElementName(element: defs.Element | string | undefined, event?: defs.Event): string;
+    /** Sets element visibility to false. */
+    hideElement(element: defs.Element): void;
+    /** Sets element visibility to true. */
+    showElement(element: defs.Element): void;
+    /** Assigns an error message to an element. */
+    setElementError(elementName: string, error: string | undefined, markdown?: boolean): void;
+    /** Finds the specified item and sets it as the current one. Returns true if a match was found, false otherwise. */
+    setCurrentItem(elementName: string, value: defs.Value | defs.Text | defs.Item, matchType: defs.ItemMatchType): boolean;
+    /**
+     * Assigns a property to an element, or overwrites an existing property.
+     * @param elementName The name of the element to be updated.
+     * @param propertyName The name of the property of the element to be updated.
+     * @param propertyValue The new value for the element's property.
+     * @param markdown (optional) True if the value should be treated as markdown, false otherwise. The default value is false.
+     * @param event (optional) Only relevant when `propertyName` is `"value"`. If a boolean value, indicates whether or not to post a "changed" event. If a `Partial<defs.Element>` specifies some of the properties of the event to be posted. Any `name` and `value` provided here are ignored. The default value is true.
+     */
+    assignElementProperty(elementName: string, propertyName: string, propertyValue: any, markdown?: boolean, event?: Partial<defs.Event> | boolean): void;
+    /** Assigns an items property to an element. */
+    assignItemsToElement(elementName: string, items: Record<string, defs.Item>, reset?: boolean): void;
+    /** Assigns a property to an element item, or overwrites an existing property. */
+    assignElementItemProperty(elementName: string, itemKey: string, propertyName: string, propertyValue: any, markdown?: boolean): void;
+    /** Filters the items of an element based on heuristics. */
+    filterItems(elementName: string, phrase: string): boolean;
+    /**
+     * Adds the supplied element to the form.
+     * @param elementName The unique name for the element.
+     * @param type The type of element to add.
+     * @param element The contents of the element to add.
+     */
+    addElement(elementName: string, type: string, element: defs.Element, elementPosition?: ElementPosition): defs.Element;
+}

package/activities/forms/FormActor.js

@@ -0,0 +1 @@
+import{defs}from"../../forms/FormHost.js";export{defs};

package/activities/forms/FormRenderer.d.ts

@@ -1,45 +1,9 @@
 import { FormHost, defs } from "../../forms/FormHost";
+import type { ElementPosition } from "./FormActor";
+import type FormActor from "./FormActor";
 import type { Activator } from "../../Activator";
 import type { FormElementRegistration } from "../../forms/index";
 export { defs };
-/** Defines what the renderer exposes. */
-export interface FormActor {
-    /** Returns the element with the given name. If the element does not exist an error will be thrown. */
-    getElement(element: string | defs.Element | undefined, event?: defs.Event): defs.Element;
-    getElementRegistration(element: defs.Element): FormElementRegistration | undefined;
-    /** Returns the name of the given element. If the element does not exist an error will be thrown. */
-    getElementName(element: defs.Element | string | undefined, event?: defs.Event): string;
-    /** Sets element visibility to false. */
-    hideElement(element: defs.Element): void;
-    /** Sets element visibility to true. */
-    showElement(element: defs.Element): void;
-    /** Assigns an error message to an element. */
-    setElementError(elementName: string, error: string | undefined, markdown?: boolean): void;
-    /** Finds the specified item and sets it as the current one. Returns true if a match was found, false otherwise. */
-    setCurrentItem(elementName: string, value: defs.Value | defs.Text | defs.Item, matchType: defs.ItemMatchType): boolean;
-    /**
-     * Assigns a property to an element, or overwrites an existing property.
-     * @param elementName The name of the element to be updated.
-     * @param propertyName The name of the property of the element to be updated.
-     * @param propertyValue The new value for the element's property.
-     * @param markdown (optional) True if the value should be treated as markdown, false otherwise. The default value is false.
-     * @param event (optional) Only relevant when `propertyName` is `"value"`. If a boolean value, indicates whether or not to post a "changed" event. If a `Partial<defs.Element>` specifies some of the properties of the event to be posted. Any `name` and `value` provided here are ignored. The default value is true.
-     */
-    assignElementProperty(elementName: string, propertyName: string, propertyValue: any, markdown?: boolean, event?: Partial<defs.Event> | boolean): void;
-    /** Assigns an items property to an element. */
-    assignItemsToElement(elementName: string, items: Record<string, defs.Item>, reset?: boolean): void;
-    /** Assigns a property to an element item, or overwrites an existing property. */
-    assignElementItemProperty(elementName: string, itemKey: string, propertyName: string, propertyValue: any, markdown?: boolean): void;
-    /** Filters the items of an element based on heuristics. */
-    filterItems(elementName: string, phrase: string): boolean;
-    /**
-     * Adds the supplied element to the form.
-     * @param elementName The unique name for the element.
-     * @param type The type of element to add.
-     * @param element The contents of the element to add.
-     */
-    addElement(elementName: string, type: string, element: defs.Element): defs.Element;
-}
 /**
  * Renders a form on behalf of the DisplayForm activity.
  * @public
@@ -52,7 +16,7 @@ export declare class FormRenderer extends FormHost implements FormActor {
     static createCustom(): FormRenderer;
     /** Register this renderer class as the form renderer. */
     static register(activator: Activator): void;
-    addElement(elementName: string, type: string, element: defs.Element): defs.Element;
+    addElement(elementName: string, type: string, element: defs.Element, elementPosition?: ElementPosition): defs.Element;
     assignElementProperty(elementName: string, propertyName: string, propertyValue: any, markdown?: boolean, event?: Partial<defs.Event> | boolean): void;
     assignElementItemProperty(elementName: string, itemKey: string, propertyName: string, propertyValue: any, markdown?: boolean): void;
     assignItemsToElement(elementName: string, items: Record<string, defs.Item>, reset?: boolean): void;
@@ -126,8 +90,6 @@ export declare class FormRenderer extends FormHost implements FormActor {
     load(): boolean;
     /** Loads the form with a new definition. */
     load(form: defs.Form, template?: defs.Form): boolean;
-    /** Renders form text as HTML. */
-    renderHtml(content: defs.Text, htmlContentCategory?: defs.HTMLContentCategory): string;
     /** Renders form text as plain text. */
     renderText(content: defs.Text | undefined): string;
     setCurrentItem(elementName: string, searchValue: defs.Value | defs.Text | defs.Item, itemMatchType: defs.ItemMatchType): boolean;
@@ -135,5 +97,7 @@ export declare class FormRenderer extends FormHost implements FormActor {
     showElement(element: defs.Element): void;
     /** Used to request that the form spins without blocking the application. */
     spinNoBlock(): boolean;
-    translateText(content: defs.Text): string | defs.MarkdownRef | undefined;
+    translateText(content: string | defs.StatusRef | undefined): string | undefined;
+    translateText(content: defs.MarkdownRef | undefined): defs.MarkdownRef | undefined;
+    translateText(content: defs.Text | undefined): string | defs.MarkdownRef | undefined;
 }

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,t,r){if(this.form.elements.hasOwnProperty(e))throw new Error(`Element already present: ${e}`);const s={};if("object"==typeof r)for(const n in r)s[n]=r[n];s.type=t;t=s.section;if(t){let e;if("object"==typeof t?e=t.name:"string"==typeof t&&(e=t),"header"===e||"footer"===e)throw new Error("Elements cannot be added to the header or footer.")}return this.form.elements[e]=s,this.invalidate(),s}assignElementProperty(t,r,s,e=!1,n=!0){e&&(s=toMarkdownRef(r,s));const o=this.getElement(t);if(o[r]!==s){const i={},a=this.getElementRegistration(o);if(a?.onPropertyChange)try{const m=(e,t)=>{i[e]!==t&&(i[e]=t,a.onPropertyChange({properties:{...o,...i},property:e,setProperty:m}))};m(r,s)}catch(e){throw console.error(`Error setting element property.\nElement: "${t}"\nProperty: "${r}"\nValue: ${s}\n`,e),e}else i[r]=s;for(const l of Object.keys(i))o[l]=i[l];a&&"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,s,n){const o=this.getElement(e),i=o.items||{};if(i[t][r]=n?toMarkdownRef(r,s):s,"checked"===r&&[FormElementTypes.CHECKGROUP,FormElementTypes.ITEMPICKER,FormElementTypes.LISTBOX].includes(o.type)){const m=[];for(const t in i){var a=i[t];a.checked&&m.push(a)}o.value=0===m.length?void 0:{refValueType:"items",items:m}}this.refresh(e)}assignItemsToElement(e,t,r){const s=this.getElement(e);let n=s.items||{};!1!==r&&(n={});for(const o in t)n[o]=t[o];s.items=n,s.type!==FormElementTypes.GEOMETRYPICKER&&s.type!==FormElementTypes.ITEMPICKER||delete s.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 s=r.items;if(null==s)return!1;if("string"!=typeof t)return t;let n=!1;const o={};var i=t.toLowerCase().split(/\s+/);for(const l in s){var a=s[l];const f=this.renderText(a.label);var m=f.toLowerCase().split(/\s+/);for(const c of i)if(0<c.length)for(const h of m)0<h.length&&0===h.indexOf(c)&&(n=!0,o[l]=a)}return r.items=o,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&&this.state.trivia&&this.state.trivia.isDescendantOf&&this.state.trivia.isDescendantOf(e.state)}load(e,t){t=super.load(e,t);if(t&&this.form?.elements)for(const s in this.form.elements){var r=this.form.elements[s];const n=this.getElementRegistration(r);n&&n.getInitialProperties&&(r={...r,...n.getInitialProperties()},this.form.elements[s]=r)}return t}renderHtml(e,t){return super.renderHtml(this.getText(e),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 s;switch(r){case"index":s=(e,t,r)=>{var s=Object.keys(n.items);return 0<s.length&&e===s[r]};break;case"item":s=(e,t,r)=>r===t;break;case"key":s=(e,t,r)=>r===e;break;case"label":s=(e,t,r)=>getContent(r)===getContent(t.label);break;case"value":s=(e,t,r)=>r===t.value;break;default:throw new Error("Unsupported value for itemMatchType: "+r)}for(const o in n.items)if(s(o,n.items[o],t))return n.current=o,[FormElementTypes.AUTOCOMPLETE,FormElementTypes.DROPDOWNLIST,FormElementTypes.RADIOGROUP].includes(n.type)&&(n.label=n.items[o].label,n.value=n.items[o].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.hasOwnProperty(e))throw new Error(`Element already present: ${e}`);const s={};if("object"==typeof t)for(const p in t)s[p]=t[p];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.hasOwnProperty(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,4 +1,4 @@
-import type { IActivityHandler, IActivityContext } from "../../IActivityHandler";
+import type { IActivityHandler } from "../../IActivityHandler";
 import type { Item } from "../../forms/FormDefinition";
 export interface GetFormElementItemsFromCollectionInputs {
     /** The collection to be converted to the items collection. */
@@ -45,5 +45,5 @@ export declare class GetFormElementItemsFromCollection implements IActivityHandl
      * Instead, we check every prototype.
      */
     private getPropertyNames;
-    execute(inputs: GetFormElementItemsFromCollectionInputs, context: IActivityContext): GetFormElementItemsFromCollectionOutputs;
+    execute(inputs: GetFormElementItemsFromCollectionInputs): GetFormElementItemsFromCollectionOutputs;
 }

package/activities/forms/GetFormElementItemsFromCollection.js

@@ -1 +1 @@
-import*as TemplateUtils from"../../TemplateUtils.js";import{validation}from"../../Validation.js";import{text}from"../../forms/utils.js";class GetFormElementItemsFromCollection{_isLabelFieldName(e,t){return null!=e&&0!==t.length&&e===this._getPropertyName(e,t)}_getPropertyName(e,t){return t.includes(e)?e:void 0}_getPropertyValue(e,t,l){t=this._getPropertyName(e,t);return t?TemplateUtils.valueOrEmptyString(l[t]):void 0}_getTokenValues(e,t,l){const o={};for(const i of e){var r,a=i.token;o.hasOwnProperty(a)||(r=this._getPropertyValue(a,t,l),r=TemplateUtils.getTokenValueString(a,r),o[a]=text.escapeTextForMarkdown(r))}return o}getPropertyNames(e){const t=[];if(!e)return t;for(const l in e)"function"!=typeof e[l]&&t.push(l);return t}execute(l,e){var o=l.labelFieldName||void 0,r=validation.array("collection",l.collection,validation.never);const a={};var i=0<r.length?this.getPropertyNames(r[0]):[],n=this._isLabelFieldName(o,i),s=n?[]:TemplateUtils.findTokenInstances(o);for(let t=0;t<r.length;++t){var m,c=r[t];let e;e=n?c[l.labelFieldName]:o?(m=this._getTokenValues(s,i,c),TemplateUtils.replacePlaceholders(o,s,m)):c,void 0!==e&&null!==e||(e="");const u={};l.valueFieldName?u.value=c[l.valueFieldName]:u.value={refValueType:"data",type:"object",data:c},text.isMarkdown(e)?u.label=e:u.label=e.toString(),a[t]=u}return{items:a}}}GetFormElementItemsFromCollection.action="gcx:wf:forms::GetFormElementItemsFromCollection",GetFormElementItemsFromCollection.suite="gcx:wf:builtin";export{GetFormElementItemsFromCollection};
+import*as TemplateUtils from"../../TemplateUtils.js";import{validation}from"../../Validation.js";import{text}from"../../forms/utils.js";class GetFormElementItemsFromCollection{_isLabelFieldName(e,t){return null!=e&&0!==t.length&&e===this._getPropertyName(e,t)}_getPropertyName(e,t){return t.includes(e)?e:void 0}_getPropertyValue(e,t,l){t=this._getPropertyName(e,t);return t?TemplateUtils.valueOrEmptyString(l[t]):void 0}_getTokenValues(e,t,l){const o={};for(const i of e){var r,a=i.token;o.hasOwnProperty(a)||(r=this._getPropertyValue(a,t,l),r=TemplateUtils.getTokenValueString(a,r),o[a]=text.escapeTextForMarkdown(r))}return o}getPropertyNames(e){const t=[];if(!e)return t;for(const l in e)"function"!=typeof e[l]&&t.push(l);return t}execute(l){var o=l.labelFieldName||void 0,r=validation.array("collection",l.collection,validation.never);const a={};var i=0<r.length?this.getPropertyNames(r[0]):[],n=this._isLabelFieldName(o,i),s=n?[]:TemplateUtils.findTokenInstances(o);for(let t=0;t<r.length;++t){var m,c=r[t];let e;e=n?c[l.labelFieldName]:o?(m=this._getTokenValues(s,i,c),TemplateUtils.replacePlaceholders(o,s,m)):c,void 0!==e&&null!==e||(e="");const u={};l.valueFieldName?u.value=c[l.valueFieldName]:u.value={refValueType:"data",type:"object",data:c},text.isMarkdown(e)?u.label=e:u.label=e.toString(),a[t]=u}return{items:a}}}GetFormElementItemsFromCollection.action="gcx:wf:forms::GetFormElementItemsFromCollection",GetFormElementItemsFromCollection.suite="gcx:wf:builtin";export{GetFormElementItemsFromCollection};

package/activities/forms/GetFormElementProperty.d.ts

@@ -1,5 +1,5 @@
 import type { DisplayFormOutputs } from "./DisplayForm";
-import type { IActivityHandler, IActivityContext } from "../../IActivityHandler";
+import type { IActivityHandler } from "../../IActivityHandler";
 import type * as defs from "../../forms/FormDefinition";
 export interface GetFormElementPropertyInputs {
     form: DisplayFormOutputs;
@@ -15,5 +15,5 @@ export interface GetFormElementPropertyOutputs {
 export declare class GetFormElementProperty implements IActivityHandler {
     static readonly action = "gcx:wf:forms::GetFormElementProperty";
     static readonly suite = "gcx:wf:builtin";
-    execute(inputs: GetFormElementPropertyInputs, context: IActivityContext): GetFormElementPropertyOutputs;
+    execute(inputs: GetFormElementPropertyInputs): GetFormElementPropertyOutputs;
 }

package/activities/forms/GetFormElementProperty.js

@@ -1 +1 @@
-import{validation}from"../../Validation.js";import{getFormForElement}from"./FormElementMap.js";class GetFormElementProperty{execute(e,t){var{elementName:r,name:o}=e;let m=e["form"];return"object"==typeof r&&(m=getFormForElement(r)),validation.exists("form",m),{value:m.actor.getElement(r,m.event)[o]}}}GetFormElementProperty.action="gcx:wf:forms::GetFormElementProperty",GetFormElementProperty.suite="gcx:wf:builtin";export{GetFormElementProperty};
+import{validation}from"../../Validation.js";import{getFormForElement}from"./FormElementMap.js";class GetFormElementProperty{execute(e){var{elementName:t,name:r}=e;let o=e["form"];return"object"==typeof t&&(o=getFormForElement(t)),validation.exists("form",o),{value:o.actor.getElement(t,o.event)[r]}}}GetFormElementProperty.action="gcx:wf:forms::GetFormElementProperty",GetFormElementProperty.suite="gcx:wf:builtin";export{GetFormElementProperty};

package/activities/forms/GetFormElementValue.d.ts

@@ -1,5 +1,5 @@
 import type { DisplayFormOutputs } from "./DisplayForm";
-import type { IActivityHandler, IActivityContext } from "../../IActivityHandler";
+import type { IActivityHandler } from "../../IActivityHandler";
 import type * as defs from "../../forms/FormDefinition";
 export interface GetFormElementValueInputs {
     form: DisplayFormOutputs;
@@ -13,5 +13,5 @@ export interface GetFormElementValueOutputs {
 export declare class GetFormElementValue implements IActivityHandler {
     static readonly action = "gcx:wf:forms::GetFormElementValue";
     static readonly suite = "gcx:wf:builtin";
-    execute(inputs: GetFormElementValueInputs, context: IActivityContext): GetFormElementValueOutputs;
+    execute(inputs: GetFormElementValueInputs): GetFormElementValueOutputs;
 }

package/activities/forms/GetFormElementValue.js

@@ -1 +1 @@
-import{validation}from"../../Validation.js";import{isDataRef,isDateRangeRef,isDateTimeRef,isFilesRef,isGeometryRef,isItemsRef,isNumberRef,isScanRef}from"../../forms/utils.js";import{getFormForElement}from"./FormElementMap.js";class GetFormElementValue{execute(e,t){var m=e["elementName"];let a=e["form"];"object"==typeof m&&(a=getFormForElement(m)),validation.exists("form",a);let i=a.actor.getElement(m,a.event).value;return isDataRef(i)?i=i.data:isDateRangeRef(i)?i=[i.startDate,i.endDate]:isDateTimeRef(i)?i=i.value:isFilesRef(i)?i=i.files:isGeometryRef(i)?i=i.geometry:isItemsRef(i)?i=i.items:isNumberRef(i)?i=i.numeric:isScanRef(i)&&(i=i.value),{value:i}}}GetFormElementValue.action="gcx:wf:forms::GetFormElementValue",GetFormElementValue.suite="gcx:wf:builtin";export{GetFormElementValue};
+import{validation}from"../../Validation.js";import{isDataRef,isDateRangeRef,isDateTimeRef,isFilesRef,isGeometryRef,isItemsRef,isNumberRef,isScanRef}from"../../forms/utils.js";import{getFormForElement}from"./FormElementMap.js";class GetFormElementValue{execute(e){var t=e["elementName"];let m=e["form"];"object"==typeof t&&(m=getFormForElement(t)),validation.exists("form",m);let a=m.actor.getElement(t,m.event).value;return isDataRef(a)?a=a.data:isDateRangeRef(a)?a=[a.startDate,a.endDate]:isDateTimeRef(a)?a=a.value:isFilesRef(a)?a=a.files:isGeometryRef(a)?a=a.geometry:isItemsRef(a)?a=a.items:isNumberRef(a)?a=a.numeric:isScanRef(a)&&(a=a.value),{value:a}}}GetFormElementValue.action="gcx:wf:forms::GetFormElementValue",GetFormElementValue.suite="gcx:wf:builtin";export{GetFormElementValue};

package/activities/forms/SetFormElementEvent.d.ts

@@ -8,7 +8,7 @@ export interface SetFormElementEventInputs {
     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, Subworkflow, or Try Catch. */
+    /** 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 {