@mtna/web-form-angular 0.0.1

package/lib/_index.scss

@@ -0,0 +1,25 @@
+// Theme bundles
+@forward './lib/core/all-color' show all-component-colors;
+@forward './lib/core/all-theme' show all-component-themes;
+@forward './lib/core/all-typography' show all-component-typographies;
+
+// Component themes
+@forward './lib/form-item-controls/date-item-theme' as date-item-* show date-item-theme, date-item-color, date-item-typography;
+@forward './lib/form-item-controls/form-control-theme' as form-control-* show form-control-theme, form-control-color,
+form-control-typography;
+@forward './lib/form-item-controls/year-quarter-item-theme' as year-quarter-item-* show year-quarter-item-theme,
+year-quarter-item-color, year-quarter-item-typography;
+@forward './lib/form-stepper/form-step-group-theme' as form-step-group-* show form-step-group-theme, form-step-group-color,
+form-step-group-typography;
+@forward './lib/form-stepper/form-stepper-theme' as form-stepper-* show form-stepper-theme, form-stepper-color,
+form-stepper-typography;
+@forward './lib/groups/checkbox-theme' as checkbox-* show checkbox-theme, checkbox-color, checkbox-typography;
+@forward './lib/groups/form-group-theme' as form-group-* show form-group-theme, form-group-color, form-group-typography;
+@forward './lib/groups/multiple-choice-theme' as multiple-choice-* show multiple-choice-theme, multiple-choice-color,
+multiple-choice-typography;
+@forward './lib/groups/repeatable-item-theme' as repeatable-item-* show repeatable-item-theme, repeatable-item-color,
+repeatable-item-typography;
+@forward './lib/item-header/item-header-theme' as item-header-* show item-header-theme, item-header-color, item-header-typography;
+@forward './lib/step-card/step-card-theme' as step-card-* show step-card-theme, step-card-color, step-card-typography;
+
+@forward './lib/core/core-theme' as core-* show core-theme;

package/lib/core/_all-color.scss

@@ -0,0 +1,25 @@
+@use '../form-item-controls/date-item-theme';
+@use '../form-item-controls/form-control-theme';
+@use '../form-item-controls/year-quarter-item-theme';
+@use '../form-stepper/form-step-group-theme';
+@use '../form-stepper/form-stepper-theme';
+@use '../groups/checkbox-theme';
+@use '../groups/form-group-theme';
+@use '../groups/multiple-choice-theme';
+@use '../groups/repeatable-item-theme';
+@use '../item-header/item-header-theme';
+@use '../step-card/step-card-theme';
+
+@mixin all-component-colors($theme) {
+  @include checkbox-theme.color($theme);
+  @include date-item-theme.color($theme);
+  @include form-control-theme.color($theme);
+  @include form-group-theme.color($theme);
+  @include form-step-group-theme.color($theme);
+  @include form-stepper-theme.color($theme);
+  @include item-header-theme.color($theme);
+  @include multiple-choice-theme.color($theme);
+  @include repeatable-item-theme.color($theme);
+  @include step-card-theme.color($theme);
+  @include year-quarter-item-theme.color($theme);
+}

package/lib/core/_all-theme.scss

@@ -0,0 +1,28 @@
+@use '../form-item-controls/date-item-theme';
+@use '../form-item-controls/form-control-theme';
+@use '../form-item-controls/year-quarter-item-theme';
+@use '../form-stepper/form-step-group-theme';
+@use '../form-stepper/form-stepper-theme';
+@use '../groups/checkbox-theme';
+@use '../groups/form-group-theme';
+@use '../groups/multiple-choice-theme';
+@use '../groups/repeatable-item-theme';
+@use '../item-header/item-header-theme';
+@use '../step-card/step-card-theme';
+
+@use './core-theme';
+
+@mixin all-component-themes($theme) {
+  @include checkbox-theme.theme($theme);
+  @include core-theme.theme($theme);
+  @include date-item-theme.theme($theme);
+  @include form-control-theme.theme($theme);
+  @include form-group-theme.theme($theme);
+  @include form-step-group-theme.theme($theme);
+  @include form-stepper-theme.theme($theme);
+  @include item-header-theme.theme($theme);
+  @include multiple-choice-theme.theme($theme);
+  @include repeatable-item-theme.theme($theme);
+  @include step-card-theme.theme($theme);
+  @include year-quarter-item-theme.theme($theme);
+}

