@researchdatabox/sails-ng-common 0.0.1-beta.8936

package/dist/src/config/visitor/common.model.js

@@ -0,0 +1,421 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormPathHelper = exports.PropertiesHelper = void 0;
+const form_component_model_1 = require("../form-component.model");
+const dictionary_model_1 = require("../dictionary.model");
+const naming_helpers_1 = require("../names/naming-helpers");
+const shared_outline_1 = require("../shared.outline");
+class PropertiesHelper {
+    fieldComponentMap;
+    fieldModelMap;
+    fieldLayoutMap;
+    formComponentMap;
+    kindNameDefaultsMap;
+    constructor() {
+        this.fieldComponentMap = dictionary_model_1.FieldComponentDefinitionMap;
+        this.fieldModelMap = dictionary_model_1.FieldModelDefinitionMap;
+        this.fieldLayoutMap = dictionary_model_1.FieldLayoutDefinitionMap;
+        this.formComponentMap = dictionary_model_1.FormComponentDefinitionMap;
+        this.kindNameDefaultsMap = dictionary_model_1.KindNameDefaultsMap;
+    }
+    /**
+     * Create a new instance of a form component.
+     * Populate the common form component properties.
+     * @param currentData The form component definition.
+     */
+    sharedConstructFormComponent(currentData) {
+        // The class to use is identified by the class property string values in the field definitions.
+        const formComponentClassString = currentData?.component?.class;
+        if (typeof formComponentClassString !== 'string' || formComponentClassString.trim().length === 0) {
+            throw new Error(`Missing required 'component.class' in form component '${currentData?.name ?? '<unknown>'}': ${JSON.stringify(currentData)}`);
+        }
+        // The class to use is identified by the class property string values in the field definitions.
+        // The form component is identifier the component field class string
+        const formComponentClass = this.formComponentMap?.get(formComponentClassString);
+        // Create new instance
+        if (!formComponentClass) {
+            const knownFormComponentClassNames = [...this.formComponentMap.keys()].sort().join(', ');
+            throw new Error(`Could not find class for form component class name '${formComponentClassString}'. ` +
+                `Known classes: [${knownFormComponentClassNames}]. ` +
+                `Item: ${JSON.stringify(currentData)}`);
+        }
+        const item = new formComponentClass();
+        // Set the simple properties
+        item.name = currentData.name;
+        item.module = currentData.module;
+        // Set the constraints
+        item.constraints = new form_component_model_1.FormConstraintConfig();
+        item.constraints.allowModes = currentData?.constraints?.allowModes ?? [];
+        item.constraints.authorization = new form_component_model_1.FormConstraintAuthorizationConfig();
+        item.constraints.authorization.allowRoles = currentData?.constraints?.authorization?.allowRoles ?? [];
+        // TODO: Commented out below while we decide on how to handle 'form-level' expressions
+        // Set the expressions
+        // item.expressions = new FormExpressionsConfig();
+        // for (const [key, value] of Object.entries(currentData.expressions ?? {})) {
+        //     item.expressions[key] = value;
+        // }
+        // Set the overrides, as they might be used to transform this component into other components.
+        item.overrides = currentData.overrides;
+        // Create the field component class instance.
+        const componentClassString = currentData?.component?.class;
+        const componentClass = this.fieldComponentMap?.get(componentClassString);
+        if (!componentClass) {
+            throw new Error(`Could not find class for field component class string '${componentClassString}'.`);
+        }
+        item.component = new componentClass();
+        const sourceDefaultsMap = this.kindNameDefaultsMap.get(shared_outline_1.FormComponentDefinitionKind);
+        const targetDefaultsMap = sourceDefaultsMap?.get(componentClassString);
+        // Create the model class instance.
+        // If there is no model class, use the default if there is one.
+        const modelClassDefaultName = targetDefaultsMap?.get(shared_outline_1.FieldModelDefinitionKind);
+        const modelClassString = currentData?.model?.class ?? modelClassDefaultName;
+        const modelClass = modelClassString ? this.fieldModelMap?.get(modelClassString) : null;
+        if (modelClassString && !modelClass) {
+            throw new Error(`Could not find class for field model class string '${modelClassString}'.`);
+        }
+        const model = modelClass ? new modelClass() : undefined;
+        item.model = model;
+        if (model) {
+            this.setFieldClassName(currentData, 'model', modelClassString);
+        }
+        // Create the layout class instance.
+        // If there is no layout class, use the default if there is one.
+        const layoutClassDefaultName = targetDefaultsMap?.get(shared_outline_1.FieldLayoutDefinitionKind);
+        const layoutClassString = currentData?.layout?.class ?? layoutClassDefaultName;
+        const layoutClass = layoutClassString ? this.fieldLayoutMap?.get(layoutClassString) : null;
+        if (layoutClassString && !layoutClass) {
+            throw new Error(`Could not find class for field layout class string '${layoutClassString}'.`);
+        }
+        const layout = layoutClass ? new layoutClass() : undefined;
+        item.layout = layout;
+        if (layout) {
+            this.setFieldClassName(currentData, 'layout', layoutClassString);
+        }
+        return item;
+    }
+    /**
+     * Set the common field component config properties.
+     * @param item Set the value of the named properties on this item.
+     * @param config Get the value of the named properties from this config.
+     */
+    sharedPopulateFieldComponentConfig(item, config) {
+        this.setPropOverride('readonly', item, config);
+        this.setPropOverride('visible', item, config);
+        this.setPropOverride('editMode', item, config);
+        this.setPropOverride('label', item, config);
+        this.setPropOverride('defaultComponentCssClasses', item, config);
+        this.setPropOverride('hostCssClasses', item, config);
+        this.setPropOverride('wrapperCssClasses', item, config);
+        this.setPropOverride('disabled', item, config);
+        this.setPropOverride('autofocus', item, config);
+        this.setPropOverride('tooltip', item, config);
+        this.setPropOverride('onItemSelect', item, config);
+        this.setPropOverride('syncSources', item, config);
+    }
+    /**
+     * Set the common field model config properties.
+     * @param item Set the value of the named properties on this item.
+     * @param config Get the value of the named properties from this config.
+     */
+    sharedPopulateFieldModelConfig(item, config) {
+        this.setPropOverride('disableFormBinding', item, config);
+        this.setPropOverride('value', item, config);
+        this.setPropOverride('defaultValue', item, config);
+        this.setPropOverride('validators', item, config);
+        this.setPropOverride('wrapperCssClasses', item, config);
+        this.setPropOverride('editCssClasses', item, config);
+    }
+    /**
+     * Set the common field layout config properties.
+     * @param item Set the value of the named properties on this item.
+     * @param config Get the value of the named properties from this config.
+     */
+    sharedPopulateFieldLayoutConfig(item, config) {
+        this.sharedPopulateFieldComponentConfig(item, config);
+        this.setPropOverride('labelRequiredStr', item, config);
+        this.setPropOverride('helpText', item, config);
+        this.setPropOverride('cssClassesMap', item, config);
+        this.setPropOverride('helpTextVisibleOnInit', item, config);
+        this.setPropOverride('helpTextVisible', item, config);
+    }
+    /**
+     * Set the property on target.
+     * Retain the target property value if it is not undefined.
+     * Use the value of the property from the first source with a non-undefined property of the same name.
+     *
+     * @param target Set the name property on the target.
+     * @param name The property to set.
+     * @param sources The sources that might have the name property.
+     */
+    setPropDefault(name, target, ...sources) {
+        if (target === undefined || target === null) {
+            throw new Error('Target provided to setPropDefault was undefined or null.');
+        }
+        if (name === undefined || name === null) {
+            throw new Error('Property name provided to setPropDefault was undefined or null.');
+        }
+        const propValue = [target, ...sources].find(val => val?.[name] !== undefined)?.[name];
+        if (propValue !== undefined) {
+            target[name] = propValue;
+        }
+    }
+    /**
+     * Set the property on target.
+     * Override the value of the property from the last source with a non-undefined property of the same name.
+     * @param name The property to set.
+     * @param target Set the name property on the target.
+     * @param sources The sources that might have the name property.
+     */
+    setPropOverride(name, target, ...sources) {
+        if (target === undefined || target === null) {
+            throw new Error('Target provided to setPropOverride was undefined or null.');
+        }
+        if (name === undefined || name === null) {
+            throw new Error('Property name provided to setPropOverride was undefined or null.');
+        }
+        const propValue = [target, ...sources].findLast(val => val?.[name] !== undefined)?.[name];
+        if (propValue !== undefined) {
+            target[name] = propValue;
+        }
+    }
+    /**
+     * Convert a value to a field reference that can be used in a JSONata expression.
+     * @param value The value to convert.
+     * @return The value ready to be used as a field reference in a JSON expression.
+     */
+    toFieldReference(value) {
+        // Normalise the string to a form useful for comparing identifiers.
+        const fieldRaw = value?.toString()?.normalize("NFKC") ?? "";
+        // see: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/codePointAt
+        const fieldReference = [...fieldRaw].map((char) => {
+            const codePoint = char.codePointAt(0);
+            if (codePoint === undefined) {
+                return '';
+            }
+            // Numbers 0 - 9
+            if (codePoint >= 48 && codePoint <= 57) {
+                return char;
+            }
+            // Letters A - Z
+            if (codePoint >= 65 && codePoint <= 90) {
+                return char;
+            }
+            // Letters a - z
+            if (codePoint >= 97 && codePoint <= 122) {
+                return char;
+            }
+            // Selected punctuation used in identifiers - : colon 58, @ at sign 64,
+            // - hyphen minus 45, . full stop 46, _ low line 95
+            if ([58, 64, 45, 46, 95].includes(codePoint)) {
+                return char;
+            }
+            // Anything else is replaced with '_'
+            return '_';
+        });
+        return fieldReference.join('');
+    }
+    /**
+     * Convert a lineage path to a set of dot-separated field references for a JSONata expression.
+     * @param path The lineage path to convert.
+     * @return The path ready to be used as field references in a JSON expression.
+     */
+    lineagePathToExpressionIdentifiers(path) {
+        // Escape unexpected characters.
+        const pathFieldRefs = path.map(i => this.toFieldReference(i));
+        // Use backticks to build each item in the jsonata identifier.
+        const identifiers = pathFieldRefs.map(i => `\`${i}\``);
+        // Join identifiers using dot.
+        return identifiers.join('.');
+    }
+    setFieldClassName(currentData, fieldTypeName, className) {
+        if (currentData === undefined || currentData === null || className === undefined || className === null) {
+            return;
+        }
+        if (currentData[fieldTypeName] === undefined || currentData[fieldTypeName] === null) {
+            currentData[fieldTypeName] = { class: className };
+            return;
+        }
+        else if (currentData[fieldTypeName]?.class === undefined || currentData[fieldTypeName]?.class === null) {
+            currentData[fieldTypeName].class = className;
+        }
+    }
+}
+exports.PropertiesHelper = PropertiesHelper;
+class FormPathHelper {
+    logName = 'FormPathHelper';
+    logger;
+    visitor;
+    _formPath;
+    constructor(logger, visitor) {
+        this.logger = logger;
+        this.visitor = visitor;
+        this._formPath = (0, naming_helpers_1.buildLineagePaths)();
+    }
+    /**
+       * Get the current form paths.
+       */
+    get formPath() {
+        // Return a copy so the current form paths cannot be changed.
+        return {
+            angularComponents: [...this._formPath.angularComponents],
+            angularComponentsJsonPointer: this._formPath.angularComponentsJsonPointer?.toString(),
+            dataModel: [...this._formPath.dataModel],
+            formConfig: [...this._formPath.formConfig],
+            layout: [...this._formPath.layout],
+            layoutJsonPointer: this._formPath.layoutJsonPointer?.toString(),
+        };
+    }
+    /**
+     * Get the current model name.
+     */
+    get modelName() {
+        if (this._formPath.dataModel.length > 0) {
+            return this._formPath.dataModel[this._formPath.dataModel.length - 1]?.toString();
+        }
+        return null;
+    }
+    reset() {
+        this._formPath = (0, naming_helpers_1.buildLineagePaths)();
+    }
+    /**
+     * Call accept on the provided item and set the current path with the given suffix.
+     * Set the current path to the previous value after the accept method is done.
+     * @param item The item to visit.
+     * @param more The lineage paths to add to the end of the current paths.
+     */
+    acceptFormPath(item, more) {
+        if (!item) {
+            this.logger?.warn?.(`${this.logName}: acceptFormPath requires an item: ${JSON.stringify(item)}`);
+            return;
+        }
+        // Copy the original lineage paths so they can be restored.
+        const original = (0, naming_helpers_1.buildLineagePaths)(this._formPath);
+        try {
+            this._formPath = (0, naming_helpers_1.buildLineagePaths)(original, more);
+            item.accept(this.visitor);
+        }
+        catch (error) {
+            throw error;
+        }
+        finally {
+            this._formPath = original;
+        }
+    }
+    /**
+     * Call accept on the properties of the form component definition outline that can be visited.
+     * @param item The form component definition outline.
+     */
+    acceptFormComponentDefinition(item) {
+        this.acceptFormPath(item.component, { formConfig: ['component'] });
+        if (item.model) {
+            this.acceptFormPath(item.model, { formConfig: ['model'] });
+        }
+        if (item.layout) {
+            this.acceptFormPath(item.layout, { formConfig: ['layout'] });
+        }
+    }
+    lineagePathsForFormConfigComponentDefinition(item, index) {
+        return {
+            formConfig: ['componentDefinitions', index.toString()],
+            dataModel: this.getFormPathDataModel(item),
+            angularComponents: this.getFormPathAngularComponents(item),
+            layout: this.getFormPathLayout(item),
+        };
+    }
+    lineagePathsForGroupFieldComponentDefinition(item, index) {
+        return {
+            formConfig: ['config', 'componentDefinitions', index.toString()],
+            dataModel: this.getFormPathDataModel(item),
+            angularComponents: this.getFormPathAngularComponents(item),
+            layout: this.getFormPathLayout(item),
+        };
+    }
+    lineagePathsForTabFieldComponentDefinition(item, index) {
+        return {
+            formConfig: ['config', 'tabs', index.toString()],
+            dataModel: this.getFormPathDataModel(item),
+            angularComponents: this.getFormPathAngularComponents(item),
+            layout: this.getFormPathLayout(item),
+        };
+    }
+    lineagePathsForTabContentFieldComponentDefinition(item, index) {
+        return {
+            formConfig: ['config', 'componentDefinitions', index.toString()],
+            dataModel: this.getFormPathDataModel(item),
+            angularComponents: this.getFormPathAngularComponents(item),
+            layout: this.getFormPathLayout(item),
+        };
+    }
+    lineagePathsForAccordionFieldComponentDefinition(item, index) {
+        return {
+            formConfig: ['config', 'panels', index.toString()],
+            dataModel: this.getFormPathDataModel(item),
+            angularComponents: this.getFormPathAngularComponents(item),
+            layout: this.getFormPathLayout(item),
+        };
+    }
+    lineagePathsForAccordionPanelFieldComponentDefinition(item, index) {
+        return {
+            formConfig: ['config', 'componentDefinitions', index.toString()],
+            dataModel: this.getFormPathDataModel(item),
+            angularComponents: this.getFormPathAngularComponents(item),
+            layout: this.getFormPathLayout(item),
+        };
+    }
+    lineagePathsForRepeatableFieldComponentDefinition(item) {
+        return {
+            formConfig: ['config', 'elementTemplate'],
+            dataModel: this.getFormPathDataModel(item),
+            angularComponents: this.getFormPathAngularComponents(item),
+            layout: this.getFormPathLayout(item),
+        };
+    }
+    lineagePathsForReusableFieldComponentDefinition(item, index) {
+        return {
+            formConfig: ['config', 'componentDefinitions', index.toString()],
+            dataModel: this.getFormPathDataModel(item),
+            angularComponents: this.getFormPathAngularComponents(item),
+            layout: this.getFormPathLayout(item),
+        };
+    }
+    lineagePathsForQuestionTreeFieldComponentDefinition(item, index) {
+        return {
+            formConfig: ['config', 'componentDefinitions', index.toString()],
+            dataModel: this.getFormPathDataModel(item),
+            angularComponents: this.getFormPathAngularComponents(item),
+            layout: this.getFormPathLayout(item),
+        };
+    }
+    getFormPathDataModel(item) {
+        const itemName = item?.name ?? '';
+        const className = item?.component?.class ?? '';
+        // NOTE: The repeatable elementTemplate should not be part of the data model path.
+        // This is done by also checking the name - it has a model, but it must have a 'falsy' name.
+        // TODO: does this need to cater for components that have no model but need the model data, like content component?
+        const dataModel = [];
+        const isGroupWithoutModel = className === 'GroupComponent' && (item.model === undefined || item.model === null);
+        if (itemName && (item.model !== undefined && item.model !== null || isGroupWithoutModel)) {
+            dataModel.push(itemName);
+        }
+        return dataModel;
+    }
+    getFormPathAngularComponents(item) {
+        const itemName = item?.name ?? '';
+        const angularComponents = [];
+        // TODO: don't include the top-level form config name
+        if (itemName) {
+            angularComponents.push(itemName);
+        }
+        return angularComponents;
+    }
+    getFormPathLayout(item) {
+        const itemName = item?.name ?? '';
+        const layout = [];
+        if (itemName) {
+            layout.push(`${itemName}-layout`);
+        }
+        return layout;
+    }
+}
+exports.FormPathHelper = FormPathHelper;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tbW9uLm1vZGVsLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2NvbmZpZy92aXNpdG9yL2NvbW1vbi5tb2RlbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFNQSxrRUFBa0c7QUFDbEcsMERBVzZCO0FBQzdCLDREQUE0RztBQUU1RyxzREFBcUg7QUFFckgsTUFBYSxnQkFBZ0I7SUFDbkIsaUJBQWlCLENBQWtDO0lBQ25ELGFBQWEsQ0FBOEI7SUFDM0MsY0FBYyxDQUErQjtJQUM3QyxnQkFBZ0IsQ0FBc0M7SUFDdEQsbUJBQW1CLENBQTBCO0lBRXJEO1FBQ0UsSUFBSSxDQUFDLGlCQUFpQixHQUFHLDhDQUEyQixDQUFDO1FBQ3JELElBQUksQ0FBQyxhQUFhLEdBQUcsMENBQXVCLENBQUM7UUFDN0MsSUFBSSxDQUFDLGNBQWMsR0FBRywyQ0FBd0IsQ0FBQztRQUMvQyxJQUFJLENBQUMsZ0JBQWdCLEdBQUcsNkNBQTBCLENBQUM7UUFDbkQsSUFBSSxDQUFDLG1CQUFtQixHQUFHLHNDQUFtQixDQUFDO0lBQ2pELENBQUM7SUFFRDs7OztPQUlHO0lBQ0ksNEJBQTRCLENBQUMsV0FBeUM7UUFDM0UsK0ZBQStGO1FBQy9GLE1BQU0sd0JBQXdCLEdBQUcsV0FBVyxFQUFFLFNBQVMsRUFBRSxLQUFLLENBQUM7UUFDL0QsSUFBSSxPQUFPLHdCQUF3QixLQUFLLFFBQVEsSUFBSSx3QkFBd0IsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFLENBQUM7WUFDakcsTUFBTSxJQUFJLEtBQUssQ0FDYix5REFBeUQsV0FBVyxFQUFFLElBQUksSUFBSSxXQUFXLE1BQU0sSUFBSSxDQUFDLFNBQVMsQ0FBQyxXQUFXLENBQUMsRUFBRSxDQUM3SCxDQUFDO1FBQ0osQ0FBQztRQUVELCtGQUErRjtRQUMvRixvRUFBb0U7UUFDcEUsTUFBTSxrQkFBa0IsR0FBRyxJQUFJLENBQUMsZ0JBQWdCLEVBQUUsR0FBRyxDQUFDLHdCQUF3QixDQUFDLENBQUM7UUFFaEYsc0JBQXNCO1FBQ3RCLElBQUksQ0FBQyxrQkFBa0IsRUFBRSxDQUFDO1lBQ3hCLE1BQU0sNEJBQTRCLEdBQUcsQ0FBQyxHQUFHLElBQUksQ0FBQyxnQkFBZ0IsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFDLElBQUksRUFBRSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUN6RixNQUFNLElBQUksS0FBSyxDQUNiLHVEQUF1RCx3QkFBd0IsS0FBSztnQkFDbEYsbUJBQW1CLDRCQUE0QixLQUFLO2dCQUNwRCxTQUFTLElBQUksQ0FBQyxTQUFTLENBQUMsV0FBVyxDQUFDLEVBQUUsQ0FDekMsQ0FBQztRQUNKLENBQUM7UUFFRCxNQUFNLElBQUksR0FBRyxJQUFJLGtCQUFrQixFQUFFLENBQUM7UUFFdEMsNEJBQTRCO1FBQzVCLElBQUksQ0FBQyxJQUFJLEdBQUcsV0FBVyxDQUFDLElBQUksQ0FBQztRQUM3QixJQUFJLENBQUMsTUFBTSxHQUFHLFdBQVcsQ0FBQyxNQUFNLENBQUM7UUFFakMsc0JBQXNCO1FBQ3RCLElBQUksQ0FBQyxXQUFXLEdBQUcsSUFBSSwyQ0FBb0IsRUFBRSxDQUFDO1FBQzlDLElBQUksQ0FBQyxXQUFXLENBQUMsVUFBVSxHQUFHLFdBQVcsRUFBRSxXQUFXLEVBQUUsVUFBVSxJQUFJLEVBQUUsQ0FBQztRQUV6RSxJQUFJLENBQUMsV0FBVyxDQUFDLGFBQWEsR0FBRyxJQUFJLHdEQUFpQyxFQUFFLENBQUM7UUFDekUsSUFBSSxDQUFDLFdBQVcsQ0FBQyxhQUFhLENBQUMsVUFBVSxHQUFHLFdBQVcsRUFBRSxXQUFXLEVBQUUsYUFBYSxFQUFFLFVBQVUsSUFBSSxFQUFFLENBQUM7UUFFdEcsc0ZBQXNGO1FBQ3RGLHNCQUFzQjtRQUN0QixrREFBa0Q7UUFDbEQsOEVBQThFO1FBQzlFLHFDQUFxQztRQUNyQyxJQUFJO1FBRUosOEZBQThGO1FBQzlGLElBQUksQ0FBQyxTQUFTLEdBQUcsV0FBVyxDQUFDLFNBQVMsQ0FBQztRQUV2Qyw2Q0FBNkM7UUFDN0MsTUFBTSxvQkFBb0IsR0FBRyxXQUFXLEVBQUUsU0FBUyxFQUFFLEtBQUssQ0FBQztRQUMzRCxNQUFNLGNBQWMsR0FBRyxJQUFJLENBQUMsaUJBQWlCLEVBQUUsR0FBRyxDQUFDLG9CQUFvQixDQUFDLENBQUM7UUFDekUsSUFBSSxDQUFDLGNBQWMsRUFBRSxDQUFDO1lBQ3BCLE1BQU0sSUFBSSxLQUFLLENBQUMsMERBQTBELG9CQUFvQixJQUFJLENBQUMsQ0FBQztRQUN0RyxDQUFDO1FBQ0QsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLGNBQWMsRUFBRSxDQUFDO1FBRXRDLE1BQU0saUJBQWlCLEdBQUcsSUFBSSxDQUFDLG1CQUFtQixDQUFDLEdBQUcsQ0FBQyw0Q0FBMkIsQ0FBQyxDQUFDO1FBQ3BGLE1BQU0saUJBQWlCLEdBQUcsaUJBQWlCLEVBQUUsR0FBRyxDQUFDLG9CQUFvQixDQUFDLENBQUM7UUFFdkUsbUNBQW1DO1FBQ25DLCtEQUErRDtRQUMvRCxNQUFNLHFCQUFxQixHQUFHLGlCQUFpQixFQUFFLEdBQUcsQ0FBQyx5Q0FBd0IsQ0FBQyxDQUFDO1FBQy9FLE1BQU0sZ0JBQWdCLEdBQUcsV0FBVyxFQUFFLEtBQUssRUFBRSxLQUFLLElBQUkscUJBQXFCLENBQUM7UUFDNUUsTUFBTSxVQUFVLEdBQUcsZ0JBQWdCLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxhQUFhLEVBQUUsR0FBRyxDQUFDLGdCQUFnQixDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQztRQUN2RixJQUFJLGdCQUFnQixJQUFJLENBQUMsVUFBVSxFQUFFLENBQUM7WUFDcEMsTUFBTSxJQUFJLEtBQUssQ0FBQyxzREFBc0QsZ0JBQWdCLElBQUksQ0FBQyxDQUFDO1FBQzlGLENBQUM7UUFDRCxNQUFNLEtBQUssR0FBRyxVQUFVLENBQUMsQ0FBQyxDQUFDLElBQUksVUFBVSxFQUFFLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQztRQUN4RCxJQUFJLENBQUMsS0FBSyxHQUFHLEtBQUssQ0FBQztRQUNuQixJQUFJLEtBQUssRUFBRSxDQUFDO1lBQ1YsSUFBSSxDQUFDLGlCQUFpQixDQUFDLFdBQVcsRUFBRSxPQUFPLEVBQUUsZ0JBQWdCLENBQUMsQ0FBQztRQUNqRSxDQUFDO1FBRUQsb0NBQW9DO1FBQ3BDLGdFQUFnRTtRQUNoRSxNQUFNLHNCQUFzQixHQUFHLGlCQUFpQixFQUFFLEdBQUcsQ0FBQywwQ0FBeUIsQ0FBQyxDQUFDO1FBQ2pGLE1BQU0saUJBQWlCLEdBQUcsV0FBVyxFQUFFLE1BQU0sRUFBRSxLQUFLLElBQUksc0JBQXNCLENBQUM7UUFDL0UsTUFBTSxXQUFXLEdBQUcsaUJBQWlCLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxjQUFjLEVBQUUsR0FBRyxDQUFDLGlCQUFpQixDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQztRQUMzRixJQUFJLGlCQUFpQixJQUFJLENBQUMsV0FBVyxFQUFFLENBQUM7WUFDdEMsTUFBTSxJQUFJLEtBQUssQ0FBQyx1REFBdUQsaUJBQWlCLElBQUksQ0FBQyxDQUFDO1FBQ2hHLENBQUM7UUFDRCxNQUFNLE1BQU0sR0FBRyxXQUFXLENBQUMsQ0FBQyxDQUFDLElBQUksV0FBVyxFQUFFLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQztRQUMzRCxJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztRQUNyQixJQUFJLE1BQU0sRUFBRSxDQUFDO1lBQ1gsSUFBSSxDQUFDLGlCQUFpQixDQUFDLFdBQVcsRUFBRSxRQUFRLEVBQUUsaUJBQWlCLENBQUMsQ0FBQztRQUNuRSxDQUFDO1FBRUQsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNJLGtDQUFrQyxDQUFDLElBQStCLEVBQUUsTUFBa0M7UUFDM0csSUFBSSxDQUFDLGVBQWUsQ0FBQyxVQUFVLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBQy9DLElBQUksQ0FBQyxlQUFlLENBQUMsU0FBUyxFQUFFLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQztRQUM5QyxJQUFJLENBQUMsZUFBZSxDQUFDLFVBQVUsRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLENBQUM7UUFDL0MsSUFBSSxDQUFDLGVBQWUsQ0FBQyxPQUFPLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBQzVDLElBQUksQ0FBQyxlQUFlLENBQUMsNEJBQTRCLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBQ2pFLElBQUksQ0FBQyxlQUFlLENBQUMsZ0JBQWdCLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBQ3JELElBQUksQ0FBQyxlQUFlLENBQUMsbUJBQW1CLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBQ3hELElBQUksQ0FBQyxlQUFlLENBQUMsVUFBVSxFQUFFLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQztRQUMvQyxJQUFJLENBQUMsZUFBZSxDQUFDLFdBQVcsRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLENBQUM7UUFDaEQsSUFBSSxDQUFDLGVBQWUsQ0FBQyxTQUFTLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBQzlDLElBQUksQ0FBQyxlQUFlLENBQUMsY0FBYyxFQUFFLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQztRQUNuRCxJQUFJLENBQUMsZUFBZSxDQUFDLGFBQWEsRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLENBQUM7SUFDcEQsQ0FBQztJQUVEOzs7O09BSUc7SUFDSSw4QkFBOEIsQ0FBQyxJQUFvQyxFQUFFLE1BQXVDO1FBQ2pILElBQUksQ0FBQyxlQUFlLENBQUMsb0JBQW9CLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBQ3pELElBQUksQ0FBQyxlQUFlLENBQUMsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQztRQUM1QyxJQUFJLENBQUMsZUFBZSxDQUFDLGNBQWMsRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLENBQUM7UUFDbkQsSUFBSSxDQUFDLGVBQWUsQ0FBQyxZQUFZLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBQ2pELElBQUksQ0FBQyxlQUFlLENBQUMsbUJBQW1CLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBQ3hELElBQUksQ0FBQyxlQUFlLENBQUMsZ0JBQWdCLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ3ZELENBQUM7SUFFRDs7OztPQUlHO0lBQ0ksK0JBQStCLENBQUMsSUFBNEIsRUFBRSxNQUErQjtRQUNsRyxJQUFJLENBQUMsa0NBQWtDLENBQUMsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBQ3RELElBQUksQ0FBQyxlQUFlLENBQUMsa0JBQWtCLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBQ3ZELElBQUksQ0FBQyxlQUFlLENBQUMsVUFBVSxFQUFFLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQztRQUMvQyxJQUFJLENBQUMsZUFBZSxDQUFDLGVBQWUsRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLENBQUM7UUFDcEQsSUFBSSxDQUFDLGVBQWUsQ0FBQyx1QkFBdUIsRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLENBQUM7UUFDNUQsSUFBSSxDQUFDLGVBQWUsQ0FBQyxpQkFBaUIsRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLENBQUM7SUFDeEQsQ0FBQztJQUVEOzs7Ozs7OztPQVFHO0lBQ0ksY0FBYyxDQUNuQixJQUFZLEVBQ1osTUFBNEIsRUFDNUIsR0FBRyxPQUFvRDtRQUV2RCxJQUFJLE1BQU0sS0FBSyxTQUFTLElBQUksTUFBTSxLQUFLLElBQUksRUFBRSxDQUFDO1lBQzVDLE1BQU0sSUFBSSxLQUFLLENBQUMsMERBQTBELENBQUMsQ0FBQztRQUM5RSxDQUFDO1FBQ0QsSUFBSSxJQUFJLEtBQUssU0FBUyxJQUFJLElBQUksS0FBSyxJQUFJLEVBQUUsQ0FBQztZQUN4QyxNQUFNLElBQUksS0FBSyxDQUFDLGlFQUFpRSxDQUFDLENBQUM7UUFDckYsQ0FBQztRQUVELE1BQU0sU0FBUyxHQUFHLENBQUMsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxFQUFFLENBQUMsSUFBSSxDQUFDLEtBQUssU0FBUyxDQUFDLEVBQUUsQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUN0RixJQUFJLFNBQVMsS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUM1QixNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsU0FBUyxDQUFDO1FBQzNCLENBQUM7SUFDSCxDQUFDO0lBRUQ7Ozs7OztPQU1HO0lBQ0ksZUFBZSxDQUNwQixJQUFZLEVBQ1osTUFBNEIsRUFDNUIsR0FBRyxPQUFvRDtRQUV2RCxJQUFJLE1BQU0sS0FBSyxTQUFTLElBQUksTUFBTSxLQUFLLElBQUksRUFBRSxDQUFDO1lBQzVDLE1BQU0sSUFBSSxLQUFLLENBQUMsMkRBQTJELENBQUMsQ0FBQztRQUMvRSxDQUFDO1FBQ0QsSUFBSSxJQUFJLEtBQUssU0FBUyxJQUFJLElBQUksS0FBSyxJQUFJLEVBQUUsQ0FBQztZQUN4QyxNQUFNLElBQUksS0FBSyxDQUFDLGtFQUFrRSxDQUFDLENBQUM7UUFDdEYsQ0FBQztRQUVELE1BQU0sU0FBUyxHQUFHLENBQUMsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxFQUFFLENBQUMsSUFBSSxDQUFDLEtBQUssU0FBUyxDQUFDLEVBQUUsQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUMxRixJQUFJLFNBQVMsS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUM1QixNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsU0FBUyxDQUFDO1FBQzNCLENBQUM7SUFDSCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNJLGdCQUFnQixDQUFDLEtBQWM7UUFDcEMsbUVBQW1FO1FBQ25FLE1BQU0sUUFBUSxHQUFHLEtBQUssRUFBRSxRQUFRLEVBQUUsRUFBRSxTQUFTLENBQUMsTUFBTSxDQUFDLElBQUksRUFBRSxDQUFDO1FBQzVELDJHQUEyRztRQUMzRyxNQUFNLGNBQWMsR0FBRyxDQUFDLEdBQUcsUUFBUSxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsSUFBSSxFQUFFLEVBQUU7WUFDaEQsTUFBTSxTQUFTLEdBQUcsSUFBSSxDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUN0QyxJQUFJLFNBQVMsS0FBSyxTQUFTLEVBQUUsQ0FBQztnQkFDNUIsT0FBTyxFQUFFLENBQUE7WUFDWCxDQUFDO1lBQ0QsZ0JBQWdCO1lBQ2hCLElBQUksU0FBUyxJQUFJLEVBQUUsSUFBSSxTQUFTLElBQUksRUFBRSxFQUFFLENBQUM7Z0JBQ3ZDLE9BQU8sSUFBSSxDQUFBO1lBQ2IsQ0FBQztZQUNELGdCQUFnQjtZQUNoQixJQUFJLFNBQVMsSUFBSSxFQUFFLElBQUksU0FBUyxJQUFJLEVBQUUsRUFBRSxDQUFDO2dCQUN2QyxPQUFPLElBQUksQ0FBQTtZQUNiLENBQUM7WUFDRCxnQkFBZ0I7WUFDaEIsSUFBSSxTQUFTLElBQUksRUFBRSxJQUFJLFNBQVMsSUFBSSxHQUFHLEVBQUUsQ0FBQztnQkFDeEMsT0FBTyxJQUFJLENBQUE7WUFDYixDQUFDO1lBQ0QsdUVBQXVFO1lBQ3ZFLG1EQUFtRDtZQUNuRCxJQUFJLENBQUMsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDO2dCQUM3QyxPQUFPLElBQUksQ0FBQTtZQUNiLENBQUM7WUFDRCxxQ0FBcUM7WUFDckMsT0FBTyxHQUFHLENBQUM7UUFDYixDQUFDLENBQUMsQ0FBQztRQUNILE9BQU8sY0FBYyxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQztJQUNqQyxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNJLGtDQUFrQyxDQUFDLElBQWlCO1FBQ3pELGdDQUFnQztRQUNoQyxNQUFNLGFBQWEsR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLGdCQUFnQixDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDOUQsOERBQThEO1FBQzlELE1BQU0sV0FBVyxHQUFHLGFBQWEsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDdkQsOEJBQThCO1FBQzlCLE9BQU8sV0FBVyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUMvQixDQUFDO0lBRU8saUJBQWlCLENBQ3ZCLFdBQXlDLEVBQ3pDLGFBQWlDLEVBQ2pDLFNBQW9DO1FBRXBDLElBQUksV0FBVyxLQUFLLFNBQVMsSUFBSSxXQUFXLEtBQUssSUFBSSxJQUFJLFNBQVMsS0FBSyxTQUFTLElBQUksU0FBUyxLQUFLLElBQUksRUFBRSxDQUFDO1lBQ3ZHLE9BQU87UUFDVCxDQUFDO1FBQ0QsSUFBSSxXQUFXLENBQUMsYUFBYSxDQUFDLEtBQUssU0FBUyxJQUFJLFdBQVcsQ0FBQyxhQUFhLENBQUMsS0FBSyxJQUFJLEVBQUUsQ0FBQztZQUNwRixXQUFXLENBQUMsYUFBYSxDQUFDLEdBQUcsRUFBRSxLQUFLLEVBQUUsU0FBUyxFQUFFLENBQUM7WUFDbEQsT0FBTztRQUNULENBQUM7YUFBTSxJQUFJLFdBQVcsQ0FBQyxhQUFhLENBQUMsRUFBRSxLQUFLLEtBQUssU0FBUyxJQUFJLFdBQVcsQ0FBQyxhQUFhLENBQUMsRUFBRSxLQUFLLEtBQUssSUFBSSxFQUFFLENBQUM7WUFDekcsV0FBVyxDQUFDLGFBQWEsQ0FBQyxDQUFDLEtBQUssR0FBRyxTQUFTLENBQUM7UUFDL0MsQ0FBQztJQUNILENBQUM7Q0FDRjtBQWxSRCw0Q0FrUkM7QUFFRCxNQUFhLGNBQWM7SUFDZixPQUFPLEdBQUcsZ0JBQWdCLENBQUM7SUFFM0IsTUFBTSxDQUFVO0lBQ2xCLE9BQU8sQ0FBMkI7SUFFbEMsU0FBUyxDQUFlO0lBRWhDLFlBQVksTUFBZSxFQUFFLE9BQWlDO1FBQzVELElBQUksQ0FBQyxNQUFNLEdBQUcsTUFBTSxDQUFDO1FBQ3JCLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFDO1FBRXZCLElBQUksQ0FBQyxTQUFTLEdBQUcsSUFBQSxrQ0FBaUIsR0FBRSxDQUFDO0lBQ3ZDLENBQUM7SUFFRDs7U0FFSztJQUNMLElBQUksUUFBUTtRQUNWLDZEQUE2RDtRQUM3RCxPQUFPO1lBQ0wsaUJBQWlCLEVBQUUsQ0FBQyxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsaUJBQWlCLENBQUM7WUFDeEQsNEJBQTRCLEVBQUUsSUFBSSxDQUFDLFNBQVMsQ0FBQyw0QkFBNEIsRUFBRSxRQUFRLEVBQUU7WUFDckYsU0FBUyxFQUFFLENBQUMsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLFNBQVMsQ0FBQztZQUN4QyxVQUFVLEVBQUUsQ0FBQyxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsVUFBVSxDQUFDO1lBQzFDLE1BQU0sRUFBRSxDQUFDLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxNQUFNLENBQUM7WUFDbEMsaUJBQWlCLEVBQUUsSUFBSSxDQUFDLFNBQVMsQ0FBQyxpQkFBaUIsRUFBRSxRQUFRLEVBQUU7U0FDaEUsQ0FBQztJQUNKLENBQUM7SUFFRDs7T0FFRztJQUNILElBQUksU0FBUztRQUNYLElBQUksSUFBSSxDQUFDLFNBQVMsQ0FBQyxTQUFTLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRSxDQUFDO1lBQ3hDLE9BQU8sSUFBSSxDQUFDLFNBQVMsQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxTQUFTLENBQUMsTUFBTSxHQUFHLENBQUMsQ0FBQyxFQUFFLFFBQVEsRUFBRSxDQUFDO1FBQ25GLENBQUM7UUFDRCxPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7SUFFTSxLQUFLO1FBQ1YsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFBLGtDQUFpQixHQUFFLENBQUM7SUFDdkMsQ0FBQztJQUVEOzs7OztPQUtHO0lBQ0ksY0FBYyxDQUFDLElBQWMsRUFBRSxJQUEwQjtRQUM5RCxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUM7WUFDVixJQUFJLENBQUMsTUFBTSxFQUFFLElBQUksRUFBRSxDQUFDLEdBQUcsSUFBSSxDQUFDLE9BQU8sc0NBQXNDLElBQUksQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQyxDQUFDO1lBQ2pHLE9BQU87UUFDVCxDQUFDO1FBQ0QsMkRBQTJEO1FBQzNELE1BQU0sUUFBUSxHQUFHLElBQUEsa0NBQWlCLEVBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDO1FBQ25ELElBQUksQ0FBQztZQUNILElBQUksQ0FBQyxTQUFTLEdBQUcsSUFBQSxrQ0FBaUIsRUFBQyxRQUFRLEVBQUUsSUFBSSxDQUFDLENBQUM7WUFDbkQsSUFBSSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDNUIsQ0FBQztRQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7WUFDZixNQUFNLEtBQUssQ0FBQztRQUNkLENBQUM7Z0JBQVMsQ0FBQztZQUNULElBQUksQ0FBQyxTQUFTLEdBQUcsUUFBUSxDQUFDO1FBQzVCLENBQUM7SUFDSCxDQUFDO0lBRUQ7OztPQUdHO0lBQ0ksNkJBQTZCLENBQUMsSUFBb0M7UUFDdkUsSUFBSSxDQUFDLGNBQWMsQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLEVBQUUsVUFBVSxFQUFFLENBQUMsV0FBVyxDQUFDLEVBQUUsQ0FBQyxDQUFDO1FBQ25FLElBQUksSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDO1lBQ2YsSUFBSSxDQUFDLGNBQWMsQ0FBQyxJQUFJLENBQUMsS0FBSyxFQUFFLEVBQUUsVUFBVSxFQUFFLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQyxDQUFDO1FBQzdELENBQUM7UUFDRCxJQUFJLElBQUksQ0FBQyxNQUFNLEVBQUUsQ0FBQztZQUNoQixJQUFJLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsRUFBRSxVQUFVLEVBQUUsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDLENBQUM7UUFDL0QsQ0FBQztJQUNILENBQUM7SUFFTSw0Q0FBNEMsQ0FDakQsSUFBb0MsRUFDcEMsS0FBYTtRQUViLE9BQU87WUFDTCxVQUFVLEVBQUUsQ0FBQyxzQkFBc0IsRUFBRSxLQUFLLENBQUMsUUFBUSxFQUFFLENBQUM7WUFDdEQsU0FBUyxFQUFFLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxJQUFJLENBQUM7WUFDMUMsaUJBQWlCLEVBQUUsSUFBSSxDQUFDLDRCQUE0QixDQUFDLElBQUksQ0FBQztZQUMxRCxNQUFNLEVBQUUsSUFBSSxDQUFDLGlCQUFpQixDQUFDLElBQUksQ0FBQztTQUNyQyxDQUFDO0lBQ0osQ0FBQztJQUVNLDRDQUE0QyxDQUNqRCxJQUFvQyxFQUNwQyxLQUFhO1FBRWIsT0FBTztZQUNMLFVBQVUsRUFBRSxDQUFDLFFBQVEsRUFBRSxzQkFBc0IsRUFBRSxLQUFLLENBQUMsUUFBUSxFQUFFLENBQUM7WUFDaEUsU0FBUyxFQUFFLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxJQUFJLENBQUM7WUFDMUMsaUJBQWlCLEVBQUUsSUFBSSxDQUFDLDRCQUE0QixDQUFDLElBQUksQ0FBQztZQUMxRCxNQUFNLEVBQUUsSUFBSSxDQUFDLGlCQUFpQixDQUFDLElBQUksQ0FBQztTQUNyQyxDQUFDO0lBQ0osQ0FBQztJQUVNLDBDQUEwQyxDQUMvQyxJQUFvQyxFQUNwQyxLQUFhO1FBRWIsT0FBTztZQUNMLFVBQVUsRUFBRSxDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsS0FBSyxDQUFDLFFBQVEsRUFBRSxDQUFDO1lBQ2hELFNBQVMsRUFBRSxJQUFJLENBQUMsb0JBQW9CLENBQUMsSUFBSSxDQUFDO1lBQzFDLGlCQUFpQixFQUFFLElBQUksQ0FBQyw0QkFBNEIsQ0FBQyxJQUFJLENBQUM7WUFDMUQsTUFBTSxFQUFFLElBQUksQ0FBQyxpQkFBaUIsQ0FBQyxJQUFJLENBQUM7U0FDckMsQ0FBQztJQUNKLENBQUM7SUFFTSxpREFBaUQsQ0FDdEQsSUFBb0MsRUFDcEMsS0FBYTtRQUViLE9BQU87WUFDTCxVQUFVLEVBQUUsQ0FBQyxRQUFRLEVBQUUsc0JBQXNCLEVBQUUsS0FBSyxDQUFDLFFBQVEsRUFBRSxDQUFDO1lBQ2hFLFNBQVMsRUFBRSxJQUFJLENBQUMsb0JBQW9CLENBQUMsSUFBSSxDQUFDO1lBQzFDLGlCQUFpQixFQUFFLElBQUksQ0FBQyw0QkFBNEIsQ0FBQyxJQUFJLENBQUM7WUFDMUQsTUFBTSxFQUFFLElBQUksQ0FBQyxpQkFBaUIsQ0FBQyxJQUFJLENBQUM7U0FDckMsQ0FBQztJQUNKLENBQUM7SUFFTSxnREFBZ0QsQ0FDckQsSUFBb0MsRUFDcEMsS0FBYTtRQUViLE9BQU87WUFDTCxVQUFVLEVBQUUsQ0FBQyxRQUFRLEVBQUUsUUFBUSxFQUFFLEtBQUssQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUNsRCxTQUFTLEVBQUUsSUFBSSxDQUFDLG9CQUFvQixDQUFDLElBQUksQ0FBQztZQUMxQyxpQkFBaUIsRUFBRSxJQUFJLENBQUMsNEJBQTRCLENBQUMsSUFBSSxDQUFDO1lBQzFELE1BQU0sRUFBRSxJQUFJLENBQUMsaUJBQWlCLENBQUMsSUFBSSxDQUFDO1NBQ3JDLENBQUM7SUFDSixDQUFDO0lBRU0scURBQXFELENBQzFELElBQW9DLEVBQ3BDLEtBQWE7UUFFYixPQUFPO1lBQ0wsVUFBVSxFQUFFLENBQUMsUUFBUSxFQUFFLHNCQUFzQixFQUFFLEtBQUssQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUNoRSxTQUFTLEVBQUUsSUFBSSxDQUFDLG9CQUFvQixDQUFDLElBQUksQ0FBQztZQUMxQyxpQkFBaUIsRUFBRSxJQUFJLENBQUMsNEJBQTRCLENBQUMsSUFBSSxDQUFDO1lBQzFELE1BQU0sRUFBRSxJQUFJLENBQUMsaUJBQWlCLENBQUMsSUFBSSxDQUFDO1NBQ3JDLENBQUM7SUFDSixDQUFDO0lBRU0saURBQWlELENBQUMsSUFBb0M7UUFDM0YsT0FBTztZQUNMLFVBQVUsRUFBRSxDQUFDLFFBQVEsRUFBRSxpQkFBaUIsQ0FBQztZQUN6QyxTQUFTLEVBQUUsSUFBSSxDQUFDLG9CQUFvQixDQUFDLElBQUksQ0FBQztZQUMxQyxpQkFBaUIsRUFBRSxJQUFJLENBQUMsNEJBQTRCLENBQUMsSUFBSSxDQUFDO1lBQzFELE1BQU0sRUFBRSxJQUFJLENBQUMsaUJBQWlCLENBQUMsSUFBSSxDQUFDO1NBQ3JDLENBQUM7SUFDSixDQUFDO0lBRU0sK0NBQStDLENBQ3BELElBQW9DLEVBQ3BDLEtBQWE7UUFFYixPQUFPO1lBQ0wsVUFBVSxFQUFFLENBQUMsUUFBUSxFQUFFLHNCQUFzQixFQUFFLEtBQUssQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUNoRSxTQUFTLEVBQUUsSUFBSSxDQUFDLG9CQUFvQixDQUFDLElBQUksQ0FBQztZQUMxQyxpQkFBaUIsRUFBRSxJQUFJLENBQUMsNEJBQTRCLENBQUMsSUFBSSxDQUFDO1lBQzFELE1BQU0sRUFBRSxJQUFJLENBQUMsaUJBQWlCLENBQUMsSUFBSSxDQUFDO1NBQ3JDLENBQUM7SUFDSixDQUFDO0lBRU0sbURBQW1ELENBQ3hELElBQW9DLEVBQ3BDLEtBQWE7UUFFYixPQUFPO1lBQ0wsVUFBVSxFQUFFLENBQUMsUUFBUSxFQUFFLHNCQUFzQixFQUFFLEtBQUssQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUNoRSxTQUFTLEVBQUUsSUFBSSxDQUFDLG9CQUFvQixDQUFDLElBQUksQ0FBQztZQUMxQyxpQkFBaUIsRUFBRSxJQUFJLENBQUMsNEJBQTRCLENBQUMsSUFBSSxDQUFDO1lBQzFELE1BQU0sRUFBRSxJQUFJLENBQUMsaUJBQWlCLENBQUMsSUFBSSxDQUFDO1NBQ3JDLENBQUM7SUFDSixDQUFDO0lBRU8sb0JBQW9CLENBQUMsSUFBb0M7UUFDL0QsTUFBTSxRQUFRLEdBQUcsSUFBSSxFQUFFLElBQUksSUFBSSxFQUFFLENBQUM7UUFDbEMsTUFBTSxTQUFTLEdBQUcsSUFBSSxFQUFFLFNBQVMsRUFBRSxLQUFLLElBQUksRUFBRSxDQUFDO1FBRS9DLGtGQUFrRjtRQUNsRiw0RkFBNEY7UUFFNUYsbUhBQW1IO1FBRW5ILE1BQU0sU0FBUyxHQUFHLEVBQUUsQ0FBQztRQUNyQixNQUFNLG1CQUFtQixHQUFHLFNBQVMsS0FBSyxnQkFBZ0IsSUFBSSxDQUFDLElBQUksQ0FBQyxLQUFLLEtBQUssU0FBUyxJQUFJLElBQUksQ0FBQyxLQUFLLEtBQUssSUFBSSxDQUFDLENBQUM7UUFDaEgsSUFBSSxRQUFRLElBQUksQ0FBQyxJQUFJLENBQUMsS0FBSyxLQUFLLFNBQVMsSUFBSSxJQUFJLENBQUMsS0FBSyxLQUFLLElBQUksSUFBSSxtQkFBbUIsQ0FBQyxFQUFFLENBQUM7WUFDekYsU0FBUyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQztRQUMzQixDQUFDO1FBRUQsT0FBTyxTQUFTLENBQUM7SUFDbkIsQ0FBQztJQUVPLDRCQUE0QixDQUFDLElBQW9DO1FBQ3ZFLE1BQU0sUUFBUSxHQUFHLElBQUksRUFBRSxJQUFJLElBQUksRUFBRSxDQUFDO1FBQ2xDLE1BQU0saUJBQWlCLEdBQWdCLEVBQUUsQ0FBQztRQUMxQyxxREFBcUQ7UUFDckQsSUFBSSxRQUFRLEVBQUUsQ0FBQztZQUNiLGlCQUFpQixDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQztRQUNuQyxDQUFDO1FBQ0QsT0FBTyxpQkFBaUIsQ0FBQztJQUMzQixDQUFDO0lBRU8saUJBQWlCLENBQUMsSUFBb0M7UUFDNUQsTUFBTSxRQUFRLEdBQUcsSUFBSSxFQUFFLElBQUksSUFBSSxFQUFFLENBQUM7UUFDbEMsTUFBTSxNQUFNLEdBQWdCLEVBQUUsQ0FBQztRQUMvQixJQUFJLFFBQVEsRUFBRSxDQUFDO1lBQ2IsTUFBTSxDQUFDLElBQUksQ0FBQyxHQUFHLFFBQVEsU0FBUyxDQUFDLENBQUM7UUFDcEMsQ0FBQztRQUNELE9BQU8sTUFBTSxDQUFDO0lBQ2hCLENBQUM7Q0FDRjtBQTlORCx3Q0E4TkMifQ==

