@rainbow-oh/yee-c 0.8.20 → 0.9.0

package/dist/esm/Form/form-store.js

@@ -46,6 +46,7 @@ export var FormStore = /*#__PURE__*/function () {
     _defineProperty(this, "fieldEntities", []);
     _defineProperty(this, "fieldMap", new Map());
     _defineProperty(this, "validateMessages", new Map());
+    _defineProperty(this, "fieldStatuses", new Map());
     _defineProperty(this, "initialized", false);
     _defineProperty(this, "initialValues", {});
     // List key manager
@@ -109,6 +110,65 @@ export var FormStore = /*#__PURE__*/function () {
       }
       return null;
     });
+    _defineProperty(this, "getFieldStatus", function (name) {
+      var _this$validateMessage;
+      var normalizedName = stringifyPath(getNamePath(name));
+      var manualStatus = _this.fieldStatuses.get(normalizedName);
+      var validateMessage = (_this$validateMessage = _this.validateMessages.get(normalizedName)) === null || _this$validateMessage === void 0 ? void 0 : _this$validateMessage[0];
+
+      // Rule errors reflect the current value and auto-clear once validation
+      // passes, so they always take display precedence — a stale manually set
+      // status must never hide why submission failed.
+      if ((validateMessage === null || validateMessage === void 0 ? void 0 : validateMessage.status) === 'error') {
+        return {
+          status: 'error',
+          message: validateMessage.message
+        };
+      }
+      if (manualStatus) {
+        return _objectSpread({}, manualStatus);
+      }
+      if (validateMessage) {
+        return {
+          status: validateMessage.status,
+          message: validateMessage.message
+        };
+      }
+      return null;
+    });
+    _defineProperty(this, "setFieldStatus", function (name, status) {
+      var _this$fieldMap$get;
+      var normalizedName = stringifyPath(getNamePath(name));
+      if (!normalizedName) return;
+      if (status) {
+        _this.fieldStatuses.set(normalizedName, _objectSpread({}, status));
+      } else {
+        _this.fieldStatuses.delete(normalizedName);
+      }
+      (_this$fieldMap$get = _this.fieldMap.get(normalizedName)) === null || _this$fieldMap$get === void 0 || _this$fieldMap$get.onStoreChange();
+    });
+    // Delete entries whose key equals or nests under one of `names`
+    // (no names = delete all). Keeps rule messages and manual statuses in
+    // sync with the fields that reset/clear actually touched.
+    _defineProperty(this, "deleteRelatedEntries", function (entries, names) {
+      if (!names) {
+        entries.clear();
+        return;
+      }
+      var normalizedNames = names.map(function (name) {
+        return stringifyPath(getNamePath(name));
+      });
+      Array.from(entries.keys()).forEach(function (fieldName) {
+        if (normalizedNames.some(function (name) {
+          return isRelatedNamePath(fieldName, name);
+        })) {
+          entries.delete(fieldName);
+        }
+      });
+    });
+    _defineProperty(this, "clearFieldStatuses", function (names) {
+      _this.deleteRelatedEntries(_this.fieldStatuses, names);
+    });
     _defineProperty(this, "setFieldsValue", function (newStore) {
       var trigger = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'onChange';
       if (trigger === 'reset' || trigger === 'clear') {
@@ -189,7 +249,10 @@ export var FormStore = /*#__PURE__*/function () {
         });
       }
       (_this$callbacks4 = _this.callbacks) === null || _this$callbacks4 === void 0 || (_this$callbacks4$onRe = _this$callbacks4.onReset) === null || _this$callbacks4$onRe === void 0 || _this$callbacks4$onRe.call(_this$callbacks4);
-      _this.validateMessages.clear();
+      // A named reset only clears rule messages of the fields it touched;
+      // unrelated fields keep their (still valid) validation state.
+      _this.deleteRelatedEntries(_this.validateMessages, name);
+      _this.clearFieldStatuses(name);
       _this.groupEntities.forEach(function (entity) {
         return entity.reset();
       });
@@ -201,6 +264,7 @@ export var FormStore = /*#__PURE__*/function () {
         acc[name] = undefined;
         return acc;
       }, {});
