@genesislcap/foundation-forms 14.452.0 → 14.452.1-FUI-2538.1

package/dist/custom-elements.json

@@ -1456,6 +1456,15 @@
               "privacy": "private",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "serverErrors",
+              "type": {
+                "text": "ErrorObject[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
             {
               "kind": "field",
               "name": "submitted",
@@ -1603,6 +1612,75 @@
               "kind": "field",
               "name": "dispatch"
             },
+            {
+              "kind": "method",
+              "name": "setServerErrors",
+              "parameters": [
+                {
+                  "name": "errors",
+                  "type": {
+                    "text": "ErrorObject[]"
+                  }
+                }
+              ],
+              "description": "Applies server-side validation errors returned from an EVENT_NACK response.\nErrors are merged into `core.additionalErrors` and shown inline on fields.",
+              "privacy": "public"
+            },
+            {
+              "kind": "method",
+              "name": "clearServerErrors",
+              "description": "Clears all server-side validation errors from the form.",
+              "privacy": "public"
+            },
+            {
+              "kind": "method",
+              "name": "buildAdditionalErrors",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "ErrorObject[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "uischema",
+                  "type": {
+                    "text": "UISchemaElement"
+                  }
+                },
+                {
+                  "name": "data",
+                  "type": {
+                    "text": "any"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "applyAdditionalErrorsToCore",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "nextCore",
+                  "type": {
+                    "text": "JsonFormsCore"
+                  }
+                },
+                {
+                  "name": "changedPath",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "refreshAdditionalErrors",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "validate",
@@ -1939,6 +2017,14 @@
             "package": "./validation"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./server-errors"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -1961,6 +2047,58 @@
       "declarations": [],
       "exports": []
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/server-errors.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "mapGenesisFieldErrorsToAdditionalErrors",
+          "return": {
+            "type": {
+              "text": "ErrorObject[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "errors",
+              "type": {
+                "text": "GenesisFieldError[] | undefined"
+              },
+              "description": "Genesis ERROR array from an EVENT_NACK response"
+            },
+            {
+              "name": "schema",
+              "optional": true,
+              "type": {
+                "text": "JSONSchema7"
+              },
+              "description": "JSON schema used to resolve `parentSchema` for each field"
+            },
+            {
+              "name": "instancePathPrefix",
+              "optional": true,
+              "type": {
+                "text": "string"
+              },
+              "description": "Optional prefix for bulk-insert rows (e.g. `/items/0`)"
+            }
+          ],
+          "description": "Maps Genesis commitEvent NACK `ERROR[]` entries to JsonForms `ErrorObject[]`\nsuitable for `additionalErrors` on the form core.\n\nOnly entries with a `FIELD` or `PATH` are mapped; generic errors (no field\nassociation) are omitted so callers can still surface them via toast/dialog.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "mapGenesisFieldErrorsToAdditionalErrors",
+          "declaration": {
+            "name": "mapGenesisFieldErrorsToAdditionalErrors",
+            "module": "src/utils/server-errors.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/translation.ts",

package/dist/dts/form.d.ts

@@ -1,5 +1,6 @@
 import { FoundationElement } from '@microsoft/fast-foundation';
 import { JSONSchema7 } from 'json-schema';
+import { JSONForms } from './jsonforms/json-forms';
 import { BulkRowStatus, RendererEntry, UiSchema } from './types';
 /**
  * Set of default renderers used by the foundation-forms.
@@ -442,6 +443,11 @@ export declare class Form extends Form_base {
      * @internal
      */
     csvFileInput: HTMLInputElement;
+    /**
+     * Reference to the internal json-forms element.
+     * @internal
+     */
+    jsonFormsElement: JSONForms;
     /**
      * Stores the approval message entered by the user.
      * @internal
@@ -664,6 +670,16 @@ export declare class Form extends Form_base {
      * @public
      */
     reset(clearData?: boolean): void;
+    /**
+     * Maps Genesis EVENT_NACK field errors onto the form via additionalErrors.
+     * @internal
+     */
+    private applyServerFieldErrors;
+    /**
+     * Maps field errors from failed bulk-insert rows onto the form.
+     * @internal
+     */
+    private applyBulkServerFieldErrors;
     /**
      * Show the approval message modal
      * @internal

package/dist/dts/form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/form.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/form.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAuBnD,OAAO,EAAE,aAAa,EAAmC,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AA2BlG;;;GAGG;AACH,eAAO,MAAM,SAAS,OAwBrB,CAAC;;;;;;;kBAnDY,CAAC;;;;;;;;8BAuDK,CAAC,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAiB/B,CAAC;4IAQK,CAAC;wFAG+C,CAAC;+IAO1D,CAAF;2FAGmB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAgCZ,CADC;;;;;;;;;;;;;;;;;;;;;;;mBAuES,CAAC;;;;;;;;;;;;;6BA+BN,CAAC;8BAKD,CAAC;kBAA4D,CAAC;;oBAMnD,CAAC;;sBACgB,CAAA;oBAGF,CAAC;;;;;;;;gDAkBnB,CAAC;;;;;;;;;;;;;;;;;;uBA+Ba,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAmHd,CAAC;yBAKrB,CAAD;UAEK,GAAG;WAG2B,GAAG;;gBAEtB,GAAG;;;;;;;WAWF,GAAG;YAKN,GAAG;;;;;;;;;;;oBA+BiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6MI,CAAC;cAIvC,CAAH;eAI8B,CAAC;gBACO,CAAC;;;;;;;;;;;;;;SA4CpC,CAAC;;;iBAIE,CAAC;;AAlqBR;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAMa,IAAK,SAAQ,SAAiC;IACzD;;;OAGG;IAC0C,MAAM,EAAE,MAAM,CAAW;IACtE;;;;OAIG;IACG,YAAY,EAAE,MAAM,CAAC;YACb,mBAAmB;IAyCjC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAahC;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAkCpC;;;;OAIG;IAC0C,mBAAmB,EAAE,MAAM,CAAC;IAEzE;;;;OAIG;IAC2D,kBAAkB,EAAE,OAAO,CAAC;IAE1F;;;OAGG;IAC4C,oBAAoB,EAAE,MAAM,CAAsB;IAEjG;;;OAGG;IACI,aAAa,EAAE,GAAG,CAAC;IAE1B;;;OAGG;IACI,YAAY,EAAE,gBAAgB,CAAC;IAEtC;;;OAGG;IACI,gBAAgB,EAAE,SAAS,CAAC;IAEnC;;;OAGG;IACS,eAAe,EAAE,MAAM,CAAM;IAEzC;;;OAGG;IACH,OAAO,CAAC,cAAc,CAAa;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACS,QAAQ,EAAE,QAAQ,CAAC;IAC/B;;;OAGG;IACS,SAAS,EAAE,aAAa,EAAE,CAAa;IACnD;;OAEG;IACH,gBAAgB;IAGhB;;;;;;;OAOG;IACS,mBAAmB,EAAE,aAAa,EAAE,CAAM;IACtD;;OAEG;IACH,0BAA0B;IAG1B;;;;;OAKG;IACS,eAAe,EAAE,aAAa,EAAE,CAAa;IACzD,OAAO,CAAC,qBAAqB;IAI7B;;;;;;OAMG;IACS,UAAU,EAAE,WAAW,CAAC;IAEpC,OAAO,CAAC,MAAM,CAAqB;IAC1B,OAAO,CAAC,OAAO,CAAW;IACnC;;;OAGG;IACS,IAAI,EAAE,GAAG,CAAM;IAE3B;;OAEG;IACS,UAAU,EAAE,OAAO,CAAC;IAChC;;OAEG;IACS,SAAS,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACwB,QAAQ,EAAE,OAAO,CAAC;IAC7C;;;OAGG;IACyD,UAAU,EAAE,OAAO,CAAC;IAEhF;;;OAGG;IACwD,SAAS,EAAE,OAAO,CAAC;IAE9E;;;;OAIG;IACkD,UAAU,EAAE,OAAO,CAAC;IAEzE;;;OAGG;IAQH,kBAAkB,EAAE,MAAM,CAAK;IAE/B;;;OAGG;IAQH,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC;;;OAGG;IACH,OAAO,CAAC,qBAAqB,CAA0B;IAEvD;;;OAGG;IACH,OAAO,CAAC,oBAAoB,CAAuB;IAEnD;;;;OAIG;IACS,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAa;IAEtE;;OAEG;IACG,OAAO;IAkEb;;;;OAIG;YACW,WAAW;IA0GzB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAQvB;;;OAGG;IACH,sBAAsB;IAItB;;;;;OAKG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDnD;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAwB5B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;;OAGG;IACH,IAAc,cAAc,YAM3B;IAED;;;OAGG;IACH,IAAc,cAAc,YAE3B;IAED;;OAEG;IACM,SAAS,IAAI,IAAI;IAW1B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,WAAW;IAI7B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW;IAmB3B;;OAEG;IACH,oBAAoB;IAKpB;;;OAGG;IACH,KAAK,CAAC,SAAS,UAAO;IAUtB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAalC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;OAGG;IACH,kBAAkB;IAQlB;;;OAGG;IACG,kBAAkB;IAgCxB;;;;;OAKG;IACG,qBAAqB,CAAC,KAAK,EAAE,KAAK;IAyFxC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;;OAKG;IACH,mBAAmB;CA2BpB"}

package/dist/dts/form.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form.template.d.ts","sourceRoot":"","sources":["../../src/form.template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAiBnC,gBAAgB;AAChB,eAAO,MAAM,eAAe,GAAI,WAAM,8DAiHrC,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,sBAAsB,2DAElC,CAAC"}
+{"version":3,"file":"form.template.d.ts","sourceRoot":"","sources":["../../src/form.template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAiBnC,gBAAgB;AAChB,eAAO,MAAM,eAAe,GAAI,WAAM,8DAkHrC,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,sBAAsB,2DAElC,CAAC"}

package/dist/dts/jsonforms/json-forms.d.ts

@@ -11,6 +11,7 @@ import { BulkRowStatus } from '../types';
  */
 export declare class JSONForms extends FASTElement {
     private _submitted;
+    private serverErrors;
     get submitted(): boolean;
     set submitted(value: boolean);
     prefix: any;
@@ -48,6 +49,20 @@ export declare class JSONForms extends FASTElement {
     bulkInsertChanged(): void;
     get props(): RendererProps;
     dispatch: (action: UpdateAction) => void;
+    /**
+     * Applies server-side validation errors returned from an EVENT_NACK response.
+     * Errors are merged into `core.additionalErrors` and shown inline on fields.
+     * @public
+     */
+    setServerErrors(errors: ErrorObject[]): void;
+    /**
+     * Clears all server-side validation errors from the form.
+     * @public
+     */
+    clearServerErrors(): void;
+    private buildAdditionalErrors;
+    private applyAdditionalErrorsToCore;
+    private refreshAdditionalErrors;
     /**
      * Performs client-side validation by running the validator defined in the UI schema.
      * @param uischema the UI schema

package/dist/dts/jsonforms/json-forms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-forms.d.ts","sourceRoot":"","sources":["../../../src/jsonforms/json-forms.ts"],"names":[],"mappings":"AACA,OAAO,EASL,8BAA8B,EAE9B,aAAa,EAGb,eAAe,EACf,YAAY,EACZ,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAIL,WAAW,EAKZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,GAAG,EAAE,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAmCzC;;;;;;GAMG;AACH,qBAUa,SAAU,SAAQ,WAAW;IACxC,OAAO,CAAC,UAAU,CAAS;IAE3B,IAAI,SAAS,IAAI,OAAO,CAGvB;IAED,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,EAG3B;IAEW,MAAM,MAAC;IACnB,aAAa;IAGD,SAAS,MAAC;IACV,IAAI,MAAC;IACL,YAAY,MAAC;IAEb,MAAM,MAAC;IACnB,aAAa;IA2DD,QAAQ,EAAE,eAAe,CAAC;IACtC,eAAe;IAIH,IAAI,MAAC;IACjB,WAAW;IAkCC,SAAS,EAAE,8BAA8B,EAAE,CAAC;IACxD,gBAAgB;IAIJ,cAAc,EAAE,cAAc,CAAC;IAC3C,qBAAqB;IAIT,GAAG,EAAE,GAAG,CAAiD;IACrE,UAAU;IAIiB,QAAQ,EAAE,OAAO,CAAC;IAC7C,eAAe;IAIH,MAAM,EAAE,GAAG,CAAC;IACxB,aAAa;IAIb;;;OAGG;IACS,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAa;IACtE,wBAAwB;IAUxB;;;OAGG;IACS,UAAU,EAAE,OAAO,CAAS;IACxC,iBAAiB;IAUjB,IAAI,KAAK,IAAI,aAAa,CAuBzB;IAED,QAAQ,GAAI,QAAQ,YAAY,UAoB9B;IAEF;;;;;OAKG;IACH,QAAQ,GAAI,UAAU,eAAe,EAAE,UAAiC,KAAG,WAAW,EAAE,CAoDtF;IAEI,uBAAuB;CAQ9B"}
+{"version":3,"file":"json-forms.d.ts","sourceRoot":"","sources":["../../../src/jsonforms/json-forms.ts"],"names":[],"mappings":"AACA,OAAO,EASL,8BAA8B,EAE9B,aAAa,EAGb,eAAe,EACf,YAAY,EACZ,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAIL,WAAW,EAKZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,GAAG,EAAE,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAmCzC;;;;;;GAMG;AACH,qBAUa,SAAU,SAAQ,WAAW;IACxC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAqB;IAEzC,IAAI,SAAS,IAAI,OAAO,CAGvB;IAED,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,EAG3B;IAEW,MAAM,MAAC;IACnB,aAAa;IAGD,SAAS,MAAC;IACV,IAAI,MAAC;IACL,YAAY,MAAC;IAEb,MAAM,MAAC;IACnB,aAAa;IA+DD,QAAQ,EAAE,eAAe,CAAC;IACtC,eAAe;IAIH,IAAI,MAAC;IACjB,WAAW;IAwBC,SAAS,EAAE,8BAA8B,EAAE,CAAC;IACxD,gBAAgB;IAIJ,cAAc,EAAE,cAAc,CAAC;IAC3C,qBAAqB;IAIT,GAAG,EAAE,GAAG,CAAiD;IACrE,UAAU;IAIiB,QAAQ,EAAE,OAAO,CAAC;IAC7C,eAAe;IAIH,MAAM,EAAE,GAAG,CAAC;IACxB,aAAa;IAIb;;;OAGG;IACS,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAa;IACtE,wBAAwB;IAUxB;;;OAGG;IACS,UAAU,EAAE,OAAO,CAAS;IACxC,iBAAiB;IAUjB,IAAI,KAAK,IAAI,aAAa,CAuBzB;IAED,QAAQ,GAAI,QAAQ,YAAY,UAe9B;IAEF;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE;IAKrC;;;OAGG;IACH,iBAAiB;IAKjB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,2BAA2B;IAenC,OAAO,CAAC,uBAAuB;IAO/B;;;;;OAKG;IACH,QAAQ,GAAI,UAAU,eAAe,EAAE,UAAiC,KAAG,WAAW,EAAE,CAoDtF;IAEI,uBAAuB;CAQ9B"}

package/dist/dts/utils/index.d.ts

@@ -3,5 +3,6 @@ export * from './filters';
 export * from './logger';
 export * from './translation';
 export * from './validation';
+export * from './server-errors';
 export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}

package/dist/dts/utils/server-errors.d.ts

@@ -0,0 +1,40 @@
+import { ErrorObject } from 'ajv';
+import { JSONSchema7 } from 'json-schema';
+/**
+ * Genesis EVENT_NACK field-level error entry.
+ * @public
+ */
+export type GenesisFieldError = {
+    '@type'?: string;
+    CODE?: string;
+    TEXT: string;
+    STATUS_CODE?: string;
+    FIELD?: string;
+    PATH?: string | null;
+};
+/**
+ * Converts a JsonForms/Ajv instance path to a JSON Forms scope string.
+ * @example `/items/0/CCY` → `#/properties/items/items/0/properties/CCY`
+ * @internal
+ */
+export declare function instancePathToJsonFormsScope(instancePath: string): string;
+/**
+ * Converts a Genesis JSON-path or FIELD name to a JsonForms instance path.
+ * Strips the `$.` prefix and optional `DETAILS` segment used in event payloads.
+ * @internal
+ */
+export declare function genesisFieldToInstancePath(field?: string, path?: string | null, instancePathPrefix?: string): string | null;
+/**
+ * Maps Genesis commitEvent NACK `ERROR[]` entries to JsonForms `ErrorObject[]`
+ * suitable for `additionalErrors` on the form core.
+ *
+ * Only entries with a `FIELD` or `PATH` are mapped; generic errors (no field
+ * association) are omitted so callers can still surface them via toast/dialog.
+ *
+ * @param errors - Genesis ERROR array from an EVENT_NACK response
+ * @param schema - JSON schema used to resolve `parentSchema` for each field
+ * @param instancePathPrefix - Optional prefix for bulk-insert rows (e.g. `/items/0`)
+ * @public
+ */
+export declare function mapGenesisFieldErrorsToAdditionalErrors(errors: GenesisFieldError[] | undefined, schema?: JSONSchema7, instancePathPrefix?: string): ErrorObject[];
+//# sourceMappingURL=server-errors.d.ts.map

package/dist/dts/utils/server-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-errors.d.ts","sourceRoot":"","sources":["../../../src/utils/server-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAkBzE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EACpB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,MAAM,GAAG,IAAI,CAuBf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,iBAAiB,EAAE,GAAG,SAAS,EACvC,MAAM,CAAC,EAAE,WAAW,EACpB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,WAAW,EAAE,CAoCf"}

package/dist/esm/form.js

@@ -29,7 +29,7 @@ import { NumberControlRendererEntry } from './jsonforms/renderers/NumberControlR
 import { SegmentedControlRendererEntry } from './jsonforms/renderers/SegmentedControlRenderer';
 import { StringArrayEntry } from './jsonforms/renderers/StringArrayControlRenderer';
 import { StringControlRendererTemplate } from './jsonforms/renderers/StringControlRenderer';
-import { downloadCsvTemplate as downloadCsvFile, extractFieldsFromUiSchema, generateCsvTemplate, logger, mapCsvToSchema, parseCsv, } from './utils';
+import { downloadCsvTemplate as downloadCsvFile, extractFieldsFromUiSchema, generateCsvTemplate, logger, mapCsvToSchema, mapGenesisFieldErrorsToAdditionalErrors, parseCsv, } from './utils';
 import { findModalParent, showConfirmationDialog } from './utils/confirmation-dialog-utils';
 import { removeDataPropertiesNotInSchema } from './utils/form-utils';
 import { generateBulkUiSchema, isBulkUiSchema } from './utils/schema-utils';
@@ -297,6 +297,7 @@ let Form = class Form extends LifecycleMixin(FoundationElement) {
                         this.showApprovalModal();
                     }
                     else {
+                        this.applyServerFieldErrors(formSubmitReq.ERROR);
                         this.$emit('submit-failure', { payload, errors: formSubmitReq.ERROR });
                     }
                 }
@@ -313,7 +314,7 @@ let Form = class Form extends LifecycleMixin(FoundationElement) {
      */
     _submitBulk() {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a;
+            var _a, _b;
             const items = ((_a = this.data) === null || _a === void 0 ? void 0 : _a.items) || [];
             // Validate minimum items
             if (items.length < this.bulkInsertMinItems) {
@@ -390,15 +391,18 @@ let Form = class Form extends LifecycleMixin(FoundationElement) {
             this.$emit('bulk-submit-complete', results);
             // Also emit standard events based on overall result
             if (results.failed.length === 0) {
+                (_b = this.jsonFormsElement) === null || _b === void 0 ? void 0 : _b.clearServerErrors();
                 this.$emit('submit-success', { payload: this.data, results });
             }
             else if (results.successful.length === 0) {
+                this.applyBulkServerFieldErrors(results.failed);
                 this.$emit('submit-failure', {
                     payload: this.data,
                     errors: results.failed.flatMap((f) => f.errors),
                 });
             }
             else {
+                this.applyBulkServerFieldErrors(results.failed);
                 // Partial success - emit both events
                 this.$emit('submit-partial-success', { payload: this.data, results });
             }
@@ -461,6 +465,7 @@ let Form = class Form extends LifecycleMixin(FoundationElement) {
                 const response = yield this.connect.commitEvent(this.resourceName, commitPayload);
                 if (response.ERROR) {
                     this.updateRowStatus(index, { status: 'failed', errors: response.ERROR });
+                    this.applyServerFieldErrors(response.ERROR, `/items/${index}`);
                     this.$emit('row-submit-failure', { index, item, errors: response.ERROR });
                 }
                 else {
@@ -583,13 +588,43 @@ let Form = class Form extends LifecycleMixin(FoundationElement) {
      * @public
      */
     reset(clearData = true) {
+        var _a;
         this.submitted = false;
         this.clearRowSubmitStatuses();
+        (_a = this.jsonFormsElement) === null || _a === void 0 ? void 0 : _a.clearServerErrors();
         if (clearData) {
             this.data = {};
         }
         Observable.notify(this, 'submitted');
     }
+    /**
+     * Maps Genesis EVENT_NACK field errors onto the form via additionalErrors.
+     * @internal
+     */
+    applyServerFieldErrors(errors, instancePathPrefix) {
+        var _a, _b;
+        const additionalErrors = mapGenesisFieldErrorsToAdditionalErrors(errors, this.jsonSchema, instancePathPrefix);
+        if (additionalErrors.length) {
+            (_a = this.jsonFormsElement) === null || _a === void 0 ? void 0 : _a.setServerErrors(additionalErrors);
+        }
+        else {
+            (_b = this.jsonFormsElement) === null || _b === void 0 ? void 0 : _b.clearServerErrors();
+        }
+    }
+    /**
+     * Maps field errors from failed bulk-insert rows onto the form.
+     * @internal
+     */
+    applyBulkServerFieldErrors(failed) {
+        var _a, _b;
+        const additionalErrors = failed.flatMap(({ index, errors }) => mapGenesisFieldErrorsToAdditionalErrors(errors, this.jsonSchema, `/items/${index}`));
+        if (additionalErrors.length) {
+            (_a = this.jsonFormsElement) === null || _a === void 0 ? void 0 : _a.setServerErrors(additionalErrors);
+        }
+        else {
+            (_b = this.jsonFormsElement) === null || _b === void 0 ? void 0 : _b.clearServerErrors();
+        }
+    }
     /**
      * Show the approval message modal
      * @internal
@@ -634,6 +669,7 @@ let Form = class Form extends LifecycleMixin(FoundationElement) {
             const formSubmitReq = yield this.connect.commitEvent(this.resourceName, commitPayload);
             this.submitting = false;
             if (formSubmitReq.ERROR) {
+                this.applyServerFieldErrors(formSubmitReq.ERROR);
                 this.$emit('submit-failure', { payload: this.pendingPayload, errors: formSubmitReq.ERROR });
             }
             else {

package/dist/esm/form.template.js

@@ -40,6 +40,7 @@ export const getPrefixedForm = (prefix) => html `
         </div>
       `)}
     <json-forms
+      ${ref('jsonFormsElement')}
       @submit-button-clicked=${(x) => x._submit()}
       @submit-part=${(x, c) => x.submitPart(c.event)}
       @submit-single-row=${(x, c) => x.submitSingleRow(c.event.detail.index)}

package/dist/esm/jsonforms/json-forms.js

@@ -37,6 +37,7 @@ let JSONForms = class JSONForms extends FASTElement {
     constructor() {
         super(...arguments);
         this._submitted = false;
+        this.serverErrors = [];
         this.ajv = createAjv({ useDefaults: true, $data: true });
         /**
          * Row submit statuses for bulk insert mode.
@@ -54,16 +55,13 @@ let JSONForms = class JSONForms extends FASTElement {
             // the fresh errors. Without this, the value baked in by `Actions.init`
             // sticks forever even when validators would now return [].
             const nextCore = coreReducer(this.jsonforms.core, action);
-            // Validate against the post-action data, not `this.jsonforms.core.data`
-            // (which is still the pre-action snapshot at this point).
-            const additionalErrors = this.validate(this.uichemaToUse, nextCore.data);
-            this.jsonforms = Object.assign(Object.assign({}, this.jsonforms), { core: Object.assign(Object.assign({}, nextCore), { additionalErrors }) });
-            this.$emit('data-change', {
-                data: this.jsonforms.core.data,
-                errors: this.jsonforms.core.errors,
-                additionalErrors,
-                path: action.path,
-            });
+            if (action.path) {
+                const editedPath = action.path.startsWith('/')
+                    ? action.path
+                    : `/${action.path.replace(/\./g, '/')}`;
+                this.serverErrors = this.serverErrors.filter((e) => e.instancePath !== editedPath);
+            }
+            this.applyAdditionalErrorsToCore(nextCore, action.path);
         };
         /**
          * Performs client-side validation by running the validator defined in the UI schema.
@@ -139,6 +137,7 @@ let JSONForms = class JSONForms extends FASTElement {
         if (!this.schema) {
             return;
         }
+        this.serverErrors = [];
         this.uichemaToUse = (_a = this.uischema) !== null && _a !== void 0 ? _a : Generate.uiSchema(this.schema);
         if (!this.uischema) {
             logger.debug('UI schema not provided. Auto generated schema:', this.uichemaToUse);
@@ -152,7 +151,7 @@ let JSONForms = class JSONForms extends FASTElement {
             const core = coreReducer(initialCore, Actions.init(this.data, this.schema, this.uichemaToUse, {
                 validationMode: this.validationMode || 'ValidateAndShow',
                 ajv: this.ajv,
-                additionalErrors: this.validate(this.uichemaToUse, this.data),
+                additionalErrors: this.buildAdditionalErrors(this.uichemaToUse, this.data),
             }));
             return core;
         };
@@ -166,7 +165,7 @@ let JSONForms = class JSONForms extends FASTElement {
             rowSubmitStatuses: this.rowSubmitStatuses,
             bulkInsert: this.bulkInsert,
         };
-        const additionalErrors = this.validate(this.uichemaToUse, this.data);
+        const additionalErrors = this.buildAdditionalErrors(this.uichemaToUse, this.data);
         // Only notify consumers when `init` actually changed `core.data` (e.g. defaults
         // were filled in). A bare uischema/schema swap must not re-emit `this.data` —
         // when `<foundation-form>` mirrors the echo into its own `data` property it
@@ -202,13 +201,7 @@ let JSONForms = class JSONForms extends FASTElement {
         const nextCore = coreReducer(this.jsonforms.core, Actions.updateCore(this.data, this.schema, this.uichemaToUse));
         // Validate against the freshly-reduced data, not the still-assigned
         // `this.jsonforms.core.data` (which is the pre-action snapshot).
-        const additionalErrors = this.validate(this.uichemaToUse, nextCore.data);
-        this.jsonforms = Object.assign(Object.assign({}, this.jsonforms), { core: Object.assign(Object.assign({}, nextCore), { additionalErrors }) });
-        this.$emit('data-change', {
-            data: this.jsonforms.core.data,
-            errors: this.jsonforms.core.errors,
-            additionalErrors,
-        });
+        this.applyAdditionalErrorsToCore(nextCore);
     }
     renderersChanged() {
         this.schemaChanged();
@@ -257,6 +250,43 @@ let JSONForms = class JSONForms extends FASTElement {
             visible: true,
         };
     }
+    /**
+     * Applies server-side validation errors returned from an EVENT_NACK response.
+     * Errors are merged into `core.additionalErrors` and shown inline on fields.
+     * @public
+     */
+    setServerErrors(errors) {
+        this.serverErrors = errors !== null && errors !== void 0 ? errors : [];
+        this.refreshAdditionalErrors();
+    }
+    /**
+     * Clears all server-side validation errors from the form.
+     * @public
+     */
+    clearServerErrors() {
+        this.serverErrors = [];
+        this.refreshAdditionalErrors();
+    }
+    buildAdditionalErrors(uischema, data) {
+        return [...this.validate(uischema, data), ...this.serverErrors];
+    }
+    applyAdditionalErrorsToCore(nextCore, changedPath) {
+        const additionalErrors = this.buildAdditionalErrors(this.uichemaToUse, nextCore.data);
+        this.jsonforms = Object.assign(Object.assign({}, this.jsonforms), { core: Object.assign(Object.assign({}, nextCore), { additionalErrors }) });
+        this.$emit('data-change', {
+            data: this.jsonforms.core.data,
+            errors: this.jsonforms.core.errors,
+            additionalErrors,
+            path: changedPath,
+        });
+    }
+    refreshAdditionalErrors() {
+        var _a;
+        if (!((_a = this.jsonforms) === null || _a === void 0 ? void 0 : _a.core) || !this.uichemaToUse) {
+            return;
+        }
+        this.applyAdditionalErrorsToCore(this.jsonforms.core);
+    }
     copyUISchemaToClipboard() {
         return __awaiter(this, void 0, void 0, function* () {
             try {

package/dist/esm/utils/index.js

@@ -3,4 +3,5 @@ export * from './filters';
 export * from './logger';
 export * from './translation';
 export * from './validation';
+export * from './server-errors';
 export * from './types';

package/dist/esm/utils/server-errors.js

@@ -0,0 +1,98 @@
+import { Resolve } from '@jsonforms/core';
+/**
+ * Converts a JsonForms/Ajv instance path to a JSON Forms scope string.
+ * @example `/items/0/CCY` → `#/properties/items/items/0/properties/CCY`
+ * @internal
+ */
+export function instancePathToJsonFormsScope(instancePath) {
+    const segments = instancePath.replace(/^\//, '').split('/').filter(Boolean);
+    if (segments.length === 0) {
+        return '#';
+    }
+    let scope = '#';
+    for (let i = 0; i < segments.length; i += 1) {
+        const segment = segments[i];
+        if (i === 0) {
+            scope += `/properties/${segment}`;
+        }
+        else if (/^\d+$/.test(segment)) {
+            scope += `/items/${segment}`;
+        }
+        else {
+            scope += `/properties/${segment}`;
+        }
+    }
+    return scope;
+}
+/**
+ * Converts a Genesis JSON-path or FIELD name to a JsonForms instance path.
+ * Strips the `$.` prefix and optional `DETAILS` segment used in event payloads.
+ * @internal
+ */
+export function genesisFieldToInstancePath(field, path, instancePathPrefix) {
+    let relativePath = null;
+    if (path) {
+        let normalized = path.replace(/^\$\.?/, '').replace(/\./g, '/');
+        normalized = normalized.replace(/^DETAILS\//, '');
+        relativePath = normalized.startsWith('/') ? normalized : `/${normalized}`;
+    }
+    else if (field) {
+        relativePath = field.startsWith('/') ? field : `/${field}`;
+    }
+    if (!relativePath) {
+        return null;
+    }
+    if (instancePathPrefix) {
+        const prefix = instancePathPrefix.startsWith('/')
+            ? instancePathPrefix.replace(/\/$/, '')
+            : `/${instancePathPrefix.replace(/\/$/, '')}`;
+        return `${prefix}${relativePath}`;
+    }
+    return relativePath;
+}
+/**
+ * Maps Genesis commitEvent NACK `ERROR[]` entries to JsonForms `ErrorObject[]`
+ * suitable for `additionalErrors` on the form core.
+ *
+ * Only entries with a `FIELD` or `PATH` are mapped; generic errors (no field
+ * association) are omitted so callers can still surface them via toast/dialog.
+ *
+ * @param errors - Genesis ERROR array from an EVENT_NACK response
+ * @param schema - JSON schema used to resolve `parentSchema` for each field
+ * @param instancePathPrefix - Optional prefix for bulk-insert rows (e.g. `/items/0`)
+ * @public
+ */
+export function mapGenesisFieldErrorsToAdditionalErrors(errors, schema, instancePathPrefix) {
+    if (!(errors === null || errors === void 0 ? void 0 : errors.length)) {
+        return [];
+    }
+    return errors
+        .map((entry) => {
+        const instancePath = genesisFieldToInstancePath(entry.FIELD, entry.PATH, instancePathPrefix);
+        if (!instancePath) {
+            return null;
+        }
+        const error = {
+            keyword: 'serverValidation',
+            message: entry.TEXT,
+            instancePath,
+            schemaPath: '',
+            params: { code: entry.CODE },
+        };
+        if (schema) {
+            try {
+                const scope = instancePathToJsonFormsScope(instancePath);
+                const jsonFormsSchema = schema;
+                const fieldSchema = Resolve.schema(jsonFormsSchema, scope, jsonFormsSchema);
+                if (fieldSchema) {
+                    error.parentSchema = fieldSchema;
+                }
+            }
+            catch (_a) {
+                // parentSchema is best-effort; errors still render without it
+            }
+        }
+        return error;
+    })
+        .filter((e) => e !== null);
+}

package/dist/foundation-forms.api.json

@@ -2736,6 +2736,32 @@
           ],
           "name": "generateCsvTemplate"
         },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/foundation-forms!GenesisFieldError:type",
+          "docComment": "/**\n * Genesis EVENT_NACK field-level error entry.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type GenesisFieldError = "
+            },
+            {
+              "kind": "Content",
+              "text": "{\n    '@type'?: string;\n    CODE?: string;\n    TEXT: string;\n    STATUS_CODE?: string;\n    FIELD?: string;\n    PATH?: string | null;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/utils/server-errors.ts",
+          "releaseTag": "Public",
+          "name": "GenesisFieldError",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-forms!getAnyOfErrorMessage:function(1)",
@@ -3309,6 +3335,94 @@
           ],
           "name": "mapCsvToSchema"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-forms!mapGenesisFieldErrorsToAdditionalErrors:function(1)",
+          "docComment": "/**\n * Maps Genesis commitEvent NACK `ERROR[]` entries to JsonForms `ErrorObject[]` suitable for `additionalErrors` on the form core.\n *\n * Only entries with a `FIELD` or `PATH` are mapped; generic errors (no field association) are omitted so callers can still surface them via toast/dialog.\n *\n * @param errors - Genesis ERROR array from an EVENT_NACK response\n *\n * @param schema - JSON schema used to resolve `parentSchema` for each field\n *\n * @param instancePathPrefix - Optional prefix for bulk-insert rows (e.g. `/items/0`)\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function mapGenesisFieldErrorsToAdditionalErrors(errors: "
+            },
+            {
+              "kind": "Reference",
+              "text": "GenesisFieldError",
+              "canonicalReference": "@genesislcap/foundation-forms!GenesisFieldError:type"
+            },
+            {
+              "kind": "Content",
+              "text": "[] | undefined"
+            },
+            {
+              "kind": "Content",
+              "text": ", schema?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "JSONSchema7",
+              "canonicalReference": "@types/json-schema!JSONSchema7:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", instancePathPrefix?: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "ErrorObject",
+              "canonicalReference": "ajv!ErrorObject:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "[]"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/utils/server-errors.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 8,
+            "endIndex": 10
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "errors",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "schema",
+              "parameterTypeTokenRange": {
+                "startIndex": 4,
+                "endIndex": 5
+              },
+              "isOptional": true
+            },
+            {
+              "parameterName": "instancePathPrefix",
+              "parameterTypeTokenRange": {
+                "startIndex": 6,
+                "endIndex": 7
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "mapGenesisFieldErrorsToAdditionalErrors"
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/foundation-forms!MulticolumnDropdownControlRendererEntry:var",

package/dist/foundation-forms.d.ts

@@ -1,3 +1,4 @@
+import Ajv from 'ajv';
 import { Controller } from '@microsoft/fast-element';
 import { DatasourceOptions } from '@genesislcap/foundation-comms';
 import { DOMContainer } from '@genesislcap/foundation-utils';
@@ -9,6 +10,7 @@ import { FASTElement } from '@microsoft/fast-element';
 import { FilterMode } from '@genesislcap/foundation-ui';
 import { FoundationElement } from '@microsoft/fast-foundation';
 import { FoundationLayoutContainer } from '@genesislcap/foundation-utils';
+import { JsonFormsRendererRegistryEntry } from '@jsonforms/core';
 import { JsonFormsState } from '@jsonforms/core';
 import { JSONSchema7 } from 'json-schema';
 import { KVStorage } from '@genesislcap/foundation-comms';
@@ -17,10 +19,13 @@ import { LayoutCacheContainer } from '@genesislcap/foundation-utils';
 import { Logger } from '@genesislcap/foundation-logger';
 import { OwnPropsOfControl } from '@jsonforms/core';
 import { RankedTester } from '@jsonforms/core';
+import { RendererProps } from '@jsonforms/core';
 import { RuleEffect } from '@jsonforms/core';
 import { SchemaBasedCondition } from '@jsonforms/core';
 import { StatePropsOfControl } from '@jsonforms/core';
 import { UISchemaElement } from '@jsonforms/core';
+import { UpdateAction } from '@jsonforms/core';
+import { ValidationMode } from '@jsonforms/core';
 import { ViewTemplate } from '@microsoft/fast-element';
 
 /**
@@ -1069,6 +1074,11 @@ export declare class Form extends Form_base {
      * @internal
      */
     csvFileInput: HTMLInputElement;
+    /**
+     * Reference to the internal json-forms element.
+     * @internal
+     */
+    jsonFormsElement: JSONForms;
     /**
      * Stores the approval message entered by the user.
      * @internal
@@ -1291,6 +1301,16 @@ export declare class Form extends Form_base {
      * @public
      */
     reset(clearData?: boolean): void;
+    /**
+     * Maps Genesis EVENT_NACK field errors onto the form via additionalErrors.
+     * @internal
+     */
+    private applyServerFieldErrors;
+    /**
+     * Maps field errors from failed bulk-insert rows onto the form.
+     * @internal
+     */
+    private applyBulkServerFieldErrors;
     /**
      * Show the approval message modal
      * @internal
@@ -1718,6 +1738,26 @@ export declare function generateCsvTemplate(schema: JSONSchema7 | undefined, uiS
  */
 export declare const genesisErrorTranslator: ErrorTranslator;
 
+/**
+ * Genesis EVENT_NACK field-level error entry.
+ * @public
+ */
+export declare type GenesisFieldError = {
+    '@type'?: string;
+    CODE?: string;
+    TEXT: string;
+    STATUS_CODE?: string;
+    FIELD?: string;
+    PATH?: string | null;
+};
+
+/**
+ * Converts a Genesis JSON-path or FIELD name to a JsonForms instance path.
+ * Strips the `$.` prefix and optional `DETAILS` segment used in event payloads.
+ * @internal
+ */
+export declare function genesisFieldToInstancePath(field?: string, path?: string | null, instancePathPrefix?: string): string | null;
+
 /**
  * @internal
  * Needed to explicitly set as string as we don't want to let typescript set them as ascending numbers
@@ -1760,12 +1800,90 @@ export declare function getVerticalCategorizationHeight(layout: CategorizationLa
  */
 export declare type GroupRendererOptions = CategorizationRendererOptions;
 
+/**
+ * Converts a JsonForms/Ajv instance path to a JSON Forms scope string.
+ * @example `/items/0/CCY` → `#/properties/items/items/0/properties/CCY`
+ * @internal
+ */
+export declare function instancePathToJsonFormsScope(instancePath: string): string;
+
 /**
  * Whether categorization `layout` selects the vertical renderer (string `'vertical'` or object `{ type: 'vertical' }`).
  * @public
  */
 export declare function isVerticalCategorizationLayout(layout: CategorizationLayoutType | undefined): boolean;
 
+/**
+ * JSON Forms host element for schema-driven UI.
+ * @public
+ *
+ * @fires change - Bubbles from nested dispatch-renderer when a control emits change (e.g. multiselect)
+ * @fires data-change - Fired when bound form data changes
+ */
+declare class JSONForms extends FASTElement {
+    private _submitted;
+    private serverErrors;
+    get submitted(): boolean;
+    set submitted(value: boolean);
+    prefix: any;
+    prefixChanged(): void;
+    jsonforms: any;
+    i18n: any;
+    uichemaToUse: any;
+    schema: any;
+    schemaChanged(): void;
+    uischema: UISchemaElement;
+    uischemaChanged(): void;
+    data: any;
+    dataChanged(): void;
+    renderers: JsonFormsRendererRegistryEntry[];
+    renderersChanged(): void;
+    validationMode: ValidationMode;
+    validationModeChanged(): void;
+    ajv: Ajv;
+    ajvChanged(): void;
+    readonly: boolean;
+    readonlyChanged(): void;
+    config: any;
+    configChanged(): void;
+    /**
+     * Row submit statuses for bulk insert mode.
+     * Passed from the parent foundation-form.
+     */
+    rowSubmitStatuses: Map<number, BulkRowStatus>;
+    rowSubmitStatusesChanged(): void;
+    /**
+     * Whether the form is in bulk insert mode.
+     * Passed from the parent foundation-form.
+     */
+    bulkInsert: boolean;
+    bulkInsertChanged(): void;
+    get props(): RendererProps;
+    dispatch: (action: UpdateAction) => void;
+    /**
+     * Applies server-side validation errors returned from an EVENT_NACK response.
+     * Errors are merged into `core.additionalErrors` and shown inline on fields.
+     * @public
+     */
+    setServerErrors(errors: ErrorObject[]): void;
+    /**
+     * Clears all server-side validation errors from the form.
+     * @public
+     */
+    clearServerErrors(): void;
+    private buildAdditionalErrors;
+    private applyAdditionalErrorsToCore;
+    private refreshAdditionalErrors;
+    /**
+     * Performs client-side validation by running the validator defined in the UI schema.
+     * @param uischema the UI schema
+     * @param data the data to validate against (defaults to the current core data)
+     * @returns ErrorObject[] that will be passed to JsonFormsCore as additionalErrors
+     */
+    validate: (uischema: UISchemaElement, data?: any) => ErrorObject[];
+    copyUISchemaToClipboard(): Promise<void>;
+}
+
 /**
  * Orientation options available for stepper renderer.
  * @public
@@ -1834,6 +1952,20 @@ export declare const logger: Logger;
  */
 export declare function mapCsvToSchema(csvRows: Record<string, string>[], schema: JSONSchema7 | undefined, uiSchema?: UiSchema): CsvMappingResult;
 
+/**
+ * Maps Genesis commitEvent NACK `ERROR[]` entries to JsonForms `ErrorObject[]`
+ * suitable for `additionalErrors` on the form core.
+ *
+ * Only entries with a `FIELD` or `PATH` are mapped; generic errors (no field
+ * association) are omitted so callers can still surface them via toast/dialog.
+ *
+ * @param errors - Genesis ERROR array from an EVENT_NACK response
+ * @param schema - JSON schema used to resolve `parentSchema` for each field
+ * @param instancePathPrefix - Optional prefix for bulk-insert rows (e.g. `/items/0`)
+ * @public
+ */
+export declare function mapGenesisFieldErrorsToAdditionalErrors(errors: GenesisFieldError[] | undefined, schema?: JSONSchema7, instancePathPrefix?: string): ErrorObject[];
+
 /** @beta */
 export declare const MulticolumnDropdownControlRendererEntry: any;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-forms",
   "description": "Genesis Foundation Forms",
-  "version": "14.452.0",
+  "version": "14.452.1-FUI-2538.1",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -59,13 +59,13 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.452.0",
-    "@genesislcap/genx": "14.452.0",
-    "@genesislcap/rollup-builder": "14.452.0",
-    "@genesislcap/ts-builder": "14.452.0",
-    "@genesislcap/uvu-playwright-builder": "14.452.0",
-    "@genesislcap/vite-builder": "14.452.0",
-    "@genesislcap/webpack-builder": "14.452.0",
+    "@genesislcap/foundation-testing": "14.452.1-FUI-2538.1",
+    "@genesislcap/genx": "14.452.1-FUI-2538.1",
+    "@genesislcap/rollup-builder": "14.452.1-FUI-2538.1",
+    "@genesislcap/ts-builder": "14.452.1-FUI-2538.1",
+    "@genesislcap/uvu-playwright-builder": "14.452.1-FUI-2538.1",
+    "@genesislcap/vite-builder": "14.452.1-FUI-2538.1",
+    "@genesislcap/webpack-builder": "14.452.1-FUI-2538.1",
     "@types/json-schema": "^7.0.11",
     "@types/papaparse": "^5.3.14"
   },
@@ -82,12 +82,12 @@
     }
   },
   "dependencies": {
-    "@genesislcap/foundation-comms": "14.452.0",
-    "@genesislcap/foundation-criteria": "14.452.0",
-    "@genesislcap/foundation-logger": "14.452.0",
-    "@genesislcap/foundation-notifications": "14.452.0",
-    "@genesislcap/foundation-ui": "14.452.0",
-    "@genesislcap/foundation-utils": "14.452.0",
+    "@genesislcap/foundation-comms": "14.452.1-FUI-2538.1",
+    "@genesislcap/foundation-criteria": "14.452.1-FUI-2538.1",
+    "@genesislcap/foundation-logger": "14.452.1-FUI-2538.1",
+    "@genesislcap/foundation-notifications": "14.452.1-FUI-2538.1",
+    "@genesislcap/foundation-ui": "14.452.1-FUI-2538.1",
+    "@genesislcap/foundation-utils": "14.452.1-FUI-2538.1",
     "@json-schema-tools/dereferencer": "^1.6.1",
     "@jsonforms/core": "^3.2.1",
     "@microsoft/fast-components": "2.30.6",
@@ -109,5 +109,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "f2d34cef52ecea070247f239e9274d9d7bb74784"
+  "gitHead": "f02752e979beb9ef663a6ce89a4db72d1b9a9514"
 }