@vertigis/workflow 5.37.1 → 5.38.1

package/execution/ActivityContext.d.ts

@@ -0,0 +1,92 @@
+import Bluebird from "bluebird";
+import type ActivityContextProxy from "./ActivityContextProxy";
+import type AmbientState from "./AmbientState";
+import type { IActivityState } from "./IDebugSession";
+import type MonikerFrame from "./MonikerFrame";
+import type { IActivityContext, IActivityHandler } from "../IActivityHandler";
+import type { Task } from "../Task";
+import type { Activity } from "../definition/Activity";
+interface ExpressionEvaluator {
+    (resources: any, values: any): any;
+}
+type Recent = {
+    context: ActivityContext;
+};
+/**
+ * USE TRY-CATCH CAREFULLY
+ *
+ * There is a difference between an error with the workflow and an error with
+ * the environment and/or engine. We don't want to conflate the two. So to that
+ * end, whenever we invoke something else outside of the engine, we should try
+ * to isolate that code. Bludbird's Promise.attempt feature does this very nicely.
+ *
+ * CAPTURING ERRORS
+ *
+ * Here we are using a Promise<Error[]> to capture the errors during activity
+ * execution. Many things can contribute an error: accessors, inputs, handler
+ * creation, and activation problems. The promise is never meant to become
+ * rejected itself as this would indicate a problem with the actual engine
+ * rather than a problem with executing the workflow. This distinction is
+ * extremely important in terms of issue routing.
+ */
+declare abstract class ActivityContext implements IActivityState, IActivityContext {
+    id: any;
+    luid: any;
+    action: string;
+    activity: Activity;
+    ambient: AmbientState;
+    frame: MonikerFrame;
+    proxy: ActivityContextProxy;
+    caught?: Error;
+    passes: number;
+    recent?: Recent;
+    repeat?: boolean;
+    state: any;
+    branch?: boolean | number | string;
+    callBranch?: boolean;
+    forkBranch?: boolean;
+    jumpBranch?: boolean | number | string;
+    registeredForErrors?: boolean;
+    stateToPersist: any;
+    inputs: Record<string, any>;
+    outputs: Record<string, any>;
+    extras: any[];
+    monikers: string[];
+    handler?: Bluebird<IActivityHandler | undefined>;
+    evaluators: Record<string, ExpressionEvaluator>;
+    scope: Record<string, any>;
+    cancellationToken: Task<void>;
+    cancellationResolve: () => void;
+    promise: Bluebird<Error[]> | undefined;
+    private static filterErrors;
+    private static isError;
+    private static isInvalidHandler;
+    private static reduceErrors;
+    registerForErrors(): void;
+    persist(state: any): void;
+    call(branch: any): void;
+    fork(branch: any): void;
+    jump(branch: any): void;
+    hasBranch(branch: any): boolean;
+    private emitExpressionEvaluationError;
+    private emitExpressionSyntaxError;
+    private emitExpressionAccessorError;
+    private emitActivityBindingError;
+    private emitActivityActivationError;
+    private emitActivityError;
+    private executeHandlerInline;
+    private resolveExtrasInline;
+    private resolveInputsInline;
+    private resolveHandlerInline;
+    private findContext;
+    private resolveOutputsInline;
+    private resolveAccessorInline;
+    private resolveAssetsInline;
+    private concludeInline;
+    protected generateMonikers(): void;
+    protected marshalError(): Error | undefined;
+    protected abstract transferInline(): void;
+    execute(): Bluebird<Error[]> | Bluebird<undefined>;
+    goto(): void;
+}
+export {};

package/execution/ActivityContext.js

@@ -0,0 +1 @@
+import Bluebird from"bluebird";import{ExpressionEvaluationError,ExpressionSyntaxError,ExpressionAccessorError,ActivityBindingError,ActivityActivationError,ActivityError,GenericActivityError,AggregateActivityError}from"../Errors.js";import{query}from"../Hooks.js";import{isAccessor,isExpression,isLiteral}from"./util.js";const echoHandler={execute:t=>t};let evaluators={};function compileExpression(t,i){var e=t.code;let r=evaluators[e];if(void 0===r){const n=[],o={};n.push('"use strict"; ');var s=t.accessors;if(Array.isArray(s))for(const c of s)isAccessor(c)&&!o[c]&&(n.push(`var ${c} = this.${c};`),o[c]=!0);n.push("return "),n.push(e),n.push(";"),r=evaluators[e]=new Function("resources","values",n.join(""))}return function(){return r.call(this,i,t.values)}}class PromiseWrapper{}class ActivityContext{constructor(){this.action="",this.activity={},this.ambient={},this.frame={},this.proxy={},this.passes=0,this.inputs={},this.outputs={},this.extras=[],this.monikers=[],this.evaluators={},this.scope={},this.cancellationToken={},this.cancellationResolve=()=>{}}static filterErrors(t){return t.filter(ActivityContext.isError)}static isError(t){return void 0!==t}static isInvalidHandler(t){return null==t||"function"!=typeof t.execute}static reduceErrors(t){return t.isPending()?t.then(ActivityContext.filterErrors):t.isFulfilled()?Bluebird.resolve(ActivityContext.filterErrors(t.value())):t}registerForErrors(){this.registeredForErrors=!0}persist(t){this.stateToPersist=t}call(t){this.callBranch=!0,this.forkBranch=!1,this.jumpBranch=t}fork(t){this.callBranch=!1,this.forkBranch=!0,this.jumpBranch=t}jump(t){this.callBranch=!1,this.forkBranch=!1,this.jumpBranch=t}hasBranch(t){var i=this.activity;const e=this.ambient.inspector;return e.isStep(i)&&void 0!==e.relate(i,t).peek()}emitExpressionEvaluationError(t,i){var e=this.activity.id,r=this.activity.inputs[t];return new ExpressionEvaluationError(e,t,r.source||r.code,i)}emitExpressionSyntaxError(t,i){var e=this.activity.id,r=this.activity.inputs[t];return new ExpressionSyntaxError(e,t,r.source||r.code,i)}emitExpressionAccessorError(t,i,e){return new ExpressionAccessorError(this.activity.id,t,i,e)}emitActivityBindingError(t){var i=this.activity;return new ActivityBindingError(i.id,i.action,t)}emitActivityActivationError(t,i){return new ActivityActivationError(this.activity.id,t,i)}emitActivityError(t){if(t instanceof ActivityError)return t;var i=this.activity;const e=new GenericActivityError(void 0,t?.message);return e.activityId=i.id,e.error=t,e}executeHandlerInline(i){if(0<i.length||this.cancellationToken.isFulfilled())return i;const e=this.extras;for(let t=0;t<e.length;t++)e[t]=Bluebird.resolve(e[t]).value();const r=this.inputs;for(const o in r){let t=Bluebird.resolve(r[o]).value();t instanceof PromiseWrapper&&(t=t.result),r[o]=t}const t=this.proxy,s=this.handler.value(),n=Bluebird.attempt(function(){return s.execute(r,t,...e)});return n.isPending()?n.then(t=>(this.outputs=t,i),t=>[this.emitActivityError(t)]):n.isRejected()?[this.emitActivityError(n.reason())]:(this.outputs=n.value(),i)}resolveExtrasInline(){for(const i of query(this.handler.value())){const t=this.ambient.engine.activator,e=t.activate(i);if(this.extras.push(e),e.isPending())return e.then(t=>{},t=>this.emitActivityActivationError(i.type,t));if(e.isRejected())return this.emitActivityActivationError(i.type,e.reason())}}resolveInputsInline(t){if(0<t.length||this.cancellationToken.isFulfilled())return t;const i=[];i.push(this.resolveExtrasInline());const e=this.evaluators;if(void 0!==e){const r=this.scope;for(const n in r)r[n]=Bluebird.resolve(r[n]).value();const s=this.inputs;for(const o in e){const c=s[o]=Bluebird.attempt(function(){var t=e[o].call(r,void 0,void 0);if(t&&"function"==typeof t.then){const i=new PromiseWrapper;return i.result=t,i}return t});c.isPending()&&i.push(c.then(t=>{},t=>this.emitExpressionEvaluationError(o,t))),c.isRejected()&&i.push(this.emitExpressionEvaluationError(o,c.reason()))}}return ActivityContext.reduceErrors(Bluebird.all(i))}resolveHandlerInline(){const i=this.activity.action;if("string"==typeof i){var e=this.ambient;const r=e.handlers;let t=this.handler=r[i];if(void 0===t){const s=e.engine,n=e.inspector;t=this.handler=r[i]=Bluebird.attempt(function(){return s.createHandler(i,n)})}return t.isPending()?t.then(t=>ActivityContext.isInvalidHandler(t)?this.emitActivityBindingError():void 0,t=>this.emitActivityBindingError(t)):t.isRejected()?this.emitActivityBindingError(t.reason()):ActivityContext.isInvalidHandler(t.value())?this.emitActivityBindingError():void 0}this.handler=Bluebird.resolve(echoHandler)}findContext(t){var i=this.ambient,e=i.stack;let r=i.frame;for(;void 0!==r;){var s=r.state[t];if(void 0!==s)return s;r=e[r.index-1]}}resolveOutputsInline(){const t=this.promise;if(t.isPending())return t.then(t=>void 0!==t&&0<t.length?Bluebird.reject(t):this.outputs,t=>{});if(t.isRejected())return Bluebird.resolve(void 0);var i=t.value();return void 0!==i&&0<i.length?Bluebird.reject(i):Bluebird.resolve(this.outputs)}resolveAccessorInline(i){const t=this.findContext(i);if(void 0!==t){const e=this.scope[i]=t.resolveOutputsInline();return e.isPending()?e.then(t=>{},t=>this.emitExpressionAccessorError(i,void 0,t)):e.isRejected()?this.emitExpressionAccessorError(i,void 0,e.reason()):void 0}const e=this.scope[i]=Bluebird.resolve(this.ambient.environment[i]);return e.isPending()?e.then(t=>{},t=>this.emitExpressionAccessorError(i,t)):e.isRejected()?this.emitExpressionAccessorError(i,e.reason()):void 0}resolveAssetsInline(){const e=[];e.push(this.resolveHandlerInline());var r=this.activity.inputs;if(null!=r){let t,i;const n=this.ambient;for(const o in r){const c=r[o];if(void 0!==c&&null!==c)if(isLiteral(c))this.inputs[o]=Bluebird.resolve(c);else if(isExpression(c)){void 0===t&&(this.scope=t={}),void 0===i&&(this.evaluators=i={});var s=c.accessors;if(Array.isArray(s))for(const l of s)"string"==typeof l&&void 0===t[l]&&e.push(this.resolveAccessorInline(l));const a=Bluebird.attempt(function(){return compileExpression(c,n.resources)});a.isFulfilled()?i[o]=a.value():e.push(this.emitExpressionSyntaxError(o,a.reason()))}else e.push(this.emitExpressionSyntaxError(o))}}return ActivityContext.reduceErrors(Bluebird.all(e))}concludeInline(t){return this.cancellationResolve(),t}generateMonikers(){const t=this.monikers;var i=this.activity;t.push("$"+i.id),"string"==typeof i.name&&t.push("$"+i.name);const e=i.action;"string"!=typeof e||1<(i=e.split(":")).length&&(0<(i=i[i.length-2]).length&&t.push("$$"+i))}marshalError(){var t=this.promise.value();return 1<t.length?new AggregateActivityError(this.activity.id,t):0<t.length?t[0]:void 0}execute(){let t=this.promise;const i=this.ambient;if(void 0!==t)return i.debug(i),i.halted||this.transferInline(),t;{if(t=this.resolveAssetsInline(),t.isRejected())return t;if(t=t.isPending()?t.then(t=>this.resolveInputsInline(t)):Bluebird.resolve(this.resolveInputsInline(t.value())),t.isRejected())return t;if(t=t.isPending()?t.then(t=>this.executeHandlerInline(t)):Bluebird.resolve(this.executeHandlerInline(t.value())),t.isRejected())return t;if(t=t.isPending()?t.then(t=>this.concludeInline(t)):Bluebird.resolve(this.concludeInline(t.value())),t.isRejected())return t;t.isPending()&&(t=t.catch(t=>i.fail(t)),t.then(t=>i.execute())),this.generateMonikers();const e=i.frame.state;for(const r of this.monikers)e[r]=this;return this.promise=t,Bluebird.resolve(void 0)}}goto(){}}export default ActivityContext;

