@vertigis/workflow 5.31.0

package/esm/definition/ProgramInspector.d.ts

@@ -0,0 +1,285 @@
+import { Lookup, Dictionary, Iterator, Iterable } from "../Collections";
+import { Activity } from "./Activity";
+import { Component } from "./Component";
+import { DeploymentConfig } from "./DeploymentConfig";
+import { Form } from "./Form";
+import { Program } from "./Program";
+import { Reference } from "./Reference";
+import { Resource } from "./Resource";
+import { Step } from "./Step";
+import { Transition } from "./Transition";
+/** Contains the results of the import operation. */
+export interface ImportResults extends Lookup<Resource> {
+    start?: Step;
+}
+/** Delegates remapping of identifiers and names. */
+export interface NameIdMapper {
+    (id: number, name: string): boolean | number | string | {
+        id?: number;
+        name?: string;
+    };
+}
+/** Inspects and manipulates a Workflow program. */
+export declare class ProgramInspector {
+    /** Indicates the map of incidents. */
+    protected incidents: IncidentList;
+    /** Indicates the components being built. */
+    protected components: ComponentList;
+    /** Indicates the forms being built. */
+    protected forms: FormList;
+    /** Indicates the references being built. */
+    protected references: ReferenceList;
+    /** Indicates the steps being built. */
+    protected steps: StepList;
+    /** Indicates the transitions being built. */
+    protected transitions: TransitionList;
+    /** Indicates the program being built. */
+    program: Program;
+    /** Indicates the starting step. */
+    start: Step;
+    /** Yields a new identifier that is not currently in use. */
+    newId(nextId?: number): number;
+    /** Checks to see if the given identifier exists. */
+    exists(resource: Resource | undefined): boolean;
+    /** Retrieves the resource for the given identifier. */
+    find(id: number): Resource;
+    /** Retrieves the component for the given identifier or name. */
+    findComponent(nameId: number | string): Component;
+    /** Retrieves the form for the given identifier or name. */
+    findForm(nameId: number | string): Form;
+    /** Retrieves the reference for the given identifier or name. */
+    findReference(nameId: number | string): Reference;
+    /** Retrieves the reference for the given identifier or name. */
+    findStep(nameId: number | string): Step;
+    /** Iterates over all the assets. */
+    findTransition(nameId: number | string): Transition;
+    /** Iterates over all the assets. */
+    all(): Iterator<Resource>;
+    /** Iterates over the components. */
+    allComponents(): Iterator<Component>;
+    /** Iterates over the forms. */
+    allForms(): Iterator<Form>;
+    /** Iterates over the references. */
+    allReferences(): Iterator<Reference>;
+    /** Iterates over the steps. */
+    allSteps(): Iterator<Step>;
+    /** Iterates over the transitions. */
+    allTransitions(): Iterator<Transition>;
+    /** Adds a new component. */
+    addComponent(): Component;
+    /** Adds a new form. */
+    addForm(): Form;
+    /** Adds a reference. */
+    addReference(): Reference;
+    /** Adds a new step. */
+    addStep(): Step;
+    /** Adds a new transition. */
+    addTransition(source: Step, target: Step): Transition;
+    /** Forms a lookup cache of the components.  */
+    cacheComponents(): Lookup<Component>;
+    /** Forms a lookup cache of the forms.  */
+    cacheForms(): Lookup<Form>;
+    /** Forms a lookup cache of the references.  */
+    cacheReference(): Lookup<Reference>;
+    /** Forms a lookup cache of the steps.  */
+    cacheSteps(): Lookup<Step>;
+    /** Forms a lookup cache of the transitions.  */
+    cacheTransitions(): Lookup<Transition>;
+    /** Relates components to steps and transitions. */
+    relate(components: Iterable<Component>): Iterator<Activity>;
+    /** Relates steps to transitions. */
+    relate(steps: Iterable<Step>, branch?: boolean | number | string): Iterator<Transition>;
+    /** Relates transitions to steps. */
+    relate(transitions: Iterable<Transition>): Iterator<Step>;
+    /** Relates resources to resources. */
+    relate(member: Iterable<Resource>): Iterator<Resource>;
+    /** Removes the given resource. */
+    remove(resource: Resource, orphan?: boolean): boolean;
+    /** Removes the given resources via an iterator. */
+    remove(resources: Resource[], orphan?: boolean): number;
+    /** Removes the given resources via an iterator. */
+    remove(resources: Iterator<Resource>, orphan?: boolean): number;
+    /** Removes the given component. */
+    removeComponent(resource: Resource): boolean;
+    /** Removes the given form. */
+    removeForm(resource: Resource): boolean;
+    /** Removes the given reference. */
+    removeReference(resource: Resource): boolean;
+    /** Removes the given step. */
+    removeStep(resource: Resource): boolean;
+    /** Removes the given transition. */
+    removeTransition(resource: Resource): boolean;
+    /** Renames the given component to another identifer. */
+    shift(resource: Resource, id: number): void;
+    /** Renames the given component to another identifer. */
+    shiftComponent(resource: Resource, id: number): boolean;
+    /** Shifts the given form to another identifier. */
+    shiftForm(resource: Resource, id: number): boolean;
+    /** Shifts the given step to another identifier. */
+    shiftReference(resource: Resource, id: number): boolean;
+    /** Shifts the given step to another identifier. */
+    shiftStep(resource: Resource, id: number): boolean;
+    /** Renames the given transition to another identifier. */
+    shiftTransition(resource: Resource, id: number): boolean;
+    /** Renames the given resource. */
+    rename(resource: Resource, name: string): string;
+    /** Renames the given componnent. */
+    renameComponent(resource: Resource, name: string): boolean;
+    /** Renames the given form. */
+    renameForm(resource: Resource, name: string): boolean;
+    /** Renames the given reference. */
+    renameReference(resource: Resource, name: string): boolean;
+    /** Renames the given step. */
+    renameStep(resource: Resource, name: string): boolean;
+    /** Renames the given transition. */
+    renameTransition(resource: Resource, name: string): boolean;
+    /** Changes the starting step. */
+    changeStart(step: Step): boolean;
+    /** Changes the branch of the given step or transition. */
+    changeBranch(transition: Transition, branch: boolean | number | string): boolean;
+    /** Changes the parent of the given step or transition. */
+    changeParent(activity: Activity, parent: Component): boolean;
+    /** Changes the source of the given transition. */
+    changeSource(transition: Transition, source: Step): boolean;
+    /** Changes the target of the given transition. */
+    changeTarget(transition: Transition, target: Step): boolean;
+    /** Tests if the given resource is a component */
+    isComponent(resource: Resource | undefined): resource is Component;
+    /** Tests if the given resource is a member of the component. */
+    isParent(component: Component, resource: Resource): resource is Activity;
+    /** Tests if the given resource is a form. */
+    isForm(resource: Resource | undefined): resource is Form;
+    /** Tests if the given resource is an activity. */
+    isActivity(resource: Resource): resource is Activity;
+    /** Tests if the given resource is a reference. */
+    isReference(resource: Resource | undefined): resource is Reference;
+    /** Tests if the given resource is a step. */
+    isStep(resource: Resource | undefined): resource is Step;
+    /** Tests if the given resource is a transition. */
+    isTransition(resource: Resource | undefined): resource is Transition;
+    /** Tests if the given resource is the source for the given transition. */
+    isSource(transition: Transition, resource: Resource): resource is Step;
+    /** Tests if the given resource is the target for the given transition. */
+    isTarget(transition: Transition, resource: Resource): resource is Step;
+    /** Returns deployment configuration details. */
+    getDeploymentConfig(): DeploymentConfig;
+    /**
+     * Retrieves the default locale for the workflow.
+     */
+    getDefaultLocale(): string;
+    /**
+     * Retrieves the string lookups for the given locale.
+     * @param locale The locale of the strings to retrieve. Defaults to the invariant strings.
+     */
+    getStrings(locale?: string): Lookup<string>;
+    /** Attempts to align the underlying program with the actual state of the inspector. */
+    /** Use this to get a static view of the program (say for saving a project). */
+    realize(): void;
+    release(): void;
+    resolveStart(start?: Step | number | string): Step;
+    /**
+     * Imports a workflow program (must be pure JSON).
+     * @param program The program as JSON or as a JSON-string.
+     * @param compact Instructs the parsing to assume compact form.
+     * @param mapper Indicates how identifiers and names should get preserved.
+     */
+    import(program: Program | string, compact?: boolean, mapper?: NameIdMapper): ImportResults;
+    /** Exports the program. */
+    export(): Program;
+    /** Resets the entire state. */
+    reset(): void;
+    toJSON(): Program;
+}
+export interface Incident<TResource extends Resource> {
+    token: string;
+    master?: ResourceList<TResource, Incident<TResource>>;
+    resource?: TResource;
+}
+export declare class IncidentList extends Dictionary<Incident<Resource>> {
+    nextId: number;
+    findFor(resource: Resource | undefined): Incident<Resource>;
+    newId(): number;
+    relate(resource: Resource, branch: string): Iterable<Resource>;
+}
+export declare abstract class ResourceList<T extends Resource, TIncident extends Incident<T>> extends Dictionary<TIncident> {
+    incidents: IncidentList;
+    protected cacheLookup: Lookup<T>;
+    abstract qualify(name: string): string;
+    abstract create(): T;
+    constructor(incidents: IncidentList);
+    all(): Iterator<T>;
+    cache(): Lookup<T>;
+    findFor(resource: Resource | undefined): TIncident | undefined;
+    test(incident: Incident<Resource>): incident is TIncident;
+    findWith(nameId: number | string): T;
+    shift(incident: TIncident, id: number): void;
+    shiftFor(resource: Resource | undefined, id: number): boolean;
+    /**
+     * Renames the specified item, returning the old name.
+     * @param incident The thing to be renamed.
+     * @param name The new name.
+     */
+    rename(incident: TIncident, name: string): string;
+    renameFor(resource: Resource | undefined, name: string): boolean;
+    add(): TIncident;
+    removeFor(resource: Resource | undefined): boolean;
+    unlink(incident: Incident<Resource>): number;
+    relate(incident: Incident<Resource>, branch: string): Iterable<Resource>;
+    changeParent(this: StepList | TransitionList, incident: StepIncident | TransitionIncident, parent: ComponentIncident): void;
+}
+export interface ComponentIncident extends Incident<Component> {
+    steps?: Dictionary<StepIncident>;
+    transitions?: Dictionary<TransitionIncident>;
+}
+export declare class ComponentList extends ResourceList<Component, ComponentIncident> {
+    create(): Component;
+    qualify(name: string): string;
+    unlink(incident: ComponentIncident): number;
+    relate(incident: ComponentIncident, branch: string): Iterable<Activity>;
+}
+export declare class FormList extends ResourceList<Form, Incident<Form>> {
+    create(): Form;
+    qualify(name: string): string;
+}
+export declare class ReferenceList extends ResourceList<Reference, Incident<Reference>> {
+    create(): Reference;
+    qualify(name: string): string;
+}
+export interface StepIncident extends Incident<Step> {
+    master?: StepList;
+    parent?: ComponentIncident;
+    branches?: Lookup<Transition | Transition[]>;
+    transitions?: Dictionary<TransitionIncident>;
+}
+export declare class StepList extends ResourceList<Step, StepIncident> {
+    create(): Step;
+    qualify(name: string): string;
+    siblings(incident: ComponentIncident): Dictionary<StepIncident | TransitionIncident>;
+    unlink(incident: StepIncident): number;
+    relate(incident: StepIncident, branch: string): Iterable<Transition>;
+}
+export interface TransitionIncident extends Incident<Transition> {
+    master?: TransitionList;
+    parent?: ComponentIncident;
+    source?: StepIncident;
+    target?: StepIncident;
+}
+export declare class TransitionList extends ResourceList<Transition, TransitionIncident> {
+    create(): Transition;
+    qualify(name: string): string;
+    siblings(incident: ComponentIncident): Dictionary<StepIncident | TransitionIncident>;
+    unlink(incident: TransitionIncident): number;
+    relate(incident: TransitionIncident, branch: string): Iterable<Step>;
+}
+export declare type LocaleParts = {
+    language: string;
+    script?: string;
+    territory?: string;
+};
+/**
+ * Parses a locale code into its component parts.
+ * If the locale is invalid, nothing is returned.
+ */
+export declare function parseLocale(locale: string): LocaleParts;
+/** Converts a locale code to its canonicalized form, e.g. "de-ch" becomes "de-CH", "ZH-HANS-CN" becomes "zh-Hans-CN"). */
+export declare function canonicalizeLocale(locale: string): string;

