@makehq/forman-schema 1.11.1 → 1.12.1

package/dist/index.cjs

@@ -1056,6 +1056,9 @@ function processNestedDirective(field, nested, domain, result, context) {
 }
 
 // src/validator.ts
+function fieldAllowsCustomValue(field) {
+  return field.mappable === true || field.editable === true;
+}
 function hasPlaceholderNested(field) {
   if (!isObject(field.options)) return false;
   const placeholder = field.options.placeholder;
@@ -1158,6 +1161,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 +1312,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: [
@@ -1677,7 +1681,7 @@ async function handlePathType(value, field, context) {
     });
     const selectedOption = selectableOptions.find((candidate) => candidate.value === levelSelectedValue);
     if (!selectedOption) {
-      if (optionsFromRPC) {
+      if (optionsFromRPC && (context.roots[context.domain].allowDynamicValues || fieldAllowsCustomValue(field))) {
         warnings.push({
           domain: context.domain,
           path: context.path.join("."),
@@ -1783,7 +1787,7 @@ async function handleSelectType(value, field, context) {
         optionsOrGroups
       );
       if (!found) {
-        (optionsFromRPC ? warnings : errors).push({
+        (optionsFromRPC && (context.roots[context.domain].allowDynamicValues || fieldAllowsCustomValue(field)) ? warnings : errors).push({
           domain: context.domain,
           path: context.path.join("."),
           message: `Value '${singleValue}' not found in options.`
@@ -1791,7 +1795,7 @@ async function handleSelectType(value, field, context) {
         hasUnresolvedValue = true;
       }
     }
-    if (optionsFromRPC && hasUnresolvedValue) {
+    if (optionsFromRPC && (context.roots[context.domain].allowDynamicValues || fieldAllowsCustomValue(field)) && hasUnresolvedValue) {
       context.roots[context.domain].fieldStates.push({
         path: context.path,
         state: { mode: "edit" }
@@ -1828,7 +1832,7 @@ async function handleSelectType(value, field, context) {
   } else {
     const item = findValueInSelectOptions(field, value, optionsOrGroups);
     if (!item) {
-      if (optionsFromRPC) {
+      if (optionsFromRPC && (context.roots[context.domain].allowDynamicValues || fieldAllowsCustomValue(field))) {
         warnings.push({
           domain: context.domain,
           path: context.path.join("."),
@@ -2158,7 +2162,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

@@ -53,6 +53,8 @@ type FormanSchemaField = {
     disabled?: boolean;
     /** Whether the field is mappable */
     mappable?: boolean;
+    /** Whether the field allows custom (typed-in) values even when dynamic values are not allowed in the domain */
+    editable?: boolean;
     /** Whether the user will be able to insert new lines in GUI (a textarea will be displayed instead of the text field) */
     multiline?: boolean;
     /** Whether the select field allows multiple values */
@@ -231,6 +233,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 +263,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

@@ -53,6 +53,8 @@ type FormanSchemaField = {
     disabled?: boolean;
     /** Whether the field is mappable */
     mappable?: boolean;
+    /** Whether the field allows custom (typed-in) values even when dynamic values are not allowed in the domain */
+    editable?: boolean;
     /** Whether the user will be able to insert new lines in GUI (a textarea will be displayed instead of the text field) */
     multiline?: boolean;
     /** Whether the select field allows multiple values */
@@ -231,6 +233,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 +263,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

@@ -1027,6 +1027,9 @@ function processNestedDirective(field, nested, domain, result, context) {
 }
 
 // src/validator.ts
+function fieldAllowsCustomValue(field) {
+  return field.mappable === true || field.editable === true;
+}
 function hasPlaceholderNested(field) {
   if (!isObject(field.options)) return false;
   const placeholder = field.options.placeholder;
@@ -1129,6 +1132,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 +1283,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: [
@@ -1648,7 +1652,7 @@ async function handlePathType(value, field, context) {
     });
     const selectedOption = selectableOptions.find((candidate) => candidate.value === levelSelectedValue);
     if (!selectedOption) {
-      if (optionsFromRPC) {
+      if (optionsFromRPC && (context.roots[context.domain].allowDynamicValues || fieldAllowsCustomValue(field))) {
         warnings.push({
           domain: context.domain,
           path: context.path.join("."),
@@ -1754,7 +1758,7 @@ async function handleSelectType(value, field, context) {
         optionsOrGroups
       );
       if (!found) {
-        (optionsFromRPC ? warnings : errors).push({
+        (optionsFromRPC && (context.roots[context.domain].allowDynamicValues || fieldAllowsCustomValue(field)) ? warnings : errors).push({
           domain: context.domain,
           path: context.path.join("."),
           message: `Value '${singleValue}' not found in options.`
@@ -1762,7 +1766,7 @@ async function handleSelectType(value, field, context) {
         hasUnresolvedValue = true;
       }
     }
-    if (optionsFromRPC && hasUnresolvedValue) {
+    if (optionsFromRPC && (context.roots[context.domain].allowDynamicValues || fieldAllowsCustomValue(field)) && hasUnresolvedValue) {
       context.roots[context.domain].fieldStates.push({
         path: context.path,
         state: { mode: "edit" }
@@ -1799,7 +1803,7 @@ async function handleSelectType(value, field, context) {
   } else {
     const item = findValueInSelectOptions(field, value, optionsOrGroups);
     if (!item) {
-      if (optionsFromRPC) {
+      if (optionsFromRPC && (context.roots[context.domain].allowDynamicValues || fieldAllowsCustomValue(field))) {
         warnings.push({
           domain: context.domain,
           path: context.path.join("."),
@@ -2129,7 +2133,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.1",
+    "version": "1.12.1",
     "description": "Forman Schema Tools",
     "license": "MIT",
     "author": "Make",