package/execution/ActivityContextProxy.d.ts

@@ -0,0 +1,24 @@
+import Proxy from "./Proxy";
+import type ActivityContext from "./ActivityContext";
+import type { IActivityContext } from "../IActivityHandler";
+/**
+ * A proxy of the ActivityContext so that callers cannot influence the guts of the engine.
+ */
+declare class ActivityContextProxy extends Proxy<ActivityContext> implements IActivityContext {
+    get luid(): any;
+    get ambient(): import("./AmbientStateProxy").default;
+    get action(): string;
+    get branch(): string | number | boolean | undefined;
+    get cancellationToken(): import("../Task").Task<void>;
+    get passes(): number;
+    get caught(): Error | undefined;
+    call(branch?: boolean | number | string): void;
+    fork(branch?: boolean | number | string): void;
+    jump(branch?: boolean | number | string): void;
+    hasBranch(branch?: boolean | number | string): boolean;
+    get state(): any;
+    registerForErrors(): void;
+    persist(value: any): void;
+    goto(): void;
+}
+export {};

package/execution/ActivityContextProxy.js

@@ -0,0 +1 @@
+import Proxy,{clearGuard}from"./Proxy.js";class ActivityContextProxy extends Proxy{get luid(){return clearGuard(),this.target.luid}get ambient(){return clearGuard(),this.target.ambient.proxy}get action(){return clearGuard(),this.target.action}get branch(){return clearGuard(),this.target.branch}get cancellationToken(){return clearGuard(),this.target.cancellationToken}get passes(){return clearGuard(),this.target.passes}get caught(){return clearGuard(),this.target.caught}call(r){return clearGuard(),this.target.call(r)}fork(r){return clearGuard(),this.target.fork(r)}jump(r){return clearGuard(),this.target.jump(r)}hasBranch(r){return clearGuard(),this.target.hasBranch(r)}get state(){return clearGuard(),this.target.state}registerForErrors(){return clearGuard(),this.target.registerForErrors()}persist(r){return clearGuard(),this.target.persist(r)}goto(){return clearGuard(),this.target.goto()}}export default ActivityContextProxy;

package/execution/ActivityLoader.d.ts

@@ -1,8 +1,8 @@
-import { IActivityHandler } from "../IActivityHandler";
-import { ProgramInspector } from "../definition/ProgramInspector";
-import { Reference } from "../definition/Reference";
-import { FormElementRegistration } from "../index";
-import { IActivityHandlerFactory } from "./Engine";
+import type { IActivityHandlerFactory } from "./Engine";
+import type { IActivityHandler } from "../IActivityHandler";
+import type { ProgramInspector } from "../definition/ProgramInspector";
+import type { Reference } from "../definition/Reference";
+import type { FormElementRegistration } from "../index";
 declare const formElementCache: Record<string, FormElementRegistration<any>>;
 export declare function getCachedFormElements(): typeof formElementCache;
 /**

package/execution/AmbientState.d.ts

@@ -0,0 +1,71 @@
+import Bluebird from "bluebird";
+import { Task } from "../Task";
+import MonikerFrame from "./MonikerFrame";
+import type ActivityContext from "./ActivityContext";
+import type AmbientStateProxy from "./AmbientStateProxy";
+import type { Engine } from "./Engine";
+import type { ExternalEventCallback } from "./ExternalEvent";
+import type { IDebugSession } from "./IDebugSession";
+import type { IAmbientState, IActivityHandler } from "../IActivityHandler";
+import type { ProgramInspector } from "../definition/ProgramInspector";
+import type { Step } from "../definition/Step";
+import type { Transition } from "../definition/Transition";
+import type { LogLevel } from "../diagnostics/logging";
+/**
+ * Ambient state deals with the state for the overall workflow. The basic concept
+ * is to have an executor loop which sequences and initiates activities. If the
+ * workflow is completed or halted, the workflow should not continue
+ * to progress. At any point, execute and callback can be called, so to protect
+ * against re-entrancy issues the main loop should indicate somehow that it is
+ * presently executing.
+ */
+declare class AmbientState implements IDebugSession, IAmbientState {
+    debug: (session: IDebugSession) => void;
+    engine: Engine;
+    inspector: ProgramInspector;
+    id: string;
+    environment: Record<string, any>;
+    error: Error | undefined;
+    inputs: Record<string, any>;
+    resources?: Record<string, any>;
+    locale: string | undefined;
+    logLevel: LogLevel | undefined;
+    outputs: Record<string, any>;
+    removeExternalEventHandler: (_callback: ExternalEventCallback) => void;
+    setExternalEventHandler: (_callback: ExternalEventCallback) => void;
+    trivia: Record<string, any> | undefined;
+    frame: MonikerFrame | undefined;
+    queue: Transition[];
+    stack: MonikerFrame[];
+    handlers: Record<string, Bluebird<IActivityHandler | undefined>>;
+    get activityContexts(): Record<string, ActivityContext>;
+    cancellationResolve: () => void;
+    cancellationToken: Task<void>;
+    completion: Bluebird<{}>;
+    resolveCompletion: (result: {}) => void;
+    rejectCompletion: (error: any) => void;
+    scheduler: Bluebird<void>;
+    proxy: AmbientStateProxy;
+    inline: boolean;
+    halted: boolean;
+    private static createLinkedCancellationToken;
+    break(): void;
+    continue(): void;
+    execute(action?: () => void): boolean;
+    complete(outputs?: {}): void;
+    reject(error?: any): void;
+    fail(thrown?: any): void;
+    cancel(): void;
+    push(): MonikerFrame;
+    pop(error?: Error): MonikerFrame | undefined;
+    call(): void;
+    fork(): void;
+    bubble(error: Error): void;
+    next(): void;
+    prepare(next: ActivityContext, context?: ActivityContext, caught?: Error): void;
+    attempt(transition: Transition): void;
+    start(step: Step, context?: ActivityContext, caught?: Error): void;
+    enqueue(step: Step, branch?: boolean | number | string): void;
+    goto(frame: MonikerFrame): boolean;
+}
+export {};