package/lib/core/_all-typography.scss

@@ -0,0 +1,25 @@
+@use '../form-item-controls/date-item-theme';
+@use '../form-item-controls/form-control-theme';
+@use '../form-item-controls/year-quarter-item-theme';
+@use '../form-stepper/form-step-group-theme';
+@use '../form-stepper/form-stepper-theme';
+@use '../groups/checkbox-theme';
+@use '../groups/form-group-theme';
+@use '../groups/multiple-choice-theme';
+@use '../groups/repeatable-item-theme';
+@use '../item-header/item-header-theme';
+@use '../step-card/step-card-theme';
+
+@mixin all-component-typographies($theme) {
+  @include checkbox-theme.typography($theme);
+  @include date-item-theme.typography($theme);
+  @include form-control-theme.typography($theme);
+  @include form-group-theme.typography($theme);
+  @include form-step-group-theme.typography($theme);
+  @include form-stepper-theme.typography($theme);
+  @include item-header-theme.typography($theme);
+  @include multiple-choice-theme.typography($theme);
+  @include repeatable-item-theme.typography($theme);
+  @include step-card-theme.typography($theme);
+  @include year-quarter-item-theme.typography($theme);
+}

package/lib/core/_core-theme.scss

@@ -0,0 +1,43 @@
+@use 'sass:map';
+@use '~@angular/material' as mat;
+
+@mixin theme($theme) {
+  $config: mat.get-color-config($theme);
+  $background: map.get($config, background);
+  $foreground: map.get($config, foreground);
+
+  mtna-wf-item .mat-list-base {
+    padding-top: 0;
+  }
+
+  .mtna-wf-title-item {
+    color: mat.get-color-from-palette($foreground, secondary-text);
+  }
+
+  /* Date item disabled appearence when fieldset is disabled */
+  mtna-form form fieldset[disabled] .mtna-wf-item .mtna-wf-date-item .mat-form-field.mat-form-field-appearance-outline {
+    .mat-form-field-flex {
+      & .mat-form-field-outline,
+      & .mat-form-field-outline-thick {
+        color: mat.get-color-from-palette($background, disabled-button);
+      }
+    }
+    .mat-form-field-suffix .mat-datepicker-toggle .mat-icon-button {
+      color: mat.get-color-from-palette($background, disabled-button);
+    }
+  }
+
+  .mtna-wf-title-item {
+    font-size: 1rem;
+    font-weight: 400;
+    letter-spacing: 1px;
+    line-height: 32px;
+    text-transform: uppercase;
+  }
+
+  mtna-wf-section .mtna-wf-title-item {
+    font-size: 0.875rem;
+    line-height: 28px;
+    font-weight: 500;
+  }
+}

package/lib/core/animations.d.ts

@@ -0,0 +1,2 @@
+export declare const COMPLEX_STANDARD = "300ms cubic-bezier(0.4, 0.0, 0.2, 1)";
+export declare const MTNA_WF_EXPAND_COLLAPSE: import("@angular/animations").AnimationTriggerMetadata;

package/lib/core/api-config.d.ts

@@ -0,0 +1,5 @@
+import { InjectionToken } from '@angular/core';
+export interface MtnaWfApiConfig {
+    baseUrl: string;
+}
+export declare const MTNA_WF_API_TOKEN: InjectionToken<MtnaWfApiConfig>;

package/lib/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from './animations';
+export * from './api-config';
+export * from './pipes/index';
+export * from './services/index';
+export * from './utilities/index';
+export * from './validators/index';

package/lib/core/pipes/coerce-date-item.pipe.d.ts

@@ -0,0 +1,11 @@
+import { PipeTransform } from '@angular/core';
+import { DateItem, ValueItem } from '@mtna/web-form-ts';
+import { GetObjectTypePipe } from './get-object-type.pipe';
+import * as i0 from "@angular/core";
+export declare class CoerceDateItemPipe implements PipeTransform {
+    private objectTypePipe;
+    constructor(objectTypePipe: GetObjectTypePipe);
+    transform(item: ValueItem<unknown> | undefined | null): DateItem | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CoerceDateItemPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<CoerceDateItemPipe, "coerceDateItem">;
+}

package/lib/core/pipes/coerce-form-group.pipe.d.ts