package/dist/src/handlebars-helpers.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Shared Handlebars helper definitions for use in both server and client contexts.
+ * These helpers provide CSP-safe alternatives to lodash template expressions.
+ *
+ * Usage:
+ * - Server: Import and register with Handlebars.registerHelper()
+ * - Client: Import and register with Handlebars runtime
+ */
+/**
+ * Preset mapping for locale-aware date formatting.
+ * Maps preset names to Luxon's built-in format options.
+ */
+export declare const dateLocalePresetMap: Record<string, Intl.DateTimeFormatOptions>;
+/**
+ * Helper function definitions that can be registered with Handlebars.
+ * Each function is a pure, deterministic helper that does not execute arbitrary code.
+ */
+export declare const handlebarsHelperDefinitions: {
+    /**
+     * Format a date value using a custom format string.
+     * Supports ISO date strings and JavaScript Date instances.
+     * Replaces lodash template usage like: ${ DateTime.fromISO(data.date).toFormat('dd/MM/yyyy hh:mm a') }
+     *
+     * @example {{formatDate lastSaveDate "dd/MM/yyyy hh:mm a"}}
+     */
+    formatDate: (dateValue: string | Date, formatOrOptions?: string | Record<string, unknown>) => string;
+    /**
+     * Format a date value using locale-aware presets.
+     * Supports ISO date strings and JavaScript Date instances.
+     *
+     * @example {{formatDateLocale lastSaveDate "DATETIME_MED"}}
+     */
+    formatDateLocale: (dateValue: string | Date, presetNameOrOptions?: string | Record<string, unknown>, localeOrOptions?: string | Record<string, unknown>) => string;
+    /**
+     * Parse a date string (pass-through for chaining).
+     *
+     * @example {{parseDateString dateString}}
+     */
+    parseDateString: (dateString: string) => string;
+    /**
+     * Get a nested property from an object using dot notation.
+     * Replaces lodash template usage like: ${ _.get(data, 'metadata.contributor_ci', '') }
+     *
+     * @example {{get this "metadata.contributor_ci.text_full_name"}}
+     */
+    get: (obj: unknown, path: string, defaultValue?: unknown) => unknown;
+    /**
+     * Check if a value is empty (null, undefined, empty string, empty array, empty object).
+     *
+     * @example {{#if (isEmpty value)}}empty{{/if}}
+     */
+    isEmpty: (value: unknown) => boolean;
+    /**
+     * Check if a value is undefined.
+     *
+     * @example {{#if (isUndefined value)}}undefined{{/if}}
+     */
+    isUndefined: (value: unknown) => boolean;
+    /**
+     * Check if a value is null.
+     *
+     * @example {{#if (isNull value)}}null{{/if}}
+     */
+    isNull: (value: unknown) => boolean;
+    /**
+     * Check if a value is defined (not undefined and not null).
+     *
+     * @example {{#if (isDefined value)}}defined{{/if}}
+     */
+    isDefined: (value: unknown) => boolean;
+    /**
+     * Check if a value is an array.
+     *
+     * @example {{#if (isArray value)}}is array{{/if}}
+     */
+    isArray: (value: unknown) => boolean;
+    /**
+     * Check if a value is a plain object.
+     *
+     * @example {{#if (isObject value)}}is object{{/if}}
+     */
+    isObject: (value: unknown) => boolean;
+    /**
+     * Strict equality comparison.
+     *
+     * @example {{#if (eq status "active")}}active{{/if}}
+     */
+    eq: (a: unknown, b: unknown) => boolean;
+    /**
+     * Not equal comparison.
+     *
+     * @example {{#if (ne status "inactive")}}not inactive{{/if}}
+     */
+    ne: (a: unknown, b: unknown) => boolean;
+    /**
+     * Logical AND - returns true if all arguments are truthy.
+     * Note: The last argument is the Handlebars options hash, which is removed.
+     *
+     * @example {{#if (and condition1 condition2)}}both true{{/if}}
+     */
+    and: (...args: unknown[]) => boolean;
+    /**
+     * Logical OR - returns true if any argument is truthy.
+     * Note: The last argument is the Handlebars options hash, which is removed.
+     *
+     * @example {{#if (or condition1 condition2)}}at least one true{{/if}}
+     */
+    or: (...args: unknown[]) => boolean;
+    /**
+     * Logical NOT - returns true if value is falsy.
+     *
+     * @example {{#if (not condition)}}condition is false{{/if}}
+     */
+    not: (value: unknown) => boolean;
+    /**
+     * Greater than comparison.
+     *
+     * @example {{#if (gt count 0)}}has items{{/if}}
+     */
+    gt: (a: unknown, b: unknown) => boolean;
+    /**
+     * Greater than or equal comparison.
+     *
+     * @example {{#if (gte count 1)}}at least one{{/if}}
+     */
+    gte: (a: unknown, b: unknown) => boolean;
+    /**
+     * Less than comparison.
+     *
+     * @example {{#if (lt count 10)}}less than ten{{/if}}
+     */
+    lt: (a: unknown, b: unknown) => boolean;
+    /**
+     * Less than or equal comparison.
+     *
+     * @example {{#if (lte count 10)}}ten or less{{/if}}
+     */
+    lte: (a: unknown, b: unknown) => boolean;
+    /**
+     * Trim leading/trailing whitespace from a string value.
+     *
+     * @example {{trim title}}
+     */
+    trim: (value: unknown) => string;
+    /**
+     * Translation helper - looks up translation from context.translationService.
+     * The translation service must be provided in the template context.
+     *
+     * @example {{t "label.title"}}
+     */
+    t: (this: {
+        translationService?: {
+            t: (key: string) => string;
+        };
+    }, key: string) => string;
+    /**
+     * Join array elements with a separator.
+     *
+     * @example {{join items ", "}}
+     */
+    join: (arr: unknown[], separator?: string) => string;
+    /**
+     * Return part of a string using slice semantics.
+     *
+     * @example {{substring notation 0 6}}
+     */
+    substring: (value: unknown, start: number, end?: number) => string;
+    /**
+     * Split a string into parts, or return one part if index is provided.
+     * Supports negative index values, where -1 is the last part.
+     *
+     * @example {{split notation "/" -1}}
+     */
+    split: (value: unknown, separator: string, index?: number) => unknown;
+    /**
+     * Concatenate strings.
+     * Note: The last argument is the Handlebars options hash, which is removed.
+     *
+     * @example {{concat prefix value suffix}}
+     */
+    concat: (...args: unknown[]) => string;
+    /**
+     * Default value if the primary value is empty/falsy.
+     *
+     * @example {{default title "Untitled"}}
+     */
+    default: (value: unknown, defaultValue: unknown) => unknown;
+    /**
+     * Convert markdown to HTML when output format is markdown, otherwise pass HTML through.
+     * Note: This helper does not sanitize HTML output, we are currently only using it on the client side with Angular's DomSanitizer to ensure safe usage.
+     * Do not use this helper with untrusted content in a server-side context without proper sanitization (see DOMSanitizerService as a way to sanitize the HTML on the server side).
+     *
+     * @example {{{markdownToHtml content outputFormat}}}
+     */
+    markdownToHtml: (value: unknown, outputFormat?: string) => string;
+    /**
+     * JSON stringify a value (useful for debugging).
+     *
+     * @example {{json data}}
+     */
+    json: (value: unknown) => string;
+    /**
+     * Render metadata values into nested HTML suitable for generated view-only display.
+     *
+     * @example {{{renderMetadataValue metadata.someField}}}
+     */
+    renderMetadataValue: (value: unknown) => string;
+};
+/**
+ * Type definition for the Handlebars helper functions.
+ */
+export type HandlebarsHelperDefinitions = typeof handlebarsHelperDefinitions;
+/**
+ * Register all shared helpers with a Handlebars instance.
+ *
+ * @param Handlebars The Handlebars instance to register helpers on
+ */
+export declare function registerSharedHandlebarsHelpers(Handlebars: {
+    registerHelper: (name: string, fn: (...args: any[]) => any) => void;
+}): void;
+/**
+ * Get the names of all shared helpers.
+ */
+export declare function getSharedHandlebarsHelperNames(): string[];