@pnp/spfx-controls-react 3.17.0-beta.7003036 → 3.17.0-beta.7072516

package/lib/common/utilities/FormulaEvaluation.types.d.ts

@@ -0,0 +1,23 @@
+export declare type TokenType = "FUNCTION" | "STRING" | "NUMBER" | "UNARY_MINUS" | "BOOLEAN" | "WORD" | "OPERATOR" | "ARRAY" | "VARIABLE";
+export declare class Token {
+    type: TokenType;
+    value: string | number;
+    constructor(tokenType: TokenType, value: string | number);
+    toString(): string;
+}
+export declare type ArrayNodeValue = (string | number | ArrayNodeValue)[];
+export declare class ArrayLiteralNode {
+    elements: ArrayNodeValue;
+    constructor(elements: ArrayNodeValue);
+    evaluate(): ArrayNodeValue;
+}
+export declare type ASTNode = {
+    type: string;
+    value?: string | number;
+    operands?: (ASTNode | ArrayLiteralNode)[];
+};
+export declare type Context = {
+    [key: string]: boolean | number | object | string | undefined;
+};
+export declare const ValidFuncNames: string[];
+//# sourceMappingURL=FormulaEvaluation.types.d.ts.map

package/lib/common/utilities/FormulaEvaluation.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormulaEvaluation.types.d.ts","sourceRoot":"","sources":["../../../src/common/utilities/FormulaEvaluation.types.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;AAElI,qBAAa,KAAK;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;gBAEX,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAKxD,QAAQ,IAAI,MAAM;CAGrB;AAED,oBAAY,cAAc,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC,EAAE,CAAC;AAClE,qBAAa,gBAAgB;IACzB,QAAQ,EAAE,cAAc,CAAC;gBAEb,QAAQ,EAAE,cAAc;IAIpC,QAAQ,IAAI,cAAc;CAqB7B;AAED,oBAAY,OAAO,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,OAAO,GAAG,gBAAgB,CAAC,EAAE,CAAC;CAC7C,CAAC;AAEF,oBAAY,OAAO,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAExF,eAAO,MAAM,cAAc,UAyC1B,CAAC"}

package/lib/common/utilities/FormulaEvaluation.types.js

@@ -0,0 +1,80 @@
+var Token = /** @class */ (function () {
+    function Token(tokenType, value) {
+        this.type = tokenType;
+        this.value = value;
+    }
+    Token.prototype.toString = function () {
+        return "".concat(this.type, ": ").concat(this.value);
+    };
+    return Token;
+}());
+export { Token };
+var ArrayLiteralNode = /** @class */ (function () {
+    function ArrayLiteralNode(elements) {
+        this.elements = elements; // Store array elements
+    }
+    ArrayLiteralNode.prototype.evaluate = function () {
+        // Evaluate array elements and return the array
+        var evaluatedElements = this.elements.map(function (element) {
+            if (element instanceof ArrayLiteralNode) {
+                return element.evaluate();
+            }
+            else {
+                if (typeof element === "string" &&
+                    ((element.startsWith("'") && element.endsWith("'")) ||
+                        (element.startsWith('"') && element.endsWith('"')))) {
+                    return element.slice(1, -1);
+                }
+                else {
+                    return element;
+                }
+            }
+        });
+        return evaluatedElements;
+    };
+    return ArrayLiteralNode;
+}());
+export { ArrayLiteralNode };
+export var ValidFuncNames = [
+    "if",
+    "ternary",
+    "Number",
+    "abs",
+    "floor",
+    "ceiling",
+    "pow",
+    "cos",
+    "sin",
+    "indexOf",
+    "lastIndexOf",
+    "toString",
+    "join",
+    "substring",
+    "toUpperCase",
+    "toLowerCase",
+    "startsWith",
+    "endsWith",
+    "replaceAll",
+    "replace",
+    "padStart",
+    "padEnd",
+    "split",
+    "toDateString",
+    "toDate",
+    "toLocaleString",
+    "toLocaleDateString",
+    "toLocaleTimeString",
+    "getDate",
+    "getMonth",
+    "getYear",
+    "addDays",
+    "addMinutes",
+    "getUserImage",
+    "getThumbnailImage",
+    "indexOf",
+    "length",
+    "appendTo",
+    "removeFrom",
+    "loopIndex"
+];
+//# sourceMappingURL=FormulaEvaluation.types.js.map

