ngx-t-forms-types 0.0.28 → 0.0.30

package/dist/interfaces/Form/ArrayFunctions.d.ts

@@ -29,7 +29,9 @@ export declare enum FunctionTypes {
     /** Group items into buckets keyed by one or more paths. Returns a record of arrays. Terminal. */
     GroupBy = "groupBy",
     /** Aggregate items into a scalar or summary object (sum/avg/min/max/count/first/last/join). Terminal. */
-    Reduce = "reduce"
+    Reduce = "reduce",
+    /** Add derived fields to each item via an arithmetic expression (`alias = a * b`, child aggregates, `round`). Returns an array. */
+    Compute = "compute"
 }
 /**
  * A single declarative array-transform step.

package/dist/interfaces/Form/ArrayFunctions.js

@@ -31,5 +31,7 @@ export var FunctionTypes;
     FunctionTypes["GroupBy"] = "groupBy";
     /** Aggregate items into a scalar or summary object (sum/avg/min/max/count/first/last/join). Terminal. */
     FunctionTypes["Reduce"] = "reduce";
+    /** Add derived fields to each item via an arithmetic expression (`alias = a * b`, child aggregates, `round`). Returns an array. */
+    FunctionTypes["Compute"] = "compute";
     // Add more function types here as needed
 })(FunctionTypes || (FunctionTypes = {}));

package/dist/interfaces/FormBuilder/elementEditor.d.ts

@@ -43,6 +43,20 @@ export declare enum ElementEditorTypes {
     HeaderTemplate = "headerTemplate",
     /** JSON query-parameter template ({@link QueryTemplate}) for a value/options fetch (GET and POST alike). */
     QueryTemplate = "queryTemplate",
+    /**
+     * Single-line text carrying `{{token}}` references, with the `$`-trigger
+     * picker over the form's inputs.
+     *
+     * The same gesture the JSON template editors offer — type `$`, pick a field,
+     * get its `{{token}}` inserted — but over plain text rather than JSON. Use it
+     * wherever an author writes a short string that should interpolate document
+     * values: an email subject, a generated title, a reference format.
+     *
+     * NOT {@link ElementEditorTypes.Input}: that renders a bare `matInput` with no
+     * `$` affordance at all, so an element using it cannot offer the picker no
+     * matter what bindings are available.
+     */
+    TokenTextInput = "tokenTextInput",
     /**
      * Composite editor owning a whole `matOptions.fetch.<slot>` API config:
      * endpoint selection, query parameters, headers, body mapping/template and
@@ -50,7 +64,17 @@ export declare enum ElementEditorTypes {
      * default config; the individual editTypes above remain renderable for
      * host-supplied custom `editorSections`.
      */
-    ApiEndpointConfig = "apiEndpointConfig"
+    ApiEndpointConfig = "apiEndpointConfig",
+    /**
+     * Composite editor owning the WHOLE `mscoaConfig` object: accounting basis,
+     * account value label, the accrual and cash segment sets, the dual-basis
+     * cash-exclusion rules and the counter-account extensions.
+     *
+     * Replaced eight separate rows that each bound one key. Those keys are still
+     * the storage shape — only the authoring surface was unified, into a summary
+     * card plus a guided setup dialog.
+     */
+    MscoaConfig = "mscoaConfigSetup"
 }
 export interface ElementEditorConfigInterface {
     editorSections: Array<ElementEditorConfigSectionInterface>;
@@ -97,6 +121,36 @@ export interface ElementEditorInnerSectionElementInterface {
         label: string;
         value: any;
     }>;
+    /**
+     * Insertable entries for the `$`-trigger token picker on
+     * {@link ElementEditorTypes.TokenTextInput} and
+     * {@link ElementEditorTypes.RichTextEditor} elements.
+     *
+     * INJECTED AT RUNTIME by the host, the same way picker `options` are: the
+     * workflow step editor passes `formInputs: []` to `lib-t-dynamic-data-edit`
+     * and resolves every picker's option pool onto the element config instead
+     * (`ngx-t-workflows/.../workflowDiagramSelectors.ts`, `stepEditorSections$`).
+     * When present and non-empty this list wins over anything derived from
+     * `formInputs`; when absent the editor falls back to that derivation, which
+     * is what the form builder (which DOES pass real `formInputs`) relies on.
+     *
+     * Structurally identical to the editor components' `EditorBinding` — declared
+     * here rather than imported because this package cannot depend on the lib.
+     */
+    bindings?: ReadonlyArray<{
+        /** Human label shown in the menu — never the raw id. */
+        label: string;
+        /** Exact text inserted at the caret, e.g. `"{{contractType}}"`. */
+        insert: string;
+        /** Text matched against the `$`-filter; defaults to `label`. */
+        searchText?: string;
+        /** Optional Material icon name. */
+        icon?: string;
+        /** Muted second line (field kind, owning step). */
+        detail?: string;
+        /** Other token contents recognised as this field. */
+        aliases?: readonly string[];
+    }>;
     computedErrors?: ValidationError[];
     min?: number;
     max?: number;

package/dist/interfaces/FormBuilder/elementEditor.js

@@ -37,6 +37,20 @@ export var ElementEditorTypes;
     ElementEditorTypes["HeaderTemplate"] = "headerTemplate";
     /** JSON query-parameter template ({@link QueryTemplate}) for a value/options fetch (GET and POST alike). */
     ElementEditorTypes["QueryTemplate"] = "queryTemplate";
+    /**
+     * Single-line text carrying `{{token}}` references, with the `$`-trigger
+     * picker over the form's inputs.
+     *
+     * The same gesture the JSON template editors offer — type `$`, pick a field,
+     * get its `{{token}}` inserted — but over plain text rather than JSON. Use it
+     * wherever an author writes a short string that should interpolate document
+     * values: an email subject, a generated title, a reference format.
+     *
+     * NOT {@link ElementEditorTypes.Input}: that renders a bare `matInput` with no
+     * `$` affordance at all, so an element using it cannot offer the picker no
+     * matter what bindings are available.
+     */
+    ElementEditorTypes["TokenTextInput"] = "tokenTextInput";
     /**
      * Composite editor owning a whole `matOptions.fetch.<slot>` API config:
      * endpoint selection, query parameters, headers, body mapping/template and
@@ -45,6 +59,16 @@ export var ElementEditorTypes;
      * host-supplied custom `editorSections`.
      */
     ElementEditorTypes["ApiEndpointConfig"] = "apiEndpointConfig";
+    /**
+     * Composite editor owning the WHOLE `mscoaConfig` object: accounting basis,
+     * account value label, the accrual and cash segment sets, the dual-basis
+     * cash-exclusion rules and the counter-account extensions.
+     *
+     * Replaced eight separate rows that each bound one key. Those keys are still
+     * the storage shape — only the authoring surface was unified, into a summary
+     * card plus a guided setup dialog.
+     */
+    ElementEditorTypes["MscoaConfig"] = "mscoaConfigSetup";
 })(ElementEditorTypes || (ElementEditorTypes = {}));
 // interface TStringExpressionValidationTest{
 //   expression: string;

