ngx-t-forms-types 0.0.29 → 0.0.33

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/Form/formSubmissionHandleInterface.d.ts

@@ -1,6 +1,12 @@
 import { APIDataFetchingConfigurationInterface, MongoDbPipeLineConfigInterface } from "../formInput/index.js";
 import { DataSources } from "../formInput/APIDataFetchingConfigurationInterface.js";
 export interface FormSubmissionHandleInterface {
+    /**
+     * @deprecated Retained only so existing stored forms keep deserialising. Do
+     * not set it on new forms, and do not offer it to a model — it is excluded
+     * from the Skillet generation schema for the same reason
+     * `iServeInputWithRequisitionItems` is.
+     */
     innerComponentShowSubmitButton?: boolean;
     canSubmitAPI?: Array<APIDataFetchingConfigurationInterface>;
     submissionAPI: Array<APIDataFetchingConfigurationInterface>;

package/dist/interfaces/FormBuilder/DefaultEelement.js

@@ -33,6 +33,14 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.HintLabel,
             AllFormInputPrimaryKeys.MatOptions,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Pattern,
+            FormInputKeys.Placeholder,
+            FormInputKeys.Autocomplete,
+            FormInputKeys.PrefixText,
+            FormInputKeys.SuffixText,
+            FormInputKeys.PrefixIcon,
+            FormInputKeys.SuffixIcon,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.Input,
@@ -62,6 +70,7 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.FormControlName,
             AllFormInputPrimaryKeys.Validators, // Assuming Validators is also needed here
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.Location,
@@ -97,6 +106,14 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.Value,
             AllFormInputPrimaryKeys.MatOptions,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Pattern,
+            FormInputKeys.Placeholder,
+            FormInputKeys.Autocomplete,
+            FormInputKeys.PrefixText,
+            FormInputKeys.SuffixText,
+            FormInputKeys.PrefixIcon,
+            FormInputKeys.SuffixIcon,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.AutoCompleteInput,
@@ -134,6 +151,7 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.TrueLabel,
             AllFormInputPrimaryKeys.FalseLabel,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.Toggle,
@@ -181,6 +199,9 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.OptionSelectType,
             AllFormInputPrimaryKeys.AllowMultipleSelection,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Pattern,
+            FormInputKeys.SelectUpto,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.Select,
@@ -226,6 +247,8 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.AllowMultipleSelection,
             AllFormInputPrimaryKeys.PaginationSelectionConfig,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.SelectUpto,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.PaginatedSelectionTable,
@@ -260,6 +283,7 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.Value,
             AllFormInputPrimaryKeys.HintLabel,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.IconSelect,
@@ -304,6 +328,7 @@ export const DefaultInputConfig = {
             FormInputKeys.Placeholder,
             AllFormInputPrimaryKeys.Wrap,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.Textarea,
@@ -350,6 +375,7 @@ export const DefaultInputConfig = {
             FormInputKeys.PrefixText,
             FormInputKeys.SuffixText,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.DatePicker,
@@ -362,6 +388,45 @@ export const DefaultInputConfig = {
             validators: [],
         },
     },
+    [ElementTypes.DateTimePicker]: {
+        label: 'dateTimePicker',
+        illustration: '/assets/datePicker.svg',
+        disabled: false,
+        requiredProperties: [
+            AllFormInputPrimaryKeys.Label,
+            AllFormInputPrimaryKeys.Appearance,
+            AllFormInputPrimaryKeys.FormControlName,
+            AllFormInputPrimaryKeys.Required,
+        ],
+        properties: [
+            AllFormInputPrimaryKeys.Label,
+            AllFormInputPrimaryKeys.Appearance,
+            AllFormInputPrimaryKeys.FormControlName,
+            AllFormInputPrimaryKeys.Validators,
+            AllFormInputPrimaryKeys.Required,
+            AllFormInputPrimaryKeys.ColSize,
+            AllFormInputPrimaryKeys.Value,
+            AllFormInputPrimaryKeys.Min,
+            AllFormInputPrimaryKeys.Max,
+            AllFormInputPrimaryKeys.HintLabel,
+            FormInputKeys.SuffixIcon,
+            FormInputKeys.PrefixIcon,
+            FormInputKeys.PrefixText,
+            FormInputKeys.SuffixText,
+            AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
+        ],
+        elementTemplate: {
+            element: ElementTypes.DateTimePicker,
+            dataType: InputDataTypes.Date,
+            appearance: 'outline',
+            isCalculatedField: false,
+            required: true,
+            onlySetTempErrorOnTouch: false,
+            colSize: 12,
+            validators: [],
+        },
+    },
     [ElementTypes.DateRangePicker]: {
         label: 'dateRangePicker',
         illustration: '/assets/dateRange.svg',
@@ -394,6 +459,7 @@ export const DefaultInputConfig = {
             FormInputKeys.PrefixText,
             FormInputKeys.SuffixText,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.DateRangePicker,
@@ -436,6 +502,7 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.FileType,
             FormInputKeys.Accept,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.FileUpload,
@@ -471,6 +538,7 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.Required,
             AllFormInputPrimaryKeys.Value,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.Signature,
@@ -561,6 +629,7 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.Required,
             AllFormInputPrimaryKeys.Value,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.ImageCapture,
@@ -643,6 +712,8 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.WorkflowPickerConfig,
             AllFormInputPrimaryKeys.AllowMultipleSelection,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.SelectUpto,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.WorkflowDocumentPicker,
@@ -679,6 +750,7 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.MinLength,
             AllFormInputPrimaryKeys.MaxLength,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.WorkflowAdjudication,
@@ -751,6 +823,8 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.HandleLabel,
             SpecialElementKeys.MultipleInputAvailableOperations,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.ShowTotalsOf,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.MultipleInput,
@@ -787,6 +861,7 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.HintLabel,
             AllFormInputPrimaryKeys.RichTextEditorLibrary,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.Editor,
@@ -821,6 +896,7 @@ export const DefaultInputConfig = {
             AllFormInputPrimaryKeys.MatOptions,
             AllFormInputPrimaryKeys.MscoaConfig,
             AllFormInputPrimaryKeys.ConditionalInputConfig,
+            FormInputKeys.Disabled,
         ],
         elementTemplate: {
             element: ElementTypes.MscoaSelection,

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

@@ -88,6 +88,19 @@ export interface DefaultInputConfigInterface {
         elementTemplate: IFormElementTemplate;
         requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
     };
+    /**
+     * Single date-and-time control. Shares {@link IFormElementTemplate} with the
+     * plain date picker — it adds no member of its own, because the time is part
+     * of the one `Date` the element already stores.
+     */
+    [ElementTypes.DateTimePicker]?: {
+        label: string;
+        disabled: boolean;
+        illustration: string;
+        properties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
+        elementTemplate: IFormElementTemplate;
+        requiredProperties: Array<FormInputKeys | AllFormInputPrimaryKeys>;
+    };
     [ElementTypes.DateRangePicker]?: {
         label: string;
         disabled: boolean;

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

@@ -62,6 +62,12 @@ export declare enum AllFormInputPrimaryKeys {
     Value = "value",
     DataType = "dataType",
     Readonly = "readonly",
+    /**
+     * @deprecated Superseded and retained only so existing stored forms keep
+     * deserialising. Do not set it on new inputs, and do not offer it to a
+     * model: it is excluded from the Skillet generation schemas by way of
+     * `DEPRECATED_INPUT_MEMBERS`.
+     */
     IServeInputWithRequisitionItems = "iServeInputWithRequisitionItems",
     CalculatedFieldRules = "calculatedFieldRules",
     MatOptions = "matOptions",

package/dist/interfaces/FormBuilder/FormInputKeys.js

@@ -66,6 +66,12 @@ export var AllFormInputPrimaryKeys;
     AllFormInputPrimaryKeys["Value"] = "value";
     AllFormInputPrimaryKeys["DataType"] = "dataType";
     AllFormInputPrimaryKeys["Readonly"] = "readonly";
+    /**
+     * @deprecated Superseded and retained only so existing stored forms keep
+     * deserialising. Do not set it on new inputs, and do not offer it to a
+     * model: it is excluded from the Skillet generation schemas by way of
+     * `DEPRECATED_INPUT_MEMBERS`.
+     */
     AllFormInputPrimaryKeys["IServeInputWithRequisitionItems"] = "iServeInputWithRequisitionItems";
     AllFormInputPrimaryKeys["CalculatedFieldRules"] = "calculatedFieldRules";
     AllFormInputPrimaryKeys["MatOptions"] = "matOptions";

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

@@ -1,13 +1,13 @@
 import { CurrenciesList } from "../../../Configs/currencies.js";
 import { DatePipeOptions } from "../../../Configs/datePipes.js";
-import { AdjudicationSteps, ElementTypes, InputDataTypes, InputPipeTypes, InputTypes } from "../../formInput/index.js";
+import { AdjudicationSteps, AutocompleteOptions, ElementTypes, InputDataTypes, InputPipeTypes, InputTypes } from "../../formInput/index.js";
 import { DataSources } from "../../formInput/APIDataFetchingConfigurationInterface.js";
 import { OptionSelectTypes } from "../../formInput/BasicFormInputInterface.js";
 import { InputFileType } from "../../formInput/FileUploadInputInterface.js";
 import { MultipleInputAvailableOperations } from "../../formInput/MultipleInterface.js";
 import { RichTextEditorType } from "../../formInput/RichTextEditorInput.js";
 import { LabelPosition } from "../../formInput/ToggleInputInterface.js";
-import { AllFormInputPrimaryKeys, SpecialElementKeys } from "../FormInputKeys.js";
+import { AllFormInputPrimaryKeys, FormInputKeys, SpecialElementKeys } from "../FormInputKeys.js";
 import { BlurHandleTypes, ElementEditorTypes } from "../elementEditor.js";
 import { DOCUMENT_PICKER_FILTER_OPERATORS, DOCUMENT_PICKER_FILTER_VALUE_SOURCES, DOCUMENT_PICKER_FILTER_VALUE_TYPES } from "../../formInput/WorkflowDocumentPicker.js";
 /** Human-facing names for the document-picker filter operators. */
@@ -191,7 +191,7 @@ export const MSCOA_DUAL_CASH_EXCLUSION_RULE_EDITOR = () => [
                 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.`,
+                hint: `A JavaScript regular expression (without the surrounding slashes). It is tested against each selected accrual account's SCOA account value and against one labelled field — the account value label configured for this input, unless this rule names a different one under 'Test against field'. An invalid expression never matches, so it can never suppress cash by accident.`,
                 id: "3b7e9f52-0d84-4c16-a2e8-7f5c1d90b364"
             },
             {
@@ -203,6 +203,25 @@ export const MSCOA_DUAL_CASH_EXCLUSION_RULE_EDITOR = () => [
                 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: ['matchField'],
+                editType: ElementEditorTypes.ChipSelect,
+                label: 'Test against field',
+                // The full pool is listed here rather than filled in at runtime: unlike
+                // the segment scope, which only this input knows, the fields an account
+                // can be read by are the same everywhere. The MSCOA setup editor still
+                // relabels the leading entry with the field actually configured, so an
+                // administrator can see what the default resolves to. NO `defaultValue`,
+                // so opening a saved rule never stamps a field onto it — absent means
+                // "whatever the input displays accounts by", and must stay absent.
+                options: [
+                    { label: 'Configured account value label', value: '' },
+                    ...MSCOA_ACCOUNT_VALUE_LABEL_OPTIONS,
+                ],
+                hint: `Optional. Which labelled field of the account the expression is tested against. Leave it on 'Configured account value label' to test the field this input displays accounts by. The account's SCOA account value is always tested as well, whichever field is chosen — this only changes the second one. A field the selected accounts do not carry contributes nothing to test, so the rule falls back to the SCOA account value alone.`,
+                id: "9d4a1c6e-2f83-4b57-a0d6-3e7b5c81f294"
+            },
             {
                 name: SpecialElementKeys.Default,
                 deepBind: ['segment'],
@@ -451,6 +470,24 @@ export var ElementConfig = {
                     label: 'Allow multiple selection',
                     hint: `When enabled, users can select multiple options from the list. This is useful for inputs like tags or categories.`,
                 },
+                {
+                    // Sits directly below the toggle it depends on, and stays hidden until
+                    // that toggle is on: a cap on how many options may be chosen says
+                    // nothing about a control that already allows exactly one.
+                    name: FormInputKeys.SelectUpto,
+                    deepBind: [FormInputKeys.SelectUpto],
+                    editType: ElementEditorTypes.Input,
+                    label: 'Maximum selections',
+                    min: 1,
+                    hint: `Leave it empty for no limit.`,
+                    additionalTest: [
+                        {
+                            expression: `${AllFormInputPrimaryKeys.AllowMultipleSelection} === true`,
+                            deepBind: [AllFormInputPrimaryKeys.AllowMultipleSelection],
+                        },
+                    ],
+                    id: "5c1a7e93-2b48-4d6f-9a07-e83b15fc2d40"
+                },
                 {
                     name: AllFormInputPrimaryKeys.FileType,
                     editType: ElementEditorTypes.OptionSelect,
@@ -512,6 +549,14 @@ export var ElementConfig = {
                     label: 'Max length of characters',
                     id: "9bc50894-5230-46f2-91de-b45673b3a80a"
                 },
+                {
+                    name: FormInputKeys.Pattern,
+                    deepBind: [FormInputKeys.Pattern],
+                    editType: ElementEditorTypes.Input,
+                    label: 'Value format (regex)',
+                    hint: 'A regular expression the value must match in full — it is anchored for you, so \\d{13} means exactly 13 digits and nothing else. Leave blank for no format restriction. An expression that does not compile is ignored rather than rejecting every entry.',
+                    id: "3305046e-1ef6-4595-acef-946c9beb2fb1"
+                },
                 {
                     name: SpecialElementKeys.MultipleInputAvailableOperations,
                     deepBind: [SpecialElementKeys.MultipleInputAvailableOperations],
@@ -535,6 +580,19 @@ export var ElementConfig = {
                     label: 'Handle label',
                     id: "3f056cc9-e639-4db7-aa41-3f96593356b2"
                 },
+                {
+                    // Only an item list has rows to total, so this is scoped to it through
+                    // `properties` rather than shown everywhere. The names it takes are the
+                    // columns declared in `formInputs`, which is why it sits with the list
+                    // settings rather than with the formatting rows.
+                    name: FormInputKeys.ShowTotalsOf,
+                    deepBind: [FormInputKeys.ShowTotalsOf],
+                    editType: ElementEditorTypes.FormInputSelector,
+                    multipleSelection: true,
+                    label: 'Show totals for',
+                    hint: `The total is shown beneath the rows. Only numeric columns total meaningfully.`,
+                    id: "9b6f0d27-3c54-41ae-8d19-7a2e6b40cf85"
+                },
                 {
                     name: AllFormInputPrimaryKeys.MscoaConfig,
                     deepBind: ['mscoaConfig'],
@@ -745,6 +803,19 @@ export var ElementConfig = {
                     label: 'Set as readonly field',
                     id: "cdc5173b-8464-4e03-b0fb-6258437fa50b"
                 },
+                {
+                    // Deliberately NOT a `SpecialElementKeys.Default` row like `readonly`
+                    // above it. A Default row shows on every element, and a section heading
+                    // captures no value and renders no control, so there is nothing there to
+                    // disable. Naming the key scopes the row to the elements whose
+                    // `properties` list it — every element except the section title.
+                    name: FormInputKeys.Disabled,
+                    deepBind: [FormInputKeys.Disabled],
+                    editType: ElementEditorTypes.Toggle,
+                    label: 'Set as disabled field',
+                    hint: `Its value is left out of the submitted form entirely. Use readonly instead when the value should still be submitted.`,
+                    id: "7d4c8a15-6e29-4b30-a5f1-c026b9e78314"
+                },
                 {
                     name: SpecialElementKeys.Default,
                     editType: ElementEditorTypes.Toggle,
@@ -849,6 +920,71 @@ export var ElementConfig = {
                     label: 'API endpoint',
                     id: "c9e2f7a4-1b58-4d03-9a6e-2f84c1b0d597"
                 },
+                {
+                    // Opt-out of the read-only lock the tower puts on every value
+                    // it owns — the SCALAR half. Offered only for an `api` value
+                    // source: a scalar that is inherited from another input
+                    // (`local`) or calculated recomputes from a field the user can
+                    // already edit, so it stays read-only with no opt-out. The
+                    // complex (object / array) half is the NEXT entry, which binds
+                    // the same key under a different rule — see there. Lives inside
+                    // the fetch slot so the source chip's `clearOnChange` above
+                    // wipes it when the source changes.
+                    name: SpecialElementKeys.Default,
+                    deepBind: ['matOptions', 'fetch', 'value', 'allowManualValueEntry'],
+                    editType: ElementEditorTypes.Toggle,
+                    additionalTest: [
+                        {
+                            expression: `source === ${DataSources.Api}`,
+                            deepBind: ['matOptions', 'fetch', 'value', 'source'],
+                        },
+                        {
+                            // Scalars only — this is what keeps the two halves of the key
+                            // mutually exclusive. `additionalTest` entries are AND-ed and
+                            // each one sees ONLY its own bound key, so an either/or across
+                            // two paths is expressed as two complementary tests, one per
+                            // entry. An input with no declared `dataType` reads as scalar,
+                            // which is what every config written before this rule was.
+                            expression: `dataType !== '${InputDataTypes.Object}' && dataType !== '${InputDataTypes.Array}'`,
+                            deepBind: ['dataType'],
+                        },
+                    ],
+                    hint: `Off by default: a value fetched from an API is locked, because anything typed over it is replaced the next time the endpoint answers. Turn this on to leave the field editable so a user can supply a value themselves when the endpoint returns nothing — no response yet, an empty response, or a failed request. A non-empty response still wins and replaces what they typed.`,
+                    label: 'Allow manual entry when the API returns nothing',
+                    id: "0f0a1c7e-4d92-4f6b-9a31-7c5e8b2d64af"
+                },
+                {
+                    // The COMPLEX half of the same key: an input whose value is an
+                    // object or an array (mSCOA, MultipleInput). Offered for an
+                    // inherited (`local`) source as well as an `api` one, because a
+                    // multi-dimensional value can arrive PARTIALLY populated — an
+                    // mSCOA that inherits two of its segments, rows that come back
+                    // missing a column — and the user has to be able to finish it.
+                    // The lock is lifted and the tower re-merges instead: each change
+                    // in the derived value is applied as a delta, so what the tower
+                    // supplies updates and what the user added survives.
+                    //
+                    // Gated on a picked source because the flag has nowhere to live
+                    // until the fetch value slot exists; a purely calculated complex
+                    // value therefore has no toggle here, though the engine honours
+                    // the flag if one is present.
+                    name: SpecialElementKeys.Default,
+                    deepBind: ['matOptions', 'fetch', 'value', 'allowManualValueEntry'],
+                    editType: ElementEditorTypes.Toggle,
+                    additionalTest: [
+                        {
+                            expression: `dataType === '${InputDataTypes.Object}' || dataType === '${InputDataTypes.Array}'`,
+                            deepBind: ['dataType'],
+                        },
+                        {
+                            expression: `source === ${DataSources.Api} || source === ${DataSources.Local}`,
+                            deepBind: ['matOptions', 'fetch', 'value', 'source'],
+                        },
+                    ],
+                    hint: `Off by default: a value the form works out for itself — fetched from an API or inherited from another field — is locked, because anything typed over it is replaced the next time the form works it out. Turn this on when the value can arrive incomplete and the user has to finish it: an API that answers with rows that are missing a column, or an mSCOA that inherits only some of its segments. The field stays editable, and when the form works the value out again only what actually changed is applied over it — whatever the user added is kept.`,
+                    label: 'Allow the user to complete this value',
+                    id: "3c6b58d1-9f42-4e07-b8a5-1d90e7c4af62"
+                },
                 {
                     name: SpecialElementKeys.Default,
                     deepBind: ['matOptions', 'fetch', 'value'],
@@ -1076,6 +1212,55 @@ export var ElementConfig = {
                     deepBind: ['conditionalInputConfig'],
                     id: "3f2b1c74-9d6e-4a58-9b2f-27c5a1e4d803"
                 },
+                {
+                    name: FormInputKeys.Placeholder,
+                    deepBind: [FormInputKeys.Placeholder],
+                    editType: ElementEditorTypes.Input,
+                    label: 'Placeholder',
+                    hint: `Give an example of a valid value rather than repeating the label.`,
+                    id: "1e8b47f0-9a25-4c63-b7d8-2f5091ac36be"
+                },
+                {
+                    name: FormInputKeys.Autocomplete,
+                    deepBind: [FormInputKeys.Autocomplete],
+                    editType: ElementEditorTypes.ChipSelect,
+                    label: 'Browser autofill',
+                    hint: `Turn this off for one-time values such as a reference number or an OTP, which should never be autofilled.`,
+                    options: Object.values(AutocompleteOptions).map((option) => ({ label: option, value: option })),
+                    id: "4a09c6d3-5e71-4820-9bf6-83d2e5107ca9"
+                },
+                {
+                    name: FormInputKeys.PrefixText,
+                    deepBind: [FormInputKeys.PrefixText],
+                    editType: ElementEditorTypes.Input,
+                    label: 'Prefix text',
+                    hint: `For example a currency symbol.`,
+                    id: "6c35f9a2-0b84-4e17-95da-71c8046be3f2"
+                },
+                {
+                    name: FormInputKeys.SuffixText,
+                    deepBind: [FormInputKeys.SuffixText],
+                    editType: ElementEditorTypes.Input,
+                    label: 'Suffix text',
+                    hint: `For example a unit such as kg or %.`,
+                    id: "b8e14d70-2c96-4a5b-8317-df60259ea4c1"
+                },
+                {
+                    name: FormInputKeys.PrefixIcon,
+                    deepBind: [FormInputKeys.PrefixIcon],
+                    editType: ElementEditorTypes.Input,
+                    label: 'Prefix icon',
+                    hint: `For example search or person.`,
+                    id: "d27a6301-4f58-49ce-b0a2-95e7361c8fd4"
+                },
+                {
+                    name: FormInputKeys.SuffixIcon,
+                    deepBind: [FormInputKeys.SuffixIcon],
+                    editType: ElementEditorTypes.Input,
+                    label: 'Suffix icon',
+                    hint: `For example visibility or calendar_today.`,
+                    id: "af503b8e-1d67-4290-83c5-6e214b90daf7"
+                },
             ],
         },
     ],

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

@@ -199,6 +199,40 @@ export interface APIDataFetchingConfigurationInterface extends DataFetchingBaseC
      * interpreted — mirrors the other `captured*` seeds.
      */
     capturedDocs?: string;
+    /**
+     * Opts this value out of the automatic read-only lock, so a user may supply
+     * what the tower's own value leaves out.
+     *
+     * An input whose value the tower owns is rendered read-only by default — a
+     * typed-over value would only be overwritten on the derived signal's next
+     * evaluation. This flag lifts that lock, and what it then means depends on
+     * the SHAPE the input declares in its `dataType`:
+     *
+     * **Scalar** (`string`, `number`, `boolean`, `date`, …) — the editor's *Allow
+     * manual entry when the API returns nothing* toggle, offered only on an `api`
+     * value source. The manually entered value stands **whenever the fetch
+     * contributes nothing** — no response yet, a `null` / empty response, or a
+     * failed request. A non-empty response always wins. A scalar that is
+     * calculated (`calculatedFieldRules`) or inherited from another input
+     * (`source: 'local'`) is read-only unconditionally and ignores this flag,
+     * because its derived signal recomputes synchronously from inputs the user
+     * can already edit.
+     *
+     * **Complex** (`dataType: 'object' | 'array'` — mSCOA, MultipleInput) — the
+     * editor's *Allow the user to complete this value* toggle, offered on a
+     * `local` value source as well as an `api` one. A multi-dimensional value can
+     * arrive partially populated (an mSCOA that inherits two of its segments,
+     * rows that come back missing a column), so the field stays editable and the
+     * tower **re-merges** rather than replacing: every change in the derived value
+     * is applied over the live value as a delta — what the tower supplies updates,
+     * what the user added survives. The first value the tower produces is taken
+     * whole; there is no earlier value to diff it against.
+     *
+     * Absent / `false` ⇒ the historical behaviour: the field is locked.
+     *
+     * @defaultValue false
+     */
+    allowManualValueEntry?: boolean;
     backEndConfig: {
         /**
          * The default/mapTo mapping that shapes the POST body in `'mappedInputs'` mode.

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

@@ -24,6 +24,7 @@ export declare enum ElementTypes {
     IconSelect = "iconSelect",
     Textarea = "textarea",
     DatePicker = "datePicker",
+    DateTimePicker = "dateTimePicker",
     DateRangePicker = "dateRangePicker",
     FileUpload = "fileUpload",
     Signature = "signature",

package/dist/interfaces/formInput/BasicFormInputInterface.js

@@ -8,6 +8,7 @@ export var ElementTypes;
     ElementTypes["IconSelect"] = "iconSelect";
     ElementTypes["Textarea"] = "textarea";
     ElementTypes["DatePicker"] = "datePicker";
+    ElementTypes["DateTimePicker"] = "dateTimePicker";
     ElementTypes["DateRangePicker"] = "dateRangePicker";
     ElementTypes["FileUpload"] = "fileUpload";
     ElementTypes["Signature"] = "signature";

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

@@ -133,9 +133,11 @@ export type DualCashExclusionMatchMode = 'any' | 'all';
  * 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.
+ * of ONE labelled field: by default the field named by
+ * {@link IScoaInputConfig.accountValueLabel} (what the user sees selected in the
+ * chart), or — when the rule sets one — the field named by
+ * {@link IDualCashExclusionRule.matchField}. An invalid pattern never matches, so
+ * it can never suppress the cash requirement by accident.
  */
 export interface IDualCashExclusionRule {
     /** Stable record id (stamped by the builder's record-list editor). */
@@ -144,6 +146,20 @@ export interface IDualCashExclusionRule {
     pattern: string;
     /** Optional regex flags (e.g. `i`). Invalid flags make the rule evaluate as not matched. */
     flags?: string;
+    /**
+     * Optional per-rule override of WHICH labelled account field the pattern is
+     * tested against, named exactly as the account carries it — the same pool the
+     * `accountValueLabel` picker offers (e.g. `ShortDescription`).
+     *
+     * Empty or absent means the input's configured
+     * {@link IScoaInputConfig.accountValueLabel}, which is the default and leaves
+     * every rule saved before this member existed evaluating exactly as it did.
+     * The account's `SCOAAccount` value is always tested as well, whatever this
+     * holds — the override replaces the labelled field only. A field the selected
+     * account does not carry contributes no candidate, so such a rule falls back to
+     * testing `SCOAAccount` alone rather than matching everything.
+     */
+    matchField?: string;
     /**
      * Optional segment scope (matched case-insensitively against the accrual
      * segment key, e.g. `ITEM`). Empty/absent = every accrual segment.