package/esm/definition/ProgramInspector.js

@@ -0,0 +1 @@
+import{Dictionary,Iterator,Stash}from"../Collections.js";class ProgramInspector{constructor(){this.incidents=new IncidentList,this.components=new ComponentList(this.incidents),this.forms=new FormList(this.incidents),this.references=new ReferenceList(this.incidents),this.steps=new StepList(this.incidents),this.transitions=new TransitionList(this.incidents),this.program=makeBlankProgram()}newId(t){return"number"==typeof t&&(this.incidents.nextId=t),this.incidents.newId()}exists(t){return void 0!==this.incidents.findFor(t)}find(t){t=this.incidents.find(t);return void 0!==t?t.resource:void 0}findComponent(t){return this.components.findWith(t)}findForm(t){return this.forms.findWith(t)}findReference(t){return this.references.findWith(t)}findStep(t){return this.steps.findWith(t)}findTransition(t){return this.transitions.findWith(t)}all(){return iterate(this.incidents)}allComponents(){return this.components.all()}allForms(){return this.forms.all()}allReferences(){return this.references.all()}allSteps(){return this.steps.all()}allTransitions(){return this.transitions.all()}addComponent(){return this.components.add().resource}addForm(){return this.forms.add().resource}addReference(){return this.references.add().resource}addStep(){return this.steps.add().resource}addTransition(r,n){const i=this.steps.findFor(r),s=this.steps.findFor(n);if(void 0!==i&&void 0!==s){let t=i.transitions;void 0===t&&(t=i.transitions=new Dictionary);let e=s.transitions;void 0===e&&(e=s.transitions=new Dictionary);const o=this.transitions.add(),a=o.resource;return o.source=i,a.source=r,t.assign(o.token,o),o.target=s,a.target=n,e.assign(o.token,o),i.branches=void 0,a}}cacheComponents(){return this.components.cache()}cacheForms(){return this.forms.cache()}cacheReference(){return this.references.cache()}cacheSteps(){return this.steps.cache()}cacheTransitions(){return this.transitions.cache()}relate(t,e){const r=1<arguments.length?branchToToken(e):void 0;return Iterator.from(t).map(t=>this.incidents.relate(t,r))}remove(e,n){const i=this;function r(t){let e=0;!1===n&&i.isComponent(t)&&(e+=i.remove(i.relate(t)));const r=i.incidents.findFor(t);return void 0!==r&&(e+=r.master.unlink(r),i.start===r.resource&&(i.start=void 0)),e}if(Array.isArray(e)||e instanceof Iterator){let t=0;const s=Iterator.from(e);for(;s.next();)t+=r(s.current);return t}return 0<r(e)}removeComponent(t){return this.components.removeFor(t)}removeForm(t){return this.forms.removeFor(t)}removeReference(t){return this.references.removeFor(t)}removeStep(t){return!!this.steps.removeFor(t)&&(this.start===t&&(this.start=void 0),!0)}removeTransition(t){return this.transitions.removeFor(t)}shift(t,e){const r=this.incidents.findFor(t);return void 0!==r&&r.master.shift(r,e)}shiftComponent(t,e){return this.components.shiftFor(t,e)}shiftForm(t,e){return this.forms.shiftFor(t,e)}shiftReference(t,e){return this.references.shiftFor(t,e)}shiftStep(t,e){return this.steps.shiftFor(t,e)}shiftTransition(t,e){return this.transitions.shiftFor(t,e)}rename(t,e){const r=this.incidents.findFor(t);return void 0!==r?r.master.rename(r,e):void 0}renameComponent(t,e){return this.components.renameFor(t,e)}renameForm(t,e){return this.forms.renameFor(t,e)}renameReference(t,e){return this.references.renameFor(t,e)}renameStep(t,e){return this.steps.renameFor(t,e)}renameTransition(t,e){return this.transitions.renameFor(t,e)}changeStart(t){return!!this.isStep(t)&&(this.start=t,!0)}changeBranch(t,e){const r=this.transitions.findFor(t);return void 0!==r&&(r.source.branches=void 0,t.branch=void 0!==literalType(e)?e:void 0,!0)}changeParent(t,e){let r=void 0;if(r=this.steps.findFor(t),void 0===r&&(r=this.transitions.findFor(t)),void 0===r)return!1;let n=void 0;return(null==e||(n=this.components.findFor(e),void 0!==n))&&(r.master.changeParent(r,n),!0)}changeSource(t,e){const r=this.transitions.findFor(t);if(void 0===r)return!1;const n=this.steps.findFor(e);if(void 0===n)return!1;r.source.branches=void 0,r.source!==r.target&&r.source.transitions.remove(r.token);let i=n.transitions;return void 0===i&&(i=n.transitions=new Dictionary),r.source=n,t.source=e,n.branches=void 0,i.assign(r.token,r),!0}changeTarget(t,e){const r=this.transitions.findFor(t);if(void 0===r)return!1;const n=this.steps.findFor(e);if(void 0===n)return!1;r.target!==r.source&&r.target.transitions.remove(r.token);let i=n.transitions;return void 0===i&&(i=n.transitions=new Dictionary),r.target=n,t.target=e,i.assign(r.token,r),!0}isComponent(t){return void 0!==this.components.findFor(t)}isParent(t,e){return this.isActivity(e)&&e.parent===t}isForm(t){return void 0!==this.forms.findFor(t)}isActivity(t){return this.isStep(t)||this.isTransition(t)}isReference(t){return void 0!==this.references.findFor(t)}isStep(t){return void 0!==this.steps.findFor(t)}isTransition(t){return void 0!==this.transitions.findFor(t)}isSource(t,e){return this.isTransition(t)&&t.source===e}isTarget(t,e){return this.isTransition(t)&&t.target===e}getDeploymentConfig(){return this.program.deploymentConfig||{supportedApps:{}}}getDefaultLocale(){return navigator.language||navigator.userLanguage||"inv"}getStrings(t){var e,r=this.program.strings||{};t=t||this.getDefaultLocale();let n={...r.inv||{}};return"inv"===t||(t=canonicalizeLocale(t))&&(t!==(e=parseLocale(t).language)&&e in r&&(n={...n,...r[e]}),t in r&&(n={...n,...r[t]})),n}realize(){this.program.components=this.allComponents().list(),this.program.forms=this.allForms().list(),this.program.references=this.allReferences().list(),this.program.steps=this.allSteps().list(),this.program.transitions=this.allTransitions().list(),this.program.start=this.start;const t=this.allComponents();for(;t.next();)t.current.steps.length=0,t.current.transitions.length=0;const e=this.allSteps();for(;e.next();){const n=e.current;n.transitions.length=0;const i=n.parent;void 0!==i&&i.steps.push(n)}const r=this.allTransitions();for(;r.next();){const s=r.current,o=s.parent;void 0!==o&&o.transitions.push(s),s.source.transitions.push(s),s.target!==s.source&&s.target.transitions.push(s)}}release(){this.program.components.length=0,this.program.forms.length=0,this.program.references.length=0,this.program.steps.length=0,this.program.transitions.length=0,this.program.start=void 0;const t=this.allComponents();for(;t.next();)t.current.steps.length=0,t.current.transitions.length=0;const e=this.allSteps();for(;e.next();)e.current.transitions.length=0}resolveStart(t){if("number"==typeof t)return this.findStep(t);if("string"==typeof t)return this.findStep(t);if("object"!=typeof t||null===t)return this.start;var e=t.id;if("number"==typeof e)return this.findStep(e);t=t.name;return"string"==typeof t?this.findStep(t):void 0}import(t,n,s){if("object"!=typeof(t="string"==typeof t?JSON.parse(t):t)||null===t)return{};"function"!=typeof s&&(s=void 0),n=!1!==n;const i={},o={},a=this,c=new Stash;function u(t,e){copyResource(t,e);let r=t.id,n=t.name;void 0!==s&&("number"==typeof(i=s(r,n))?(r=i,n=void 0):"string"==typeof i?(r=void 0,n=i):"object"==typeof i&&null!==i?(r=i.id,n=i.name):!0!==i&&(r=void 0,n=void 0)),"number"==typeof r&&(a.shift(e,r),o[r]=e),"string"==typeof n&&a.rename(e,n);var i="number"==typeof r?"id$"+r:"auto";return c.write(i,t,e),e}function h(t,e,r){var n=e.id;if("number"!=typeof n)return u(e,r());t+=n,n=i[t];return u(e,void 0===n?i[t]=r():n)}function r(){return a.addComponent()}function d(t){const e=h("component$",t,r);return F(t.steps,t=>l(t,e)),F(t.transitions,t=>g(t,e)),e}function e(){return a.addForm()}function f(){return a.addReference()}function p(){return a.addStep()}function l(t,e){const r=h("step$",t,p);return a.changeParent(r,y(t.parent,d)||r.parent||e),F(t.transitions,t=>g(t,n?e:void 0,r)),r}const m=this.addStep();function v(){return a.addTransition(m,m)}function g(t,e,r){var n=h("transition$",t,v);a.changeParent(n,y(t.parent,d)||n.parent||e);e=n.source!==m?n.source:void 0;a.changeSource(n,y(t.source,l)||e||r);e=n.target!==m?n.target:void 0;return a.changeTarget(n,y(t.target,l)||e||r),n}function y(t,e){if(isObject(t)){var r=t.id,r="number"==typeof r?"id$"+r:"auto";return c.read(r,t)||e(t)}}function F(t,e){if(Array.isArray(t))for(const r of t)y(r,e)}copyResource(t,this.program),F(t.components,d),F(t.forms,function(t){return h("form$",t,e)}),F(t.references,function(t){return h("reference$",t,f)}),F(t.steps,l),F(t.transitions,g),o.start=y(t.start,l),void 0===s&&(this.start=o.start);let k=void 0;function L(t){return void 0===k&&(k=a.addStep(),a.changeParent(k,t)),k}const b=this.relate(m);for(;b.next();){k=void 0;var S=b.current;S.source===m&&this.changeSource(S,L(S.parent)),S.target===m&&this.changeTarget(S,L(S.parent))}return this.removeStep(m),this.realize(),o}export(){this.realize();const t=new ProgramInspector;t.import(this.program,!1);const e=t.program;e.steps=minifyArray(e.steps,function(e){return e.transitions=minifyArray(e.transitions,function(t){return t.source===e&&t.parent===e.parent&&(t.parent=void 0,t.source=void 0,t.target=t.target!==t.source?{id:t.target.id}:void 0,!0)}),void 0===e.parent}),e.transitions=minifyArray(e.transitions,function(t){return void 0===t.parent&&void 0!==t.source&&(t.source={id:t.source.id},t.target={id:t.target.id},!0)}),e.components=minifyArray(e.components,function(t){return t.steps=minifyArray(t.steps,function(t){return!(t.parent=void 0)}),t.transitions=minifyArray(t.transitions,function(t){return void 0!==t.parent&&(t.parent=void 0,t.source={id:t.source.id},t.target={id:t.target.id},!0)}),!0}),e.forms=minifyArray(e.forms),e.references=minifyArray(e.references);var r=t.start;return e.start=void 0!==r?{id:r.id}:void 0,e}reset(){this.incidents.clear(),this.components.clear(),this.forms.clear(),this.references.clear(),this.steps.clear(),this.transitions.clear(),this.incidents.nextId=1,this.program=makeBlankProgram(),this.start=void 0}toJSON(){return this.export()}}function iterate(t){return void 0===t?Iterator.empty:t.iterate().filter(function(t,e){return 0===String(e).lastIndexOf("token$",0)}).map(t=>t.resource,t=>t.id)}class IncidentList extends Dictionary{constructor(){super(...arguments),this.nextId=1}findFor(t){if(null!=t){var e=this.find(t.id);if(void 0!==e&&e.resource===t)return e}}newId(){let t=this.nextId;for(;this.exists(t);)t++;return this.nextId=t+1,t}relate(t,e){const r=this.findFor(t);return void 0!==r?r.master.relate(r,e):Iterator.empty}}class ResourceList extends Dictionary{constructor(t){super(),this.incidents=t}all(){return iterate(this)}cache(){let t=this.cacheLookup;if(void 0!==t)return t;t=this.cacheLookup={};const e=this.iterate();for(;e.next();){var r=e.current.resource,n=(t[r.id]=r).name;void 0!==n&&(t["$"+n]=r)}return t}findFor(t){t=this.incidents.findFor(t);return this.test(t)?t:void 0}test(t){return void 0!==t&&t.master===this}findWith(t){"string"==typeof t&&(t=this.qualify(t));t=this.incidents.find(t);return this.test(t)?t.resource:void 0}shift(t,e){this.incidents.remove(t.resource.id),"number"!=typeof e&&(e=this.incidents.newId());const r=this.incidents.assign(t.resource.id=e,t);void 0!==r&&this.incidents.assign(r.resource.id=this.incidents.newId(),r),this.cacheLookup=void 0}shiftFor(t,e){t=this.findFor(t);return void 0!==t&&(this.shift(t,e),!0)}rename(t,e){var r=t.resource.name;if(void 0!==r&&this.incidents.remove(this.qualify(r)),"string"==typeof e){e=this.qualify(t.resource.name=e);const n=this.incidents.assign(e,t);void 0!==n&&(n.resource.name=void 0)}else t.resource.name=void 0;return this.cacheLookup=void 0,r}renameFor(t,e){t=this.findFor(t);return void 0!==t&&(this.rename(t,e),!0)}add(){const t={},e=t.resource=this.create();return t.token=generateToken(),t.master=this,e.id=this.incidents.newId(),this.assign(t.token,t),this.incidents.assign(e.id,t),this.cacheLookup=void 0,t}removeFor(t){t=this.findFor(t);return void 0!==t&&(this.unlink(t),!0)}unlink(t){this.remove(t.token),this.cacheLookup=void 0;var e=t.resource.id;this.incidents.remove(e);t=t.resource.name;return void 0!==t&&this.incidents.remove(this.qualify(t)),1}relate(t,e){return Iterator.empty}changeParent(t,e){var r=t.parent;void 0!==r&&this.siblings(r).remove(t.token),void 0!==e?(t.parent=e,t.resource.parent=e.resource,this.siblings(e).assign(t.token,t)):(t.parent=void 0,t.resource.parent=void 0)}}class ComponentList extends ResourceList{create(){return{steps:[],transitions:[]}}qualify(t){return"component$"+t}unlink(t){super.unlink(t);const e=t.steps;if(void 0!==e){const n=e.iterate();for(;n.next();)n.current.resource.parent=void 0}const r=t.transitions;if(void 0!==r){const i=r.iterate();for(;i.next();)i.current.resource.parent=void 0}return 1}relate(t,e){const r=iterate(t.steps);t=iterate(t.transitions);return r.concat(t)}}class FormList extends ResourceList{create(){return{defaults:{},elements:{}}}qualify(t){return"form$"+t}}class ReferenceList extends ResourceList{create(){return{}}qualify(t){return"reference$"+t}}class StepList extends ResourceList{create(){return{inputs:{},transitions:[]}}qualify(t){return"activity$"+t}siblings(t){return t.steps||(t.steps=new Dictionary)}unlink(t){let e=super.unlink(t);void 0!==t.parent&&t.parent.steps.remove(t.token);const r=t.transitions;if(void 0!==r){const n=r.iterate();for(;n.next();)e+=n.current.master.unlink(n.current)}return e}relate(t,e){var r=t.transitions;if(void 0===r)return Iterator.empty;if(void 0===e)return iterate(r);let n=t.branches;if(void 0===n){n=t.branches={};for(const s of iterate(r).list().sort(compareTransitions))if(s.source===t.resource){var i=branchToToken(s.branch);const o=n[i];void 0===o?n[i]=s:Array.isArray(o)?o.push(s):n[i]=[o,s]}}return n[e]||Iterator.empty}}class TransitionList extends ResourceList{create(){return{inputs:{}}}qualify(t){return"activity$"+t}siblings(t){return t.transitions||(t.transitions=new Dictionary)}unlink(t){return super.unlink(t),t.source.branches=void 0,t.source.transitions.remove(t.token),t.target.transitions.remove(t.token),void 0!==t.parent&&t.parent.transitions.remove(t.token),1}relate(t,e){return t.source!==t.target?[t.source.resource,t.target.resource]:t.source.resource}}const safeProps={id:!1,name:!1,components:!1,forms:!1,references:!1,steps:!1,transitions:!1,start:!1,parent:!1,source:!1,target:!1};function copyResource(t,e){for(const r in t)!1!==safeProps[r]&&(e[r]=deepClone(t[r]))}function deepClone(t){if(null!=t){if(Array.isArray(t))return t.map(deepClone);if("object"!=typeof t)return t;{const r={};for(const n in t){var e=t[n];null!=e&&(r[n]=e)}return r}}}function isObject(t){return!Array.isArray(t)&&("object"==typeof t&&null!==t)}function makeBlankProgram(){return{components:[],forms:[],references:[],steps:[],transitions:[]}}function minifyArray(e,r){let n=0;for(let t=0;t<e.length;t++){var i=e[t];void 0!==r&&!r(i)||(e[n++]=i)}return e.length=n,0<e.length?e:void 0}function literalType(t){var e=typeof t;switch(e){case"boolean":case"number":case"string":return e}}function branchToToken(t){var e=literalType(t);return void 0!==e?e+"$"+t:"blank"}function hasInputs(t){for(const e in t)return!0;return!1}function compareTransitions(t,e){return"number"==typeof t.rank?"number"!=typeof e.rank||t<e?-1:e<t?1:0:"number"==typeof e.rank?1:hasInputs(t)?hasInputs(e)?0:-1:hasInputs(e)?1:0}const generateToken=function(){let t,e;function r(){t=0,e="token$"+(new Date).valueOf()+"$"}r();return function(){return 1073741824<=t&&r(),e+t++}}();function parseLocale(t){if("string"==typeof t){const e=t.split("-");if(!(e.length<1||3<e.length||e.some(t=>0===t.length))){const r={language:e[0].toLowerCase()};return 2==e.length?2==e[1].length?r.territory=e[1].toUpperCase():r.script=e[1][0].toUpperCase()+e[1].slice(1).toLowerCase():3===e.length&&(r.script=e[1][0].toUpperCase()+e[1].slice(1).toLowerCase(),r.territory=e[2].toUpperCase()),r}}}function canonicalizeLocale(e){e=parseLocale(e);if(e){let t=e.language;return e.script&&(t+="-"+e.script),e.territory&&(t+="-"+e.territory),t}}export{ProgramInspector,IncidentList,ResourceList,ComponentList,FormList,ReferenceList,StepList,TransitionList,parseLocale,canonicalizeLocale};