package/dist/interfaces/FormBuilder/index.d.ts

@@ -1,6 +1,6 @@
 import { DefaultInputConfig, defaultInputs } from "./DefaultEelement.js";
 import { DefaultInputConfigInterface } from "./DefaultInputConfigInterface.js";
-import { getElementEditorConfig } from "./inputConfig/ElementEditConfig.js";
+import { getElementEditorConfig, MSCOA_ACCOUNT_VALUE_LABEL_OPTIONS, MSCOA_DUAL_CASH_EXCLUSION_RULE_EDITOR } from "./inputConfig/ElementEditConfig.js";
 import { AllFormInputPrimaryKeys, FormInputKeys, SpecialElementKeys } from "./FormInputKeys.js";
 import { BlurHandleTypes, ConfigurationValidTestInterface, ElementEditorConfigSectionInterface, ElementEditorInnerSectionElementInterface, ElementEditorTypes } from "./elementEditor.js";
 import { IWorkflowOption } from "./workflowSelectionConfig.js";
@@ -8,4 +8,4 @@ import { FormBuilderFunctions } from "./FormBuilderCallBackFunctions.js";
 import { IGetPostmanCollections, IPostmanCollectionConfig } from "./postmanCollection.js";
 import { DataSources } from "../formInput/APIDataFetchingConfigurationInterface.js";
 import { IScoaAccount } from "../formInput/IMscoaAccount.js";
-export { DefaultInputConfigInterface, BlurHandleTypes, FormInputKeys, ElementEditorTypes, ConfigurationValidTestInterface, ElementEditorInnerSectionElementInterface, SpecialElementKeys, AllFormInputPrimaryKeys, DefaultInputConfig, defaultInputs, getElementEditorConfig, IWorkflowOption, FormBuilderFunctions, IGetPostmanCollections, IPostmanCollectionConfig, DataSources, ElementEditorConfigSectionInterface, IScoaAccount, };
+export { DefaultInputConfigInterface, BlurHandleTypes, FormInputKeys, ElementEditorTypes, ConfigurationValidTestInterface, ElementEditorInnerSectionElementInterface, SpecialElementKeys, AllFormInputPrimaryKeys, DefaultInputConfig, defaultInputs, getElementEditorConfig, MSCOA_ACCOUNT_VALUE_LABEL_OPTIONS, MSCOA_DUAL_CASH_EXCLUSION_RULE_EDITOR, IWorkflowOption, FormBuilderFunctions, IGetPostmanCollections, IPostmanCollectionConfig, DataSources, ElementEditorConfigSectionInterface, IScoaAccount, };

package/dist/interfaces/FormBuilder/index.js

@@ -1,6 +1,6 @@
 import { DefaultInputConfig, defaultInputs } from "./DefaultEelement.js";
-import { getElementEditorConfig } from "./inputConfig/ElementEditConfig.js";
+import { getElementEditorConfig, MSCOA_ACCOUNT_VALUE_LABEL_OPTIONS, MSCOA_DUAL_CASH_EXCLUSION_RULE_EDITOR } from "./inputConfig/ElementEditConfig.js";
 import { AllFormInputPrimaryKeys, FormInputKeys, SpecialElementKeys } from "./FormInputKeys.js";
 import { BlurHandleTypes, ElementEditorTypes } from "./elementEditor.js";
 import { DataSources } from "../formInput/APIDataFetchingConfigurationInterface.js";
-export { BlurHandleTypes, FormInputKeys, ElementEditorTypes, SpecialElementKeys, AllFormInputPrimaryKeys, DefaultInputConfig, defaultInputs, getElementEditorConfig, DataSources, };
+export { BlurHandleTypes, FormInputKeys, ElementEditorTypes, SpecialElementKeys, AllFormInputPrimaryKeys, DefaultInputConfig, defaultInputs, getElementEditorConfig, MSCOA_ACCOUNT_VALUE_LABEL_OPTIONS, MSCOA_DUAL_CASH_EXCLUSION_RULE_EDITOR, DataSources, };

package/dist/interfaces/FormBuilder/inputConfig/ElementEditConfig.d.ts

