@rainbow-oh/yee-c 0.13.0 → 0.14.0

package/dist/cjs/Field/demo/standalone.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const _default: () => React.JSX.Element;
+export default _default;

package/dist/cjs/Field/demo/standalone.js

@@ -0,0 +1,56 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/Field/demo/standalone.tsx
+var standalone_exports = {};
+__export(standalone_exports, {
+  default: () => standalone_default
+});
+module.exports = __toCommonJS(standalone_exports);
+var import_yee_c = require("../..");
+var import_react = __toESM(require("react"));
+var standalone_default = () => {
+  const [name, setName] = (0, import_react.useState)("");
+  const [remark, setRemark] = (0, import_react.useState)("");
+  return /* @__PURE__ */ import_react.default.createElement("div", { style: { maxWidth: 400 } }, /* @__PURE__ */ import_react.default.createElement(import_yee_c.Field, { label: "Name", required: true }, /* @__PURE__ */ import_react.default.createElement(
+    import_yee_c.Input,
+    {
+      value: name,
+      onChange: (v) => setName(v),
+      placeholder: "Standalone controlled Input"
+    }
+  )), /* @__PURE__ */ import_react.default.createElement(import_yee_c.Field, { label: "Remark" }, /* @__PURE__ */ import_react.default.createElement(
+    import_yee_c.TextArea,
+    {
+      value: remark,
+      onChange: (v) => setRemark(v),
+      placeholder: "Standalone controlled TextArea",
+      rows: 3
+    }
+  )), /* @__PURE__ */ import_react.default.createElement(import_yee_c.Field, null, /* @__PURE__ */ import_react.default.createElement(import_yee_c.Input, { placeholder: "Field without label" })));
+};

package/dist/cjs/Field/field.js

@@ -55,7 +55,7 @@ var Field = (props) => {
     disabled
   } = props;
   const [, forceUpdate] = (0, import_react2.useReducer)((x) => x + 1, 0);
