@react-fabric/form 1.0.0-beta.5 → 1.0.0-beta.7

package/dist/cjs/input/RadioGroup.js

@@ -6,13 +6,14 @@ var react = require('react');
 var FieldWrapper = require('../internal/FieldWrapper.js');
 var jsxRuntime = require('react/jsx-runtime');
 
-var _excluded = ["children", "name", "className", "onChange"];
+var _excluded = ["children", "name", "className", "optionWidth", "onChange"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 var RadioGroup = function RadioGroup(_ref) {
   var children = _ref.children,
     name = _ref.name,
     className = _ref.className,
+    optionWidth = _ref.optionWidth,
     onChange = _ref.onChange,
     rest = _objectWithoutProperties(_ref, _excluded);
   return /*#__PURE__*/jsxRuntime.jsx(FieldWrapper.FieldWrapper, _objectSpread(_objectSpread({}, rest), {}, {
@@ -21,7 +22,8 @@ var RadioGroup = function RadioGroup(_ref) {
       children: react.Children.map(children, function (child) {
         return /*#__PURE__*/react.cloneElement(child, {
           name: name,
-          onChange: onChange
+          onChange: onChange,
+          width: optionWidth
         });
       })
     })

package/dist/cjs/input/Switch.js

@@ -10,7 +10,7 @@ require('@react-fabric/utilities');
 var getColor = require('../utils/getColor.js');
 var jsxRuntime = require('react/jsx-runtime');
 
-var _excluded = ["ref", "label", "checked", "invalid", "disabled", "error", "width", "color", "name", "defaultColor", "onChange"];
+var _excluded = ["ref", "label", "checked", "invalid", "disabled", "error", "width", "color", "name", "onLabel", "offLabel", "onLabelColor", "offLabelColor", "defaultColor", "onChange"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 var Switch = function Switch(_ref) {
@@ -23,7 +23,11 @@ var Switch = function Switch(_ref) {
     width = _ref.width,
     color = _ref.color;
     _ref.name;
-    var defaultColor = _ref.defaultColor,
+    var onLabel = _ref.onLabel,
+    offLabel = _ref.offLabel,
+    onLabelColor = _ref.onLabelColor,
+    offLabelColor = _ref.offLabelColor,
+    defaultColor = _ref.defaultColor,
     onChange = _ref.onChange,
     rest = _objectWithoutProperties(_ref, _excluded);
   var _useState = react.useState(false),
@@ -45,7 +49,7 @@ var Switch = function Switch(_ref) {
       width: width
     },
     children: [/*#__PURE__*/jsxRuntime.jsxs("div", {
-      className: classNames(actualValue && getColor.getBgClass(color ? "".concat(color, "-500") : "primary-500"), !actualValue && (defaultColor ? getColor.getBgClass("".concat(defaultColor, "-500")) : "bg-tint-200"), "relative flex h-6 w-10 cursor-pointer rounded-full p-1 transition-colors duration-200 ease-in-out"),
+      className: classNames(actualValue && getColor.getBgClass(color ? "".concat(color, "-500") : "primary-500"), !actualValue && (defaultColor ? getColor.getBgClass("".concat(defaultColor, "-500")) : "bg-tint-200"), "relative grid grid-cols-2 items-center h-6 min-w-10 cursor-pointer rounded-full p-1 transition-colors duration-200 ease-in-out"),
       style: {
         backgroundColor: actualValue ? getColor.getColor(color) : getColor.getColor(defaultColor)
       },
@@ -64,7 +68,24 @@ var Switch = function Switch(_ref) {
         onChange: handleChange
       }, rest)), /*#__PURE__*/jsxRuntime.jsx("span", {
         "aria-hidden": "true",
-        className: classNames(!disabled && "shadow-sm", actualValue ? "translate-x-4" : "translate-x-0", "pointer-events-none inline-block size-4 rounded-full bg-white ring-0 transition duration-200 ease-in-out")
+        className: classNames(!disabled && "shadow-sm", actualValue ? "translate-x-[100%]" : "translate-x-0", "pointer-events-none inline-block h-4 start-1 absolute rounded-full bg-white ring-0 transition duration-200 ease-in-out"),
+        style: {
+          width: "calc(50% - 0.25rem)"
+        }
+      }), (!!onLabel || !!offLabel) && /*#__PURE__*/jsxRuntime.jsxs(react.Fragment, {
+        children: [/*#__PURE__*/jsxRuntime.jsx("span", {
+          className: "whitespace-nowrap text-xs px-1 ".concat(getColor.getColorClass(onLabelColor !== null && onLabelColor !== void 0 ? onLabelColor : "white")),
+          style: {
+            color: getColor.getColor(onLabelColor)
+          },
+          children: onLabel !== null && onLabel !== void 0 ? onLabel : " "
+        }), /*#__PURE__*/jsxRuntime.jsx("span", {
+          className: "whitespace-nowrap text-xs px-1 ".concat(getColor.getColorClass(offLabelColor !== null && offLabelColor !== void 0 ? offLabelColor : "base")),
+          style: {
+            color: getColor.getColor(offLabelColor)
+          },
+          children: offLabel !== null && offLabel !== void 0 ? offLabel : " "
+        })]
       })]
     }), /*#__PURE__*/jsxRuntime.jsx(ErrorIcon.ErrorIcon, {
       invalid: invalid,

package/dist/cjs/utils/getColor.js

@@ -35,6 +35,12 @@ var getBgClass = function getBgClass(bg) {
     return "bg-".concat(bg);
   }
 };
+var getColorClass = function getColorClass(color) {
+  if (color && !utilities.isColor(color)) {
+    return "text-".concat(color);
+  }
+};
 
 exports.getBgClass = getBgClass;
 exports.getColor = getColor;
+exports.getColorClass = getColorClass;

package/dist/esm/input/RadioGroup.js

@@ -6,13 +6,14 @@ import { Children, cloneElement } from 'react';
 import { FieldWrapper } from '../internal/FieldWrapper.js';
 import { jsx } from 'react/jsx-runtime';
 
-var _excluded = ["children", "name", "className", "onChange"];
+var _excluded = ["children", "name", "className", "optionWidth", "onChange"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 var RadioGroup = function RadioGroup(_ref) {
   var children = _ref.children,
     name = _ref.name,
     className = _ref.className,
+    optionWidth = _ref.optionWidth,
     onChange = _ref.onChange,
     rest = _objectWithoutProperties(_ref, _excluded);
   return /*#__PURE__*/jsx(FieldWrapper, _objectSpread(_objectSpread({}, rest), {}, {
@@ -21,7 +22,8 @@ var RadioGroup = function RadioGroup(_ref) {
       children: Children.map(children, function (child) {
         return /*#__PURE__*/cloneElement(child, {
           name: name,
-          onChange: onChange
+          onChange: onChange,
+          width: optionWidth
         });
       })
     })

package/dist/esm/input/Switch.js

@@ -4,13 +4,13 @@ import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
 import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
 import classNames from 'classnames';
-import { useState, useDeferredValue, useEffect, useCallback } from 'react';
+import { useState, useDeferredValue, useEffect, useCallback, Fragment } from 'react';
 import { ErrorIcon } from '../internal/ErrorIcon.js';
 import '@react-fabric/utilities';
-import { getBgClass, getColor } from '../utils/getColor.js';
+import { getBgClass, getColor, getColorClass } from '../utils/getColor.js';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
-var _excluded = ["ref", "label", "checked", "invalid", "disabled", "error", "width", "color", "name", "defaultColor", "onChange"];
+var _excluded = ["ref", "label", "checked", "invalid", "disabled", "error", "width", "color", "name", "onLabel", "offLabel", "onLabelColor", "offLabelColor", "defaultColor", "onChange"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 var Switch = function Switch(_ref) {
@@ -23,7 +23,11 @@ var Switch = function Switch(_ref) {
     width = _ref.width,
     color = _ref.color;
     _ref.name;
-    var defaultColor = _ref.defaultColor,
+    var onLabel = _ref.onLabel,
+    offLabel = _ref.offLabel,
+    onLabelColor = _ref.onLabelColor,
+    offLabelColor = _ref.offLabelColor,
+    defaultColor = _ref.defaultColor,
     onChange = _ref.onChange,
     rest = _objectWithoutProperties(_ref, _excluded);
   var _useState = useState(false),
@@ -45,7 +49,7 @@ var Switch = function Switch(_ref) {
       width: width
     },
     children: [/*#__PURE__*/jsxs("div", {
-      className: classNames(actualValue && getBgClass(color ? "".concat(color, "-500") : "primary-500"), !actualValue && (defaultColor ? getBgClass("".concat(defaultColor, "-500")) : "bg-tint-200"), "relative flex h-6 w-10 cursor-pointer rounded-full p-1 transition-colors duration-200 ease-in-out"),
+      className: classNames(actualValue && getBgClass(color ? "".concat(color, "-500") : "primary-500"), !actualValue && (defaultColor ? getBgClass("".concat(defaultColor, "-500")) : "bg-tint-200"), "relative grid grid-cols-2 items-center h-6 min-w-10 cursor-pointer rounded-full p-1 transition-colors duration-200 ease-in-out"),
       style: {
         backgroundColor: actualValue ? getColor(color) : getColor(defaultColor)
       },
@@ -64,7 +68,24 @@ var Switch = function Switch(_ref) {
         onChange: handleChange
       }, rest)), /*#__PURE__*/jsx("span", {
         "aria-hidden": "true",
-        className: classNames(!disabled && "shadow-sm", actualValue ? "translate-x-4" : "translate-x-0", "pointer-events-none inline-block size-4 rounded-full bg-white ring-0 transition duration-200 ease-in-out")
+        className: classNames(!disabled && "shadow-sm", actualValue ? "translate-x-[100%]" : "translate-x-0", "pointer-events-none inline-block h-4 start-1 absolute rounded-full bg-white ring-0 transition duration-200 ease-in-out"),
+        style: {
+          width: "calc(50% - 0.25rem)"
+        }
+      }), (!!onLabel || !!offLabel) && /*#__PURE__*/jsxs(Fragment, {
+        children: [/*#__PURE__*/jsx("span", {
+          className: "whitespace-nowrap text-xs px-1 ".concat(getColorClass(onLabelColor !== null && onLabelColor !== void 0 ? onLabelColor : "white")),
+          style: {
+            color: getColor(onLabelColor)
+          },
+          children: onLabel !== null && onLabel !== void 0 ? onLabel : " "
+        }), /*#__PURE__*/jsx("span", {
+          className: "whitespace-nowrap text-xs px-1 ".concat(getColorClass(offLabelColor !== null && offLabelColor !== void 0 ? offLabelColor : "base")),
+          style: {
+            color: getColor(offLabelColor)
+          },
+          children: offLabel !== null && offLabel !== void 0 ? offLabel : " "
+        })]
       })]
     }), /*#__PURE__*/jsx(ErrorIcon, {
       invalid: invalid,

package/dist/esm/utils/getColor.js

@@ -35,5 +35,10 @@ var getBgClass = function getBgClass(bg) {
     return "bg-".concat(bg);
   }
 };
+var getColorClass = function getColorClass(color) {
+  if (color && !isColor(color)) {
+    return "text-".concat(color);
+  }
+};
 
-export { getBgClass, getColor };
+export { getBgClass, getColor, getColorClass };

package/dist/types/input/ArrayInput.d.ts

@@ -60,5 +60,17 @@ export interface ArrayInputProps {
      * Add item
      */
     onAdd?: () => AnyObject;
+    /**
+     * field width
+     */
+    width?: number | string;
+    /**
+     * inline label and input
+     */
+    inline?: boolean;
+    /**
+     * label width for inline
+     */
+    labelWidth?: string;
 }
 export declare const ArrayInput: ({ name, children, addLabel, fixedList, focusName, onAdd, arrayRef, enableSorting, disabled, readOnly, minItems, ...rest }: ArrayInputProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/input/RadioGroup.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-import { type CssProp, type ChildrenProp } from "@react-fabric/core/dist/types/types";
+import { type ChildrenProp, type CssProp } from "@react-fabric/core/dist/types/types";
 import { type Radio } from "./Radio";
 export interface RadioGroupProps extends ChildrenProp<typeof Radio>, CssProp {
     /**
@@ -14,6 +14,22 @@ export interface RadioGroupProps extends ChildrenProp<typeof Radio>, CssProp {
      * field info
      */
     info?: string;
+    /**
+     * field width
+     */
+    width?: number | string;
+    /**
+     * inline label and input
+     */
+    inline?: boolean;
+    /**
+     * label width for inline
+     */
+    labelWidth?: string;
+    /**
+     * label width for inline
+     */
+    optionWidth?: string;
     /**
      * field name
      */
@@ -27,4 +43,4 @@ export interface RadioGroupProps extends ChildrenProp<typeof Radio>, CssProp {
      */
     onChange?: (value: AnyObject) => void;
 }
-export declare const RadioGroup: ({ children, name, className, onChange, ...rest }: RadioGroupProps) => import("react/jsx-runtime").JSX.Element;
+export declare const RadioGroup: ({ children, name, className, optionWidth, onChange, ...rest }: RadioGroupProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/input/Switch.d.ts

@@ -32,11 +32,15 @@ export interface SwitchProps extends RefProp<HTMLInputElement> {
     /**
      * cutom Switch icon
      */
-    color?: ColorType;
+    color?: string | ColorType;
     /**
      * cutom Switch icon
      */
-    defaultColor?: ColorType;
+    defaultColor?: string | ColorType;
     name?: string;
+    onLabel?: string;
+    onLabelColor?: string | ColorType;
+    offLabel?: string;
+    offLabelColor?: string | ColorType;
 }
-export declare const Switch: ({ ref, label, checked, invalid, disabled, error, width, color, name, defaultColor, onChange, ...rest }: SwitchProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Switch: ({ ref, label, checked, invalid, disabled, error, width, color, name, onLabel, offLabel, onLabelColor, offLabelColor, defaultColor, onChange, ...rest }: SwitchProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/types/index.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="react" />
-import { type RefProp } from "@react-fabric/core/dist/types/types";
-export interface InputProps<V = string> {
+import { type RefProp, type TestProps } from "@react-fabric/core/dist/types/types";
+export interface InputProps<V = string> extends TestProps {
     /**
      * value
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-fabric/form",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.7",
   "description": "RUF: Form package",
   "author": "Adarsh Pastakia <adarshpastakia@outlook.com>",
   "license": "MIT",
@@ -39,8 +39,8 @@
     "@dnd-kit/utilities": "^3.2.2",
     "@floating-ui/react": "0.26.24",
     "@hookform/resolvers": "^3.9.0",
-    "@react-fabric/core": "^1.0.0-beta.5",
-    "@react-fabric/utilities": "^1.0.0-beta.5",
+    "@react-fabric/core": "^1.0.0-beta.7",
+    "@react-fabric/utilities": "^1.0.0-beta.7",
     "classnames": "^2.5.1",
     "color": "^4.2.3",
     "react-color": "^2.19.3",
@@ -60,5 +60,5 @@
     "node": ">=18.12.0",
     "npm": ">=8.19.0"
   },
-  "gitHead": "7d4a7ed1ea9890652826bef58d01c31280d761c8"
+  "gitHead": "8e6efedbbb02660c0b64140aff00e633b891bb85"
 }

package/src/input/ArrayInput.tsx

@@ -104,6 +104,19 @@ export interface ArrayInputProps {
    * Add item
    */
   onAdd?: () => AnyObject;
+
+  /**
+   * field width
+   */
+  width?: number | string;
+  /**
+   * inline label and input
+   */
+  inline?: boolean;
+  /**
+   * label width for inline
+   */
+  labelWidth?: string;
 }
 
 export const ArrayInput = ({

package/src/input/RadioGroup.tsx

@@ -22,8 +22,8 @@
  */
 
 import {
-  type CssProp,
   type ChildrenProp,
+  type CssProp,
 } from "@react-fabric/core/dist/types/types";
 import { Children, cloneElement } from "react";
 import { FieldWrapper } from "../internal/FieldWrapper";
@@ -42,6 +42,23 @@ export interface RadioGroupProps extends ChildrenProp<typeof Radio>, CssProp {
    * field info
    */
   info?: string;
+
+  /**
+   * field width
+   */
+  width?: number | string;
+  /**
+   * inline label and input
+   */
+  inline?: boolean;
+  /**
+   * label width for inline
+   */
+  labelWidth?: string;
+  /**
+   * label width for inline
+   */
+  optionWidth?: string;
   /**
    * field name
    */
@@ -60,6 +77,7 @@ export const RadioGroup = ({
   children,
   name,
   className,
+  optionWidth,
   onChange,
   ...rest
 }: RadioGroupProps) => {
@@ -67,7 +85,11 @@ export const RadioGroup = ({
     <FieldWrapper {...rest}>
       <div className={className}>
         {Children.map(children, (child) =>
-          cloneElement(child as AnyObject, { name, onChange }),
+          cloneElement(child as AnyObject, {
+            name,
+            onChange,
+            width: optionWidth,
+          }),
         )}
       </div>
     </FieldWrapper>

package/src/input/Switch.tsx

@@ -27,6 +27,7 @@ import {
 } from "@react-fabric/core/dist/types/types";
 import classNames from "classnames";
 import {
+  Fragment,
   useCallback,
   useDeferredValue,
   useEffect,
@@ -34,7 +35,7 @@ import {
   type ChangeEvent,
 } from "react";
 import { ErrorIcon } from "../internal/ErrorIcon";
-import { getBgClass, getColor } from "../utils";
+import { getBgClass, getColor, getColorClass } from "../utils";
 
 export interface SwitchProps extends RefProp<HTMLInputElement> {
   /**
@@ -71,13 +72,19 @@ export interface SwitchProps extends RefProp<HTMLInputElement> {
   /**
    * cutom Switch icon
    */
-  color?: ColorType;
+  color?: string | ColorType;
   /**
    * cutom Switch icon
    */
-  defaultColor?: ColorType;
+  defaultColor?: string | ColorType;
 
   name?: string;
+
+  onLabel?: string;
+  onLabelColor?: string | ColorType;
+
+  offLabel?: string;
+  offLabelColor?: string | ColorType;
 }
 
 export const Switch = ({
@@ -90,6 +97,10 @@ export const Switch = ({
   width,
   color,
   name,
+  onLabel,
+  offLabel,
+  onLabelColor,
+  offLabelColor,
   defaultColor,
   onChange,
   ...rest
@@ -125,7 +136,7 @@ export const Switch = ({
           actualValue && getBgClass(color ? `${color}-500` : "primary-500"),
           !actualValue &&
             (defaultColor ? getBgClass(`${defaultColor}-500`) : "bg-tint-200"),
-          "relative flex h-6 w-10 cursor-pointer rounded-full p-1 transition-colors duration-200 ease-in-out",
+          "relative grid grid-cols-2 items-center h-6 min-w-10 cursor-pointer rounded-full p-1 transition-colors duration-200 ease-in-out",
         )}
         style={{
           backgroundColor: actualValue
@@ -154,10 +165,33 @@ export const Switch = ({
           aria-hidden="true"
           className={classNames(
             !disabled && "shadow-sm",
-            actualValue ? "translate-x-4" : "translate-x-0",
-            "pointer-events-none inline-block size-4 rounded-full bg-white ring-0 transition duration-200 ease-in-out",
+            actualValue ? "translate-x-[100%]" : "translate-x-0",
+            "pointer-events-none inline-block h-4 start-1 absolute rounded-full bg-white ring-0 transition duration-200 ease-in-out",
           )}
+          style={{
+            width: "calc(50% - 0.25rem)",
+          }}
         />
+        {(!!onLabel || !!offLabel) && (
+          <Fragment>
+            <span
+              className={`whitespace-nowrap text-xs px-1 ${getColorClass(onLabelColor ?? "white")}`}
+              style={{
+                color: getColor(onLabelColor),
+              }}
+            >
+              {onLabel ?? " "}
+            </span>
+            <span
+              className={`whitespace-nowrap text-xs px-1 ${getColorClass(offLabelColor ?? "base")}`}
+              style={{
+                color: getColor(offLabelColor),
+              }}
+            >
+              {offLabel ?? " "}
+            </span>
+          </Fragment>
+        )}
       </div>
       <ErrorIcon invalid={invalid} error={error} />
       {label && (

package/src/types/index.ts

@@ -21,9 +21,12 @@
  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  */
 
-import { type RefProp } from "@react-fabric/core/dist/types/types";
+import {
+  type RefProp,
+  type TestProps,
+} from "@react-fabric/core/dist/types/types";
 
-export interface InputProps<V = string> {
+export interface InputProps<V = string> extends TestProps {
   /**
    * value
    */