package/lib/common/utilities/FormulaEvaluation.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormulaEvaluation.types.js","sourceRoot":"","sources":["../../../src/common/utilities/FormulaEvaluation.types.ts"],"names":[],"mappings":"AAEA;IAII,eAAY,SAAoB,EAAE,KAAsB;QACpD,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,wBAAQ,GAAR;QACI,OAAO,UAAG,IAAI,CAAC,IAAI,eAAK,IAAI,CAAC,KAAK,CAAE,CAAC;IACzC,CAAC;IACL,YAAC;AAAD,CAAC,AAZD,IAYC;;AAGD;IAGI,0BAAY,QAAwB;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,uBAAuB;IACrD,CAAC;IAED,mCAAQ,GAAR;QACI,+CAA+C;QAC/C,IAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAC,OAAO;YAChD,IAAI,OAAO,YAAY,gBAAgB,EAAE;gBACrC,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;aAC7B;iBAAM;gBACH,IACI,OAAO,OAAO,KAAK,QAAQ;oBAC3B,CACI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;wBAClD,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CACrD,EACH;oBACE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;iBAC/B;qBAAM;oBACH,OAAO,OAAO,CAAC;iBAClB;aACJ;QACL,CAAC,CAAC,CAAC;QACH,OAAO,iBAAiB,CAAC;IAC7B,CAAC;IACL,uBAAC;AAAD,CAAC,AA5BD,IA4BC;;AAUD,MAAM,CAAC,IAAM,cAAc,GAAG;IAC1B,IAAI;IACJ,SAAS;IACT,QAAQ;IACR,KAAK;IACL,OAAO;IACP,SAAS;IACT,KAAK;IACL,KAAK;IACL,KAAK;IACL,SAAS;IACT,aAAa;IACb,UAAU;IACV,MAAM;IACN,WAAW;IACX,aAAa;IACb,aAAa;IACb,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,SAAS;IACT,UAAU;IACV,QAAQ;IACR,OAAO;IACP,cAAc;IACd,QAAQ;IACR,gBAAgB;IAChB,oBAAoB;IACpB,oBAAoB;IACpB,SAAS;IACT,UAAU;IACV,SAAS;IACT,SAAS;IACT,YAAY;IACZ,cAAc;IACd,mBAAmB;IACnB,SAAS;IACT,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,WAAW;CACd,CAAC"}

package/lib/common/utilities/ICustomFormatting.d.ts

@@ -0,0 +1,27 @@
+import { CSSProperties } from "react";
+export interface ICustomFormattingExpressionNode {
+    operator: string;
+    operands: (string | number | ICustomFormattingExpressionNode)[];
+}
+export interface ICustomFormattingNode {
+    elmType: keyof HTMLElementTagNameMap;
+    iconName: string;
+    style: CSSProperties;
+    attributes?: {
+        [key: string]: string;
+    };
+    children?: ICustomFormattingNode[];
+    txtContent?: string;
+}
+export interface ICustomFormattingBodySection {
+    displayname: string;
+    fields: string[];
+}
+export interface ICustomFormatting {
+    headerJSONFormatter: ICustomFormattingNode;
+    bodyJSONFormatter: {
+        sections: ICustomFormattingBodySection[];
+    };
+    footerJSONFormatter: ICustomFormattingNode;
+}
+//# sourceMappingURL=ICustomFormatting.d.ts.map

package/lib/common/utilities/ICustomFormatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICustomFormatting.d.ts","sourceRoot":"","sources":["../../../src/common/utilities/ICustomFormatting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,WAAW,+BAA+B;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,+BAA+B,CAAC,EAAE,CAAC;CACnE;AAED,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,qBAAqB,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,CAAC,EAAE;QACT,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,iBAAiB,EAAE;QACf,QAAQ,EAAE,4BAA4B,EAAE,CAAC;KAC5C,CAAC;IACF,mBAAmB,EAAE,qBAAqB,CAAC;CAC9C"}

