docs(segments): 📝 add docs

Author: navin-moorthy

docs/datefield.md

@@ -95,7 +95,7 @@ export default DateFieldBasic;
 
 | Name          | Type                        | Description                                          |
 | :------------ | :-------------------------- | :--------------------------------------------------- |
-| **`segment`** | <code>DateSegment</code>    |                                                      |
+| **`segment`** | <code>DateSegment</code>    | Current segment state return from `state.segments`.  |
 | **`state`**   | <code>DateFieldState</code> | Object returned by the `useDateFieldBaseState` hook. |
 
 ### `DateFieldOptions`

docs/timefield.md

@@ -94,7 +94,7 @@ export default TimeFieldBasic;
 
 | Name          | Type                        | Description                                          |
 | :------------ | :-------------------------- | :--------------------------------------------------- |
-| **`segment`** | <code>DateSegment</code>    |                                                      |
+| **`segment`** | <code>DateSegment</code>    | Current segment state return from `state.segments`.  |
 | **`state`**   | <code>DateFieldState</code> | Object returned by the `useTimeFieldBaseState` hook. |
 
 ### `TimeFieldOptions`

src/datefield/date-segment.ts

@@ -31,6 +31,9 @@ export const DateSegment = createComponent<DateSegmentOptions>(props => {
 });
 
 export type DateSegmentOptions<T extends As = "div"> = Options<T> & {
+  /**
+   * Current segment state return from `state.segments`.
+   */
   segment: DateSegmentState;
   /**
    * Object returned by the `useDateFieldBaseState` hook.

src/timefield/time-segment.ts

@@ -31,6 +31,9 @@ export const TimeSegment = createComponent<TimeSegmentOptions>(props => {
 });
 
 export type TimeSegmentOptions<T extends As = "div"> = Options<T> & {
+  /**
+   * Current segment state return from `state.segments`.
+   */
   segment: DateSegmentState;
   /**
    * Object returned by the `useTimeFieldBaseState` hook.