package/esm/definition/Reference.d.ts

@@ -0,0 +1,8 @@
+import { Resource } from "./Resource";
+/** Defines a reference for w workflow. */
+export interface Reference extends Resource {
+    /** Indicates the suite to load. */
+    suite?: string;
+    /** Indicates the location of the source code to load. */
+    path?: string;
+}

package/esm/definition/Resource.d.ts

@@ -0,0 +1,26 @@
+/** Defines the resource for a program. */
+export interface Resource {
+    /** Indicates the identifier of the resource for id-based lookups. */
+    id?: number;
+    /** Indicates the name of the resource for name-based lookups. */
+    name?: string;
+    /** Indicates the label for annotation of the resource on a design surface. */
+    title?: string;
+    /** Indicates the description for annotation of the resource on a design surface. */
+    description?: string;
+    /** Indicates the position of the resource on a design surface. */
+    position?: string;
+    /** Indicates the look of the resource on a design surface. */
+    look?: string;
+    /** Indicates the purpose of the resource on a design surface. */
+    purpose?: string;
+    /** Information about how the program is licensed. */
+    licenseInfo?: {
+        /** The ID of the licensee that created the program. */
+        licenseeId?: string;
+        /** The url of the license endpoint for on-premises workflows. */
+        licenseUrl?: string;
+    };
+    /** The version of VertiGIS Studio Workflow Designer used to create this workflow. */
+    designerVersion?: string;
+}

package/esm/definition/Step.d.ts

@@ -0,0 +1,9 @@
+import { Activity } from "./Activity";
+import { Transition } from "./Transition";
+/** Describes a step in a workflow. */
+export interface Step extends Activity {
+    /** Indicates the activity should be consumed asynchronously. */
+    async?: boolean;
+    /** Indicates the full list of transitions to or from this step. */
+    transitions?: Transition[];
+}

package/esm/definition/Transition.d.ts

@@ -0,0 +1,17 @@
+import { Activity } from "./Activity";
+import { Step } from "./Step";
+/** Defines a transition. */
+export interface Transition extends Activity {
+    /** Indicates the branch of that the transition participates in. */
+    branch?: boolean | number | string;
+    /** Indicates the source of this transition (what was previous). */
+    source?: Step;
+    /** Indicates the target of this transition (what is next). */
+    target?: Step;
+    /** Indicates the precedence for this transition. */
+    rank?: number;
+    /** Indicates the type of connector for the source on a design surface. */
+    sourceConnector?: string;
+    /** Indicates the type of connector for the target on a design surface. */
+    targetConnector?: string;
+}