package/lib/common/utilities/ICustomFormatting.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ICustomFormatting.js.map

package/lib/common/utilities/ICustomFormatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICustomFormatting.js","sourceRoot":"","sources":["../../../src/common/utilities/ICustomFormatting.ts"],"names":[],"mappings":""}

package/lib/controls/dynamicForm/DynamicForm.d.ts

@@ -1,38 +1,86 @@
 import * as React from "react";
-import { IDynamicFormProps } from "./IDynamicFormProps";
-import { IDynamicFormState } from "./IDynamicFormState";
 import "@pnp/sp/lists";
 import "@pnp/sp/content-types";
 import "@pnp/sp/folders";
 import "@pnp/sp/items";
+import { IDynamicFormProps } from "./IDynamicFormProps";
+import { IDynamicFormState } from "./IDynamicFormState";
 /**
  * DynamicForm Class Control
  */
 export declare class DynamicForm extends React.Component<IDynamicFormProps, IDynamicFormState> {
     private _spService;
+    private _formulaEvaluation;
+    private _customFormatter;
     private webURL;
     constructor(props: IDynamicFormProps);
     /**
      * Lifecycle hook when component is mounted
      */
     componentDidMount(): void;
+    componentDidUpdate(prevProps: IDynamicFormProps, prevState: IDynamicFormState): void;
     /**
      * Default React component render method
      */
     render(): JSX.Element;
+    private renderField;
+    private updateFormMessages;
+    /** Triggered when the user submits the form. */
     private onSubmitClick;
+    /**
+     * Adds selected file to the library
+     */
     private addFileToLibrary;
+    /**
+     * Triggered when the user makes any field value change in the form
+     */
     private onChange;
-    private getFieldInformations;
+    /** Validation callback, used when form first loads (getListInformation) and following onChange */
+    private performValidation;
+    /** Determines visibility of fields that have show/hide formulas set in Edit Form > Edit Columns > Edit Conditional Formula */
+    private evaluateColumnVisibilityFormulas;
+    /** Evaluates field validation formulas set in column settings and returns a Record of error messages */
+    private evaluateFieldValueFormulas;
+    /**
+     * Evaluates formulas and returns a Record of error messages or an array of column names that have failed validation
+     * @param formulas A Record / dictionary-like object, where key is internal column name and value is an object with ValidationFormula and ValidationMessage properties
+     * @param returnMessages Determines whether a Record of error messages is returned or an array of column names that have failed validation
+     * @param requireValue Set to true if the formula should only be evaluated when the field has a value
+     * @returns
+     */
+    private evaluateFormulas;
+    /**
+     * Used for validation. Returns a Record of field values, where key is internal column name and value is the field value.
+     * Expands certain properties and stores many of them as primitives (strings, numbers or bools) so the expression evaluator
+     * can process them. For example: a User column named Person will have values stored as Person, Person.email, Person.title etc.
+     * This is so the expression evaluator can process expressions like '=[$Person.title] == "Contoso Employee 1138"'
+     * @param fieldCollection Optional. Could be used to compare field values in state with previous state.
+     * @returns
+     */
+    private getFormValuesForValidation;
+    /**
+     * Invoked when component first mounts, loads information about the SharePoint list, fields and list item
+     */
+    private getListInformation;
+    /**
+     * Builds a collection of fields to be rendered in the form
+     * @param listInfo Data returned by RenderListDataAsStream with RenderOptions = 64 (ClientFormSchema)
+     * @param contentTypeName SharePoint List Content Type
+     * @param item SharePoint List Item
+     * @param numberFields Additional information about Number fields (min and max values)
+     * @param listId SharePoint List ID
+     * @param listItemId SharePoint List Item ID
+     * @param disabledFields Fields that should be disabled due to configuration
+     * @returns
+     */
+    private buildFieldCollection;
     private cultureNameLookup;
     private uploadImage;
     private getImageArrayBuffer;
-    private getFormFields;
     private closeValidationErrorDialog;
     private getValidationErrorTitle;
     private getValidationErrorMessage;
     private renderFileSelectionControl;
     private getFileIconFromExtension;
-    private isEmptyNumOrString;
 }
 //# sourceMappingURL=DynamicForm.d.ts.map