@@ -1,3 +1,24 @@
-import { ElementEditorConfigInterface } from "../elementEditor.js";
+import { ElementEditorConfigInterface, ElementEditorConfigSectionInterface } from "../elementEditor.js";
+/**
+ * Fields an MSCOA account can be displayed by. Chosen once per input and used
+ * for every account the picker renders, so an administrator reads the same
+ * identifier in the chart that the account carries in the chart of accounts.
+ *
+ * Exported because the unified MSCOA setup editor renders this list itself;
+ * it is the option pool for the `accountValueLabel` picker.
+ */
+export declare const MSCOA_ACCOUNT_VALUE_LABEL_OPTIONS: Array<{
+    label: string;
+    value: string;
+}>;
+/**
+ * Per-record editor for one cash-exclusion regex rule
+ * (`IDualCashExclusionRule`), rendered by the unified MSCOA setup editor's
+ * "Cash rules" panel (Dual basis only).
+ *
+ * Exported because that editor builds the record-list element around it and
+ * fills the segment row's options from the input's own accrual segments.
+ */
+export declare const MSCOA_DUAL_CASH_EXCLUSION_RULE_EDITOR: () => Array<ElementEditorConfigSectionInterface>;
 export declare var ElementConfig: ElementEditorConfigInterface;
 export declare const getElementEditorConfig: ElementEditorConfigInterface;

package/dist/interfaces/FormBuilder/inputConfig/ElementEditConfig.js

