@makehq/forman-schema 1.18.0 → 1.19.0

package/dist/index.cjs

@@ -1392,7 +1392,12 @@ async function validateFormanWithDomainsInternal(domains, options) {
     states: errors.length === 0 && options?.states ? buildRestoreStructure(
       Object.keys(domains).map((domain) => roots[domain].fieldStates.map((state) => ({ domain, ...state }))).flat()
     ) : void 0,
-    schemas: errors.length === 0 && options?.schemas ? Object.fromEntries(Object.keys(domains).map((domain) => [domain, roots[domain].schemaFields])) : void 0
+    schemas: errors.length === 0 && options?.schemas ? Object.fromEntries(Object.keys(domains).map((domain) => [domain, roots[domain].schemaFields])) : void 0,
+    // Same spec as `schemas`, but also on the failure path. Remote-resolved fields are
+    // built before the verdict, so a rejection can name the fields it rejected instead of
+    // leaving the caller to guess at a sub-form it never saw. `schemas` stays success-only:
+    // callers read its presence as a success signal.
+    resolvedSchemas: options?.schemas ? Object.fromEntries(Object.keys(domains).map((domain) => [domain, roots[domain].schemaFields])) : void 0
   };
 }
 async function validateFormanValue(value, field, context) {

package/dist/index.d.cts

@@ -216,8 +216,15 @@ type FormanValidationResult = {
     }[];
     /** States of fields grouped by domain */
     states?: Record<string, FormanSchemaFieldState>;
-    /** Resolved schema fields per domain */
+    /** Resolved schema fields per domain. Requires `options.schemas`; only present when validation succeeded. */
     schemas?: Record<string, FormanSchemaField[]>;
+    /**
+     * Resolved schema fields per domain. Requires `options.schemas`, and unlike {@link schemas} is
+     * present whether or not validation succeeded — including fields revealed by a remote-resolved
+     * (`rpc://`) sub-form, which cannot be known from the static schema alone. Lets a caller report
+     * which fields it rejected.
+     */
+    resolvedSchemas?: Record<string, FormanSchemaField[]>;
 };
 type FormanSchemaFieldState = {
     mode?: 'chose' | 'edit';

package/dist/index.d.ts

@@ -216,8 +216,15 @@ type FormanValidationResult = {
     }[];
     /** States of fields grouped by domain */
     states?: Record<string, FormanSchemaFieldState>;
-    /** Resolved schema fields per domain */
+    /** Resolved schema fields per domain. Requires `options.schemas`; only present when validation succeeded. */
     schemas?: Record<string, FormanSchemaField[]>;
+    /**
+     * Resolved schema fields per domain. Requires `options.schemas`, and unlike {@link schemas} is
+     * present whether or not validation succeeded — including fields revealed by a remote-resolved
+     * (`rpc://`) sub-form, which cannot be known from the static schema alone. Lets a caller report
+     * which fields it rejected.
+     */
+    resolvedSchemas?: Record<string, FormanSchemaField[]>;
 };
 type FormanSchemaFieldState = {
     mode?: 'chose' | 'edit';

package/dist/index.js

@@ -1360,7 +1360,12 @@ async function validateFormanWithDomainsInternal(domains, options) {
     states: errors.length === 0 && options?.states ? buildRestoreStructure(
       Object.keys(domains).map((domain) => roots[domain].fieldStates.map((state) => ({ domain, ...state }))).flat()
     ) : void 0,
-    schemas: errors.length === 0 && options?.schemas ? Object.fromEntries(Object.keys(domains).map((domain) => [domain, roots[domain].schemaFields])) : void 0
+    schemas: errors.length === 0 && options?.schemas ? Object.fromEntries(Object.keys(domains).map((domain) => [domain, roots[domain].schemaFields])) : void 0,
+    // Same spec as `schemas`, but also on the failure path. Remote-resolved fields are
+    // built before the verdict, so a rejection can name the fields it rejected instead of
+    // leaving the caller to guess at a sub-form it never saw. `schemas` stays success-only:
+    // callers read its presence as a success signal.
+    resolvedSchemas: options?.schemas ? Object.fromEntries(Object.keys(domains).map((domain) => [domain, roots[domain].schemaFields])) : void 0
   };
 }
 async function validateFormanValue(value, field, context) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@makehq/forman-schema",
-    "version": "1.18.0",
+    "version": "1.19.0",
     "description": "Forman Schema Tools",
     "license": "MIT",
     "author": "Make",