package/execution/AmbientState.js

@@ -0,0 +1 @@
+import Bluebird from"bluebird";import{ActivityCancellationError,EngineRuntimeError}from"../Errors.js";import{Task}from"../Task.js";import ActivityContextProxy from"./ActivityContextProxy.js";import AsyncContext from"./AsyncContext.js";import MonikerFrame from"./MonikerFrame.js";import StepContext from"./StepContext.js";import TransitionContext from"./TransitionContext.js";import{newSymbol}from"./util.js";class AmbientState{constructor(){this.debug=()=>{},this.engine={},this.inspector={},this.id="",this.environment={},this.inputs={},this.outputs={},this.removeExternalEventHandler=t=>{},this.setExternalEventHandler=t=>{},this.frame=new MonikerFrame,this.queue=[],this.stack=[],this.handlers={},this.cancellationResolve=()=>{},this.cancellationToken={},this.completion={},this.resolveCompletion=()=>{},this.rejectCompletion=()=>{},this.scheduler={},this.proxy={},this.inline=!1,this.halted=!1}get activityContexts(){const t={};for(const e of[...this.stack,this.frame])for(const i in e.state)"$$"===i.substring(0,2)&&(t[i]=e.state[i]);return t}static createLinkedCancellationToken(t,e){const i=Task.race([new Task(e),t]),n=new AbortController;return i.signal=n.signal,i.finally(()=>n.abort()),i}break(){this.halted=!0}continue(){this.halted=!1,void 0!==this.scheduler&&!this.scheduler.isFulfilled()||(this.scheduler=Bluebird.resolve(void 0).then(t=>{this.execute()}))}execute(t){if(this.inline)return!1;this.inline=!0;try{void 0!==t&&t();const e=this.completion;for(;e.isPending();){if(this.halted)return!1;const i=this.frame.current.execute();if(i.isPending())break;i.isRejected()&&this.fail(i.reason())}}catch(t){this.fail(t)}finally{this.inline=!1}return!0}complete(t){this.completion.isPending()&&(this.cancellationResolve(),this.resolveCompletion(t||this.outputs))}reject(t){this.completion.isPending()&&(this.cancellationResolve(),this.rejectCompletion(t||this.error))}fail(t){this.completion.isPending()&&(this.cancellationResolve(),this.rejectCompletion(new EngineRuntimeError(t)))}cancel(){this.completion.isPending()&&(this.cancellationResolve(),this.rejectCompletion(new ActivityCancellationError))}push(){const t=this.stack;t.push(this.frame);const e=this.frame=new MonikerFrame;return e.index=t.length,e}pop(t){const e=this.frame;if(void 0!==e){e.current=void 0;const n=e.cancellationResolve;void 0!==n&&n()}var i=this.frame=this.stack.pop();return void 0===i&&(void 0!==t?this.reject(t):this.complete()),i}call(){var t=this.frame;const e=this.push();e.cancellationToken=t.cancellationToken,e.state=t.state}fork(){const e=this.push();e.cancellationToken=AmbientState.createLinkedCancellationToken(this.cancellationToken,t=>e.cancellationResolve=t),e.state={}}bubble(t){let e=this.pop(t);for(;void 0!==e&&!e.current.registeredForErrors;)e=this.pop(t);var i;void 0!==e&&(i=e.current,this.start(i.activity,i,t))}next(){var t=this.queue.pop();void 0!==t?this.attempt(t):void 0!==(t=this.pop())&&(t=t.current,this.start(t.activity,t))}prepare(e,t,i){const n=e.frame=this.frame;if((n.current=e).luid=this.id+":"+e.activity.id,e.action=e.activity.action,e.ambient=this,e.id=newSymbol(),e.caught=i,e.cancellationToken=AmbientState.createLinkedCancellationToken(n.cancellationToken,t=>e.cancellationResolve=t),e.proxy=new ActivityContextProxy(e),void 0!==t){const s=e.recent=t.recent||(t.recent={});t=s.context||t;(s.context=e).passes=t.passes+1,e.stateToPersist=e.state=t.stateToPersist}else e.passes=0}attempt(t){const e=new TransitionContext;e.activity=t,e.branch=t.branch,this.prepare(e)}start(t,e,i){const n=new(t.async?AsyncContext:StepContext);n.activity=t,n.monikers.push("$"),this.prepare(n,e,i)}enqueue(t,e){const i=this.inspector;this.queue=i.relate(t,e).list(),this.next()}goto(t){for(var e=this.stack,i=t.index;e[i]===t;)this.pop();return t===this.frame}}export default AmbientState;

package/execution/AmbientStateProxy.d.ts

@@ -0,0 +1,28 @@
+import Proxy from "./Proxy";
+import type AmbientState from "./AmbientState";
+import type { ExternalEventCallback } from "./ExternalEvent";
+import type { IAmbientState } from "../IActivityHandler";
+import type { LogLevel } from "../diagnostics/logging";
+/**
+ * A proxy of the AmbientState so that callers cannot influence the guts of the engine.
+ */
+declare class AmbientStateProxy extends Proxy<AmbientState> implements IAmbientState {
+    get outputs(): {};
+    set outputs(outputs: {});
+    get error(): Error | undefined;
+    set error(error: Error | undefined);
+    get completion(): Bluebird<{}>;
+    complete(outputs?: {}): void;
+    reject(error?: Error): void;
+    get environment(): Record<string, any>;
+    get inputs(): Record<string, any>;
+    get activityContexts(): Record<string, import("./ActivityContext").default>;
+    get locale(): string | undefined;
+    get logLevel(): LogLevel | undefined;
+    set logLevel(level: LogLevel | undefined);
+    removeExternalEventHandler(callback: ExternalEventCallback): void;
+    get resources(): Record<string, any> | undefined;
+    setExternalEventHandler(callback: ExternalEventCallback): void;
+    get trivia(): Record<string, any> | undefined;
+}
+export {};

package/execution/AmbientStateProxy.js

@@ -0,0 +1 @@
+import Proxy,{clearGuard}from"./Proxy.js";class AmbientStateProxy extends Proxy{get outputs(){return clearGuard(),this.target.outputs}set outputs(t){clearGuard(),this.target.outputs=t}get error(){return clearGuard(),this.target.error}set error(t){clearGuard(),this.target.error=t}get completion(){return clearGuard(),this.target.completion}complete(t){return clearGuard(),this.target.complete(t)}reject(t){return clearGuard(),this.target.reject(t)}get environment(){return clearGuard(),this.target.environment}get inputs(){return clearGuard(),this.target.inputs}get activityContexts(){return clearGuard(),this.target.activityContexts}get locale(){return clearGuard(),this.target.locale}get logLevel(){return clearGuard(),this.target.logLevel}set logLevel(t){clearGuard(),this.target.logLevel=t}removeExternalEventHandler(t){return clearGuard(),this.target.removeExternalEventHandler(t)}get resources(){return clearGuard(),this.target.resources}setExternalEventHandler(t){return clearGuard(),this.target.setExternalEventHandler(t)}get trivia(){return clearGuard(),this.target.trivia}}export default AmbientStateProxy;

