@genesislcap/foundation-forms 15.51.0 → 15.52.0

package/dist/custom-elements.json

@@ -2450,7 +2450,7 @@
               "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.",
+          "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` naming a field are mapped; generic errors\n(no field association, or about the whole payload) are omitted so callers can\nstill surface them via toast/dialog.",
           "privacy": "public"
         }
       ],

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

@@ -21,6 +21,15 @@ export declare function instancePathToJsonFormsScope(instancePath: string): stri
 /**
  * Converts a Genesis JSON-path or FIELD name to a JsonForms instance path.
  * Strips the `$.` prefix and optional `DETAILS` segment used in event payloads.
+ *
+ * For a schema failure GSF sets PATH to where the failure was found. FIELD is the missing
+ * property for `required` (PATH is then its parent object) and PATH's last segment otherwise:
+ * - `PATH: '$.DETAILS', FIELD: 'NAME'` → `/NAME`
+ * - `PATH: '$.DETAILS.ENABLED', FIELD: 'ENABLED'` → `/ENABLED`
+ * - `PATH: '$.DETAILS.ITEMS[0]', FIELD: 'NAME'` → `/ITEMS/0/NAME`
+ *
+ * Returns null when the error is about the whole payload (`PATH: '$.DETAILS', FIELD: 'DETAILS'`,
+ * e.g. an additional property), since no control matches it.
  * @internal
  */
 export declare function genesisFieldToInstancePath(field?: string, path?: string | null, instancePathPrefix?: string): string | null;
