@form-engine-ts/core 4.1.0 → 4.2.0

package/README.md

@@ -41,13 +41,15 @@ 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 locale constraints. `allowedLocales` constrains the default and supported
+option, text, serialized-byte, allowed-type, locale, and per-field `fieldConstraints` rules. Rating bounds can be fixed
+or range-limited, text lengths can have a policy maximum, and required state can be fixed. `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.
 
 `collectSchemaLocales(schema)` scans registrations plus every form/page/field/option `translations` and
 `translationMetadata` key. Validation reports unregistered translation locales and applies `allowedLocales` and
-`maxLocales` to the complete collected set. `sanitizeSchema` purges unregistered locale content. Pass
+`maxLocales` to the complete collected set. `sanitizeSchema(schema, { policy })` also applies fixed field values and
+safe maximum-length corrections while purging unregistered locale content. Pass
 `{ policy: { allowedLocales, maxLocales } }` to `populateSchemaTranslations` to reject inadmissible targets before the
 translation adapter runs.
 

package/dist/index.cjs

@@ -156,6 +156,27 @@ function sanitizePageLocales(page, registeredLocales) {
   const translations = registeredEntries(page.translations, registeredLocales);
   return { ...base, ...translations === void 0 ? {} : { translations } };
 }
+function sanitizeFieldConstraints(field, policy) {
+  const constraint = policy?.fieldConstraints?.[field.type];
+  if (constraint === void 0) return field;
+  const required = constraint.fixedRequired ?? field.required;
+  if (field.type === "rating") {
+    const ratingConstraint = "fixedMin" in constraint || "fixedMax" in constraint ? constraint : void 0;
+    const min = ratingConstraint !== void 0 && "fixedMin" in ratingConstraint ? ratingConstraint.fixedMin : field.min;
+    const max = ratingConstraint !== void 0 && "fixedMax" in ratingConstraint ? ratingConstraint.fixedMax : field.max;
+    return {
+      ...field,
+      required,
+      ...min === void 0 ? {} : { min },
+      ...max === void 0 ? {} : { max }
+    };
+  }
+  if ((field.type === "text" || field.type === "textarea") && "maxMaxLength" in constraint) {
+    const maxLength = field.maxLength === void 0 || constraint.maxMaxLength === void 0 ? field.maxLength : Math.min(field.maxLength, constraint.maxMaxLength);
+    return { ...field, required, ...maxLength === void 0 ? {} : { maxLength } };
+  }
+  return { ...field, required };
+}
 function cyclicQuestionIds(fields) {
   const firstById = /* @__PURE__ */ new Map();
   for (const field of fields) {
@@ -240,7 +261,7 @@ function validateSchemaStructure(schema) {
   }
   return issues;
 }
-function sanitizeSchema(schema) {
+function sanitizeSchema(schema, options = {}) {
   const existingQuestionIds = new Set(schema.fields.map((field) => field.id));
   const registeredLocales = /* @__PURE__ */ new Set([
     ...schema.defaultLocale === void 0 ? [] : [schema.defaultLocale],
@@ -248,7 +269,7 @@ function sanitizeSchema(schema) {
   ]);
   const cyclic = cyclicQuestionIds(schema.fields);
   const sanitizedFields = schema.fields.map((sourceField) => {
-    const field = sanitizeFieldLocales(sourceField, registeredLocales);
+    const field = sanitizeFieldConstraints(sanitizeFieldLocales(sourceField, registeredLocales), options.policy);
     const sourceId = field.displayCondition?.questionId;
     if (sourceId === void 0 || existingQuestionIds.has(sourceId) && sourceId !== field.id && !cyclic.has(field.id)) {
       return field;
@@ -306,6 +327,17 @@ function isNonEmptyString(value) {
 function issue(issues, path, code, message) {
   issues.push({ path, code, message });
 }
+function fieldConstraintIssue(issues, field, fieldIndex, property, expected, message) {
+  issues.push({
+    path: `fields[${fieldIndex}].${property}`,
+    code: "field_constraint_violation",
+    type: "field_constraint_violation",
+    message,
+    fieldId: field.id,
+    property,
+    expected
+  });
+}
 function validateJsonValue(value, path, issues, ancestors = /* @__PURE__ */ new Set()) {
   if (value === null || typeof value === "string" || typeof value === "boolean") return;
   if (typeof value === "number") {
@@ -659,6 +691,93 @@ function validatePolicy(schema, policy, issues) {
         `At most ${policy.maxOptionsPerField} options are allowed.`
       );
     }
+    const constraint = policy.fieldConstraints?.[field.type];
+    if (constraint === void 0) return;
+    if (constraint.fixedRequired !== void 0 && field.required !== constraint.fixedRequired) {
+      fieldConstraintIssue(
+        issues,
+        field,
+        fieldIndex,
+        "required",
+        constraint.fixedRequired,
+        `Field required must be ${String(constraint.fixedRequired)} for field type ${field.type}.`
+      );
+    }
+    if (field.type === "rating") {
+      const ratingConstraint = "fixedMin" in constraint || "fixedMax" in constraint || "allowedMinRange" in constraint || "allowedMaxRange" in constraint ? constraint : void 0;
+      if (ratingConstraint?.fixedMin !== void 0 && field.min !== ratingConstraint.fixedMin) {
+        fieldConstraintIssue(
+          issues,
+          field,
+          fieldIndex,
+          "min",
+          ratingConstraint.fixedMin,
+          `Rating minimum must be ${ratingConstraint.fixedMin}.`
+        );
+      }
+      if (ratingConstraint !== void 0 && "fixedMax" in ratingConstraint && ratingConstraint.fixedMax !== void 0 && field.max !== ratingConstraint.fixedMax) {
+        fieldConstraintIssue(
+          issues,
+          field,
+          fieldIndex,
+          "max",
+          ratingConstraint.fixedMax,
+          `Rating maximum must be ${ratingConstraint.fixedMax}.`
+        );
+      }
+      if (ratingConstraint !== void 0 && "allowedMinRange" in ratingConstraint && ratingConstraint.allowedMinRange !== void 0 && typeof field.min === "number" && (field.min < ratingConstraint.allowedMinRange[0] || field.min > ratingConstraint.allowedMinRange[1])) {
+        fieldConstraintIssue(
+          issues,
+          field,
+          fieldIndex,
+          "min",
+          ratingConstraint.allowedMinRange,
+          `Rating minimum must be between ${ratingConstraint.allowedMinRange[0]} and ${ratingConstraint.allowedMinRange[1]}.`
+        );
+      }
+      if (ratingConstraint !== void 0 && "allowedMaxRange" in ratingConstraint && ratingConstraint.allowedMaxRange !== void 0 && typeof field.max === "number" && (field.max < ratingConstraint.allowedMaxRange[0] || field.max > ratingConstraint.allowedMaxRange[1])) {
+        fieldConstraintIssue(
+          issues,
+          field,
+          fieldIndex,
+          "max",
+          ratingConstraint.allowedMaxRange,
+          `Rating maximum must be between ${ratingConstraint.allowedMaxRange[0]} and ${ratingConstraint.allowedMaxRange[1]}.`
+        );
+      }
+    }
+    if ((field.type === "text" || field.type === "textarea") && "maxMaxLength" in constraint && constraint.maxMaxLength !== void 0) {
+      if (field.maxLength !== void 0 && field.maxLength > constraint.maxMaxLength) {
+        fieldConstraintIssue(
+          issues,
+          field,
+          fieldIndex,
+          "maxLength",
+          constraint.maxMaxLength,
+          `Maximum text length must be at most ${constraint.maxMaxLength}.`
+        );
+      }
+    }
+    if ((field.type === "select" || field.type === "radio" || field.type === "multi-select") && "minOptions" in constraint && constraint.minOptions !== void 0 && field.options.length < constraint.minOptions) {
+      fieldConstraintIssue(
+        issues,
+        field,
+        fieldIndex,
+        "options",
+        constraint.minOptions,
+        `At least ${constraint.minOptions} options are required.`
+      );
+    }
+    if ((field.type === "select" || field.type === "radio" || field.type === "multi-select") && "maxOptions" in constraint && constraint.maxOptions !== void 0 && field.options.length > constraint.maxOptions) {
+      fieldConstraintIssue(
+        issues,
+        field,
+        fieldIndex,
+        "options",
+        constraint.maxOptions,
+        `At most ${constraint.maxOptions} options are allowed.`
+      );
+    }
   });
   if (policy.maxTextLength !== void 0) {
     for (const entry of collectSchemaText(schema)) {

package/dist/index.d.cts

@@ -114,6 +114,28 @@ declare function createDeleteDraftTransitionPlan(state: FormVersionState, draftR
 declare function assertVersionMutable(status: FormVersionStatus): void;
 
 type FieldType = "text" | "textarea" | "number" | "rating" | "select" | "multi-select" | "checkbox" | "radio";
+type QuestionType = FieldType;
+interface BaseFieldConstraintRule {
+    readonly defaultRequired?: boolean;
+    readonly fixedRequired?: boolean;
+}
+interface RatingFieldConstraintRule extends BaseFieldConstraintRule {
+    readonly defaultMin?: number;
+    readonly defaultMax?: number;
+    readonly fixedMin?: number;
+    readonly fixedMax?: number;
+    readonly allowedMinRange?: readonly [number, number];
+    readonly allowedMaxRange?: readonly [number, number];
+}
+interface TextFieldConstraintRule extends BaseFieldConstraintRule {
+    readonly defaultMaxLength?: number;
+    readonly maxMaxLength?: number;
+}
+interface ChoiceFieldConstraintRule extends BaseFieldConstraintRule {
+    readonly minOptions?: number;
+    readonly maxOptions?: number;
+}
+type FieldConstraintRule = RatingFieldConstraintRule | TextFieldConstraintRule | ChoiceFieldConstraintRule | BaseFieldConstraintRule;
 interface FormPolicy {
     readonly allowedFieldTypes?: readonly FieldType[];
     readonly maxFields?: number;
@@ -123,6 +145,8 @@ interface FormPolicy {
     readonly maxLocales?: number;
     readonly maxTextLength?: number;
     readonly maxSchemaBytes?: number;
+    /** Per-question-type defaults and immutable or bounded field constraints. */
+    readonly fieldConstraints?: Partial<Record<QuestionType, FieldConstraintRule>>;
 }
 type ConditionOperator = "equals" | "not_equals" | "contains" | "not_empty";
 type ConditionValue = string | number | boolean;
@@ -223,6 +247,12 @@ interface SchemaIssue {
     readonly path: string;
     readonly code: string;
     readonly message: string;
+    /** Compatibility discriminator for structured policy issues. */
+    readonly type?: string;
+    /** Present for policy issues that identify a field property and its expected value. */
+    readonly fieldId?: string;
+    readonly property?: string;
+    readonly expected?: boolean | number | readonly [number, number];
 }
 type SchemaValidationResult = {
     readonly valid: true;
@@ -417,7 +447,6 @@ interface FormAnalytics {
     readonly questions: readonly QuestionAggregate[];
 }
 type Question = FormField;
-type QuestionType = FieldType;
 type ChoiceOption = FieldOption;
 /** Translation keys reserved for the form builder UI. */
 type BuilderTranslationKey = `builder.${string}`;
@@ -577,6 +606,9 @@ interface CollectedLocales {
 /** Collects locale registrations and every locale key used by translations or translation metadata. */
 declare function collectSchemaLocales(schema: FormSchema): CollectedLocales;
 
+interface SanitizeSchemaOptions {
+    readonly policy?: FormPolicy;
+}
 type SchemaStructureIssueType = "dangling_condition_reference" | "duplicate_question_id" | "duplicate_choice_id" | "self_condition_reference" | "cyclic_condition_reference";
 interface SchemaStructureIssue {
     readonly type: SchemaStructureIssueType;
@@ -585,7 +617,7 @@ interface SchemaStructureIssue {
     readonly message: string;
 }
 declare function validateSchemaStructure(schema: FormSchema): SchemaStructureIssue[];
-declare function sanitizeSchema(schema: FormSchema): FormSchema;
+declare function sanitizeSchema(schema: FormSchema, options?: SanitizeSchemaOptions): FormSchema;
 
 interface ValidateFormSchemaOptions {
     readonly policy?: FormPolicy;
@@ -639,4 +671,4 @@ declare function calculatePageVisibility(schema: FormSchema, currentAnswers: Rea
 declare function calculateFieldVisibility(schema: FormSchema, currentAnswers: Readonly<Record<string, unknown>>): Readonly<Record<string, boolean>>;
 declare function selectVisibleAnswers(schema: FormSchema, currentAnswers: FormValues): FormValues;
 
-export { type AccumulatorReport, type AccumulatorResponse, type AccumulatorSkipReason, type AnswerValidationResult, type AsyncTranslationAdapter, type BaseField, type BuilderTranslationKey, type CheckboxField, type CheckboxQuestionAggregate, type ChoiceDistributionEntry, type ChoiceOption, type ChoiceQuestionAggregate, type CloneVersionOptions, type CollectedLocales, type ConditionOperator, type ConditionValue, type CreateSubmissionOptions, type CrossTabulationResult, type CsvColumnContext, type CsvColumnDef, type CsvExportOptions, DEFAULT_FIELD_TYPE_DEFINITIONS, type DeleteDraftOptions, type DisplayCondition, type ExtensibleNode, type FieldOption, type FieldType, type FieldTypeDefinition, type FormAnalytics, type FormEvent, type FormEventType, type FormField, type FormPage, type FormPolicy, type FormResponse, type FormSchema, type FormStorageAdapter, type FormSubmission, type FormValue, type FormValues, type FormVersionRecord, type FormVersionState, type FormVersionStatus, type JsonValue, type LocalizedText, type MultiSelectField, type NodeWritableStream, type NumberField, type NumberQuestionAggregate, type NumericSummary, type OptionAggregate, type PagedSubmissionStorageAdapter, type PaginationIteratorOptions, type PopulateTranslationOptions, type PublishDraftOptions, type PublishDraftResult, type Question, type QuestionAggregate, type QuestionType, type RatingField, type ResponseAccumulator, type ResponseAccumulatorOptions, type Result, type SchemaIssue, type SchemaStructureIssue, type SchemaStructureIssueType, type SchemaTranslations, type SchemaValidationResult, type SelectField, type StorageAdapter, type StorageCommitError, type StreamCsvOptions, type SubmissionCursorValue, type SubmissionFilter, type SubmissionPage, type SubmissionPageQueryOptions, type SubmissionQueryOptions, type TextAnswerCursorValue, type TextAnswerItem, type TextAnswerPage, type TextAnswerPageQueryOptions, type TextField, type TextQuestionAggregate, type TranslationAdapter, type TranslationReport, type TranslationSlot, type ValidateFormSchemaOptions, type ValidationCode, type ValidationError, type ValidationIssue, type VersionTransitionError, type VersionTransitionEvent, type VersionTransitionPlan, type VersionedFormStorageAdapter, type WebhookConfig, type WebhookDispatchResult, aggregateResponses, assertValidFormSchema, assertVersionMutable, calculateChoiceDistribution, calculateCrossTabulation, calculateFieldVisibility, calculateNumericSummary, calculatePageVisibility, cloneVersionToDraft, collectSchemaLocales, createCloneTransitionPlan, createDeleteDraftTransitionPlan, createPublishTransitionPlan, createResponseAccumulator, createSubmission, decodeSubmissionCursor, decodeTextAnswerCursor, deleteDraft, dispatchWebhook, encodeSubmissionCursor, encodeTextAnswerCursor, escapeCsvCell, exportResponsesToCsv, exportResponsesToCsvStream, isDisplayConditionSatisfied, isQuestionVisible, iterateSubmissionPages, jsonValuesEqual, matchesSubmissionFilter, matchesSubmissionPageFilters, normalizeSubmissionPageSize, pipeResponsesToCsvStream, populateSchemaTranslations, publishDraft, resolveFormTranslation, resolveLocalizedSchema, sanitizeSchema, selectVisibleAnswers, transformFieldType, validateAnswers, validateFormSchema, validatePageAnswers, validateSchemaStructure };
+export { type AccumulatorReport, type AccumulatorResponse, type AccumulatorSkipReason, type AnswerValidationResult, type AsyncTranslationAdapter, type BaseField, type BaseFieldConstraintRule, type BuilderTranslationKey, type CheckboxField, type CheckboxQuestionAggregate, type ChoiceDistributionEntry, type ChoiceFieldConstraintRule, type ChoiceOption, type ChoiceQuestionAggregate, type CloneVersionOptions, type CollectedLocales, type ConditionOperator, type ConditionValue, type CreateSubmissionOptions, type CrossTabulationResult, type CsvColumnContext, type CsvColumnDef, type CsvExportOptions, DEFAULT_FIELD_TYPE_DEFINITIONS, type DeleteDraftOptions, type DisplayCondition, type ExtensibleNode, type FieldConstraintRule, type FieldOption, type FieldType, type FieldTypeDefinition, type FormAnalytics, type FormEvent, type FormEventType, type FormField, type FormPage, type FormPolicy, type FormResponse, type FormSchema, type FormStorageAdapter, type FormSubmission, type FormValue, type FormValues, type FormVersionRecord, type FormVersionState, type FormVersionStatus, type JsonValue, type LocalizedText, type MultiSelectField, type NodeWritableStream, type NumberField, type NumberQuestionAggregate, type NumericSummary, type OptionAggregate, type PagedSubmissionStorageAdapter, type PaginationIteratorOptions, type PopulateTranslationOptions, type PublishDraftOptions, type PublishDraftResult, type Question, type QuestionAggregate, type QuestionType, type RatingField, type RatingFieldConstraintRule, type ResponseAccumulator, type ResponseAccumulatorOptions, type Result, type SanitizeSchemaOptions, type SchemaIssue, type SchemaStructureIssue, type SchemaStructureIssueType, type SchemaTranslations, type SchemaValidationResult, type SelectField, type StorageAdapter, type StorageCommitError, type StreamCsvOptions, type SubmissionCursorValue, type SubmissionFilter, type SubmissionPage, type SubmissionPageQueryOptions, type SubmissionQueryOptions, type TextAnswerCursorValue, type TextAnswerItem, type TextAnswerPage, type TextAnswerPageQueryOptions, type TextField, type TextFieldConstraintRule, type TextQuestionAggregate, type TranslationAdapter, type TranslationReport, type TranslationSlot, type ValidateFormSchemaOptions, type ValidationCode, type ValidationError, type ValidationIssue, type VersionTransitionError, type VersionTransitionEvent, type VersionTransitionPlan, type VersionedFormStorageAdapter, type WebhookConfig, type WebhookDispatchResult, aggregateResponses, assertValidFormSchema, assertVersionMutable, calculateChoiceDistribution, calculateCrossTabulation, calculateFieldVisibility, calculateNumericSummary, calculatePageVisibility, cloneVersionToDraft, collectSchemaLocales, createCloneTransitionPlan, createDeleteDraftTransitionPlan, createPublishTransitionPlan, createResponseAccumulator, createSubmission, decodeSubmissionCursor, decodeTextAnswerCursor, deleteDraft, dispatchWebhook, encodeSubmissionCursor, encodeTextAnswerCursor, escapeCsvCell, exportResponsesToCsv, exportResponsesToCsvStream, isDisplayConditionSatisfied, isQuestionVisible, iterateSubmissionPages, jsonValuesEqual, matchesSubmissionFilter, matchesSubmissionPageFilters, normalizeSubmissionPageSize, pipeResponsesToCsvStream, populateSchemaTranslations, publishDraft, resolveFormTranslation, resolveLocalizedSchema, sanitizeSchema, selectVisibleAnswers, transformFieldType, validateAnswers, validateFormSchema, validatePageAnswers, validateSchemaStructure };

package/dist/index.d.ts

@@ -114,6 +114,28 @@ declare function createDeleteDraftTransitionPlan(state: FormVersionState, draftR
 declare function assertVersionMutable(status: FormVersionStatus): void;
 
 type FieldType = "text" | "textarea" | "number" | "rating" | "select" | "multi-select" | "checkbox" | "radio";
+type QuestionType = FieldType;
+interface BaseFieldConstraintRule {
+    readonly defaultRequired?: boolean;
+    readonly fixedRequired?: boolean;
+}
+interface RatingFieldConstraintRule extends BaseFieldConstraintRule {
+    readonly defaultMin?: number;
+    readonly defaultMax?: number;
+    readonly fixedMin?: number;
+    readonly fixedMax?: number;
+    readonly allowedMinRange?: readonly [number, number];
+    readonly allowedMaxRange?: readonly [number, number];
+}
+interface TextFieldConstraintRule extends BaseFieldConstraintRule {
+    readonly defaultMaxLength?: number;
+    readonly maxMaxLength?: number;
+}
+interface ChoiceFieldConstraintRule extends BaseFieldConstraintRule {
+    readonly minOptions?: number;
+    readonly maxOptions?: number;
+}
+type FieldConstraintRule = RatingFieldConstraintRule | TextFieldConstraintRule | ChoiceFieldConstraintRule | BaseFieldConstraintRule;
 interface FormPolicy {
     readonly allowedFieldTypes?: readonly FieldType[];
     readonly maxFields?: number;
@@ -123,6 +145,8 @@ interface FormPolicy {
     readonly maxLocales?: number;
     readonly maxTextLength?: number;
     readonly maxSchemaBytes?: number;
+    /** Per-question-type defaults and immutable or bounded field constraints. */
+    readonly fieldConstraints?: Partial<Record<QuestionType, FieldConstraintRule>>;
 }
 type ConditionOperator = "equals" | "not_equals" | "contains" | "not_empty";
 type ConditionValue = string | number | boolean;
@@ -223,6 +247,12 @@ interface SchemaIssue {
     readonly path: string;
     readonly code: string;
     readonly message: string;
+    /** Compatibility discriminator for structured policy issues. */
+    readonly type?: string;
+    /** Present for policy issues that identify a field property and its expected value. */
+    readonly fieldId?: string;
+    readonly property?: string;
+    readonly expected?: boolean | number | readonly [number, number];
 }
 type SchemaValidationResult = {
     readonly valid: true;
@@ -417,7 +447,6 @@ interface FormAnalytics {
     readonly questions: readonly QuestionAggregate[];
 }
 type Question = FormField;
-type QuestionType = FieldType;
 type ChoiceOption = FieldOption;
 /** Translation keys reserved for the form builder UI. */
 type BuilderTranslationKey = `builder.${string}`;
@@ -577,6 +606,9 @@ interface CollectedLocales {
 /** Collects locale registrations and every locale key used by translations or translation metadata. */
 declare function collectSchemaLocales(schema: FormSchema): CollectedLocales;
 
+interface SanitizeSchemaOptions {
+    readonly policy?: FormPolicy;
+}
 type SchemaStructureIssueType = "dangling_condition_reference" | "duplicate_question_id" | "duplicate_choice_id" | "self_condition_reference" | "cyclic_condition_reference";
 interface SchemaStructureIssue {
     readonly type: SchemaStructureIssueType;
@@ -585,7 +617,7 @@ interface SchemaStructureIssue {
     readonly message: string;
 }
 declare function validateSchemaStructure(schema: FormSchema): SchemaStructureIssue[];
-declare function sanitizeSchema(schema: FormSchema): FormSchema;
+declare function sanitizeSchema(schema: FormSchema, options?: SanitizeSchemaOptions): FormSchema;
 
 interface ValidateFormSchemaOptions {
     readonly policy?: FormPolicy;
@@ -639,4 +671,4 @@ declare function calculatePageVisibility(schema: FormSchema, currentAnswers: Rea
 declare function calculateFieldVisibility(schema: FormSchema, currentAnswers: Readonly<Record<string, unknown>>): Readonly<Record<string, boolean>>;
 declare function selectVisibleAnswers(schema: FormSchema, currentAnswers: FormValues): FormValues;
 
-export { type AccumulatorReport, type AccumulatorResponse, type AccumulatorSkipReason, type AnswerValidationResult, type AsyncTranslationAdapter, type BaseField, type BuilderTranslationKey, type CheckboxField, type CheckboxQuestionAggregate, type ChoiceDistributionEntry, type ChoiceOption, type ChoiceQuestionAggregate, type CloneVersionOptions, type CollectedLocales, type ConditionOperator, type ConditionValue, type CreateSubmissionOptions, type CrossTabulationResult, type CsvColumnContext, type CsvColumnDef, type CsvExportOptions, DEFAULT_FIELD_TYPE_DEFINITIONS, type DeleteDraftOptions, type DisplayCondition, type ExtensibleNode, type FieldOption, type FieldType, type FieldTypeDefinition, type FormAnalytics, type FormEvent, type FormEventType, type FormField, type FormPage, type FormPolicy, type FormResponse, type FormSchema, type FormStorageAdapter, type FormSubmission, type FormValue, type FormValues, type FormVersionRecord, type FormVersionState, type FormVersionStatus, type JsonValue, type LocalizedText, type MultiSelectField, type NodeWritableStream, type NumberField, type NumberQuestionAggregate, type NumericSummary, type OptionAggregate, type PagedSubmissionStorageAdapter, type PaginationIteratorOptions, type PopulateTranslationOptions, type PublishDraftOptions, type PublishDraftResult, type Question, type QuestionAggregate, type QuestionType, type RatingField, type ResponseAccumulator, type ResponseAccumulatorOptions, type Result, type SchemaIssue, type SchemaStructureIssue, type SchemaStructureIssueType, type SchemaTranslations, type SchemaValidationResult, type SelectField, type StorageAdapter, type StorageCommitError, type StreamCsvOptions, type SubmissionCursorValue, type SubmissionFilter, type SubmissionPage, type SubmissionPageQueryOptions, type SubmissionQueryOptions, type TextAnswerCursorValue, type TextAnswerItem, type TextAnswerPage, type TextAnswerPageQueryOptions, type TextField, type TextQuestionAggregate, type TranslationAdapter, type TranslationReport, type TranslationSlot, type ValidateFormSchemaOptions, type ValidationCode, type ValidationError, type ValidationIssue, type VersionTransitionError, type VersionTransitionEvent, type VersionTransitionPlan, type VersionedFormStorageAdapter, type WebhookConfig, type WebhookDispatchResult, aggregateResponses, assertValidFormSchema, assertVersionMutable, calculateChoiceDistribution, calculateCrossTabulation, calculateFieldVisibility, calculateNumericSummary, calculatePageVisibility, cloneVersionToDraft, collectSchemaLocales, createCloneTransitionPlan, createDeleteDraftTransitionPlan, createPublishTransitionPlan, createResponseAccumulator, createSubmission, decodeSubmissionCursor, decodeTextAnswerCursor, deleteDraft, dispatchWebhook, encodeSubmissionCursor, encodeTextAnswerCursor, escapeCsvCell, exportResponsesToCsv, exportResponsesToCsvStream, isDisplayConditionSatisfied, isQuestionVisible, iterateSubmissionPages, jsonValuesEqual, matchesSubmissionFilter, matchesSubmissionPageFilters, normalizeSubmissionPageSize, pipeResponsesToCsvStream, populateSchemaTranslations, publishDraft, resolveFormTranslation, resolveLocalizedSchema, sanitizeSchema, selectVisibleAnswers, transformFieldType, validateAnswers, validateFormSchema, validatePageAnswers, validateSchemaStructure };
+export { type AccumulatorReport, type AccumulatorResponse, type AccumulatorSkipReason, type AnswerValidationResult, type AsyncTranslationAdapter, type BaseField, type BaseFieldConstraintRule, type BuilderTranslationKey, type CheckboxField, type CheckboxQuestionAggregate, type ChoiceDistributionEntry, type ChoiceFieldConstraintRule, type ChoiceOption, type ChoiceQuestionAggregate, type CloneVersionOptions, type CollectedLocales, type ConditionOperator, type ConditionValue, type CreateSubmissionOptions, type CrossTabulationResult, type CsvColumnContext, type CsvColumnDef, type CsvExportOptions, DEFAULT_FIELD_TYPE_DEFINITIONS, type DeleteDraftOptions, type DisplayCondition, type ExtensibleNode, type FieldConstraintRule, type FieldOption, type FieldType, type FieldTypeDefinition, type FormAnalytics, type FormEvent, type FormEventType, type FormField, type FormPage, type FormPolicy, type FormResponse, type FormSchema, type FormStorageAdapter, type FormSubmission, type FormValue, type FormValues, type FormVersionRecord, type FormVersionState, type FormVersionStatus, type JsonValue, type LocalizedText, type MultiSelectField, type NodeWritableStream, type NumberField, type NumberQuestionAggregate, type NumericSummary, type OptionAggregate, type PagedSubmissionStorageAdapter, type PaginationIteratorOptions, type PopulateTranslationOptions, type PublishDraftOptions, type PublishDraftResult, type Question, type QuestionAggregate, type QuestionType, type RatingField, type RatingFieldConstraintRule, type ResponseAccumulator, type ResponseAccumulatorOptions, type Result, type SanitizeSchemaOptions, type SchemaIssue, type SchemaStructureIssue, type SchemaStructureIssueType, type SchemaTranslations, type SchemaValidationResult, type SelectField, type StorageAdapter, type StorageCommitError, type StreamCsvOptions, type SubmissionCursorValue, type SubmissionFilter, type SubmissionPage, type SubmissionPageQueryOptions, type SubmissionQueryOptions, type TextAnswerCursorValue, type TextAnswerItem, type TextAnswerPage, type TextAnswerPageQueryOptions, type TextField, type TextFieldConstraintRule, type TextQuestionAggregate, type TranslationAdapter, type TranslationReport, type TranslationSlot, type ValidateFormSchemaOptions, type ValidationCode, type ValidationError, type ValidationIssue, type VersionTransitionError, type VersionTransitionEvent, type VersionTransitionPlan, type VersionedFormStorageAdapter, type WebhookConfig, type WebhookDispatchResult, aggregateResponses, assertValidFormSchema, assertVersionMutable, calculateChoiceDistribution, calculateCrossTabulation, calculateFieldVisibility, calculateNumericSummary, calculatePageVisibility, cloneVersionToDraft, collectSchemaLocales, createCloneTransitionPlan, createDeleteDraftTransitionPlan, createPublishTransitionPlan, createResponseAccumulator, createSubmission, decodeSubmissionCursor, decodeTextAnswerCursor, deleteDraft, dispatchWebhook, encodeSubmissionCursor, encodeTextAnswerCursor, escapeCsvCell, exportResponsesToCsv, exportResponsesToCsvStream, isDisplayConditionSatisfied, isQuestionVisible, iterateSubmissionPages, jsonValuesEqual, matchesSubmissionFilter, matchesSubmissionPageFilters, normalizeSubmissionPageSize, pipeResponsesToCsvStream, populateSchemaTranslations, publishDraft, resolveFormTranslation, resolveLocalizedSchema, sanitizeSchema, selectVisibleAnswers, transformFieldType, validateAnswers, validateFormSchema, validatePageAnswers, validateSchemaStructure };

package/dist/index.js

@@ -87,6 +87,27 @@ function sanitizePageLocales(page, registeredLocales) {
   const translations = registeredEntries(page.translations, registeredLocales);
   return { ...base, ...translations === void 0 ? {} : { translations } };
 }
+function sanitizeFieldConstraints(field, policy) {
+  const constraint = policy?.fieldConstraints?.[field.type];
+  if (constraint === void 0) return field;
+  const required = constraint.fixedRequired ?? field.required;
+  if (field.type === "rating") {
+    const ratingConstraint = "fixedMin" in constraint || "fixedMax" in constraint ? constraint : void 0;
+    const min = ratingConstraint !== void 0 && "fixedMin" in ratingConstraint ? ratingConstraint.fixedMin : field.min;
+    const max = ratingConstraint !== void 0 && "fixedMax" in ratingConstraint ? ratingConstraint.fixedMax : field.max;
+    return {
+      ...field,
+      required,
+      ...min === void 0 ? {} : { min },
+      ...max === void 0 ? {} : { max }
+    };
+  }
+  if ((field.type === "text" || field.type === "textarea") && "maxMaxLength" in constraint) {
+    const maxLength = field.maxLength === void 0 || constraint.maxMaxLength === void 0 ? field.maxLength : Math.min(field.maxLength, constraint.maxMaxLength);
+    return { ...field, required, ...maxLength === void 0 ? {} : { maxLength } };
+  }
+  return { ...field, required };
+}
 function cyclicQuestionIds(fields) {
   const firstById = /* @__PURE__ */ new Map();
   for (const field of fields) {
@@ -171,7 +192,7 @@ function validateSchemaStructure(schema) {
   }
   return issues;
 }
-function sanitizeSchema(schema) {
+function sanitizeSchema(schema, options = {}) {
   const existingQuestionIds = new Set(schema.fields.map((field) => field.id));
   const registeredLocales = /* @__PURE__ */ new Set([
     ...schema.defaultLocale === void 0 ? [] : [schema.defaultLocale],
@@ -179,7 +200,7 @@ function sanitizeSchema(schema) {
   ]);
   const cyclic = cyclicQuestionIds(schema.fields);
   const sanitizedFields = schema.fields.map((sourceField) => {
-    const field = sanitizeFieldLocales(sourceField, registeredLocales);
+    const field = sanitizeFieldConstraints(sanitizeFieldLocales(sourceField, registeredLocales), options.policy);
     const sourceId = field.displayCondition?.questionId;
     if (sourceId === void 0 || existingQuestionIds.has(sourceId) && sourceId !== field.id && !cyclic.has(field.id)) {
       return field;
@@ -237,6 +258,17 @@ function isNonEmptyString(value) {
 function issue(issues, path, code, message) {
   issues.push({ path, code, message });
 }
+function fieldConstraintIssue(issues, field, fieldIndex, property, expected, message) {
+  issues.push({
+    path: `fields[${fieldIndex}].${property}`,
+    code: "field_constraint_violation",
+    type: "field_constraint_violation",
+    message,
+    fieldId: field.id,
+    property,
+    expected
+  });
+}
 function validateJsonValue(value, path, issues, ancestors = /* @__PURE__ */ new Set()) {
   if (value === null || typeof value === "string" || typeof value === "boolean") return;
   if (typeof value === "number") {
@@ -590,6 +622,93 @@ function validatePolicy(schema, policy, issues) {
         `At most ${policy.maxOptionsPerField} options are allowed.`
       );
     }
+    const constraint = policy.fieldConstraints?.[field.type];
+    if (constraint === void 0) return;
+    if (constraint.fixedRequired !== void 0 && field.required !== constraint.fixedRequired) {
+      fieldConstraintIssue(
+        issues,
+        field,
+        fieldIndex,
+        "required",
+        constraint.fixedRequired,
+        `Field required must be ${String(constraint.fixedRequired)} for field type ${field.type}.`
+      );
+    }
+    if (field.type === "rating") {
+      const ratingConstraint = "fixedMin" in constraint || "fixedMax" in constraint || "allowedMinRange" in constraint || "allowedMaxRange" in constraint ? constraint : void 0;
+      if (ratingConstraint?.fixedMin !== void 0 && field.min !== ratingConstraint.fixedMin) {
+        fieldConstraintIssue(
+          issues,
+          field,
+          fieldIndex,
+          "min",
+          ratingConstraint.fixedMin,
+          `Rating minimum must be ${ratingConstraint.fixedMin}.`
+        );
+      }
+      if (ratingConstraint !== void 0 && "fixedMax" in ratingConstraint && ratingConstraint.fixedMax !== void 0 && field.max !== ratingConstraint.fixedMax) {
+        fieldConstraintIssue(
+          issues,
+          field,
+          fieldIndex,
+          "max",
+          ratingConstraint.fixedMax,
+          `Rating maximum must be ${ratingConstraint.fixedMax}.`
+        );
+      }
+      if (ratingConstraint !== void 0 && "allowedMinRange" in ratingConstraint && ratingConstraint.allowedMinRange !== void 0 && typeof field.min === "number" && (field.min < ratingConstraint.allowedMinRange[0] || field.min > ratingConstraint.allowedMinRange[1])) {
+        fieldConstraintIssue(
+          issues,
+          field,
+          fieldIndex,
+          "min",
+          ratingConstraint.allowedMinRange,
+          `Rating minimum must be between ${ratingConstraint.allowedMinRange[0]} and ${ratingConstraint.allowedMinRange[1]}.`
+        );
+      }
+      if (ratingConstraint !== void 0 && "allowedMaxRange" in ratingConstraint && ratingConstraint.allowedMaxRange !== void 0 && typeof field.max === "number" && (field.max < ratingConstraint.allowedMaxRange[0] || field.max > ratingConstraint.allowedMaxRange[1])) {
+        fieldConstraintIssue(
+          issues,
+          field,
+          fieldIndex,
+          "max",
+          ratingConstraint.allowedMaxRange,
+          `Rating maximum must be between ${ratingConstraint.allowedMaxRange[0]} and ${ratingConstraint.allowedMaxRange[1]}.`
+        );
+      }
+    }
+    if ((field.type === "text" || field.type === "textarea") && "maxMaxLength" in constraint && constraint.maxMaxLength !== void 0) {
+      if (field.maxLength !== void 0 && field.maxLength > constraint.maxMaxLength) {
+        fieldConstraintIssue(
+          issues,
+          field,
+          fieldIndex,
+          "maxLength",
+          constraint.maxMaxLength,
+          `Maximum text length must be at most ${constraint.maxMaxLength}.`
+        );
+      }
+    }
+    if ((field.type === "select" || field.type === "radio" || field.type === "multi-select") && "minOptions" in constraint && constraint.minOptions !== void 0 && field.options.length < constraint.minOptions) {
+      fieldConstraintIssue(
+        issues,
+        field,
+        fieldIndex,
+        "options",
+        constraint.minOptions,
+        `At least ${constraint.minOptions} options are required.`
+      );
+    }
+    if ((field.type === "select" || field.type === "radio" || field.type === "multi-select") && "maxOptions" in constraint && constraint.maxOptions !== void 0 && field.options.length > constraint.maxOptions) {
+      fieldConstraintIssue(
+        issues,
+        field,
+        fieldIndex,
+        "options",
+        constraint.maxOptions,
+        `At most ${constraint.maxOptions} options are allowed.`
+      );
+    }
   });
   if (policy.maxTextLength !== void 0) {
     for (const entry of collectSchemaText(schema)) {

package/package.json

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