package/execution/AsyncContext.d.ts

@@ -0,0 +1,7 @@
+import Bluebird from "bluebird";
+import ActivityContext from "./ActivityContext";
+declare class AsyncContext extends ActivityContext {
+    transferInline(): void;
+    execute(): Bluebird<undefined>;
+}
+export {};

package/execution/AsyncContext.js

@@ -0,0 +1 @@
+import Bluebird from"bluebird";import ActivityContext from"./ActivityContext.js";class AsyncContext extends ActivityContext{transferInline(){this.ambient.enqueue(this.activity)}execute(){return super.execute(),Bluebird.resolve(void 0)}}export default AsyncContext;

package/execution/Engine.d.ts

@@ -1,12 +1,13 @@
 import { Activator } from "../Activator";
-import { IActivityHandler } from "../IActivityHandler";
 import { Task } from "../Task";
-import { Program } from "../definition/Program";
 import { ProgramInspector } from "../definition/ProgramInspector";
-import { Step } from "../definition/Step";
-import { LogLevel } from "../diagnostics/logging";
-import { FormElementRegistration } from "../index";
-import { IDebugSession } from "./IDebugSession";
+import type { ExternalEvent, ExternalEventCallback } from "./ExternalEvent";
+import type { IDebugSession } from "./IDebugSession";
+import type { IActivityHandler } from "../IActivityHandler";
+import type { Program } from "../definition/Program";
+import type { Step } from "../definition/Step";
+import type { LogLevel } from "../diagnostics/logging";
+import type { FormElementRegistration } from "../index";
 /**
  * Describes run options for a run operation.
  * @product This is intended for internal use only within VertiGIS Studio products.
@@ -64,6 +65,18 @@ export declare class Engine {
     activator: Activator;
     /** Indicates the default environment for any workflow. */
     environment: {};