@@ -0,0 +1,23 @@
+import { PipeTransform } from '@angular/core';
+import { AbstractControl, FormGroup } from '@angular/forms';
+import * as i0 from "@angular/core";
+/**
+ * Asserts whether the given control is the narrower FormGroup type. If so, coerces the FormGroup type.
+ * Otherwise, returns null.
+ *
+ * @example
+ * <form [formGroup]="group | mtnaWfCoerceFormGroup"></form>
+ *
+ * <form *ngIf="controlContainer.control | mtnaWfCoerceFormGroup as group" [formGroup]="group"></form>
+ *
+ * @author Chase Moore <chase.moore@mtna.us>
+ */
+export declare class MtnaWfCoerceFormGroupPipe implements PipeTransform {
+    /**
+     * @param control control to be coerced into a FormGroup
+     * @returns the control typed as FormGroup if possible; else null
+     */
+    transform(control: AbstractControl | null | undefined): FormGroup | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MtnaWfCoerceFormGroupPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<MtnaWfCoerceFormGroupPipe, "mtnaWfCoerceFormGroup">;
+}

package/lib/core/pipes/date-quarter.pipe.d.ts

@@ -0,0 +1,7 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class DateQuarterPipe implements PipeTransform {
+    transform(quarter: 0 | 1 | 2 | 3, format?: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DateQuarterPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<DateQuarterPipe, "mtnaWfDateQuarter">;
+}

package/lib/core/pipes/get-auto-complete.pipe.d.ts

@@ -0,0 +1,7 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class GetAutoCompletePipe implements PipeTransform {
+    transform(label: string | null | undefined): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GetAutoCompletePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<GetAutoCompletePipe, "getAutoComplete">;
+}

package/lib/core/pipes/get-available-quarters.pipe.d.ts

@@ -0,0 +1,8 @@
+import { PipeTransform } from '@angular/core';
+import { DateRange, YearQuarter } from '@mtna/web-form-ts';
+import * as i0 from "@angular/core";
+export declare class MtnaWfGetAvailableQuartersPipe implements PipeTransform {
+    transform(year: number | null | undefined, limits: DateRange<YearQuarter> | null | undefined): number[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<MtnaWfGetAvailableQuartersPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<MtnaWfGetAvailableQuartersPipe, "mtnaWfGetQuarters">;
+}

package/lib/core/pipes/get-form-control-error.pipe.d.ts

@@ -0,0 +1,14 @@
+import { PipeTransform } from '@angular/core';
+import { FormItemImpl } from '@mtna/web-form-ts';
+import { MtnaWfUIService } from '../services/ui.service';
+import * as i0 from "@angular/core";
+export declare class MtnaGetFormControlErrorPipe implements PipeTransform {
+    private uiService;
+    constructor(uiService: MtnaWfUIService);
+    transform(error: {
+        key: string;
+        value: unknown;
+    }, item?: FormItemImpl<unknown>): unknown;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MtnaGetFormControlErrorPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<MtnaGetFormControlErrorPipe, "mtnaWfGetControlError">;
+}

package/lib/core/pipes/get-list-icon.pipe.d.ts

@@ -0,0 +1,7 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class GetListIconPipe implements PipeTransform {
+    transform(header: string | null | undefined): string | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GetListIconPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<GetListIconPipe, "getListIcon">;
+}

package/lib/core/pipes/get-object-type.pipe.d.ts

@@ -0,0 +1,7 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class GetObjectTypePipe implements PipeTransform {
+    transform(id: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GetObjectTypePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<GetObjectTypePipe, "getObjectType">;
+}

package/lib/core/pipes/get-selected-option.pipe.d.ts

@@ -0,0 +1,8 @@
+import { PipeTransform } from '@angular/core';
+import { FormOptionSelector, StringOption } from '@mtna/web-form-ts';
+import * as i0 from "@angular/core";
+export declare class MtnaWfGetSelectedOptionNamePipe implements PipeTransform {
+    transform(id: string, options: FormOptionSelector<StringOption>[]): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MtnaWfGetSelectedOptionNamePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<MtnaWfGetSelectedOptionNamePipe, "mtnaWfGetSelectedOptionName">;
+}

package/lib/core/pipes/index.d.ts

@@ -0,0 +1,28 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./coerce-date-item.pipe";
+import * as i2 from "./date-quarter.pipe";
+import * as i3 from "./get-auto-complete.pipe";
+import * as i4 from "./get-list-icon.pipe";
+import * as i5 from "./get-object-type.pipe";
+import * as i6 from "./get-form-control-error.pipe";
+import * as i7 from "./coerce-form-group.pipe";
+import * as i8 from "./get-available-quarters.pipe";
+import * as i9 from "./get-selected-option.pipe";
+import * as i10 from "./items-with-value.pipe";
+import * as i11 from "./sanitize-html.pipe";
+export declare class PipesModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<PipesModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PipesModule, [typeof i1.CoerceDateItemPipe, typeof i2.DateQuarterPipe, typeof i3.GetAutoCompletePipe, typeof i4.GetListIconPipe, typeof i5.GetObjectTypePipe, typeof i6.MtnaGetFormControlErrorPipe, typeof i7.MtnaWfCoerceFormGroupPipe, typeof i8.MtnaWfGetAvailableQuartersPipe, typeof i9.MtnaWfGetSelectedOptionNamePipe, typeof i10.MtnaWfItemsWithValuePipe, typeof i11.MtnaWfSanitizeHtmlPipe], never, [typeof i1.CoerceDateItemPipe, typeof i2.DateQuarterPipe, typeof i3.GetAutoCompletePipe, typeof i4.GetListIconPipe, typeof i5.GetObjectTypePipe, typeof i6.MtnaGetFormControlErrorPipe, typeof i7.MtnaWfCoerceFormGroupPipe, typeof i8.MtnaWfGetAvailableQuartersPipe, typeof i9.MtnaWfGetSelectedOptionNamePipe, typeof i10.MtnaWfItemsWithValuePipe, typeof i11.MtnaWfSanitizeHtmlPipe]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<PipesModule>;
+}
+export * from './coerce-date-item.pipe';
+export * from './coerce-form-group.pipe';
+export * from './date-quarter.pipe';
+export * from './get-auto-complete.pipe';
+export * from './get-available-quarters.pipe';
+export * from './get-form-control-error.pipe';
+export * from './get-list-icon.pipe';
+export * from './get-object-type.pipe';
+export * from './get-selected-option.pipe';
+export * from './items-with-value.pipe';
+export * from './sanitize-html.pipe';

package/lib/core/pipes/items-with-value.pipe.d.ts

@@ -0,0 +1,13 @@
+import { PipeTransform } from '@angular/core';
+import { FormItem, ValueItem } from '@mtna/web-form-ts';
+import * as i0 from "@angular/core";
+/**
+ * Returns an array of FormItems that contain a value.
+ * Use only for readonly forms
+ */
+export declare class MtnaWfItemsWithValuePipe implements PipeTransform {
+    itemsCache: Array<ValueItem<unknown>>;
+    transform(items: Array<FormItem> | null | undefined): Array<ValueItem<unknown>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MtnaWfItemsWithValuePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<MtnaWfItemsWithValuePipe, "mtnaWfItemsWithValue">;
+}

package/lib/core/pipes/sanitize-html.pipe.d.ts

@@ -0,0 +1,10 @@
+import { PipeTransform } from '@angular/core';
+import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
+import * as i0 from "@angular/core";
+export declare class MtnaWfSanitizeHtmlPipe implements PipeTransform {
+    private _sanitizer;
+    constructor(_sanitizer: DomSanitizer);
+    transform(v: string | null | undefined): SafeHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MtnaWfSanitizeHtmlPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<MtnaWfSanitizeHtmlPipe, "mtnaWfSanitizeHtml">;
+}

package/lib/core/services/api.service.d.ts

@@ -0,0 +1,41 @@
+import { HttpClient, HttpResponse } from '@angular/common/http';
+import { Form as WebForm, FormItemImpl, Template, TemplateItem, TemplateSectionImpl } from '@mtna/web-form-ts';
+import { Observable } from 'rxjs';
+import { MtnaWfApiConfig } from '../api-config';
+import * as i0 from "@angular/core";
+export declare class MtnaWfApiService {
+    protected apiConfig: MtnaWfApiConfig;
+    protected http: HttpClient;
+    API_URL: string;
+    FORM_URL: string;
+    TEMPLATE_URL: string;
+    NEW_TEMPLATE_URL: string;
+    NEW_SECTION_URL: string;
+    ITEMS_URL: string;
+    ITEM_INSTANCE_URL: string;
+    TEMPLATE_SAVE_URL: string;
+    TEMPLATE_DELETE_URL: string;
+    ALL_TEMPLATES_URL: string;
+    constructor(apiConfig: MtnaWfApiConfig, http: HttpClient);
+    /**
+     * Download a web form
+     * @param form the web form pojo to download
+     * @returns Full HttlReponse with the Blob as the body
+     */
+    downloadForm(form: WebForm): Observable<HttpResponse<Blob>>;
+    /**
+     * Returns a new repeatable FormItem
+     * @param formInstanceId template ID of the mtna form
+     * @param itemId repeatableTemplateId of the requesting RepeatableItem
+     */
+    getRepeatableItem(formInstanceId: string, itemId: string): Observable<FormItemImpl<unknown>>;
+    getNewTemplate(): Observable<Template>;
+    getAllTemplate(): Observable<Template>;
+    getNewSection(): Observable<TemplateSectionImpl>;
+    getItems(): Observable<TemplateItem[]>;
+    getTemplateItem(id: string): Observable<TemplateItem>;
+    saveTemplate(): Observable<Template>;
+    getDeleteTemplate(): Observable<Template>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MtnaWfApiService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MtnaWfApiService>;
+}

package/lib/core/services/form-manager.service.d.ts

@@ -0,0 +1,184 @@
+import { Type } from '@angular/core';
+import { AbstractControl } from '@angular/forms';
+import { ConditionChange, Form, FormItem, FormItemGroup, FormItemImpl, FormItemValidationResult, MtnaWfFormItemChange, MtnaWfFormItemChangeAction, RepeatableItem, Section, ValueItem } from '@mtna/web-form-ts';
+import { Observable, Subject } from 'rxjs';
+import { MtnaWfApiService } from './api.service';
+import { MtnaWfNgFormService } from './ng-form.service';
+import { MtnaWfUIService } from './ui.service';
+import type { BaseFormItem } from '../../form';
+import * as i0 from "@angular/core";
+/**
+ * Allows a caller to (de)serializae an MtnaForm. It contains the determining logic for returning specific form controls
+ * and deserializing new MtnaForms from the reactive values, as well as registering custom Form Items & functions.
+ *
+ * @export
+ */
+export declare class MtnaWfManagerService {
+    protected apiService: MtnaWfApiService;
+    protected ngFormManager: MtnaWfNgFormService;
+    protected uiService: MtnaWfUIService;
+    protected components: Map<string, Type<BaseFormItem>>;
+    protected formChange$: Subject<Form>;
+    /** A map of all {@link FormItemValidationResult} keyed on id */
+    protected _formItemValidationResults: Record<string, FormItemValidationResult>;
+    /** ConditionChanges on 'add' must wait until the form rerenders to toggle items */
+    protected itemToggleQue: Array<ConditionChange> | null | undefined;
+    protected _mtnaForm: Form | undefined;
+    /**
+     * Observable stream of MtnaForm changes. Used to inform a subscriber that an MtnaForm has been changed.
+     *
+     * @returns Observable<MtnaForm> to which a caller can subscribe
+     */
+    get formChanges(): Observable<Form>;
+    constructor(apiService: MtnaWfApiService, ngFormManager: MtnaWfNgFormService, uiService: MtnaWfUIService);
+    /**
+     * Adds or removes a FormItem from the form & modifies other affected FormItems
+     * @param change MtnaWfFormItemChange
+     */
+    changeMtnaFormItem(change: MtnaWfFormItemChange): void;
+    /**
+     * Returns a ConditionChange array for items existing in the <item> which enable/disable FormItems outside the <item>'s scope.
+     * @param item FormItem that effects the condition of other FormItems
+     * @param action Whether this item was added (ADD), or removed (REMOVE)
+     * @returns Array<ConditionChange>
+     */
+    generateConditionChangeArray(item: FormItem, action?: MtnaWfFormItemChangeAction): Array<ConditionChange>;
+    /** @returns The top level validation results (usually the errors), keyed on ID. */
+    getFormItemValidationResults(): Record<string, FormItemValidationResult>;
+    /**
+     * Returns a new MtnaForm using the previous MtnaForm & reactive form values.
+     *
+     * @param mtnaForm MtnaForm requiring value insertion
+     * @param ngFormValues JSON object of  ngForm values
+     * @returns new MtnaForm
+     */
+    insertNewValues(mtnaForm: Form, ngFormValues: Record<string, unknown>): Form;
+    /**
+     * Serializes a Form | FormItem into FormControl(s)
+     *
+     * @param item Form | FormItem requiring serialization
+     * @returns FormGroup | FormControl
+     */
+    serializeMtnaFormItem(item: Form | FormItemImpl<unknown>): AbstractControl | null;
+    getDynamicComponent(id: string): Type<BaseFormItem> | undefined;
+    /**
+     * Registers a map of components to be dynamically rendered inside an MtnaForm.
+     *
+     * @param components the map of components that a ValueItem will use for rendering
+     * @prop string - the type(itemId suffix) of component, used for retrieval
+     * @prop Type - the component to be rendered, an extension of BaseFormItem
+     */
+    registerDynamicComponents(components: Map<string, Type<BaseFormItem>>): void;
+    /**
+     * Sets an MtnaForm on the service
+     * @param form MtnaForm to be used for internal modification
+     */
+    setMtnaForm(form: Form): void;
+    /**
+     * Any FormService extension class should override this method in order to call the
+     * dynamicWebFormItemBuilder/dynamicReactiveFormControlBuilder methods. During web form generation, this method is checked &
+     * the current FormItem is passed in, which can be used by the overriding method.
+     *
+     * @example dynamicFormConditional = (item: FormItem) => item.itemId.includes({some itemId})
+     *
+     */
+    protected dynamicFormConditional: (item: FormItem) => boolean;
+    /**
+     * Function to be overridden by extended service in order to handle form generation for any application-specific dynamic form components.
+     * Should return a new ValueItem<any>.
+     * Step 3
+     *
+     * @example dynamicWebFormItemBuilder(section: Section | Form, item: FormItem, ngFormValue: any): ValueItem {
+     * const newValue = this.generateNewValue(item, rfValue, section);
+     * return { ...item, ...newValue }
+     * }
+     * @param section the current FormSection
+     * @param item the current FormItem
+     * @param ngFormValue the ngForm JSON value
+     * @returns a new ValueItem
+     */
+    protected dynamicWebFormItemBuilder(section: Form | FormItemGroup | RepeatableItem | undefined, item: FormItem, ngFormValue: unknown, disabledState?: {
+        [instanceId: string]: boolean;
+    }): ValueItem<unknown> | null;
+    /**
+     * Function to be overridden by extended service in order to handle reactive form generation
+     * for any application-specific dynamic form components.
+     * Should return FormControl | FormGroup.
+     *
+     * @example dynamicReactiveFormControlBuilder(item: FormItem) {
+     * return this.buildFormControlForDynamicComponent(item: FormItem);
+     * }
+     * @param item FormItem used to generate form controls
+     * @returns FormControl | FormGroup
+     */
+    protected dynamicReactiveFormControlBuilder(item: FormItem): AbstractControl | null;
+    /**
+     * Recursively traverses a Form to insert or remove a designated FormItem.
+     * @param item MtnaForm to search through
+     * @param change: MtnaWfFormItemChange for adding or removing a FormItem
+     * @param newItem FormItem to add to its parent
+     */
+    protected _modifyFormItem<I extends Form | Section | FormItem | FormItemImpl<unknown>>(item: I, change: MtnaWfFormItemChange, newItem?: FormItem): Form | Section | FormItem | FormItemImpl<unknown>;
+    /**
+     * Traverses an OptionItemMap of a FormItem to insert or remove a designated FormItem
+     * @param optionItem FormItem with an optionItemMap, e.g. OptionItemImpl | OptionGroupItemImpl
+     * @param change MtnaWfFormItemChange for adding or removing a FormItem
+     * @param newItem FormItem to be added to its parent
+     * @returns FormItem with an optionItemMap containing FormItems
+     */
+    private _modifyOptionItem;
+    /**
+     * Traverses table rows to insert or remove a FormItem
+     * @param tableItem TableItem to traverse
+     * @param change MtnaWfFormItemChange for adding or removing a FormItem
+     * @param newItem FormItem to be added to its parent
+     * @returns TableItem with a FormItem added or removed
+     */
+    private _modifyTableItem;
+    /**
+     * Adds or removes instanceIds from the 'itemIds' in a FormItem's condition
+     * @param form MtnaForm to search through & replace formitems with the new condition
+     * @param change The change that recently occurred in the mtnaForm
+     */
+    private _modifyFormItemConditions;
+    /**
+     * Builds a map of all instanceIds inside an item. Checks 'items' & 'optionItemMap'
+     * @param item Item to recurse
+     * @param idMap map of the item's internal instanceIds
+     */
+    private _buildInternalIdsMap;
+    /**
+     * Builds an array of ConditionChanges to be implemented in an MtnaForm.
+     * @param item FormItem that was added/removed, which affects conditions of other FormItems
+     * @param changes Array to build up
+     * @param internalIdMap Map of all instanceIds located in the item; in order to exclude them from the condition changes
+     * @param action Whether the item was added or removed
+     */
+    private _buildConditionChangeArray;
+    /**
+     * Builds an array of ConditionChanges from an item's optionItemMap
+     * @param item FormItem with an optionItemMap
+     * @param conditions Array of ConditionChanges to push on new changes
+     * @param itemMap map of instanceIds exisiting in an item; in order to exclude them from the changes
+     * @param action Whether an item was added or removed
+     */
+    private _buildArrayFromOptionItemMap;
+    /**
+     * Pushes a new ConditionChange onto the conditions array. If a ConditionChange with matching id exists,
+     * it merges the new values into it
+     * @param enablerId instanceId of the item that enables other FormItems
+     * @param enabled the item's 'enabledItems' array
+     * @param disabled the item's 'disabledItems' array
+     * @param conditions Array of ConditionChanges to build up
+     * @param itemMap map of instanceIds inside an item; to ensure no internal ids are included in a change
+     * @param enable Whether the 'enabledItems' should toggled enabled
+     */
+    private _pushConditionToArray;
+    /**
+     * Store all validation errors on the service.
+     * Revalidate form controls that previously had errors or have new errors now.
+     */
+    private _updateServerSideErrors;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MtnaWfManagerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MtnaWfManagerService>;
+}

package/lib/core/services/index.d.ts

@@ -0,0 +1,4 @@
+export * from './api.service';
+export * from './form-manager.service';
+export * from './ng-form.service';
+export * from './ui.service';

package/lib/core/services/ng-form.service.d.ts

@@ -0,0 +1,76 @@
+import { AbstractControl, FormGroup } from '@angular/forms';
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+export declare class MtnaWfNgFormService {
+    private ngForm;
+    private unsavedChanges$;
+    private valueChangeSubscription;
+    /**
+     * Informs a caller when the MtnaForm is dirty and has unsaved changes.
+     */
+    get unsavedChanges(): Observable<boolean>;
+    /**
+     * Add a control from the ngForm
+     * @param controlId id of the control being added
+     * @param parentIds array of ids representing the path to the parent control
+     * @param newControl the new form control to be added
+     */
+    addControl(controlId: string, parentIds: string[], newControl: AbstractControl): void;
+    /**
+     * Remove a control from the ngForm.
+     *
+     * @param controlId is of the control to remove
+     * @param parentIds rray of ids representing the path to the parent control
+     */
+    removeControl(controlId: string, parentIds: string[]): void;
+    /**
+     * Get the form if it exists
+     * @returns the angular form or null
+     */
+    getForm(): FormGroup | undefined;
+    /**
+     * Returns a JSON representation of form values
+     */
+    getFormValue(): any;
+    /**
+     * @returns Whether a form has been set on this service
+     */
+    hasForm(): boolean;
+    /**
+     * @returns Whether the form is dirty.
+     */
+    isFormDirty(): boolean;
+    /**
+     * Unsubscribes from value changes & sets the ngForm to null.
+     * Should be called when any component using an MtnaForm is destroyed.
+     */
+    disposeForm(): void;
+    /**
+     * Forces the unsavedChanges observable to emit true.
+     * Use with care, one example is when repeatable items are added/removed from the form.
+     */
+    forceUnsavedChange(): void;
+    /**
+     * Marks ngForm as pristine & untouched.
+     */
+    markAsPristineAndUntouched(): void;
+    /**
+     * Resets the ngForm.
+     */
+    resetForm(): void;
+    /**
+     * Sets a FormGroup on the service so an external source may observe changes.
+     * @param ngForm FormGroup to be registered.
+     */
+    setForm(ngForm: FormGroup): void;
+    /**
+     * Subscribes to ngForm status changes & updates the unsavedChanges observable
+     */
+    private observeNgFormChanges;
+    /**
+     * Removes the ngForm status change subscription.
+     */
+    private unsubscribeValueChanges;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MtnaWfNgFormService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MtnaWfNgFormService>;
+}