@@ -28,8 +37,9 @@ export declare function genesisFieldToInstancePath(field?: string, path?: string
  * 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.
+ * Only entries with a `FIELD` or `PATH` naming a field are mapped; generic errors
+ * (no field association, or about the whole payload) 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

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

@@ -1 +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"}
+{"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;AAcD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EACpB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,MAAM,GAAG,IAAI,CAgCf;AAED;;;;;;;;;;;;GAYG;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/utils/server-errors.js

@@ -24,17 +24,45 @@ export function instancePathToJsonFormsScope(instancePath) {
     }
     return scope;
 }
+/**
+ * Splits a Genesis JSON path into segments.
+ * @example `$.DETAILS.ITEMS[0].NAME` → `['DETAILS', 'ITEMS', '0', 'NAME']`
+ */
+function jsonPathSegments(path) {
+    return path
+        .replace(/^\$/, '')
+        .replace(/\[(\d+)\]/g, '.$1')
+        .split(/[./]/)
+        .filter(Boolean);
+}
 /**
  * Converts a Genesis JSON-path or FIELD name to a JsonForms instance path.
  * Strips the `$.` prefix and optional `DETAILS` segment used in event payloads.
+ *
+ * For a schema failure GSF sets PATH to where the failure was found. FIELD is the missing
+ * property for `required` (PATH is then its parent object) and PATH's last segment otherwise:
+ * - `PATH: '$.DETAILS', FIELD: 'NAME'` → `/NAME`
+ * - `PATH: '$.DETAILS.ENABLED', FIELD: 'ENABLED'` → `/ENABLED`
+ * - `PATH: '$.DETAILS.ITEMS[0]', FIELD: 'NAME'` → `/ITEMS/0/NAME`
+ *
+ * Returns null when the error is about the whole payload (`PATH: '$.DETAILS', FIELD: 'DETAILS'`,
+ * e.g. an additional property), since no control matches it.
  * @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}`;
+        const segments = jsonPathSegments(path);
+        const fieldSegments = field ? jsonPathSegments(field) : [];
+        const pathEndsWithField = fieldSegments.length <= segments.length &&
+            fieldSegments.every((s, i) => segments[segments.length - fieldSegments.length + i] === s);
+        if (!pathEndsWithField) {
+            segments.push(...fieldSegments);
+        }
+        if (segments[0] === 'DETAILS') {
+            segments.shift();
+        }
+        relativePath = segments.length ? `/${segments.join('/')}` : null;
     }
     else if (field) {
         relativePath = field.startsWith('/') ? field : `/${field}`;
@@ -54,8 +82,9 @@ export function genesisFieldToInstancePath(field, path, instancePathPrefix) {
  * 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.
+ * Only entries with a `FIELD` or `PATH` naming a field are mapped; generic errors
+ * (no field association, or about the whole payload) 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

package/dist/foundation-forms.api.json

@@ -3820,7 +3820,7 @@
         {
           "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",
+          "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` naming a field are mapped; generic errors (no field association, or about the whole payload) 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",

package/dist/foundation-forms.d.ts

@@ -2094,6 +2094,15 @@ export declare type GenesisFieldError = {
 /**
  * Converts a Genesis JSON-path or FIELD name to a JsonForms instance path.
  * Strips the `$.` prefix and optional `DETAILS` segment used in event payloads.
+ *
+ * For a schema failure GSF sets PATH to where the failure was found. FIELD is the missing
+ * property for `required` (PATH is then its parent object) and PATH's last segment otherwise:
+ * - `PATH: '$.DETAILS', FIELD: 'NAME'` → `/NAME`
+ * - `PATH: '$.DETAILS.ENABLED', FIELD: 'ENABLED'` → `/ENABLED`
+ * - `PATH: '$.DETAILS.ITEMS[0]', FIELD: 'NAME'` → `/ITEMS/0/NAME`
+ *
+ * Returns null when the error is about the whole payload (`PATH: '$.DETAILS', FIELD: 'DETAILS'`,
+ * e.g. an additional property), since no control matches it.
  * @internal
  */
 export declare function genesisFieldToInstancePath(field?: string, path?: string | null, instancePathPrefix?: string): string | null;
@@ -2241,8 +2250,9 @@ export declare function mapCsvToSchema(csvRows: Record<string, string>[], schema
  * 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.
+ * Only entries with a `FIELD` or `PATH` naming a field are mapped; generic errors
+ * (no field association, or about the whole payload) 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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-forms",
   "description": "Genesis Foundation Forms",
-  "version": "15.51.0",
+  "version": "15.52.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -56,12 +56,12 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.51.0",
-    "@genesislcap/genx": "15.51.0",
-    "@genesislcap/ts-builder": "15.51.0",
-    "@genesislcap/uvu-playwright-builder": "15.51.0",
-    "@genesislcap/vite-builder": "15.51.0",
-    "@genesislcap/webpack-builder": "15.51.0",
+    "@genesislcap/foundation-testing": "15.52.0",
+    "@genesislcap/genx": "15.52.0",
+    "@genesislcap/ts-builder": "15.52.0",
+    "@genesislcap/uvu-playwright-builder": "15.52.0",
+    "@genesislcap/vite-builder": "15.52.0",
+    "@genesislcap/webpack-builder": "15.52.0",
     "@types/json-schema": "^7.0.11",
     "@types/papaparse": "^5.3.14"
   },
@@ -78,12 +78,12 @@
     }
   },
   "dependencies": {
-    "@genesislcap/foundation-comms": "15.51.0",
-    "@genesislcap/foundation-criteria": "15.51.0",
-    "@genesislcap/foundation-logger": "15.51.0",
-    "@genesislcap/foundation-notifications": "15.51.0",
-    "@genesislcap/foundation-ui": "15.51.0",
-    "@genesislcap/foundation-utils": "15.51.0",
+    "@genesislcap/foundation-comms": "15.52.0",
+    "@genesislcap/foundation-criteria": "15.52.0",
+    "@genesislcap/foundation-logger": "15.52.0",
+    "@genesislcap/foundation-notifications": "15.52.0",
+    "@genesislcap/foundation-ui": "15.52.0",
+    "@genesislcap/foundation-utils": "15.52.0",
     "@json-schema-tools/dereferencer": "^1.6.1",
     "@jsonforms/core": "^3.2.1",
     "@microsoft/fast-components": "2.30.6",