@makehq/forman-schema 1.11.0 → 1.12.0

package/dist/index.cjs

@@ -1158,6 +1158,7 @@ async function validateFormanWithDomainsInternal(domains, options) {
         seenFields: /* @__PURE__ */ new Set(),
         fieldStates: [],
         schemaFields: [],
+        allowDynamicValues: domains[domain].allowDynamicValues ?? options?.allowDynamicValues ?? false,
         validateFields: (fields, context) => {
           return validateFormanValue(
             domains[domain].values,
@@ -1308,7 +1309,7 @@ async function validateFormanValue(value, field, context) {
     };
   }
   if (containsIMLExpression(value)) {
-    if (normalizedField.mappable === false) {
+    if (normalizedField.mappable === false || !context.roots[context.domain].allowDynamicValues) {
       return {
         valid: false,
         errors: [
@@ -1775,6 +1776,7 @@ async function handleSelectType(value, field, context) {
         warnings
       };
     }
+    let hasUnresolvedValue = false;
     for (const singleValue of value) {
       const found = findValueInSelectOptions(
         field,
@@ -1782,13 +1784,20 @@ async function handleSelectType(value, field, context) {
         optionsOrGroups
       );
       if (!found) {
-        (optionsFromRPC ? warnings : errors).push({
+        (optionsFromRPC && context.roots[context.domain].allowDynamicValues ? warnings : errors).push({
           domain: context.domain,
           path: context.path.join("."),
           message: `Value '${singleValue}' not found in options.`
         });
+        hasUnresolvedValue = true;
       }
     }
+    if (optionsFromRPC && context.roots[context.domain].allowDynamicValues && hasUnresolvedValue) {
+      context.roots[context.domain].fieldStates.push({
+        path: context.path,
+        state: { mode: "edit" }
+      });
+    }
     if (field.validate) {
       if (field.validate.minItems !== void 0 && value.length < field.validate.minItems) {
         errors.push({
@@ -1820,12 +1829,16 @@ async function handleSelectType(value, field, context) {
   } else {
     const item = findValueInSelectOptions(field, value, optionsOrGroups);
     if (!item) {
-      if (optionsFromRPC) {
+      if (optionsFromRPC && context.roots[context.domain].allowDynamicValues) {
         warnings.push({
           domain: context.domain,
           path: context.path.join("."),
           message: `Value '${value}' not found in options.`
         });
+        context.roots[context.domain].fieldStates.push({
+          path: context.path,
+          state: { mode: "edit" }
+        });
       } else {
         return {
           valid: false,
@@ -2146,7 +2159,10 @@ function validateFormanWithDomains(domains, options) {
   return validateFormanWithDomainsInternal(domains, options);
 }
 function validateForman(values, schema, options, restoreExtras) {
-  return validateFormanWithDomains({ default: { values, schema, restoreExtras } }, options);
+  return validateFormanWithDomains(
+    { default: { values, schema, restoreExtras, allowDynamicValues: options?.allowDynamicValues } },
+    options
+  );
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.d.cts

@@ -231,6 +231,10 @@ type FormanValidationOptions = {
     resolveRemote?(path: string, data: Record<string, unknown>): Promise<unknown>;
     /** Maps domain names used in nested.domain to actual domain keys passed to validateFormanWithDomains */
     domainAliases?: Record<string, string>;
+    /** Whether to allow dynamic values (IML expressions, unresolved RPC options).
+     *  When false (default), IML expressions cause errors and unresolved RPC options are treated as errors.
+     *  Applies as a global default; can be overridden per-domain in validateFormanWithDomains(). */
+    allowDynamicValues?: boolean;
 };
 
 /**
@@ -257,6 +261,9 @@ declare function validateFormanWithDomains(domains: Record<string, {
     schema: FormanSchemaField[];
     /** Extra values injected into restore states, keyed by string path (dot notation, `[index]`, backtick-escaping). */
     restoreExtras?: Record<string, Record<string, unknown>>;
+    /** Whether the domain allows dynamic values (IML expressions, unresolved RPC select options).
+     *  Defaults to false. When false, IML expressions cause errors and unresolved RPC options are treated as errors. */
+    allowDynamicValues?: boolean;
 }>, options?: FormanValidationOptions): Promise<FormanValidationResult>;
 /**
  * Validates a simple Forman values against a schema

package/dist/index.d.ts

@@ -231,6 +231,10 @@ type FormanValidationOptions = {
     resolveRemote?(path: string, data: Record<string, unknown>): Promise<unknown>;
     /** Maps domain names used in nested.domain to actual domain keys passed to validateFormanWithDomains */
     domainAliases?: Record<string, string>;
+    /** Whether to allow dynamic values (IML expressions, unresolved RPC options).
+     *  When false (default), IML expressions cause errors and unresolved RPC options are treated as errors.
+     *  Applies as a global default; can be overridden per-domain in validateFormanWithDomains(). */
+    allowDynamicValues?: boolean;
 };
 
 /**
@@ -257,6 +261,9 @@ declare function validateFormanWithDomains(domains: Record<string, {
     schema: FormanSchemaField[];
     /** Extra values injected into restore states, keyed by string path (dot notation, `[index]`, backtick-escaping). */
     restoreExtras?: Record<string, Record<string, unknown>>;
+    /** Whether the domain allows dynamic values (IML expressions, unresolved RPC select options).
+     *  Defaults to false. When false, IML expressions cause errors and unresolved RPC options are treated as errors. */
+    allowDynamicValues?: boolean;
 }>, options?: FormanValidationOptions): Promise<FormanValidationResult>;
 /**
  * Validates a simple Forman values against a schema

package/dist/index.js

@@ -1129,6 +1129,7 @@ async function validateFormanWithDomainsInternal(domains, options) {
         seenFields: /* @__PURE__ */ new Set(),
         fieldStates: [],
         schemaFields: [],
+        allowDynamicValues: domains[domain].allowDynamicValues ?? options?.allowDynamicValues ?? false,
         validateFields: (fields, context) => {
           return validateFormanValue(
             domains[domain].values,
@@ -1279,7 +1280,7 @@ async function validateFormanValue(value, field, context) {
     };
   }
   if (containsIMLExpression(value)) {
-    if (normalizedField.mappable === false) {
+    if (normalizedField.mappable === false || !context.roots[context.domain].allowDynamicValues) {
       return {
         valid: false,
         errors: [
@@ -1746,6 +1747,7 @@ async function handleSelectType(value, field, context) {
         warnings
       };
     }
+    let hasUnresolvedValue = false;
     for (const singleValue of value) {
       const found = findValueInSelectOptions(
         field,
@@ -1753,13 +1755,20 @@ async function handleSelectType(value, field, context) {
         optionsOrGroups
       );
       if (!found) {
-        (optionsFromRPC ? warnings : errors).push({
+        (optionsFromRPC && context.roots[context.domain].allowDynamicValues ? warnings : errors).push({
           domain: context.domain,
           path: context.path.join("."),
           message: `Value '${singleValue}' not found in options.`
         });
+        hasUnresolvedValue = true;
       }
     }
+    if (optionsFromRPC && context.roots[context.domain].allowDynamicValues && hasUnresolvedValue) {
+      context.roots[context.domain].fieldStates.push({
+        path: context.path,
+        state: { mode: "edit" }
+      });
+    }
     if (field.validate) {
       if (field.validate.minItems !== void 0 && value.length < field.validate.minItems) {
         errors.push({
@@ -1791,12 +1800,16 @@ async function handleSelectType(value, field, context) {
   } else {
     const item = findValueInSelectOptions(field, value, optionsOrGroups);
     if (!item) {
-      if (optionsFromRPC) {
+      if (optionsFromRPC && context.roots[context.domain].allowDynamicValues) {
         warnings.push({
           domain: context.domain,
           path: context.path.join("."),
           message: `Value '${value}' not found in options.`
         });
+        context.roots[context.domain].fieldStates.push({
+          path: context.path,
+          state: { mode: "edit" }
+        });
       } else {
         return {
           valid: false,
@@ -2117,7 +2130,10 @@ function validateFormanWithDomains(domains, options) {
   return validateFormanWithDomainsInternal(domains, options);
 }
 function validateForman(values, schema, options, restoreExtras) {
-  return validateFormanWithDomains({ default: { values, schema, restoreExtras } }, options);
+  return validateFormanWithDomains(
+    { default: { values, schema, restoreExtras, allowDynamicValues: options?.allowDynamicValues } },
+    options
+  );
 }
 export {
   toFormanSchema,

package/package.json

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