package/lib/controls/dynamicForm/DynamicForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DynamicForm.d.ts","sourceRoot":"","sources":["../../../src/controls/dynamicForm/DynamicForm.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAW/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAOxD,OAAO,eAAe,CAAC;AACvB,OAAO,uBAAuB,CAAC;AAC/B,OAAO,iBAAiB,CAAC;AACzB,OAAO,eAAe,CAAC;AAIvB;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK,CAAC,SAAS,CAC9C,iBAAiB,EACjB,iBAAiB,CAClB;IACC,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,MAAM,CAEqC;gBAEvC,KAAK,EAAE,iBAAiB;IA8BpC;;OAEG;IACI,iBAAiB,IAAI,IAAI;IAUhC;;OAEG;IACI,MAAM,IAAI,GAAG,CAAC,OAAO;IAsF5B,OAAO,CAAC,aAAa,CA4QnB;IAEF,OAAO,CAAC,gBAAgB,CAwDvB;IAGD,OAAO,CAAC,QAAQ,CAkDd;IAGF,OAAO,CAAC,oBAAoB,CAyR1B;IAEF,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,WAAW,CAqBjB;IAEF,OAAO,CAAC,mBAAmB,CASzB;IAEF,OAAO,CAAC,aAAa,CA0CnB;IAEF,OAAO,CAAC,0BAA0B,CAIhC;IAEF,OAAO,CAAC,uBAAuB,CAS7B;IAEF,OAAO,CAAC,yBAAyB,CAS/B;IAEF,OAAO,CAAC,0BAA0B,CA6CjC;IAED,OAAO,CAAC,wBAAwB,CAsB/B;IAED,OAAO,CAAC,kBAAkB;CAG3B"}
+{"version":3,"file":"DynamicForm.d.ts","sourceRoot":"","sources":["../../../src/controls/dynamicForm/DynamicForm.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA6B/B,OAAO,eAAe,CAAC;AACvB,OAAO,uBAAuB,CAAC;AAC/B,OAAO,iBAAiB,CAAC;AACzB,OAAO,eAAe,CAAC;AAYvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK,CAAC,SAAS,CAC9C,iBAAiB,EACjB,iBAAiB,CAClB;IACC,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,kBAAkB,CAAoB;IAC9C,OAAO,CAAC,gBAAgB,CAAyB;IAEjD,OAAO,CAAC,MAAM,CAEqC;gBAEvC,KAAK,EAAE,iBAAiB;IA0CpC;;OAEG;IACI,iBAAiB,IAAI,IAAI;IAWzB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAwB3F;;OAEG;IACI,MAAM,IAAI,GAAG,CAAC,OAAO;IAqH5B,OAAO,CAAC,WAAW,CAoClB;IAED,OAAO,CAAC,kBAAkB;IAO1B,gDAAgD;IAChD,OAAO,CAAC,aAAa,CA+TnB;IAEF;;OAEG;IACH,OAAO,CAAC,gBAAgB,CA2DvB;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ,CAyFd;IAEF,kGAAkG;IAClG,OAAO,CAAC,iBAAiB,CAexB;IAED,8HAA8H;IAC9H,OAAO,CAAC,gCAAgC,CAEvC;IAED,wGAAwG;IACxG,OAAO,CAAC,0BAA0B,CAEjC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB,CA2BvB;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,0BAA0B,CAsCjC;IAED;;OAEG;IACH,OAAO,CAAC,kBAAkB,CAgHzB;IAED;;;;;;;;;;OAUG;YAEW,oBAAoB;IA0QlC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,WAAW,CAqBjB;IAEF,OAAO,CAAC,mBAAmB,CASzB;IAEF,OAAO,CAAC,0BAA0B,CAIhC;IAEF,OAAO,CAAC,uBAAuB,CAS7B;IAEF,OAAO,CAAC,yBAAyB,CAS/B;IAEF,OAAO,CAAC,0BAA0B,CA6CjC;IAED,OAAO,CAAC,wBAAwB,CAsB/B;CAEF"}