-  const { form } = (0, import_useVirtualField.default)(formName, name, {
+  const { form } = (0, import_useVirtualField.default)(formName != null ? formName : "", name != null ? name : "", {
     props,
     onStoreChange: forceUpdate
   });
@@ -71,11 +71,20 @@ var Field = (props) => {
     return Array.isArray(rules) && rules.some((rule) => rule.required) || required;
   };
   const getControlled = (children2) => {
-    const mergedDisabled = disabled || children2.props.disabled;
+    const childProps = children2.props;
+    if (!form || name === void 0) {
+      if (disabled === void 0)
+        return children2;
+      return import_react2.default.cloneElement(children2, {
+        disabled: disabled || childProps.disabled
+      });
+    }
+    const mergedDisabled = disabled || childProps.disabled;
+    const fieldName = name;
     const attr = {
-      value: getFieldValue == null ? void 0 : getFieldValue(name),
+      value: getFieldValue == null ? void 0 : getFieldValue(fieldName),
       name: formName,
-      id: name,
+      id: fieldName,
       disabled: mergedDisabled,
       onChange: (value, ...rest) => {
         var _a, _b, _c;
@@ -84,21 +93,21 @@ var Field = (props) => {
         const fieldsValue = getFieldsValue == null ? void 0 : getFieldsValue();
         const feedback = (_a = callbacks == null ? void 0 : callbacks.onValuesBeforeChange) == null ? void 0 : _a.call(
           callbacks,
-          { [name]: _value },
+          { [fieldName]: _value },
           fieldsValue
         );
         if (feedback !== void 0) {
           _value = feedback;
         }
-        setFieldsValue == null ? void 0 : setFieldsValue({ [name]: _value }, "onChange");
+        setFieldsValue == null ? void 0 : setFieldsValue({ [fieldName]: _value }, "onChange");
         if ((_b = children2.props) == null ? void 0 : _b.onChange) {
           children2.props.onChange(_value, ...rest);
         }
-        (_c = callbacks == null ? void 0 : callbacks["onValuesChange"]) == null ? void 0 : _c.call(callbacks, { [name]: _value }, fieldsValue);
+        (_c = callbacks == null ? void 0 : callbacks["onValuesChange"]) == null ? void 0 : _c.call(callbacks, { [fieldName]: _value }, fieldsValue);
         forceUpdate();
       },
       onBlur: (event) => {
-        void (validateField == null ? void 0 : validateField(name, "onBlur"));
+        void (validateField == null ? void 0 : validateField(fieldName, "onBlur"));
         if (children2.props.onBlur) {
           children2.props.onBlur(event);
         }
@@ -106,7 +115,7 @@ var Field = (props) => {
     };
     return import_react2.default.cloneElement(children2, attr);
   };
-  const validate = getFieldValidate == null ? void 0 : getFieldValidate(name);
+  const validate = name !== void 0 ? getFieldValidate == null ? void 0 : getFieldValidate(name) : void 0;
   return /* @__PURE__ */ import_react2.default.createElement(
     "div",
     {
@@ -120,7 +129,7 @@ var Field = (props) => {
       ),
       style
     },
-    /* @__PURE__ */ import_react2.default.createElement(
+    label ? /* @__PURE__ */ import_react2.default.createElement(
       "label",
       {
         className: (0, import_clsx.default)(
@@ -133,7 +142,7 @@ var Field = (props) => {
         style: styles == null ? void 0 : styles.label
       },
       label
-    ),
+    ) : null,
     /* @__PURE__ */ import_react2.default.createElement(
       "div",
       {

package/dist/cjs/Field/interface.d.ts

@@ -27,13 +27,16 @@ export interface FieldProps {
      */
     label?: React.ReactNode;
     /**
-     * Field name
+     * Field name (required only when used with a registered virtual form)
      */
-    name: string;
+    name?: string;
     /**
-     * Name of the parent form
+     * Name of the parent form.
+     * When omitted (or no form is registered under this name), Field renders
+     * as a pure layout wrapper: the child keeps its own value/onChange and
+     * no validation runs.
      */
-    formName: string;
+    formName?: string;
     /**
      * Whether disabled
      */

package/dist/cjs/Field/style/index.less

@@ -25,6 +25,7 @@
   &-content {
     position: relative;
     padding-bottom: var(--yee-field-content-padding-bottom);
+    width: stretch;
   }
 
   &-error {

package/dist/cjs/style/themes.css

@@ -1,7 +1,7 @@
 /*!
  * @rainbow-oh/yee-c CSS Variables
  * Auto-generated, do not edit manually
- * Generated on 2026-09-14T07:04:58.616Z
+ * Generated on 2026-09-17T09:06:26.119Z
  */
 
 /* ========== color.blue.css ========== */

package/dist/cjs/style/variables.css

@@ -1,7 +1,7 @@
 /*!
  * @rainbow-oh/yee-c CSS Variables
  * Auto-generated, do not edit manually
- * Generated on 2026-09-14T07:04:58.616Z
+ * Generated on 2026-09-17T09:06:26.119Z
  */
 
 /* ========== color.css ========== */

package/dist/cjs/version.d.ts

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

package/dist/cjs/version.js

@@ -22,7 +22,7 @@ __export(version_exports, {
   version: () => version
 });
 module.exports = __toCommonJS(version_exports);
-var version = "0.13.0";
+var version = "0.14.0";
 if (typeof window !== "undefined") {
   window.__yee_c_version__ = version;
 }

package/dist/esm/Field/demo/standalone.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const _default: () => React.JSX.Element;
+export default _default;

package/dist/esm/Field/demo/standalone.js

@@ -0,0 +1,43 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { Field, Input, TextArea } from "../..";
+import React, { useState } from 'react';
+export default (function () {
+  var _useState = useState(''),
+    _useState2 = _slicedToArray(_useState, 2),
+    name = _useState2[0],
+    setName = _useState2[1];
+  var _useState3 = useState(''),
+    _useState4 = _slicedToArray(_useState3, 2),
+    remark = _useState4[0],
+    setRemark = _useState4[1];
+  return /*#__PURE__*/React.createElement("div", {
+    style: {
+      maxWidth: 400
+    }
+  }, /*#__PURE__*/React.createElement(Field, {
+    label: "Name",
+    required: true
+  }, /*#__PURE__*/React.createElement(Input, {
+    value: name,
+    onChange: function onChange(v) {
+      return setName(v);
+    },
+    placeholder: "Standalone controlled Input"
+  })), /*#__PURE__*/React.createElement(Field, {
+    label: "Remark"
+  }, /*#__PURE__*/React.createElement(TextArea, {
+    value: remark,
+    onChange: function onChange(v) {
+      return setRemark(v);
+    },
+    placeholder: "Standalone controlled TextArea",
+    rows: 3
+  })), /*#__PURE__*/React.createElement(Field, null, /*#__PURE__*/React.createElement(Input, {
+    placeholder: "Field without label"
+  })));
+});

package/dist/esm/Field/field.js

@@ -37,7 +37,7 @@ var Field = function Field(props) {
     }, 0),
     _useReducer2 = _slicedToArray(_useReducer, 2),
     forceUpdate = _useReducer2[1];
-  var _useVirtualField = useVirtualField(formName, name, {
+  var _useVirtualField = useVirtualField(formName !== null && formName !== void 0 ? formName : '', name !== null && name !== void 0 ? name : '', {
       props: props,
       onStoreChange: forceUpdate
     }),
@@ -55,22 +55,35 @@ var Field = function Field(props) {
     }) || required;
   };
   var getControlled = function getControlled(children) {
-    var mergedDisabled = disabled || children.props.disabled;
+    var childProps = children.props;
+
+    // Pure layout mode (no form): children keep their own value/onChange.
+    // Only a Field-level disabled is merged down.
+    // Pure layout mode (no form or no field name): children keep their own
+    // value/onChange. Only a Field-level disabled is merged down.
+    if (!form || name === undefined) {
+      if (disabled === undefined) return children;
+      return /*#__PURE__*/React.cloneElement(children, {
+        disabled: disabled || childProps.disabled
+      });
+    }
+    var mergedDisabled = disabled || childProps.disabled;
+    var fieldName = name;
     var attr = {
-      value: getFieldValue === null || getFieldValue === void 0 ? void 0 : getFieldValue(name),
+      value: getFieldValue === null || getFieldValue === void 0 ? void 0 : getFieldValue(fieldName),
       name: formName,
-      id: name,
+      id: fieldName,
       disabled: mergedDisabled,
       onChange: function onChange(value) {
         var _callbacks$onValuesBe, _children$props, _callbacks$onValuesCh;
         var callbacks = getCallbacks === null || getCallbacks === void 0 ? void 0 : getCallbacks();
         var _value = value;
         var fieldsValue = getFieldsValue === null || getFieldsValue === void 0 ? void 0 : getFieldsValue();
-        var feedback = callbacks === null || callbacks === void 0 || (_callbacks$onValuesBe = callbacks.onValuesBeforeChange) === null || _callbacks$onValuesBe === void 0 ? void 0 : _callbacks$onValuesBe.call(callbacks, _defineProperty({}, name, _value), fieldsValue);
+        var feedback = callbacks === null || callbacks === void 0 || (_callbacks$onValuesBe = callbacks.onValuesBeforeChange) === null || _callbacks$onValuesBe === void 0 ? void 0 : _callbacks$onValuesBe.call(callbacks, _defineProperty({}, fieldName, _value), fieldsValue);
         if (feedback !== undefined) {
           _value = feedback;
         }
-        setFieldsValue === null || setFieldsValue === void 0 || setFieldsValue(_defineProperty({}, name, _value), 'onChange');
+        setFieldsValue === null || setFieldsValue === void 0 || setFieldsValue(_defineProperty({}, fieldName, _value), 'onChange');
 
         // Call child component's onChange
         if ((_children$props = children.props) !== null && _children$props !== void 0 && _children$props.onChange) {
@@ -80,12 +93,12 @@ var Field = function Field(props) {
           }
           (_ref2 = children.props).onChange.apply(_ref2, [_value].concat(rest));
         }
-        callbacks === null || callbacks === void 0 || (_callbacks$onValuesCh = callbacks['onValuesChange']) === null || _callbacks$onValuesCh === void 0 || _callbacks$onValuesCh.call(callbacks, _defineProperty({}, name, _value), fieldsValue);
+        callbacks === null || callbacks === void 0 || (_callbacks$onValuesCh = callbacks['onValuesChange']) === null || _callbacks$onValuesCh === void 0 || _callbacks$onValuesCh.call(callbacks, _defineProperty({}, fieldName, _value), fieldsValue);
         forceUpdate();
       },
       onBlur: function onBlur(event) {
         // Fire-and-forget async validation; store notifies onStoreChange on completion.
-        void (validateField === null || validateField === void 0 ? void 0 : validateField(name, 'onBlur'));
+        void (validateField === null || validateField === void 0 ? void 0 : validateField(fieldName, 'onBlur'));
 
         // Call child component's onBlur
         if (children.props.onBlur) {
@@ -95,14 +108,14 @@ var Field = function Field(props) {
     };
     return /*#__PURE__*/React.cloneElement(children, attr);
   };
-  var validate = getFieldValidate === null || getFieldValidate === void 0 ? void 0 : getFieldValidate(name);
+  var validate = name !== undefined ? getFieldValidate === null || getFieldValidate === void 0 ? void 0 : getFieldValidate(name) : undefined;
   return /*#__PURE__*/React.createElement("div", {
     className: clsx("".concat(prefixCls), "".concat(prefixCls, "-").concat(layout), _defineProperty({}, "".concat(prefixCls, "-").concat(validate === null || validate === void 0 ? void 0 : validate.status), validate === null || validate === void 0 ? void 0 : validate.status), className),
     style: style
-  }, /*#__PURE__*/React.createElement("label", {
+  }, label ? /*#__PURE__*/React.createElement("label", {
     className: clsx("".concat(prefixCls, "-label"), _defineProperty({}, "".concat(prefixCls, "-required"), isRequired()), classNames === null || classNames === void 0 ? void 0 : classNames.label),
     style: styles === null || styles === void 0 ? void 0 : styles.label
-  }, label), /*#__PURE__*/React.createElement("div", {
+  }, label) : null, /*#__PURE__*/React.createElement("div", {
     className: clsx("".concat(prefixCls, "-content"), classNames === null || classNames === void 0 ? void 0 : classNames.content),
     style: styles === null || styles === void 0 ? void 0 : styles.content
   }, /*#__PURE__*/React.createElement("div", {

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

@@ -27,13 +27,16 @@ export interface FieldProps {
      */
     label?: React.ReactNode;
     /**
-     * Field name
+     * Field name (required only when used with a registered virtual form)
      */
-    name: string;
+    name?: string;
     /**
-     * Name of the parent form
+     * Name of the parent form.
+     * When omitted (or no form is registered under this name), Field renders
+     * as a pure layout wrapper: the child keeps its own value/onChange and
+     * no validation runs.
      */
-    formName: string;
+    formName?: string;
     /**
      * Whether disabled
      */

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

@@ -25,6 +25,7 @@
   &-content {
     position: relative;
     padding-bottom: var(--yee-field-content-padding-bottom);
+    width: stretch;
   }
 
   &-error {

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-09-14T07:04:58.616Z
+ * Generated on 2026-09-17T09:06:26.119Z
  */
 
 /* ========== 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-09-14T07:04:58.616Z
+ * Generated on 2026-09-17T09:06:26.119Z
  */
 
 /* ========== color.css ========== */

package/dist/esm/version.d.ts

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

package/dist/esm/version.js

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