@@ -4,7 +4,6 @@ import { AdjudicationSteps, ElementTypes, InputDataTypes, InputPipeTypes, InputT
 import { DataSources } from "../../formInput/APIDataFetchingConfigurationInterface.js";
 import { OptionSelectTypes } from "../../formInput/BasicFormInputInterface.js";
 import { InputFileType } from "../../formInput/FileUploadInputInterface.js";
-import { AccountingBasis } from "../../formInput/IMscoaAccount.js";
 import { MultipleInputAvailableOperations } from "../../formInput/MultipleInterface.js";
 import { RichTextEditorType } from "../../formInput/RichTextEditorInput.js";
 import { LabelPosition } from "../../formInput/ToggleInputInterface.js";
@@ -30,20 +29,214 @@ const DOCUMENT_PICKER_FILTER_VALUE_SOURCE_LABELS = {
     input: 'From another input',
 };
 /**
+
  * Shows a row only while the filter is NOT input-bound.
+
  *
+
  * Deliberately written as `!== input` rather than `=== fixed`: `valueSource` is
+
  * absent on every filter saved before the switch existed and on a brand-new
+
  * record, and `testAgainstItem` resolves an absent deep-bound key to `undefined`.
+
  * `undefined !== 'input'` is true, so the fixed-value rows stay visible for those
+
  * records instead of silently becoming uneditable.
+
  */
 const DOCUMENT_PICKER_FILTER_IS_FIXED_TEST = `valueSource !== input`;
 /** Shows a row only once the administrator has explicitly chosen the input source. */
 const DOCUMENT_PICKER_FILTER_IS_INPUT_TEST = `valueSource === input`;
 /**
+ * Fields an MSCOA account can be displayed by. Chosen once per input and used
+ * for every account the picker renders, so an administrator reads the same
+ * identifier in the chart that the account carries in the chart of accounts.
+ *
+ * Exported because the unified MSCOA setup editor renders this list itself;
+ * it is the option pool for the `accountValueLabel` picker.
+ */
+export const MSCOA_ACCOUNT_VALUE_LABEL_OPTIONS = [{
+        "label": "SCOA ID",
+        "value": "SCOAid"
+    }, {
+        "label": "Full Account Number",
+        "value": "AccountNumber"
+    }, {
+        "label": "Account Number",
+        "value": "AccountNumberShortened"
+    }, {
+        "label": "Short Description",
+        "value": "ShortDescription"
+    }, {
+        "label": "Definition Description",
+        "value": "DefinitionDescription"
+    }, {
+        "label": "SCOA Account",
+        "value": "SCOAAccount"
+    }, {
+        "label": "Account Prefix",
+        "value": "AccountNumberPrefix"
+    }, {
+        "label": "Applicable To",
+        "value": "ApplicableTo"
+    }, {
+        "label": "BreakDown Allowed",
+        "value": "BreakDownAllowed"
+    }, {
+        "label": "Parent SCOA ID",
+        "value": "ParentSCOAId"
+    }, {
+        "label": "Posting Level",
+        "value": "PostingLevel"
+    }, {
+        "label": "Principle",
+        "value": "Principle"
+    }, {
+        "label": "SCOA File",
+        "value": "SCOAFile"
+    }, {
+        "label": "SCOA Level",
+        "value": "SCOALevel"
+    }, {
+        "label": "VAT Status",
+        "value": "VATStatus"
+    }, {
+        "label": "A2A",
+        "value": "A2A"
+    }, {
+        "label": "A4",
+        "value": "A4"
+    }, {
+        "label": "A4F",
+        "value": "A4F"
+    }, {
+        "label": "A5",
+        "value": "A5"
+    }, {
+        "label": "A6",
+        "value": "A6"
+    }, {
+        "label": "A6F",
+        "value": "A6F"
+    }, {
+        "label": "A7",
+        "value": "A7"
+    }, {
+        "label": "A8",
+        "value": "A8"
+    }, {
+        "label": "A9",
+        "value": "A9"
+    }, {
+        "label": "IUDF",
+        "value": "IUDF"
+    }, {
+        "label": "MTSF",
+        "value": "MTSF"
+    }, {
+        "label": "NATGRANT",
+        "value": "NATGRANT"
+    }, {
+        "label": "SA1",
+        "value": "SA1"
+    }, {
+        "label": "SA3",
+        "value": "SA3"
+    }, {
+        "label": "SA30",
+        "value": "SA30"
+    }, {
+        "label": "SA34A",
+        "value": "SA34A"
+    }, {
+        "label": "SA34B",
+        "value": "SA34B"
+    }, {
+        "label": "SA34C",
+        "value": "SA34C"
+    }, {
+        "label": "SA34D",
+        "value": "SA34D"
+    }, {
+        "label": "SA34E",
+        "value": "SA34E"
+    }, {
+        "label": "Created At",
+        "value": "createdAt"
+    }, {
+        "label": "Updated At",
+        "value": "updatedAt"
+    }, {
+        "label": "Select",
+        "value": "selection"
+    }];
+/**
+ * Per-record editor for one cash-exclusion regex rule
+ * (`IDualCashExclusionRule`), rendered by the unified MSCOA setup editor's
+ * "Cash rules" panel (Dual basis only).
+ *
+ * Exported because that editor builds the record-list element around it and
+ * fills the segment row's options from the input's own accrual segments.
+ */
+export const MSCOA_DUAL_CASH_EXCLUSION_RULE_EDITOR = () => [
+    {
+        label: 'Condition',
+        id: "8c4f2d1a-6b3e-4a90-b7d5-1e8a9c62f430",
+        elements: [
+            {
+                name: SpecialElementKeys.Default,
+                deepBind: ['pattern'],
+                editType: ElementEditorTypes.Input,
+                label: 'Regular expression',
+                required: true,
+                placeholder: '^Expenditure:Depreciation',
+                hint: `A JavaScript regular expression (without the surrounding slashes). It is tested against each selected accrual account's SCOA account value and against the configured account value label field. An invalid expression never matches, so it can never suppress cash by accident.`,
+                id: "3b7e9f52-0d84-4c16-a2e8-7f5c1d90b364"
+            },
+            {
+                name: SpecialElementKeys.Default,
+                deepBind: ['flags'],
+                editType: ElementEditorTypes.Input,
+                label: 'Expression flags',
+                placeholder: 'i',
+                hint: `Optional regular-expression flags, e.g. "i" for a case-insensitive match. Leave empty for an exact-case match.`,
+                id: "6a1c8e40-935f-4d27-b8e3-0c4d7f26a591"
+            },
+            {
+                name: SpecialElementKeys.Default,
+                deepBind: ['segment'],
+                editType: ElementEditorTypes.ChipSelect,
+                label: 'Limit to segment',
+                // The real option list is filled in at runtime by the MSCOA setup
+                // editor, which knows the input's configured accrual segments — this
+                // package never sees the input being edited. The single entry below is
+                // the fallback AND the semantic default: no scope = every segment. NO
+                // `defaultValue`, so opening a saved rule never stamps a scope onto it.
+                options: [
+                    { label: 'Every accrual segment', value: '' },
+                ],
+                hint: `Optional. When set, the expression is only tested against the accounts selected for that accrual segment. Leave it on 'Every accrual segment' to test them all. Only segments you have configured under 'Configure MScoa Accrual segments' can be chosen — a scope that no longer exists can never match.`,
+                id: "e5d20b73-4816-4f9a-8c62-9b3a5e14d087"
+            },
+            {
+                name: SpecialElementKeys.Default,
+                deepBind: ['description'],
+                editType: ElementEditorTypes.Input,
+                label: 'Description',
+                placeholder: 'Non-cash items never require a cash leg',
+                hint: `Optional note explaining the business intent of this condition.`,
+                id: "1f6b4c92-7a05-4e38-9d17-c8e2a0b5f643"
+            },
+        ],
+    },
+];
+/**
+
  * Per-record editor for one preset filter (`IDocumentPickerFilter`) inside the
+
  * document picker's "Preset filters" list.
+
  */
 const DOCUMENT_PICKER_FILTER_EDITOR = () => [
     {
@@ -344,203 +537,20 @@ export var ElementConfig = {
                 },
                 {
                     name: AllFormInputPrimaryKeys.MscoaConfig,
-                    deepBind: ['mscoaConfig', 'accountingBasis'],
-                    editType: ElementEditorTypes.ChipSelect,
-                    label: 'Select Budget Accounting Basis',
-                    options: [
-                        {
-                            label: 'Performance (Accrual)',
-                            value: AccountingBasis.Accrual
-                        },
-                        {
-                            label: 'Liquidity (Cash)',
-                            value: AccountingBasis.Cash
-                        },
-                        {
-                            label: 'Dual (Both)',
-                            value: AccountingBasis.Dual
-                        }
-                    ],
-                    clearOnChange: [
-                        [AllFormInputPrimaryKeys.MscoaConfig, 'segments'],
-                        [AllFormInputPrimaryKeys.MscoaConfig, 'cashSegments'],
-                        [AllFormInputPrimaryKeys.MscoaConfig, 'showAllSegments']
-                    ],
-                    hint: "This choice dictates when funds are recognized: 'Accrual' impacts budgets based on commitments and invoices; 'Cash' restricts budget impact to actual bank movements; 'Dual' tracks both simultaneously for comprehensive reporting.",
-                    id: "d9ea60b9-653f-4d9c-88bd-f603a589cce0"
-                },
-                {
-                    name: AllFormInputPrimaryKeys.MscoaConfig,
-                    deepBind: ['mscoaConfig', 'accountValueLabel'],
-                    editType: ElementEditorTypes.ChipSelect,
-                    label: 'Account value label',
-                    hint: "Defines the label used to represent account values within the SCOA input, enhancing clarity in financial selections.",
-                    id: "1f29ce07-4f68-49d8-bb81-b1ab0fc08455",
-                    options: [{
-                            "label": "SCOA ID",
-                            "value": "SCOAid"
-                        }, {
-                            "label": "Full Account Number",
-                            "value": "AccountNumber"
-                        }, {
-                            "label": "Account Number",
-                            "value": "AccountNumberShortened"
-                        }, {
-                            "label": "Short Description",
-                            "value": "ShortDescription"
-                        }, {
-                            "label": "Definition Description",
-                            "value": "DefinitionDescription"
-                        }, {
-                            "label": "SCOA Account",
-                            "value": "SCOAAccount"
-                        }, {
-                            "label": "Account Prefix",
-                            "value": "AccountNumberPrefix"
-                        }, {
-                            "label": "Applicable To",
-                            "value": "ApplicableTo"
-                        }, {
-                            "label": "BreakDown Allowed",
-                            "value": "BreakDownAllowed"
-                        }, {
-                            "label": "Parent SCOA ID",
-                            "value": "ParentSCOAId"
-                        }, {
-                            "label": "Posting Level",
-                            "value": "PostingLevel"
-                        }, {
-                            "label": "Principle",
-                            "value": "Principle"
-                        }, {
-                            "label": "SCOA File",
-                            "value": "SCOAFile"
-                        }, {
-                            "label": "SCOA Level",
-                            "value": "SCOALevel"
-                        }, {
-                            "label": "VAT Status",
-                            "value": "VATStatus"
-                        }, {
-                            "label": "A2A",
-                            "value": "A2A"
-                        }, {
-                            "label": "A4",
-                            "value": "A4"
-                        }, {
-                            "label": "A4F",
-                            "value": "A4F"
-                        }, {
-                            "label": "A5",
-                            "value": "A5"
-                        }, {
-                            "label": "A6",
-                            "value": "A6"
-                        }, {
-                            "label": "A6F",
-                            "value": "A6F"
-                        }, {
-                            "label": "A7",
-                            "value": "A7"
-                        }, {
-                            "label": "A8",
-                            "value": "A8"
-                        }, {
-                            "label": "A9",
-                            "value": "A9"
-                        }, {
-                            "label": "IUDF",
-                            "value": "IUDF"
-                        }, {
-                            "label": "MTSF",
-                            "value": "MTSF"
-                        }, {
-                            "label": "NATGRANT",
-                            "value": "NATGRANT"
-                        }, {
-                            "label": "SA1",
-                            "value": "SA1"
-                        }, {
-                            "label": "SA3",
-                            "value": "SA3"
-                        }, {
-                            "label": "SA30",
-                            "value": "SA30"
-                        }, {
-                            "label": "SA34A",
-                            "value": "SA34A"
-                        }, {
-                            "label": "SA34B",
-                            "value": "SA34B"
-                        }, {
-                            "label": "SA34C",
-                            "value": "SA34C"
-                        }, {
-                            "label": "SA34D",
-                            "value": "SA34D"
-                        }, {
-                            "label": "SA34E",
-                            "value": "SA34E"
-                        }, {
-                            "label": "Created At",
-                            "value": "createdAt"
-                        }, {
-                            "label": "Updated At",
-                            "value": "updatedAt"
-                        }, {
-                            "label": "Select",
-                            "value": "selection"
-                        }]
-                },
-                {
-                    name: AllFormInputPrimaryKeys.MscoaConfig,
-                    editType: ElementEditorTypes.Toggle,
-                    label: 'Allow selection of all SCOA segments',
-                    deepBind: ['mscoaConfig', 'showAllSegments'],
-                    clearOnChange: [
-                        [AllFormInputPrimaryKeys.MscoaConfig, 'segments'],
-                        [AllFormInputPrimaryKeys.MscoaConfig, 'cashSegments'],
-                    ],
-                    hint: 'When enabled, allows selection from all Standard Chart of Accounts (SCOA) segments. Disable to limit available segments.',
-                    id: "0f78efcc-5477-4202-916a-8a7cf459c017"
-                },
-                {
-                    name: AllFormInputPrimaryKeys.MscoaConfig,
-                    deepBind: ['mscoaConfig', 'segments'],
-                    editType: ElementEditorTypes.ConfigMscoaSegments,
-                    label: 'Configure MScoa Accrual segments',
-                    defaultValue: false,
-                    fetchOptions: ['mscoaConfig', 'showAllSegments'],
-                    hint: "Configure SCOA segments to be used in the input",
-                    id: "ba1a5b79-b071-44a6-b39a-bf1c2fafcda5"
-                },
-                {
-                    name: AllFormInputPrimaryKeys.MscoaConfig,
-                    deepBind: ['mscoaConfig', 'cashSegments'],
-                    editType: ElementEditorTypes.ConfigMscoaSegments,
-                    label: 'Configure MScoa Cash segments',
-                    fetchOptions: ['mscoaConfig', 'showAllSegments'],
-                    additionalTest: [
-                        {
-                            // Show the cash-segments editor ONLY for an explicit Cash/Dual basis.
-                            // A positive whitelist (not `!== Accrual`) also hides it for the
-                            // unset/`undefined` default of a freshly-added input — `!== Accrual`
-                            // is true for `undefined`, which left it always visible.
-                            expression: `accountingBasis === ${AccountingBasis.Cash} || accountingBasis === ${AccountingBasis.Dual}`,
-                            deepBind: ['mscoaConfig', 'accountingBasis'],
-                        },
-                    ],
-                    hint: "Configure SCOA segments to be When mapping the Cash accounts",
-                    id: "f1a2b3c4-d5e6-4f70-8a9b-0c1d2e3f4a5b"
-                },
-                {
-                    name: AllFormInputPrimaryKeys.MscoaConfig,
-                    deepBind: ['mscoaConfig', 'extensionAccountsForSegments'],
-                    editType: ElementEditorTypes.ChipOptionsCreator,
-                    label: 'Additional account selection options',
-                    fetchOptions: ['mscoaConfig'],
-                    hint: "Config scoa segments counter account options for segments",
-                    id: "634b3c1a-f250-4b1a-8771-999b34882515"
+                    deepBind: ['mscoaConfig'],
+                    editType: ElementEditorTypes.MscoaConfig,
+                    label: 'MSCOA account setup',
+                    hint: `Everything this account picker asks the user for: which accounting basis it captures, the SCOA segments they pick from, how each account is labelled, and — for a dual basis — when the cash side is actually required. Opens a guided setup.`,
+                    // The whole `mscoaConfig` object is edited by one composite editor
+                    // (`ElementEditorTypes.MscoaConfig`), which replaced eight separate rows:
+                    // accountingBasis, accountValueLabel, showAllSegments, segments,
+                    // cashSegments, dualCashExclusion.rules, dualCashExclusion.matchMode and
+                    // extensionAccountsForSegments. Clearing dependent keys when the basis
+                    // changes is owned by that editor now, not by `clearOnChange` — the row no
+                    // longer binds a single key, so a path-based clear has nothing to key off.
+                    options: MSCOA_ACCOUNT_VALUE_LABEL_OPTIONS,
+                    secondaryElementEditorConfig: MSCOA_DUAL_CASH_EXCLUSION_RULE_EDITOR(),
+                    id: "0b6f3a91-8c47-4d52-9e3a-7f10c4b28d65"
                 },
                 // {
                 //     name: AllFormInputPrimaryKeys.MscoaConfig,
@@ -668,8 +678,8 @@ export var ElementConfig = {
                         }
                     ],
                     label: 'Adjudication point types',
-                    hint: `Configure adjudication point types for this input.
-                        This allows grouping or filtering points based on specific criteria, such as 'Functional', 'Financial'.
+                    hint: `Configure adjudication point types for this input.
+                        This allows grouping or filtering points based on specific criteria, such as 'Functional', 'Financial'.
                     .`,
                     id: "88e9e85c-66d8-4df3-9742-eba1f7e47a01"
                 },
@@ -684,8 +694,8 @@ export var ElementConfig = {
                         }
                     ],
                     label: 'Submission review Notes template',
-                    hint: `
-                        This helps the adjudicator to provide feedback on the submission. Add $bidderName, $bidderCode, $responseDate, $responsePreferenceCalculation to the template to dynamically insert values.
+                    hint: `
+                        This helps the adjudicator to provide feedback on the submission. Add $bidderName, $bidderCode, $responseDate, $responsePreferenceCalculation to the template to dynamically insert values.
                     .`,
                     id: "3907f723-b62b-4387-8f8f-133481ada45b"
                 },

package/dist/interfaces/environment/IStoreFunctions.d.ts

@@ -108,5 +108,16 @@ export interface IStoreFunctions {
         columnMapping: AdjResponseReviewColumnMapping;
         scoreSheet?: WorkflowAdjudicationScoreSheetValue[];
         adjudicationPricePreferenceCalculationFormula?: string;
+        /**
+         * "Rand value" of the procurement per PPR 2022 reg 1: the total
+         * estimated value of the contract in Rand, calculated at the time of
+         * the tender invitation (all applicable taxes included). Used by the
+         * library to auto-select the 80/20 vs 90/10 preference point system
+         * (≤ R50 million → 80/20; > R50 million → 90/10, regs 4(1)/5(1)) and
+         * as a reference for abnormally-low-tender flagging. Optional: when
+         * absent, the system is selected from the lowest acceptable tender
+         * received, per reg 3(b).
+         */
+        estimatedProcurementValue?: number;
     }>;
 }