+    /** Callback function to send a new External Event to a Display Form activity. */
+    private externalEventCallback;
+    /**
+     * Registers the supplied callback function as the event handler for external events, received from the host application.
+     * @param callback The function to be called whenever an external event is received.
+     */
+    setExternalEventHandler(callback: ExternalEventCallback): void;
+    /**
+     * Removes the supplied callback function as the event handler for external events, received from the host application.
+     * @param callback The function to be unregistered.
+     */
+    removeExternalEventHandler(callback: ExternalEventCallback): void;
     /** Indicates the default trivia for any workflow. */
     trivia: {
         getFormElementRegistration: (id: string) => FormElementRegistration | undefined;
@@ -81,4 +94,10 @@ export declare class Engine {
     /** Runs a program and returns a promise for the outputs. */
     run(document: Program, options?: RunOptions): Task<{}>;
     run(inspector: ProgramInspector, options?: RunOptions): Task<{}>;
+    /**
+     * Adds an event from an external source (the host application) to the current workflow.
+     * This will be ignored unless there is currently a callback function registered to process it.
+     * @param event The event to be sent to the workflow.
+     */
+    enqueueExternalEvent(event: ExternalEvent): void;
 }

package/execution/Engine.js

@@ -1 +1 @@
-import Bluebird from"bluebird";import{Activator}from"../Activator.js";import{getStringsForProgram}from"../LanguageStringUtils.js";import{Task}from"../Task.js";import{ProgramInspector,canonicalizeLocale}from"../definition/ProgramInspector.js";import{getCachedFormElements}from"../execution/ActivityLoader.js";import{BuiltInFormElements}from"../forms/manifest.js";import{check as checkLicense}from"../licensing/LicenseChecker.js";import{run}from"./ProgramRunner.js";class Engine{constructor(e){this._getFormElementRegistration=e=>this.formElements[e],this._registerFormElement=e=>{var t,r=e["id"];this.formElements[r]?(t={...this.formElements[r],...e},this.formElements[r]=t):this.formElements[r]=e},this.activator=new Activator,this.environment={},this.trivia={getFormElementRegistration:this._getFormElementRegistration,registerFormElement:this._registerFormElement},this.factories=[],this.implementations={},this.formElements={...getCachedFormElements(),...BuiltInFormElements},this.appSkuCode=e}static buildOptions(e,t){(t={...t||{}}).locale=canonicalizeLocale(t.locale),t.locale||(t.locale=e.getDefaultLocale()),t.logLevel=t.logLevel||"log";var r=new Proxy({},{get(e,t,r){return t}});const i=getStringsForProgram(e,t);return t.environment={activities:r,encodeHtml:function(e){return"string"==typeof e?e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#039;"):""},getText:function(e){if("string"==typeof e&&"@"===e.charAt(0)){var t=e.slice(1);if(t in i)return i[t]}return e},strings:i,...t.environment||{}},t}createHandler(e,t){var r=this.implementations[e];if(void 0!==r){const n=Bluebird.resolve(r);return n.isFulfilled()?new(n.value()):n.then(function(e){return Bluebird.attempt(function(){return new e})})}for(const o of this.factories){var i=o.create(e,this._registerFormElement,t);if(void 0!==i)return i}}run(r,i){const n=this;return Task.attempt(function(){let e;r instanceof ProgramInspector?e=r:(e=new ProgramInspector,e.import(r)),checkLicense(e.program,n.appSkuCode),i=Engine.buildOptions(e,i);var t=e.resolveStart(i?i.start:void 0);return run(n,e,i,t)})}}export{Engine};
+import Bluebird from"bluebird";import{Activator}from"../Activator.js";import{getStringsForProgram}from"../LanguageStringUtils.js";import{Task}from"../Task.js";import{ProgramInspector,canonicalizeLocale}from"../definition/ProgramInspector.js";import{getCachedFormElements}from"../execution/ActivityLoader.js";import{BuiltInFormElements}from"../forms/manifest.js";import{check as checkLicense}from"../licensing/LicenseChecker.js";import{run}from"./ProgramRunner.js";class Engine{constructor(e){this._getFormElementRegistration=e=>this.formElements[e],this._registerFormElement=e=>{var t,r=e["id"];this.formElements[r]?(t={...this.formElements[r],...e},this.formElements[r]=t):this.formElements[r]=e},this.activator=new Activator,this.environment={},this.trivia={getFormElementRegistration:this._getFormElementRegistration,registerFormElement:this._registerFormElement},this.factories=[],this.implementations={},this.formElements={...getCachedFormElements(),...BuiltInFormElements},this.appSkuCode=e}setExternalEventHandler(e){this.externalEventCallback=e}removeExternalEventHandler(e){e===this.externalEventCallback&&(this.externalEventCallback=void 0)}static buildOptions(e,t){(t={...t||{}}).locale=canonicalizeLocale(t.locale),t.locale||(t.locale=e.getDefaultLocale()),t.logLevel=t.logLevel||"log";var r=new Proxy({},{get(e,t,r){return t}});const n=getStringsForProgram(e,t);return t.environment={activities:r,encodeHtml:function(e){return"string"==typeof e?e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#039;"):""},getText:function(e){if("string"==typeof e&&"@"===e.charAt(0)){var t=e.slice(1);if(t in n)return n[t]}return e},strings:n,...t.environment||{}},t}createHandler(e,t){var r=this.implementations[e];if(void 0!==r){const i=Bluebird.resolve(r);return i.isFulfilled()?new(i.value()):i.then(function(e){return Bluebird.attempt(function(){return new e})})}for(const o of this.factories){var n=o.create(e,this._registerFormElement,t);if(void 0!==n)return n}}run(r,n){return Task.attempt(()=>{let e;r instanceof ProgramInspector?e=r:(e=new ProgramInspector,e.import(r)),checkLicense(e.program,this.appSkuCode),n=Engine.buildOptions(e,n);var t=e.resolveStart(n?n.start:void 0);return run(this,e,n,t)})}enqueueExternalEvent(e){this.externalEventCallback&&this.externalEventCallback(e)}}export{Engine};

package/execution/ExternalEvent.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Details of an event that the Engine received from the host application.
+ */
+export interface ExternalEvent {
+    /** The name of the event. */
+    name: string;
+    /** Details of parameters that accompany the event. */
+    parameters?: any;
+}
+/**
+ * Callback function to be used when an external event needs to be passed
+ * from the Engine to Display Form.
+ */
+export type ExternalEventCallback = (newEvent: ExternalEvent) => void;

package/execution/IDebugSession.d.ts

@@ -1,6 +1,6 @@
-import Bluebird from "bluebird";
-import { Activity } from "../definition/Activity";
-import { ProgramInspector } from "../definition/ProgramInspector";
+import type { Activity } from "../definition/Activity";
+import type { ProgramInspector } from "../definition/ProgramInspector";
+import type Bluebird from "bluebird";
 /** Contains information about an activity. */
 export interface IActivityState {
     /** Indicates the identifier of this state. */

package/execution/MonikerFrame.d.ts

@@ -0,0 +1,11 @@
+import type ActivityContext from "./ActivityContext";
+import type { IMonikerFrame } from "./IDebugSession";
+import type { Task } from "../Task";
+declare class MonikerFrame implements IMonikerFrame {
+    cancellationResolve: () => void;
+    cancellationToken: Task<void>;
+    index: number;
+    current?: ActivityContext;
+    state: Record<string, ActivityContext>;
+}
+export {};

package/execution/MonikerFrame.js

@@ -0,0 +1 @@
+class MonikerFrame{constructor(){this.cancellationResolve=()=>{},this.cancellationToken={},this.index=-1,this.state={}}}export default MonikerFrame;

package/execution/ProgramRunner.js

@@ -1 +1 @@
-import Bluebird from"bluebird";import{ActivityActivationError,ActivityBindingError,ActivityCancellationError,ActivityError,AggregateActivityError,EngineRuntimeError,ExpressionAccessorError,ExpressionEvaluationError,ExpressionSyntaxError,GenericActivityError,ProgramStartError}from"../Errors.js";import{query}from"../Hooks.js";import{Task}from"../Task.js";function isExpression(t){var e=t.type;return null==e&&"string"==typeof t.code}function createLinkedCancellationToken(t,e){const i=Task.race([new Task(e),t]),r=new AbortController;return i.signal=r.signal,i.finally(()=>r.abort()),i}function isInvalidHandler(t){return null==t||"function"!=typeof t.execute}function isLiteral(t){switch(typeof t){case"boolean":case"number":case"string":return!0}return!1}let evaluators={};function clearExpressionCache(){evaluators={}}const reservedIdentifiers=["resources","values","Date","JSON","Math","Object","parseInt","parseFloat","decodeURIComponent","encodeURIComponent"];function isAccessor(e){return!("string"!=typeof e||e.length<1)&&(!(0<=e.indexOf("."))&&!reservedIdentifiers.some(t=>t===e))}function compileExpression(t,e){var i=t.code;let r=evaluators[i];if(void 0===r){const s=[],o={};s.push('"use strict"; ');var n=t.accessors;if(Array.isArray(n))for(const a of n)isAccessor(a)&&!o[a]&&(s.push(`var ${a} = this.${a};`),o[a]=!0);s.push("return "),s.push(i),s.push(";"),r=evaluators[i]=new Function("resources","values",s.join(""))}return function(){return r.call(this,e,t.values)}}function echo(t){return t}const echoHandler={execute:echo};function combine(t,e){return{...t||{},...e||{}}}function isError(t){return void 0!==t}function filterErrors(t){return t.filter(isError)}function reduceErrors(t){return t.isPending()?t.then(filterErrors):t.isFulfilled()?Bluebird.resolve(filterErrors(t.value())):t}let nextSymbol,nextSymbolPrefix;function newSymbol(){return void 0!==nextSymbol&&1073741824<=nextSymbol&&(nextSymbol=void 0),void 0===nextSymbol&&(nextSymbol=0,nextSymbolPrefix=(new Date).valueOf()+":"),nextSymbolPrefix+nextSymbol++}const immediate=Bluebird.resolve(void 0);let guard=!0;class Proxy{get target(){}constructor(t){Object.defineProperty(this,"target",{get(){if(!1===guard)return guard=!0,t}})}}class AmbientStateProxy extends Proxy{get outputs(){return guard=!1,this.target.outputs}set outputs(t){guard=!1,this.target.outputs=t}get error(){return guard=!1,this.target.error}set error(t){guard=!1,this.target.error=t}get completion(){return guard=!1,this.target.completion}complete(t){return guard=!1,this.target.complete(t)}reject(t){return guard=!1,this.target.reject(t)}get environment(){return guard=!1,this.target.environment}get inputs(){return guard=!1,this.target.inputs}get activityContexts(){return guard=!1,this.target.activityContexts}get locale(){return guard=!1,this.target.locale}get logLevel(){return guard=!1,this.target.logLevel}set logLevel(t){guard=!1,this.target.logLevel=t}get resources(){return guard=!1,this.target.resources}get trivia(){return guard=!1,this.target.trivia}}class ActivityContextProxy extends Proxy{get luid(){return guard=!1,this.target.luid}get ambient(){return guard=!1,this.target.ambient.proxy}get action(){return guard=!1,this.target.action}get branch(){return guard=!1,this.target.branch}get cancellationToken(){return guard=!1,this.target.cancellationToken}get passes(){return guard=!1,this.target.passes}get caught(){return guard=!1,this.target.caught}call(t){return guard=!1,this.target.call(t)}fork(t){return guard=!1,this.target.fork(t)}jump(t){return guard=!1,this.target.jump(t)}hasBranch(t){return guard=!1,this.target.hasBranch(t)}get state(){return guard=!1,this.target.state}registerForErrors(){return guard=!1,this.target.registerForErrors()}persist(t){return guard=!1,this.target.persist(t)}goto(){return guard=!1,this.target.goto()}}class AmbientState{constructor(){this.debug=()=>{},this.engine={},this.inspector={},this.id="",this.environment={},this.error={},this.inputs={},this.outputs={},this.frame=new MonikerFrame,this.queue=[],this.stack=[],this.handlers={},this.cancellationResolve=()=>{},this.cancellationToken={},this.completion={},this.resolveCompletion=()=>{},this.rejectCompletion=()=>{},this.scheduler={},this.proxy={},this.inline=!1,this.halted=!1}get activityContexts(){const t={};for(const e of[...this.stack,this.frame])for(const i in e.state)"$$"===i.substring(0,2)&&(t[i]=e.state[i]);return t}break(){this.halted=!0}continue(){this.halted=!1,void 0!==this.scheduler&&!this.scheduler.isFulfilled()||(this.scheduler=immediate.then(t=>{this.execute()}))}execute(t){if(this.inline)return!1;this.inline=!0;try{void 0!==t&&t();const e=this.completion;for(;e.isPending();){if(this.halted)return!1;const i=this.frame.current.execute();if(i.isPending())break;i.isRejected()&&this.fail(i.reason())}}catch(t){this.fail(t)}finally{this.inline=!1}return!0}complete(t){this.completion.isPending()&&(this.cancellationResolve(),this.resolveCompletion(t||this.outputs))}reject(t){this.completion.isPending()&&(this.cancellationResolve(),this.rejectCompletion(t||this.error))}fail(t){this.completion.isPending()&&(this.cancellationResolve(),this.rejectCompletion(new EngineRuntimeError(t)))}cancel(){this.completion.isPending()&&(this.cancellationResolve(),this.rejectCompletion(new ActivityCancellationError))}push(){const t=this.stack;t.push(this.frame);const e=this.frame=new MonikerFrame;return e.index=t.length,e}pop(t){const e=this.frame;if(void 0!==e){e.current=void 0;const r=e.cancellationResolve;void 0!==r&&r()}var i=this.frame=this.stack.pop();return void 0===i&&(void 0!==t?this.reject(t):this.complete()),i}call(){var t=this.frame;const e=this.push();e.cancellationToken=t.cancellationToken,e.state=t.state}fork(){const e=this.push();e.cancellationToken=createLinkedCancellationToken(this.cancellationToken,t=>e.cancellationResolve=t),e.state={}}bubble(t){let e=this.pop(t);for(;void 0!==e&&!e.current.registeredForErrors;)e=this.pop(t);var i;void 0!==e&&(i=e.current,this.start(i.activity,i,t))}next(){var t=this.queue.pop();void 0!==t?this.attempt(t):void 0!==(t=this.pop())&&(t=t.current,this.start(t.activity,t))}prepare(e,t,i){const r=e.frame=this.frame;if((r.current=e).luid=this.id+":"+e.activity.id,e.action=e.activity.action,e.ambient=this,e.id=newSymbol(),e.caught=i,e.cancellationToken=createLinkedCancellationToken(r.cancellationToken,t=>e.cancellationResolve=t),e.proxy=new ActivityContextProxy(e),void 0!==t){const n=e.recent=t.recent||(t.recent={});t=n.context||t;(n.context=e).passes=t.passes+1,e.stateToPersist=e.state=t.stateToPersist}else e.passes=0}attempt(t){const e=new TransitionContext;e.activity=t,e.branch=t.branch,this.prepare(e)}start(t,e,i){const r=new(t.async?AsyncContext:StepContext);r.activity=t,r.monikers.push("$"),this.prepare(r,e,i)}enqueue(t,e){const i=this.inspector;this.queue=i.relate(t,e).list(),this.next()}goto(t){for(var e=this.stack,i=t.index;e[i]===t;)this.pop();return t===this.frame}}class MonikerFrame{constructor(){this.cancellationResolve=()=>{},this.cancellationToken={},this.index=-1,this.state={}}}class PromiseWrapper{}class ActivityContext{constructor(){this.action="",this.activity={},this.ambient={},this.frame={},this.proxy={},this.passes=0,this.inputs={},this.outputs={},this.extras=[],this.monikers=[],this.evaluators={},this.scope={},this.cancellationToken={},this.cancellationResolve=()=>{}}registerForErrors(){this.registeredForErrors=!0}persist(t){this.stateToPersist=t}call(t){this.callBranch=!0,this.forkBranch=!1,this.jumpBranch=t}fork(t){this.callBranch=!1,this.forkBranch=!0,this.jumpBranch=t}jump(t){this.callBranch=!1,this.forkBranch=!1,this.jumpBranch=t}hasBranch(t){var e=this.activity;const i=this.ambient.inspector;return i.isStep(e)&&void 0!==i.relate(e,t).peek()}emitExpressionEvaluationError(t,e){var i=this.activity.id,r=this.activity.inputs[t];return new ExpressionEvaluationError(i,t,r.source||r.code,e)}emitExpressionSyntaxError(t,e){var i=this.activity.id,r=this.activity.inputs[t];return new ExpressionSyntaxError(i,t,r.source||r.code,e)}emitExpressionAccessorError(t,e,i){return new ExpressionAccessorError(this.activity.id,t,e,i)}emitActivityBindingError(t){var e=this.activity;return new ActivityBindingError(e.id,e.action,t)}emitActivityActivationError(t,e){return new ActivityActivationError(this.activity.id,t,e)}emitActivityError(t){if(t instanceof ActivityError)return t;var e=this.activity;const i=new GenericActivityError(void 0,t?.message);return i.activityId=e.id,i.error=t,i}executeHandlerInline(e){if(0<e.length||this.cancellationToken.isFulfilled())return e;const i=this.extras;for(let t=0;t<i.length;t++)i[t]=Bluebird.resolve(i[t]).value();const r=this.inputs;for(const o in r){let t=Bluebird.resolve(r[o]).value();t instanceof PromiseWrapper&&(t=t.result),r[o]=t}const t=this.proxy,n=this.handler.value(),s=Bluebird.attempt(function(){return n.execute(r,t,...i)});return s.isPending()?s.then(t=>(this.outputs=t,e),t=>[this.emitActivityError(t)]):s.isRejected()?[this.emitActivityError(s.reason())]:(this.outputs=s.value(),e)}resolveExtrasInline(){for(const e of query(this.handler.value())){const t=this.ambient.engine.activator,i=t.activate(e);if(this.extras.push(i),i.isPending())return i.then(t=>{},t=>this.emitActivityActivationError(e.type,t));if(i.isRejected())return this.emitActivityActivationError(e.type,i.reason())}}resolveInputsInline(t){if(0<t.length||this.cancellationToken.isFulfilled())return t;const e=[];e.push(this.resolveExtrasInline());const i=this.evaluators;if(void 0!==i){const r=this.scope;for(const s in r)r[s]=Bluebird.resolve(r[s]).value();const n=this.inputs;for(const o in i){const a=n[o]=Bluebird.attempt(function(){var t=i[o].call(r,void 0,void 0);if(t&&"function"==typeof t.then){const e=new PromiseWrapper;return e.result=t,e}return t});a.isPending()&&e.push(a.then(t=>{},t=>this.emitExpressionEvaluationError(o,t))),a.isRejected()&&e.push(this.emitExpressionEvaluationError(o,a.reason()))}}return reduceErrors(Bluebird.all(e))}resolveHandlerInline(){const e=this.activity.action;if("string"==typeof e){var i=this.ambient;const r=i.handlers;let t=this.handler=r[e];if(void 0===t){const n=i.engine,s=i.inspector;t=this.handler=r[e]=Bluebird.attempt(function(){return n.createHandler(e,s)})}return t.isPending()?t.then(t=>isInvalidHandler(t)?this.emitActivityBindingError():void 0,t=>this.emitActivityBindingError(t)):t.isRejected()?this.emitActivityBindingError(t.reason()):isInvalidHandler(t.value())?this.emitActivityBindingError():void 0}this.handler=Bluebird.resolve(echoHandler)}findContext(t){var e=this.ambient,i=e.stack;let r=e.frame;for(;void 0!==r;){var n=r.state[t];if(void 0!==n)return n;r=i[r.index-1]}}resolveOutputsInline(){const t=this.promise;if(t.isPending())return t.then(t=>void 0!==t&&0<t.length?Bluebird.reject(t):this.outputs,t=>{});if(t.isRejected())return immediate;var e=t.value();return void 0!==e&&0<e.length?Bluebird.reject(e):Bluebird.resolve(this.outputs)}resolveAccessorInline(e){const t=this.findContext(e);if(void 0!==t){const i=this.scope[e]=t.resolveOutputsInline();return i.isPending()?i.then(t=>{},t=>this.emitExpressionAccessorError(e,void 0,t)):i.isRejected()?this.emitExpressionAccessorError(e,void 0,i.reason()):void 0}const i=this.scope[e]=Bluebird.resolve(this.ambient.environment[e]);return i.isPending()?i.then(t=>{},t=>this.emitExpressionAccessorError(e,t)):i.isRejected()?this.emitExpressionAccessorError(e,i.reason()):void 0}resolveAssetsInline(){const i=[];i.push(this.resolveHandlerInline());var r=this.activity.inputs;if(null!=r){let t,e;const s=this.ambient;for(const o in r){const a=r[o];if(void 0!==a&&null!==a)if(isLiteral(a))this.inputs[o]=Bluebird.resolve(a);else if(isExpression(a)){void 0===t&&(this.scope=t={}),void 0===e&&(this.evaluators=e={});var n=a.accessors;if(Array.isArray(n))for(const l of n)"string"==typeof l&&void 0===t[l]&&i.push(this.resolveAccessorInline(l));const c=Bluebird.attempt(function(){return compileExpression(a,s.resources)});c.isFulfilled()?e[o]=c.value():i.push(this.emitExpressionSyntaxError(o,c.reason()))}else i.push(this.emitExpressionSyntaxError(o))}}return reduceErrors(Bluebird.all(i))}concludeInline(t){return this.cancellationResolve(),t}generateMonikers(){const t=this.monikers;var e=this.activity;t.push("$"+e.id),"string"==typeof e.name&&t.push("$"+e.name);const i=e.action;"string"!=typeof i||1<(e=i.split(":")).length&&(0<(e=e[e.length-2]).length&&t.push("$$"+e))}marshalError(){var t=this.promise.value();return 1<t.length?new AggregateActivityError(this.activity.id,t):0<t.length?t[0]:void 0}execute(){let t=this.promise;const e=this.ambient;if(void 0!==t)return e.debug(e),e.halted||this.transferInline(),t;{if(t=this.resolveAssetsInline(),t.isRejected())return t;if(t=t.isPending()?t.then(t=>this.resolveInputsInline(t)):Bluebird.resolve(this.resolveInputsInline(t.value())),t.isRejected())return t;if(t=t.isPending()?t.then(t=>this.executeHandlerInline(t)):Bluebird.resolve(this.executeHandlerInline(t.value())),t.isRejected())return t;if(t=t.isPending()?t.then(t=>this.concludeInline(t)):Bluebird.resolve(this.concludeInline(t.value())),t.isRejected())return t;t.isPending()&&(t=t.catch(t=>e.fail(t)),t.then(t=>e.execute())),this.generateMonikers();const i=e.frame.state;for(const r of this.monikers)i[r]=this;return this.promise=t,immediate}}goto(){}}class StepContext extends ActivityContext{transferInline(){const t=this.promise;if(t.isFulfilled()){const i=this.ambient;var e=this.marshalError();void 0!==e?i.bubble(e):this.repeat?i.start(this.activity,this):(this.callBranch&&i.call(),this.forkBranch&&i.fork(),i.enqueue(this.activity,this.jumpBranch))}}goto(){const t=this.frame,e=this.ambient;if(e.goto(t)){var i=this.recent;const r=void 0!==i?i.context:this;t.current=r,r.repeat=!0,e.halted=!1,e.execute()}}}class TransitionContext extends ActivityContext{constructor(){super(...arguments),this.activity={}}test(){let t=void 0,e=void 0;var i=this.outputs;for(const r in i){if(void 0!==t&&void 0!==e)return!1;if(e=i[r],!isLiteral(e))return!1;if(void 0===t)t=e,e=void 0;else if(t!==e)return!1}return void 0===t||(void 0!==e||("boolean"==typeof t?t:"number"==typeof t?0<t:"string"==typeof t&&0<t.length))}transferInline(){const t=this.promise;if(t.isFulfilled()){const i=this.ambient;var e=this.marshalError();void 0!==e?i.bubble(e):this.test()?i.start(this.activity.target):i.next()}}}class AsyncContext extends ActivityContext{transferInline(){this.ambient.enqueue(this.activity)}execute(){return super.execute(),immediate}}function run(n,s,o,a){const c=t=>{var e=s.findStep(t);if(!e)throw new GenericActivityError(`The workflow does not contain a step with the id ${t}.`);return e},l=()=>{const e=d.frame.current.action;return s.allReferences().filter(t=>void 0!==t.suite&&e.startsWith(t.suite)).peek()?.path},u=(t,e,i,r)=>{t=c(t);const n=c(e);if(!n.transitions.some(t=>"content"===t.branch||"try"===t.branch))throw new GenericActivityError(`The ${e} step is not a Container, Subworkflow, or Try Catch activity.`);i=`${r}$${i}`;v(t,n,i)},h=t=>{var e=d.frame.current.activity,i=c(t);if("gcx:wf:core::Subworkflow"!==i.action)throw new GenericActivityError(`The target step ${t} is not a Subworkflow activity.`);v(e,i,"default")},v=(t,e,i)=>{var r=s.relate(t,i).peek();void 0!==r&&s.remove(r);const n=s.addTransition(t,e);n.branch=i},d=new AmbientState;return d.completion=new Bluebird((t,e)=>{d.resolveCompletion=t,d.rejectCompletion=e}),d.cancellationToken=new Task(t=>d.cancellationResolve=t),d.execute(function(){if(s.isStep(a)){o=o||{},d.engine=n,d.inspector=s,d.id=newSymbol(),d.debug=o.debug||(()=>{}),d.environment=combine(n.environment,o.environment),d.inputs=o.inputs||{},d.locale=o.locale,d.logLevel=o.logLevel,d.resources={forms:s.cacheForms()},d.outputs={},d.trivia=combine(n.trivia,o.trivia),d.trivia.getActivityPackUrl=l,d.trivia.setFormElementEvent=u,d.trivia.setSubworkflowTransition=h,d.proxy=new AmbientStateProxy(d);const e=d.trivia.isDescendantOf;e?d.trivia.isDescendantOf=t=>t===d.proxy||e(t):d.trivia.isDescendantOf=t=>t===d.proxy;const i=d.frame;i.index=0,i.cancellationToken=d.cancellationToken,i.state=o.state||{};var t=o.cancellationToken;if(null!=t){const r=Task.race([t,d.cancellationToken]);r.isPending()?(t=()=>d.cancel(),r.then(t,t)):d.cancel()}d.start(a)}else d.reject(new ProgramStartError)}),d.completion}export{clearExpressionCache,run};
+import Bluebird from"bluebird";import{GenericActivityError,ProgramStartError}from"../Errors.js";import{Task}from"../Task.js";import AmbientState from"./AmbientState.js";import AmbientStateProxy from"./AmbientStateProxy.js";import{newSymbol}from"./util.js";function combine(e,t){return{...e||{},...t||{}}}function run(i,o,a,c){const s=e=>{var t=o.findStep(e);if(!t)throw new GenericActivityError(`The workflow does not contain a step with the id ${e}.`);return t},l=()=>{const t=u.frame.current.action;return o.allReferences().filter(e=>void 0!==e.suite&&t.startsWith(e.suite)).peek()?.path},m=(e,t,r,n)=>{e=s(e);const i=s(t);if(!i.transitions.some(e=>"content"===e.branch||"try"===e.branch))throw new GenericActivityError(`The ${t} step is not a Container, Subworkflow, or Try Catch activity.`);r=`${n}$${r}`;f(e,i,r)},v=e=>{var t=u.frame.current.activity,r=s(e);if("gcx:wf:core::Subworkflow"!==r.action)throw new GenericActivityError(`The target step ${e} is not a Subworkflow activity.`);f(t,r,"default")},f=(e,t,r)=>{var n=o.relate(e,r).peek();void 0!==n&&o.remove(n);const i=o.addTransition(e,t);i.branch=r},u=new AmbientState;return u.completion=new Bluebird((e,t)=>{u.resolveCompletion=e,u.rejectCompletion=t}),u.cancellationToken=new Task(e=>u.cancellationResolve=e),u.execute(function(){if(o.isStep(c)){a=a||{},u.engine=i,u.inspector=o,u.id=newSymbol(),u.debug=a.debug||(()=>{}),u.environment=combine(i.environment,a.environment),u.inputs=a.inputs||{},u.locale=a.locale,u.logLevel=a.logLevel,u.outputs={},u.removeExternalEventHandler=i.removeExternalEventHandler.bind(i),u.resources={forms:o.cacheForms()},u.setExternalEventHandler=i.setExternalEventHandler.bind(i),u.trivia=combine(i.trivia,a.trivia),u.trivia.getActivityPackUrl=l,u.trivia.setFormElementEvent=m,u.trivia.setSubworkflowTransition=v,u.proxy=new AmbientStateProxy(u);const t=u.trivia.isDescendantOf;t?u.trivia.isDescendantOf=e=>e===u.proxy||t(e):u.trivia.isDescendantOf=e=>e===u.proxy;const r=u.frame;r.index=0,r.cancellationToken=u.cancellationToken,r.state=a.state||{};var e=a.cancellationToken;if(null!=e){const n=Task.race([e,u.cancellationToken]);n.isPending()?(e=()=>u.cancel(),n.then(e,e)):u.cancel()}u.start(c)}else u.reject(new ProgramStartError)}),u.completion}export{run};

package/execution/Proxy.d.ts

@@ -0,0 +1,5 @@
+declare class Proxy<T> {
+    get target(): T;
+    constructor(target: T);
+}
+export {};

package/execution/Proxy.js

@@ -0,0 +1 @@
+let guard=!0;function clearGuard(){guard=!1}class Proxy{get target(){}constructor(r){Object.defineProperty(this,"target",{get(){if(!1===guard)return guard=!0,r}})}}export default Proxy;export{clearGuard};

package/execution/StepContext.d.ts

@@ -0,0 +1,6 @@
+import ActivityContext from "./ActivityContext";
+declare class StepContext extends ActivityContext {
+    protected transferInline(): void;
+    goto(): void;
+}
+export {};

package/execution/StepContext.js

@@ -0,0 +1 @@
+import ActivityContext from"./ActivityContext.js";class StepContext extends ActivityContext{transferInline(){const t=this.promise;if(t.isFulfilled()){const e=this.ambient;var i=this.marshalError();void 0!==i?e.bubble(i):this.repeat?e.start(this.activity,this):(this.callBranch&&e.call(),this.forkBranch&&e.fork(),e.enqueue(this.activity,this.jumpBranch))}}goto(){const t=this.frame,i=this.ambient;if(i.goto(t)){var e=this.recent;const s=void 0!==e?e.context:this;t.current=s,s.repeat=!0,i.halted=!1,i.execute()}}}export default StepContext;

package/execution/TransitionContext.d.ts

@@ -0,0 +1,8 @@
+import ActivityContext from "./ActivityContext";
+import type { Transition } from "../definition/Transition";
+declare class TransitionContext extends ActivityContext {
+    activity: Transition;
+    private test;
+    protected transferInline(): void;
+}
+export {};

package/execution/TransitionContext.js

@@ -0,0 +1 @@
+import ActivityContext from"./ActivityContext.js";import{isLiteral}from"./util.js";class TransitionContext extends ActivityContext{constructor(){super(...arguments),this.activity={}}test(){let t=void 0,i=void 0;var e=this.outputs;for(const o in e){if(void 0!==t&&void 0!==i)return!1;if(i=e[o],!isLiteral(i))return!1;if(void 0===t)t=i,i=void 0;else if(t!==i)return!1}return void 0===t||(void 0!==i||("boolean"==typeof t?t:"number"==typeof t?0<t:"string"==typeof t&&0<t.length))}transferInline(){const t=this.promise;if(t.isFulfilled()){const e=this.ambient;var i=this.marshalError();void 0!==i?e.bubble(i):this.test()?e.start(this.activity.target):e.next()}}}export default TransitionContext;

package/execution/util.d.ts

@@ -0,0 +1 @@
+export {};

package/execution/util.js

@@ -0,0 +1 @@
+const reservedIdentifiers=["resources","values","Date","JSON","Math","Object","parseInt","parseFloat","decodeURIComponent","encodeURIComponent"];function isAccessor(n){return!("string"!=typeof n||n.length<1)&&(!(0<=n.indexOf("."))&&!reservedIdentifiers.some(e=>e===n))}function isExpression(e){var n=e.type;return null==n&&"string"==typeof e.code}function isLiteral(e){switch(typeof e){case"boolean":case"number":case"string":return!0}return!1}let nextSymbol,nextSymbolPrefix;function newSymbol(){return void 0!==nextSymbol&&1073741824<=nextSymbol&&(nextSymbol=void 0),void 0===nextSymbol&&(nextSymbol=0,nextSymbolPrefix=(new Date).valueOf()+":"),nextSymbolPrefix+nextSymbol++}export{isAccessor,isExpression,isLiteral,newSymbol};

package/forms/FormComponent.d.ts

@@ -1,8 +1,8 @@
 import { Component } from "react";
-import * as defs from "./FormDefinition";
-import { FormPresenterHost } from "./FormPresenterHost";
+import type * as defs from "./FormDefinition";
+import type { FormPresenterHost } from "./FormPresenterHost";
 import type { FormElementProps, FormElementRegistration } from "./index";
-export { FormPresenterHost };
+export type { FormPresenterHost };
 export interface EventValueTypes {
     changed: defs.Value | undefined;
     cancel: string | undefined;
@@ -21,7 +21,7 @@ export interface EventArgumentTypes {
 }
 export interface FormComponentProps {
     host: FormPresenterHost;
-    type?: "form" | "body" | "row" | "header" | "main" | "footer" | "element" | "section" | "accordionGroup";
+    type?: "form" | "body" | "row" | "header" | "main" | "footer" | "element" | "section" | "accordionGroup" | "tabGroup";
     name?: string;
     children: JSX.Element[];
 }

package/forms/FormDefinition.d.ts

@@ -1,4 +1,5 @@
-import { NumberDisplayFormat } from "./numberFormatter";
+import type { NumberDisplayFormat } from "./numberFormatter";
+import type { ExternalEvent } from "../execution/ExternalEvent";
 /**
  * References a container.
  * @product This is intended for internal use only within VertiGIS Studio products.
@@ -206,7 +207,7 @@ export interface NumberFormat {
  * @product This is intended for internal use only within VertiGIS Studio products.
  */
 export type GeometryFormat = "polygon" | "polyline" | "point" | "polygon-freehand" | "polyline-freehand" | "extent" | "line";
-export type SectionFormat = "accordion-section" | "unstyled-section" | "fieldset-section" | "basic-section" | "collapsible-section";
+export type SectionFormat = "accordion-section" | "basic-section" | "collapsible-section" | "fieldset-section" | "tab-section" | "unstyled-section";
 /**
  * The `SectionFormat` to use when no value is specified.
  * @product This is intended for internal use only within VertiGIS Studio products.
@@ -376,7 +377,7 @@ export interface Item {
     /** Indicates the style name to be used. */
     styleName?: string;
 }
-export type EventType = "load" | "cancel" | "checked" | "changed" | "clicked" | "custom" | "dragged" | "suggest" | "submit" | "end" | "verify" | "validate" | "populate" | "prepare";
+export type EventType = "cancel" | "changed" | "checked" | "clicked" | "custom" | "dragged" | "end" | "external" | "load" | "populate" | "prepare" | "submit" | "suggest" | "validate" | "verify";
 /** @product This is intended for internal use only within VertiGIS Studio products. */
 export interface Event {
     /** Indicates the name of the element raising the event. */
@@ -388,7 +389,7 @@ export interface Event {
     /** Indicates the routing key of the event. */
     routingKey?: string;
     /** Indicates the argument for the event. */
-    argument?: Value;
+    argument?: Value | ExternalEvent;
     /** Indicates the value associated with the element or item. */
     value?: Value;
     /** Indicates the cancellation token fro the event. */

package/forms/FormElement.d.ts

@@ -1,7 +1,6 @@
-import { ReactNode } from "react";
 import * as React from "react";
-import { FormComponent } from "./FormComponent";
-import { defs } from "./FormHost";
+import type { FormComponent } from "./FormComponent";
+import type { defs } from "./FormHost";
 interface FormElementProps {
     /** The CSS class name of the root element. */
     className?: string;
@@ -19,6 +18,6 @@ interface FormElementProps {
     inputId?: string;
 }
 declare const _default: React.ForwardRefExoticComponent<FormElementProps & {
-    children?: ReactNode;
+    children?: React.ReactNode;
 } & React.RefAttributes<HTMLDivElement>>;
 export default _default;

package/forms/FormHost.d.ts

@@ -1,8 +1,9 @@
 import Bluebird from "bluebird";
-import { FormComponent } from "./FormComponent";
 import * as defs from "./FormDefinition";
-import { FormPresenterHost } from "./FormPresenterHost";
-import { FormatOptions } from "./numberFormatter";
+import type { FormComponent } from "./FormComponent";
+import type { FormPresenterHost } from "./FormPresenterHost";
+import type { FormatOptions } from "./numberFormatter";
+import type { ExternalEvent } from "../execution/ExternalEvent";
 import type { ComponentType, ReactNode } from "react";
 export { defs };
 export interface FormEventSubscription {
@@ -129,10 +130,16 @@ export declare abstract class FormHost implements FormPresenterHost {
     publish(type: defs.EventType, event?: defs.Event): defs.Event;
     /** Enqueues an event (used by publish()). */
     enqueue(type: defs.EventType, event?: defs.Event): defs.Event;
+    /**
+     * Pass on an external event to the queue.
+     * This method is an arrow function so that the consumer can use it without an object reference.
+     * @param event The event to be added to the queue.
+     */
+    enqueueExternalEvent: (event: ExternalEvent) => void;
     /** Dequeues the next event (used by observe()). */
     dequeue(): defs.Event | undefined;
     /** Observes the form. */
-    observe(): Bluebird<any>;
+    observe(): Bluebird<defs.Event>;
     /** Loads the form. */
     load(form?: defs.Form, template?: defs.Form): boolean;
     /** Routes an event to achieve default behavior. */
@@ -216,10 +223,10 @@ export declare abstract class FormHost implements FormPresenterHost {
     private getAllSectionElements;
     private getMutuallyExclusiveSectionGroup;
     /**
-     * Collapses all neighbouring accordion sections except the one specified.
-     * @param expandedAccordionSectionName The name of the accordion section to be expanded. All others in the group will be collapsed.
+     * Collapses all neighbouring sections except the one specified.
+     * @param expandedSectionName The name of the mutually exclusive section to be expanded. All others in the group will be collapsed.
      */
-    updateAccordionSections(expandedAccordionSectionName: string): void;
-    private enforceAccordionConstraints;
+    updateMutuallyExclusiveSections(expandedSectionName: string): void;
+    private enforceMutuallyExclusiveConstraints;
     displayDialog(children: (closeDialog: () => void) => ReactNode, DialogComponent: ComponentType<any>): Promise<void>;
 }