@dcupl/common 2.0.0-beta.6 → 2.0.0-beta.7

package/dist/esm/types/model.types.d.ts

@@ -326,8 +326,19 @@ export type ValueMappingConfig = {
 };
 export type ModelAttribute = Property | Reference;
 export type ModelQualityConfig = {
+    /**
+     * Master switch for quality checks on this model. Default: true.
+     * Checks only run when error tracking is also enabled globally
+     * (two-tier enablement).
+     */
     enabled?: boolean;
-    attributes?: AttributeQualityConfig;
+    /**
+     * Model-wide defaults for the attribute quality FLAGS
+     * (required / nullable / forceStrictDataType / validatorHandling),
+     * merged under each attribute's own `quality`.
+     * Concrete `validators` are per-attribute only and cannot be set here.
+     */
+    attributes?: Omit<AttributeQualityConfig, 'validators'>;
 };
 export type ValidatorErrorType = 'loose' | 'strict';
 export type ValidatorConfig = {
@@ -351,6 +362,18 @@ export type AttributeValidatorConfig = {
     unique?: ValidatorConfig;
     startsWith?: ValidatorConfig;
 };
+/**
+ * Quality rules for a single property or reference.
+ *
+ * Defaults: required: true, nullable: false, forceStrictDataType: false,
+ * validatorHandling: 'loose'.
+ *
+ * validatorHandling decides what happens when a validator fails:
+ * 'loose' (default) reports an InvalidValidator error and keeps the value;
+ * 'strict' reports AND drops the value from the loaded data.
+ * forceStrictDataType: true disables type coercion — wrong-typed raw
+ * values are reported as WrongDataType and dropped.
+ */
 export type AttributeQualityConfig = {
     required?: boolean;
     nullable?: boolean;