package/dist/interfaces/formInput/IMscoaAccount.d.ts

@@ -121,6 +121,51 @@ export interface IIncludedSegmentConfig {
     segmentExtension: boolean;
     id: string;
 }
+/**
+ * How the {@link IDualCashExclusionConfig.rules} combine into one verdict.
+ * - `'any'`: cash is suppressed when AT LEAST ONE rule matches (default).
+ * - `'all'`: cash is suppressed only when EVERY rule matches.
+ */
+export type DualCashExclusionMatchMode = 'any' | 'all';
+/**
+ * One regex condition evaluated against the selected ACCRUAL account values of
+ * a Dual-basis MSCOA input. A rule "matches" when its pattern matches at least
+ * one selected accrual account value in its segment scope.
+ *
+ * The pattern is tested against the account's `SCOAAccount` value AND the value
+ * of the field named by {@link IScoaInputConfig.accountValueLabel} (what the
+ * user sees selected in the chart). An invalid pattern never matches — it can
+ * therefore never suppress the cash requirement by accident.
+ */
+export interface IDualCashExclusionRule {
+    /** Stable record id (stamped by the builder's record-list editor). */
+    id?: string;
+    /** JavaScript regular-expression source, without delimiters (e.g. `^1[0-9]{3}`). */
+    pattern: string;
+    /** Optional regex flags (e.g. `i`). Invalid flags make the rule evaluate as not matched. */
+    flags?: string;
+    /**
+     * Optional segment scope (matched case-insensitively against the accrual
+     * segment key, e.g. `ITEM`). Empty/absent = every accrual segment.
+     */
+    segment?: string;
+    /** Admin note describing the business intent of the rule. */
+    description?: string;
+}
+/**
+ * Dual-basis-only refinement of the "both bases required" rule. When the rules
+ * evaluate to a match (per {@link DualCashExclusionMatchMode}) against the
+ * selected accrual accounts, the cash side is suppressed: the cash table is
+ * hidden, cash account values are cleared from the input value, and validation
+ * requires the accrual side only. With no (usable) rules configured, the
+ * default Dual behaviour — cash AND accrual both required — is enforced.
+ */
+export interface IDualCashExclusionConfig {
+    /** Regex conditions evaluated against the selected accrual account values. */
+    rules?: IDualCashExclusionRule[];
+    /** How the rules combine; defaults to `'any'` when absent. */
+    matchMode?: DualCashExclusionMatchMode;
+}
 export interface IScoaInputConfig {
     inputs: ScoaInnerInput[];
     label: string;
@@ -131,6 +176,12 @@ export interface IScoaInputConfig {
     cashSegments: IIncludedSegmentConfig[] | undefined;
     accountValueLabel: string;
     showAllSegments: boolean;
+    /**
+     * Optional Dual-basis refinement: regex conditions under which the cash side
+     * is NOT required (see {@link IDualCashExclusionConfig}). Ignored for
+     * non-Dual accounting bases.
+     */
+    dualCashExclusion?: IDualCashExclusionConfig;
 }
 export interface IGetTreeResponse {
     message: string;

package/dist/interfaces/formInput/WorkflowAdjudication.d.ts

@@ -13,6 +13,17 @@ export interface AdjResponseReviewColumnMapping {
     respondentCodeKey: string;
     responsePreferenceCalculationKey?: string;
     responseDateKey?: string;
+    /**
+     * Form key on each submission row holding the tendered price ("price" per
+     * PPR 2022 reg 1: all applicable taxes included, less unconditional
+     * discounts). When present, the library's submission-review step computes
+     * the PPPFA price preference points itself (organically, per the
+     * Preferential Procurement Regulations 2022, regs 3–5) instead of relying
+     * on host-stamped scores. Falls back to `'totalBidPrice'` when omitted;
+     * if no row carries a usable price under that key either, the library
+     * keeps whatever score the host stamped onto the rows.
+     */
+    responsePriceKey?: string;
 }
 export interface WorkflowAdjudicationMicroFlowReviewValue {
     id: string;

package/dist/interfaces/formInput/index.d.ts

@@ -9,7 +9,7 @@ import { AllDocumentFileExtensions, AllImageFileExtensions, FileUploadInputValue
 import { DraftFormControlCustomValidator, FormControlCustomValidatorsInterface, InputObservedForChange } from "./FormControlCustomValidatorsInterface.js";
 import { IFormValidationOverride } from "./FormValidationOverride.js";
 import { FormInputBasicOptionInterface } from "./FormInputBasicOptionInterface.js";
-import { AccountingBasis, IAccountSegmentTreeKeys, IGetTreeResponse, IIncludedSegmentConfig, IScoaAccount, IScoaInput, IScoaInputConfig, ITableScoaSelectionRow, ScoaAccountTree, ScoaInterface, ScoaSegmentValue, ScoaSegmentValueBag } from "./IMscoaAccount.js";
+import { AccountingBasis, DualCashExclusionMatchMode, IAccountSegmentTreeKeys, IDualCashExclusionConfig, IDualCashExclusionRule, IGetTreeResponse, IIncludedSegmentConfig, IScoaAccount, IScoaInput, IScoaInputConfig, ITableScoaSelectionRow, ScoaAccountTree, ScoaInterface, ScoaSegmentValue, ScoaSegmentValueBag } from "./IMscoaAccount.js";
 import { ISelectInputInterface } from "./ISelectInputInterface.js";
 import { MatDataOptionsInterface } from "./MatDataOptionsInterface.js";
 import { IMatrixInput } from "./MatrixInputInterface.js";
@@ -26,4 +26,4 @@ import { CalculationFunctions, calculationVariableInterface } from "./calculatio
 import { IRichTextEditor, RichTextEditorType } from "./RichTextEditorInput.js";
 import { ValidationError, ValidationOptions } from "./schema.js";
 import { IUserSignature } from "./userSignature.js";
-export { ElementTypes, InputTypes, InputPipeTypes, AutocapitalizeOptions, AutocompleteOptions, InputDataTypes, MinInputTypes, IFormElementTemplate, IBasicFormInput, IFileUploadInput, ConditionalInputRule, IDateRangePickerInput, ITextareaProperties, IToggleInput, IMatrixInput, IMultiple, IMultipleInputCal, IScoaInput, TableConfigurationsInterface, TableColumnConfigInterface, FormControlCustomValidatorsInterface, InputObservedForChange, DraftFormControlCustomValidator, IFormValidationOverride, MinimumInputRequiredInterface, MinInputMapInput, CalculatedFieldRules, calculationVariableInterface, APIDataFetchingConfigurationInterface, PayloadTemplate, PayloadTemplateValue, RequestBodyMode, HeaderTemplate, HeaderTemplateValue, QueryTemplate, QueryTemplateValue, IGetTreeResponse, CalculationFunctions, TreeNode, IPostmanCollection, IFolderItem, FileUploadInputValueInterface, AllDocumentFileExtensions, AllImageFileExtensions, UploadTypes, InputFileType, IScoaAccount, IScoaInputConfig, ITableScoaSelectionRow, ScoaSegmentValue, ScoaSegmentValueBag, IIncludedSegmentConfig, AccountingBasis, ScoaAccountTree, IUserSignature, ValidationOptions, ValidationError, MatDataOptionsInterface, MongoDbPipeLineConfigInterface, InputAPIDataId, FormInputBasicOptionInterface, ScoaInterface, ScoaInnerInput, IAccountSegmentTreeKeys, IWorkflowDocumentPicker, IWorkflowDocumentPickerConfig, IWorkflowDocumentStepFilter, IDocumentPickerFilter, IDocumentPage, IDocumentQueryRequest, IDocumentReference, DocumentPickerFilterOperator, DocumentPickerFilterValueSource, DocumentPickerFilterValueType, DOCUMENT_PICKER_FILTER_OPERATORS, DOCUMENT_PICKER_FILTER_VALUE_SOURCES, DOCUMENT_PICKER_FILTER_VALUE_TYPES, workflowStepStatus, IWorkflowDocListCols, IWorkflowStepOption, JsDataTypes, AdjudicationSteps, IWorkflowAdjudicationInput, WorkflowAdjudicationScoreSheetValue, WorkflowAdjudicationMicroFlowReviewValue, WorkflowAdjudicationResponseElectedSupplierSelectionValue, ScoreSheetItem, AdjResponseReviewColumnMapping, OptionSelectTypes, ISelectInputInterface, MultipleInputAvailableOperations, RichTextEditorType, IRichTextEditor, };
+export { ElementTypes, InputTypes, InputPipeTypes, AutocapitalizeOptions, AutocompleteOptions, InputDataTypes, MinInputTypes, IFormElementTemplate, IBasicFormInput, IFileUploadInput, ConditionalInputRule, IDateRangePickerInput, ITextareaProperties, IToggleInput, IMatrixInput, IMultiple, IMultipleInputCal, IScoaInput, TableConfigurationsInterface, TableColumnConfigInterface, FormControlCustomValidatorsInterface, InputObservedForChange, DraftFormControlCustomValidator, IFormValidationOverride, MinimumInputRequiredInterface, MinInputMapInput, CalculatedFieldRules, calculationVariableInterface, APIDataFetchingConfigurationInterface, PayloadTemplate, PayloadTemplateValue, RequestBodyMode, HeaderTemplate, HeaderTemplateValue, QueryTemplate, QueryTemplateValue, IGetTreeResponse, CalculationFunctions, TreeNode, IPostmanCollection, IFolderItem, FileUploadInputValueInterface, AllDocumentFileExtensions, AllImageFileExtensions, UploadTypes, InputFileType, IScoaAccount, IScoaInputConfig, ITableScoaSelectionRow, ScoaSegmentValue, ScoaSegmentValueBag, IIncludedSegmentConfig, AccountingBasis, DualCashExclusionMatchMode, IDualCashExclusionConfig, IDualCashExclusionRule, ScoaAccountTree, IUserSignature, ValidationOptions, ValidationError, MatDataOptionsInterface, MongoDbPipeLineConfigInterface, InputAPIDataId, FormInputBasicOptionInterface, ScoaInterface, ScoaInnerInput, IAccountSegmentTreeKeys, IWorkflowDocumentPicker, IWorkflowDocumentPickerConfig, IWorkflowDocumentStepFilter, IDocumentPickerFilter, IDocumentPage, IDocumentQueryRequest, IDocumentReference, DocumentPickerFilterOperator, DocumentPickerFilterValueSource, DocumentPickerFilterValueType, DOCUMENT_PICKER_FILTER_OPERATORS, DOCUMENT_PICKER_FILTER_VALUE_SOURCES, DOCUMENT_PICKER_FILTER_VALUE_TYPES, workflowStepStatus, IWorkflowDocListCols, IWorkflowStepOption, JsDataTypes, AdjudicationSteps, IWorkflowAdjudicationInput, WorkflowAdjudicationScoreSheetValue, WorkflowAdjudicationMicroFlowReviewValue, WorkflowAdjudicationResponseElectedSupplierSelectionValue, ScoreSheetItem, AdjResponseReviewColumnMapping, OptionSelectTypes, ISelectInputInterface, MultipleInputAvailableOperations, RichTextEditorType, IRichTextEditor, };

package/dist/schemas/MscoaConfigSchema.d.ts

@@ -1,5 +1,7 @@
 import Joi from 'joi';
 export declare const IncludedSegmentConfigSchema: Joi.ObjectSchema<any>;
+export declare const DualCashExclusionRuleSchema: Joi.ObjectSchema<any>;
+export declare const DualCashExclusionConfigSchema: Joi.ObjectSchema<any>;
 export declare const MscoaInputConfigSchema: Joi.ObjectSchema<any>;
 export declare function validateMscoaInputConfig(value: any): {
     error: Joi.ValidationError | undefined;

package/dist/schemas/MscoaConfigSchema.js

@@ -12,6 +12,17 @@ export const IncludedSegmentConfigSchema = Joi.object({
     segmentExtension: Joi.boolean().required(),
     id: Joi.string().required()
 });
+export const DualCashExclusionRuleSchema = Joi.object({
+    id: Joi.string().optional(),
+    pattern: Joi.string().required(),
+    flags: Joi.string().allow('').optional(),
+    segment: Joi.string().allow('').optional(),
+    description: Joi.string().allow('').optional()
+});
+export const DualCashExclusionConfigSchema = Joi.object({
+    rules: Joi.array().items(DualCashExclusionRuleSchema).optional(),
+    matchMode: Joi.string().valid('any', 'all').optional()
+});
 export const MscoaInputConfigSchema = Joi.object({
     inputs: Joi.array().items(Joi.object().pattern(/./, Joi.any())).required(),
     segments: Joi.array().items(IncludedSegmentConfigSchema).min(1).required(),
@@ -19,7 +30,8 @@ export const MscoaInputConfigSchema = Joi.object({
     accountValueLabel: Joi.string().required(),
     accountingBasis: Joi.string().valid(...Object.values(AccountingBasis)).optional(),
     extensionAccountsForSegments: Joi.array().items(Joi.string()).optional(),
-    showAllSegments: Joi.boolean().required()
+    showAllSegments: Joi.boolean().required(),
+    dualCashExclusion: DualCashExclusionConfigSchema.optional()
 });
 export function validateMscoaInputConfig(value) {
     const { error, value: validatedValue } = MscoaInputConfigSchema.validate(value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-t-forms-types",
-  "version": "0.0.28",
+  "version": "0.0.30",
   "description": "Typings and interfaces for the ngx-t-forms library for dynamic forms.",
   "keywords": [
     "typings",