+      _this.clearFieldStatuses(name);
       _this.setFieldsValue(clearStore, 'clear');
     });
     _defineProperty(this, "validateField", /*#__PURE__*/function () {
@@ -347,8 +411,8 @@ export var FormStore = /*#__PURE__*/function () {
         var changedKeys = Object.keys(newStore);
         var fieldNames = relatedFieldNames !== null && relatedFieldNames !== void 0 ? relatedFieldNames : _this.getRelatedFieldNames(changedKeys);
         fieldNames.forEach(function (fieldName) {
-          var _this$fieldMap$get;
-          (_this$fieldMap$get = _this.fieldMap.get(fieldName)) === null || _this$fieldMap$get === void 0 || _this$fieldMap$get.onStoreChange();
+          var _this$fieldMap$get2;
+          (_this$fieldMap$get2 = _this.fieldMap.get(fieldName)) === null || _this$fieldMap$get2 === void 0 || _this$fieldMap$get2.onStoreChange();
         });
         _this.notifyWatchers(changedKeys);
       } else {
@@ -577,7 +641,7 @@ export var FormStore = /*#__PURE__*/function () {
       };
     });
     _defineProperty(this, "submit", /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
-      var _this$callbacks5, onFinish, onFinishFailed, fieldErrors, groupErrors, allErrors;
+      var _this$callbacks5, onFinish, onFinishFailed, fieldErrors, groupErrors, statusErrors, allErrors;
       return _regeneratorRuntime().wrap(function _callee4$(_context4) {
         while (1) switch (_context4.prev = _context4.next) {
           case 0:
@@ -590,7 +654,23 @@ export var FormStore = /*#__PURE__*/function () {
             return _this.validateGroups(true);
           case 6:
             groupErrors = _context4.sent;
-            allErrors = [].concat(_toConsumableArray(fieldErrors), _toConsumableArray(groupErrors));
+            statusErrors = Array.from(_this.fieldStatuses.entries()).filter(function (_ref9) {
+              var _ref10 = _slicedToArray(_ref9, 2),
+                status = _ref10[1];
+              return status.status === 'error' && status.blocking === true;
+            }).map(function (_ref11) {
+              var _status$message;
+              var _ref12 = _slicedToArray(_ref11, 2),
+                name = _ref12[0],
+                status = _ref12[1];
+              return {
+                name: name,
+                message: (_status$message = status.message) !== null && _status$message !== void 0 ? _status$message : '',
+                value: _this.getFieldValue(name),
+                status: 'error'
+              };
+            });
+            allErrors = [].concat(_toConsumableArray(fieldErrors), _toConsumableArray(groupErrors), _toConsumableArray(statusErrors));
             if (allErrors.length === 0) {
               onFinish === null || onFinish === void 0 || onFinish(_this.getFieldsValue());
             } else {
@@ -598,7 +678,7 @@ export var FormStore = /*#__PURE__*/function () {
             }
             _this.refreshField();
             return _context4.abrupt("return", allErrors);
-          case 11:
+          case 12:
           case "end":
             return _context4.stop();
         }
@@ -647,6 +727,8 @@ export var FormStore = /*#__PURE__*/function () {
     value: function getForm() {
       return {
         getFieldValidate: this.getFieldValidate,
+        getFieldStatus: this.getFieldStatus,
+        setFieldStatus: this.setFieldStatus,
         getFieldsValue: this.getFieldsValue,
         getFieldValue: this.getFieldValue,
         setFieldsValue: this.setFieldsValue,

package/dist/esm/Form/index.d.ts

@@ -16,5 +16,5 @@ type FormInterface = typeof InternalForm & {
     List: typeof List;
 };
 declare const Form: FormInterface;
-export type { FieldGroupProps, FormInstance, FormListProps, FormProps, } from './interface';
+export type { FieldGroupProps, FieldStatus, FieldStatusData, FormInstance, FormListProps, FormProps, } from './interface';
 export default Form;

package/dist/esm/Form/interface.d.ts

@@ -96,6 +96,15 @@ export interface FormInstance<Values = any> {
      * Get field validation info
      */
     getFieldValidate: (name: Name) => ValidateMessage | null;
+    /**
+     * Get the displayed field status. Rule validation errors take display
+     * precedence; otherwise a manually set status overrides validation.
+     */
+    getFieldStatus: (name: NamePath) => FieldStatusData | null;
+    /**
+     * Set or clear a field's displayed status. Pass null to clear it.
+     */
+    setFieldStatus: (name: NamePath, status: FieldStatusData | null) => void;
     /**
      * Get field value
      */
@@ -225,11 +234,18 @@ export type Rule = {
      */
     validateTrigger?: 'onBlur' | 'onChange' | 'onSubmit' | 'reset' | Array<'onBlur' | 'onChange' | 'onSubmit'>;
 };
+export type FieldStatus = 'error' | 'success' | 'warning' | 'info';
+export type FieldStatusData = {
+    status: FieldStatus;
+    message?: string;
+    /** Whether an error status should prevent form submission. */
+    blocking?: boolean;
+};
 export type ValidateMessage = {
     name: NamePath | NamePath[] | undefined;
     message: string;
     value: unknown;
-    status: 'error' | 'success' | 'warning' | 'info';
+    status: FieldStatus;
 };
 export type FieldConfigurableTooltip = Omit<TooltipProps, 'children'> & {
     /**

package/dist/esm/Form/style/index.less

@@ -79,6 +79,18 @@
       &-error {
         color: var(--yee-error-color);
       }
+
+      &-warning {
+        color: var(--yee-warning-color);
+      }
+
+      &-success {
+        color: var(--yee-success-color);
+      }
+
+      &-info {
+        color: var(--yee-info-color);
+      }
     }
 
     // 表单校验态：在此重定义控件读取的 border / box-shadow 变量，
@@ -97,5 +109,19 @@
       --yee-input-focus-bs-color: var(--yee-warning-color-border);
       --yee-checkbox-border-color: var(--yee-warning-color);
     }
+
+    &&-success {
+      --yee-input-border-color: var(--yee-success-color);
+      --yee-input-hover-border-color: var(--yee-success-color-hover);
+      --yee-input-focus-bs-color: var(--yee-success-color-border);
+      --yee-checkbox-border-color: var(--yee-success-color);
+    }
+
+    &&-info {
+      --yee-input-border-color: var(--yee-info-color);
+      --yee-input-hover-border-color: var(--yee-info-color-hover);
+      --yee-input-focus-bs-color: var(--yee-info-color-border);
+      --yee-checkbox-border-color: var(--yee-info-color);
+    }
   }
 }

package/dist/esm/style/themes.css

@@ -1,7 +1,7 @@
 /*!
  * @rainbow-oh/yee-c CSS Variables
  * Auto-generated, do not edit manually
- * Generated on 2026-08-13T08:02:29.627Z
+ * Generated on 2026-08-17T03:37:29.587Z
  */
 
 /* ========== color.blue.css ========== */

package/dist/esm/style/variables.css

@@ -1,7 +1,7 @@
 /*!
  * @rainbow-oh/yee-c CSS Variables
  * Auto-generated, do not edit manually
- * Generated on 2026-08-13T08:02:29.627Z
+ * Generated on 2026-08-17T03:37:29.587Z
  */
 
 /* ========== color.css ========== */

package/dist/esm/version.d.ts

@@ -3,4 +3,4 @@ declare global {
         __yee_c_version__: string;
     }
 }
-export declare const version = "0.8.20";
+export declare const version = "0.9.0";

package/dist/esm/version.js

@@ -1,4 +1,4 @@
-export var version = "0.8.20";
+export var version = "0.9.0";
 if (typeof window !== 'undefined') {
   window.__yee_c_version__ = version;
 }