@form-engine-ts/core 2.1.0 → 2.2.0

package/README.md

@@ -40,8 +40,9 @@ round-trips. `completionMessage` is localized with the rest of the form text.
 
 `transformFieldType` changes a question's type without discarding source text, translations, conditions, or extension
 metadata. `validateFormSchema(schema, { policy })` applies the framework-independent `FormPolicy`, including field,
-option, text, serialized-byte, allowed-type, and required-locale constraints. Required locales cover every source text
-that exists on the form, its fields, options, and pages.
+option, text, serialized-byte, allowed-type, and locale constraints. `allowedLocales` constrains the default and supported
+locales, `maxLocales` limits their unique total, and contradictory required/allowed locale policies are reported.
+Required locales cover every source text that exists on the form, its fields, options, and pages.
 
 Translation callbacks receive `nodeMetadata` and `existingTranslationMetadata` separately. The deprecated `metadata`
 slot property remains an alias for `nodeMetadata` during migration.

package/dist/index.cjs

@@ -554,6 +554,45 @@ function validatePolicy(schema, policy, issues) {
       }
     }
   }
+  const registeredLocales = [
+    .../* @__PURE__ */ new Set([
+      ...schema.defaultLocale === void 0 ? [] : [schema.defaultLocale],
+      ...schema.supportedLocales ?? []
+    ])
+  ];
+  if (policy.allowedLocales !== void 0) {
+    if (schema.defaultLocale !== void 0 && !policy.allowedLocales.includes(schema.defaultLocale)) {
+      issue(
+        issues,
+        "defaultLocale",
+        "disallowed_locale",
+        `Locale ${schema.defaultLocale} is not allowed by the form policy.`
+      );
+    }
+    schema.supportedLocales?.forEach((locale, index) => {
+      if (!policy.allowedLocales?.includes(locale)) {
+        issue(
+          issues,
+          `supportedLocales[${index}]`,
+          "disallowed_locale",
+          `Locale ${locale} is not allowed by the form policy.`
+        );
+      }
+    });
+    for (const locale of policy.requiredLocales ?? []) {
+      if (!policy.allowedLocales.includes(locale)) {
+        issue(
+          issues,
+          "policy.requiredLocales",
+          "required_locale_not_allowed",
+          `Required locale ${locale} is not included in allowedLocales.`
+        );
+      }
+    }
+  }
+  if (policy.maxLocales !== void 0 && registeredLocales.length > policy.maxLocales) {
+    issue(issues, "supportedLocales", "max_locales_exceeded", `At most ${policy.maxLocales} locales are allowed.`);
+  }
   for (const locale of policy.requiredLocales ?? []) addRequiredTranslationIssues(schema, locale, issues);
   if (policy.maxSchemaBytes !== void 0) {
     try {

package/dist/index.d.cts

@@ -4,6 +4,8 @@ interface FormPolicy {
     readonly maxFields?: number;
     readonly maxOptionsPerField?: number;
     readonly requiredLocales?: readonly string[];
+    readonly allowedLocales?: readonly string[];
+    readonly maxLocales?: number;
     readonly maxTextLength?: number;
     readonly maxSchemaBytes?: number;
 }

package/dist/index.d.ts

@@ -4,6 +4,8 @@ interface FormPolicy {
     readonly maxFields?: number;
     readonly maxOptionsPerField?: number;
     readonly requiredLocales?: readonly string[];
+    readonly allowedLocales?: readonly string[];
+    readonly maxLocales?: number;
     readonly maxTextLength?: number;
     readonly maxSchemaBytes?: number;
 }

package/dist/index.js

@@ -506,6 +506,45 @@ function validatePolicy(schema, policy, issues) {
       }
     }
   }
+  const registeredLocales = [
+    .../* @__PURE__ */ new Set([
+      ...schema.defaultLocale === void 0 ? [] : [schema.defaultLocale],
+      ...schema.supportedLocales ?? []
+    ])
+  ];
+  if (policy.allowedLocales !== void 0) {
+    if (schema.defaultLocale !== void 0 && !policy.allowedLocales.includes(schema.defaultLocale)) {
+      issue(
+        issues,
+        "defaultLocale",
+        "disallowed_locale",
+        `Locale ${schema.defaultLocale} is not allowed by the form policy.`
+      );
+    }
+    schema.supportedLocales?.forEach((locale, index) => {
+      if (!policy.allowedLocales?.includes(locale)) {
+        issue(
+          issues,
+          `supportedLocales[${index}]`,
+          "disallowed_locale",
+          `Locale ${locale} is not allowed by the form policy.`
+        );
+      }
+    });
+    for (const locale of policy.requiredLocales ?? []) {
+      if (!policy.allowedLocales.includes(locale)) {
+        issue(
+          issues,
+          "policy.requiredLocales",
+          "required_locale_not_allowed",
+          `Required locale ${locale} is not included in allowedLocales.`
+        );
+      }
+    }
+  }
+  if (policy.maxLocales !== void 0 && registeredLocales.length > policy.maxLocales) {
+    issue(issues, "supportedLocales", "max_locales_exceeded", `At most ${policy.maxLocales} locales are allowed.`);
+  }
   for (const locale of policy.requiredLocales ?? []) addRequiredTranslationIssues(schema, locale, issues);
   if (policy.maxSchemaBytes !== void 0) {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/core",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "publishConfig": {
     "access": "public"
   },