@douyinfe/semi-foundation 2.1.6-alpha.0 → 2.2.1

package/lib/es/cascader/cascader.scss

@@ -116,7 +116,7 @@ $module: #{$prefix}-cascader;
                 margin-left: 0;
             }
 
-            &-disabled {
+            &-disabled.#{$prefix}-tag {
                 color: $color-cascader_input_disabled-text-default;
                 cursor: not-allowed;
                 

package/lib/es/cascader/constants.d.ts

@@ -9,6 +9,9 @@ declare const strings: {
     readonly IS_VALUE: "isValue";
     readonly SHOW_NEXT_BY_CLICK: "click";
     readonly SHOW_NEXT_BY_HOVER: "hover";
+    readonly LEAF_ONLY_MERGE_TYPE: "leafOnly";
+    readonly AUTO_MERGE_VALUE_MERGE_TYPE: "autoMergeValue";
+    readonly NONE_MERGE_TYPE: "none";
 };
 declare const numbers: {};
 export { cssClasses, strings, numbers };

package/lib/es/cascader/constants.js

@@ -9,7 +9,12 @@ const strings = {
   IS_KEY: 'isKey',
   IS_VALUE: 'isValue',
   SHOW_NEXT_BY_CLICK: 'click',
-  SHOW_NEXT_BY_HOVER: 'hover'
+  SHOW_NEXT_BY_HOVER: 'hover',
+
+  /* Merge Type */
+  LEAF_ONLY_MERGE_TYPE: 'leafOnly',
+  AUTO_MERGE_VALUE_MERGE_TYPE: 'autoMergeValue',
+  NONE_MERGE_TYPE: 'none'
 };
 const numbers = {};
 export { cssClasses, strings, numbers };

package/lib/es/cascader/foundation.d.ts

@@ -57,6 +57,7 @@ export interface BasicScrollPanelProps {
 export interface BasicCascaderProps {
     mouseEnterDelay?: number;
     mouseLeaveDelay?: number;
+    separator?: string;
     arrowIcon?: any;
     changeOnSelect?: boolean;
     multiple?: boolean;
@@ -96,6 +97,8 @@ export interface BasicCascaderProps {
     topSlot?: any;
     showNext?: ShowNextType;
     disableStrictly?: boolean;
+    leafOnly?: boolean;
+    enableLeafClick?: boolean;
     onClear?: () => void;
     triggerRender?: (props: BasicTriggerRenderProps) => any;
     onListScroll?: (e: any, panel: BasicScrollPanelProps) => void;
@@ -125,7 +128,7 @@ export interface BasicCascaderInnerData {
     isHovering: boolean;
     checkedKeys: Set<string>;
     halfCheckedKeys: Set<string>;
-    mergedCheckedKeys: Set<string>;
+    resolvedCheckedKeys: Set<string>;
     loadedKeys: Set<string>;
     loadingKeys: Set<string>;
     loading: boolean;

package/lib/es/cascader/foundation.js

@@ -22,7 +22,8 @@ import _sortInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instanc
 import _parseInt from "@babel/runtime-corejs3/core-js-stable/parse-int";
 import BaseFoundation from '../base/foundation';
 import { filter, findAncestorKeys, calcCheckedKeysForUnchecked, calcCheckedKeysForChecked, calcCheckedKeys, findDescendantKeys, normalizeKeyList } from '../tree/treeUtil';
-import { convertDataToEntities, findKeysForValues, normalizedArr, isValid } from './util'; // eslint-disable-next-line max-len
+import { convertDataToEntities, findKeysForValues, normalizedArr, isValid, calcMergeType } from './util';
+import { strings } from './constants'; // eslint-disable-next-line max-len
 
 export default class CascaderFoundation extends BaseFoundation {
   constructor(adapter) {
@@ -535,10 +536,12 @@ export default class CascaderFoundation extends BaseFoundation {
   }
 
   _defaultRenderText(path, displayRender) {
+    const separator = this.getProp('separator');
+
     if (displayRender && typeof displayRender === 'function') {
       return displayRender(path);
     } else {
-      return path.join(' / ');
+      return path.join(separator);
     }
   }
 
@@ -612,7 +615,8 @@ export default class CascaderFoundation extends BaseFoundation {
     const {
       changeOnSelect: allowChange,
       filterLeafOnly,
-      multiple
+      multiple,
+      enableLeafClick
     } = this.getProps();
     const {
       keyEntities,
@@ -646,6 +650,10 @@ export default class CascaderFoundation extends BaseFoundation {
       this._adapter.updateStates({
         activeKeys: new _Set(activeKeys)
       });
+
+      if (isLeaf && enableLeafClick) {
+        this.onItemCheckboxClick(item);
+      }
     } else {
       this._adapter.notifySelect(data.value);
 
@@ -695,12 +703,13 @@ export default class CascaderFoundation extends BaseFoundation {
     const {
       checkedKeys,
       keyEntities,
-      mergedCheckedKeys
+      resolvedCheckedKeys
     } = this.getStates();
     const {
       autoMergeValue,
       max,
-      disableStrictly
+      disableStrictly,
+      leafOnly
     } = this.getProps(); // prev checked status
 
     const prevCheckedStatus = checkedKeys.has(key); // next checked status
@@ -711,16 +720,19 @@ export default class CascaderFoundation extends BaseFoundation {
       checkedKeys: curCheckedKeys,
       halfCheckedKeys: curHalfCheckedKeys
     } = disableStrictly ? this.calcNonDisabedCheckedKeys(key, curCheckedStatus) : this.calcCheckedKeys(key, curCheckedStatus);
-    const curMergedCheckedKeys = new _Set(normalizeKeyList(curCheckedKeys, keyEntities));
-    const curRealCheckedKeys = autoMergeValue ? curMergedCheckedKeys : curCheckedKeys;
+    const mergeType = calcMergeType(autoMergeValue, leafOnly);
+    const isLeafOnlyMerge = mergeType === strings.LEAF_ONLY_MERGE_TYPE;
+    const isNoneMerge = mergeType === strings.NONE_MERGE_TYPE;
+    const curResolvedCheckedKeys = new _Set(normalizeKeyList(curCheckedKeys, keyEntities, isLeafOnlyMerge));
+    const curRealCheckedKeys = isNoneMerge ? curCheckedKeys : curResolvedCheckedKeys;
 
     if (_isNumber(max)) {
-      if (autoMergeValue) {
+      if (!isNoneMerge) {
         // When it exceeds max, the quantity is allowed to be reduced, and no further increase is allowed
-        if (mergedCheckedKeys.size < curMergedCheckedKeys.size && curMergedCheckedKeys.size > max) {
+        if (resolvedCheckedKeys.size < curResolvedCheckedKeys.size && curResolvedCheckedKeys.size > max) {
           const checkedEntities = [];
 
-          _forEachInstanceProperty(curMergedCheckedKeys).call(curMergedCheckedKeys, itemKey => {
+          _forEachInstanceProperty(curResolvedCheckedKeys).call(curResolvedCheckedKeys, itemKey => {
             checkedEntities.push(keyEntities[itemKey]);
           });
 
@@ -748,7 +760,7 @@ export default class CascaderFoundation extends BaseFoundation {
       this._adapter.updateStates({
         checkedKeys: curCheckedKeys,
         halfCheckedKeys: curHalfCheckedKeys,
-        mergedCheckedKeys: curMergedCheckedKeys
+        resolvedCheckedKeys: curResolvedCheckedKeys
       });
     } // The click event during multiple selection will definitely cause the checked state of node to change,
     // so there is no need to judge the value to change.
@@ -911,7 +923,7 @@ export default class CascaderFoundation extends BaseFoundation {
       newState.halfCheckedKeys = new _Set([]);
       newState.selectedKeys = new _Set([]);
       newState.activeKeys = new _Set([]);
-      newState.mergedCheckedKeys = new _Set([]);
+      newState.resolvedCheckedKeys = new _Set([]);
 
       this._adapter.notifyChange([]);
     } else {

package/lib/es/cascader/util.d.ts

@@ -2,3 +2,4 @@ export declare function isValid(val: any): boolean;
 export declare function normalizedArr(val: any): any[];
 export declare function convertDataToEntities(dataNodes: any): any;
 export declare function findKeysForValues(value: any, keyEntities: any): any[];
+export declare function calcMergeType(autoMergeValue: boolean, leafOnly: boolean): string;

package/lib/es/cascader/util.js

@@ -8,6 +8,7 @@ import _forEachInstanceProperty from "@babel/runtime-corejs3/core-js-stable/inst
 import _mapInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/map";
 import _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
 import _Object$values from "@babel/runtime-corejs3/core-js-stable/object/values";
+import { strings } from './constants';
 
 function getPosition(level, index) {
   var _context;
@@ -88,4 +89,17 @@ export function findKeysForValues(value, keyEntities) {
   const res = _mapInstanceProperty(_context2 = _filterInstanceProperty(_context3 = _Object$values(keyEntities)).call(_context3, item => _isEqual(item.valuePath, valuePath))).call(_context2, item => item.key);
 
   return res;
+}
+export function calcMergeType(autoMergeValue, leafOnly) {
+  let mergeType;
+
+  if (leafOnly) {
+    mergeType = strings.LEAF_ONLY_MERGE_TYPE;
+  } else if (autoMergeValue) {
+    mergeType = strings.AUTO_MERGE_VALUE_MERGE_TYPE;
+  } else {
+    mergeType = strings.NONE_MERGE_TYPE;
+  }
+
+  return mergeType;
 }

package/lib/es/datePicker/_utils/parser.d.ts

@@ -1,4 +1,9 @@
+/**
+ * @file
+ * Various date-related analysis methods
+ */
+import { Locale } from 'date-fns';
 /**
  * Parsing value to Date object
  */
-export declare function compatiableParse(value: string, formatToken?: string, baseDate?: Date, locale?: any): Date | null;
+export declare function compatiableParse(value: string, formatToken?: string, baseDate?: Date, locale?: Locale): Date | null;

package/lib/es/datePicker/_utils/parser.js

@@ -26,7 +26,9 @@ export function compatiableParse(value, formatToken, baseDate, locale) {
       result = new Date(Date.parse(value));
     }
 
-    if (!isValid(result)) {
+    const yearInvalid = isValid(result) && String(result.getFullYear()).length > 4;
+
+    if (!isValid(result) || yearInvalid) {
       result = null;
     }
   }

package/lib/es/datePicker/datePicker.css

@@ -1,4 +1,3 @@
-@charset "UTF-8";
 /* shadow */
 /* sizing */
 /* spacing */
@@ -72,6 +71,9 @@
   font-family: "Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "Helvetica Neue", Helvetica, Arial, sans-serif;
   min-height: 24px;
 }
+.semi-datepicker-month-grid[x-panel-yearandmonth-open-type=left] .semi-datepicker-weeks, .semi-datepicker-month-grid[x-panel-yearandmonth-open-type=right] .semi-datepicker-weeks {
+  min-height: 216px;
+}
 .semi-datepicker-panel-yam {
   max-width: 284px;
 }
@@ -96,6 +98,12 @@
   text-align: right;
   background-color: var(--semi-color-fill-0);
 }
+.semi-datepicker-footer .semi-button:first-of-type {
+  margin-right: 12px;
+}
+.semi-datepicker-footer .semi-button:nth-of-type(2) {
+  margin-right: 8px;
+}
 .semi-datepicker-yam {
   position: absolute;
   top: 0;
@@ -561,6 +569,9 @@
 .semi-datepicker-compact .semi-datepicker-month-grid .semi-scrolllist-item-wheel .semi-scrolllist-shade-post {
   margin-top: 17px;
 }
+.semi-datepicker-compact .semi-datepicker-month-grid[x-panel-yearandmonth-open-type=left] .semi-datepicker-weeks, .semi-datepicker-compact .semi-datepicker-month-grid[x-panel-yearandmonth-open-type=right] .semi-datepicker-weeks {
+  min-height: 168px;
+}
 .semi-datepicker-compact.semi-datepicker-panel-yam .semi-scrolllist {
   font-size: 12px;
   line-height: 16px;
@@ -700,6 +711,16 @@
   padding-left: 8px;
   text-align: left;
 }
+.semi-rtl .semi-datepicker-footer .semi-button:first-of-type,
+.semi-portal-rtl .semi-datepicker-footer .semi-button:first-of-type {
+  margin-left: 0;
+  margin-right: 0;
+}
+.semi-rtl .semi-datepicker-footer .semi-button:nth-of-type(2),
+.semi-portal-rtl .semi-datepicker-footer .semi-button:nth-of-type(2) {
+  margin-right: 12px;
+  margin-left: 0;
+}
 .semi-rtl .semi-datepicker-day-offsetrange-start .semi-datepicker-day-main,
 .semi-portal-rtl .semi-datepicker-day-offsetrange-start .semi-datepicker-day-main {
   border-radius: 0 var(--semi-border-radius-small) var(--semi-border-radius-small) 0;
@@ -735,12 +756,20 @@
   margin-right: 8px;
 }
 .semi-rtl .semi-datepicker-navigation .semi-icon-chevron_left,
-.semi-rtl .semi-datepicker-navigation .semi-icon-chevron_right, .semi-rtl .semi-datepicker-yam .semi-icon-chevron_left,
+.semi-rtl .semi-datepicker-navigation .semi-icon-chevron_right,
+.semi-rtl .semi-datepicker-navigation .semi-icon-double_chevron_left,
+.semi-rtl .semi-datepicker-navigation .semi-icon-double_chevron_right, .semi-rtl .semi-datepicker-yam .semi-icon-chevron_left,
 .semi-rtl .semi-datepicker-yam .semi-icon-chevron_right,
+.semi-rtl .semi-datepicker-yam .semi-icon-double_chevron_left,
+.semi-rtl .semi-datepicker-yam .semi-icon-double_chevron_right,
 .semi-portal-rtl .semi-datepicker-navigation .semi-icon-chevron_left,
 .semi-portal-rtl .semi-datepicker-navigation .semi-icon-chevron_right,
+.semi-portal-rtl .semi-datepicker-navigation .semi-icon-double_chevron_left,
+.semi-portal-rtl .semi-datepicker-navigation .semi-icon-double_chevron_right,
 .semi-portal-rtl .semi-datepicker-yam .semi-icon-chevron_left,
-.semi-portal-rtl .semi-datepicker-yam .semi-icon-chevron_right {
+.semi-portal-rtl .semi-datepicker-yam .semi-icon-chevron_right,
+.semi-portal-rtl .semi-datepicker-yam .semi-icon-double_chevron_left,
+.semi-portal-rtl .semi-datepicker-yam .semi-icon-double_chevron_right {
   transform: scaleX(-1);
 }
 .semi-rtl .semi-datepicker-range-input-prefix,

package/lib/es/datePicker/datePicker.scss

@@ -94,6 +94,15 @@ $module: #{$prefix}-datepicker;
                 min-height: $height-datepicker_timepicker_header_min;
             }
         }
+
+        // 为了防止 scrollList 因为 weeks 变化高度发生变化导致年月可能发生滚动
+        // In order to prevent scrollList from scrolling due to changes in the height of weeks, the year and month may be scrolled
+        &[x-panel-yearandmonth-open-type="left"],
+        &[x-panel-yearandmonth-open-type="right"] {
+            .#{$module}-weeks {
+                min-height: 6 * $width-datepicker_day;
+            }
+        }
     }
 
     // 年月选择器
@@ -131,6 +140,17 @@ $module: #{$prefix}-datepicker;
         padding-bottom: $spacing-datepicker_footer-paddingBottom;
         text-align: right;
         background-color: $color-datepicker_footer-bg-default;
+
+        .#{$prefix}-button {
+            // cancel button
+            &:first-of-type {
+                margin-right: $spacing-datepicker_footer_cancel_button-marginRight;
+            }
+            // confirm button
+            &:nth-of-type(2) {
+                margin-right: $spacing-datepicker_footer_confirm_button-marginRight;
+            }
+        }
     }
 
     // 年月选择
@@ -833,6 +853,15 @@ $module: #{$prefix}-datepicker;
                 }
             }
         }
+
+        // 为了防止 scrollList 因为 weeks 变化高度发生变化导致年月可能发生滚动
+        // In order to prevent scrollList from scrolling due to changes in the height of weeks, the year and month may be scrolled
+        &[x-panel-yearandmonth-open-type="left"],
+        &[x-panel-yearandmonth-open-type="right"] {
+            .#{$module}-weeks {
+                min-height: 6 * $width-datepicker_day_compact;
+            }
+        }
     }
 
     // 年月选择器

package/lib/es/datePicker/foundation.d.ts

@@ -201,10 +201,13 @@ export default class DatePickerFoundation extends BaseFoundation<DatePickerAdapt
      *   2. set cachedSelectedValue using given dates(in needConfirm mode)
      *      - directly closePanel without click confirm will set cachedSelectedValue to state value
      *      - select one date(which means that the selection value is incomplete) and click confirm also set cachedSelectedValue to state value
-     * @param {String} inputValue
-     * @param {Date[]} dates
      */
-    rangeTypeSideEffectsWhenClosePanel(inputValue: string, dates: Date[]): void;
+    rangeTypeSideEffectsWhenClosePanel(inputValue: string, willUpdateDates: Date[]): void;
+    /**
+     * clear input value when selected date is not confirmed
+     */
+    needConfirmSideEffectsWhenClosePanel(willUpdateDates: Date[] | null | undefined): void;
+    resetCachedSelectedValue(willUpdateDates?: Date[]): void;
     /**
      * timing to call closePanel
      *  1. click confirm button

package/lib/es/datePicker/foundation.js

@@ -212,12 +212,10 @@ export default class DatePickerFoundation extends BaseFoundation {
    *   2. set cachedSelectedValue using given dates(in needConfirm mode)
    *      - directly closePanel without click confirm will set cachedSelectedValue to state value
    *      - select one date(which means that the selection value is incomplete) and click confirm also set cachedSelectedValue to state value
-   * @param {String} inputValue
-   * @param {Date[]} dates
    */
 
 
-  rangeTypeSideEffectsWhenClosePanel(inputValue, dates) {
+  rangeTypeSideEffectsWhenClosePanel(inputValue, willUpdateDates) {
     if (this._isRangeType()) {
       this._adapter.setRangeInputFocus(false);
       /**
@@ -227,17 +225,36 @@ export default class DatePickerFoundation extends BaseFoundation {
 
 
       this.handleInputBlur(inputValue);
+      this.resetCachedSelectedValue(willUpdateDates);
+    }
+  }
+  /**
+   * clear input value when selected date is not confirmed
+   */
 
-      const {
-        value,
-        cachedSelectedValue
-      } = this._adapter.getStates();
 
-      const newCachedSelectedValue = _Array$isArray(dates) && dates.length ? dates : value;
+  needConfirmSideEffectsWhenClosePanel(willUpdateDates) {
+    if (this._adapter.needConfirm() && !this._isRangeType()) {
+      /**
+       * if `null` input element will show `cachedSelectedValue` formatted value（format in DateInput render）
+       * if `` input element will show `` directly
+       */
+      this._adapter.updateInputValue(null);
 
-      if (!_isEqual(newCachedSelectedValue, cachedSelectedValue)) {
-        this._adapter.updateCachedSelectedValue(newCachedSelectedValue);
-      }
+      this.resetCachedSelectedValue(willUpdateDates);
+    }
+  }
+
+  resetCachedSelectedValue(willUpdateDates) {
+    const {
+      value,
+      cachedSelectedValue
+    } = this._adapter.getStates();
+
+    const newCachedSelectedValue = _Array$isArray(willUpdateDates) ? willUpdateDates : value;
+
+    if (!_isEqual(newCachedSelectedValue, cachedSelectedValue)) {
+      this._adapter.updateCachedSelectedValue(newCachedSelectedValue);
     }
   }
   /**
@@ -256,7 +273,14 @@ export default class DatePickerFoundation extends BaseFoundation {
 
   closePanel(e) {
     let inputValue = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : null;
-    let dates = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
+    let dates = arguments.length > 2 ? arguments[2] : undefined;
+
+    const {
+      value,
+      cachedSelectedValue
+    } = this._adapter.getStates();
+
+    const willUpdateDates = isNullOrUndefined(dates) ? this._adapter.needConfirm() ? value : cachedSelectedValue : dates;
 
     if (!this._isControlledComponent('open')) {
       this._adapter.togglePanel(false);
@@ -265,7 +289,8 @@ export default class DatePickerFoundation extends BaseFoundation {
     } // range type picker, closing panel requires the following side effects
 
 
-    this.rangeTypeSideEffectsWhenClosePanel(inputValue, dates);
+    this.rangeTypeSideEffectsWhenClosePanel(inputValue, willUpdateDates);
+    this.needConfirmSideEffectsWhenClosePanel(willUpdateDates);
 
     this._adapter.notifyOpenChange(false);
 
@@ -327,7 +352,8 @@ export default class DatePickerFoundation extends BaseFoundation {
     if (parsedResult && parsedResult.length) {
       this._updateValueAndInput(parsedResult, input === '');
     } else if (input === '') {
-      this._updateValueAndInput('', true);
+      // if clear input, set input to `''`
+      this._updateValueAndInput('', true, '');
     } else {
       this._updateValueAndInput(stateValue);
     }

package/lib/es/datePicker/inputFoundation.js

@@ -40,6 +40,9 @@ export default class InputFoundation extends BaseFoundation {
   }
 
   handleRangeInputClear(e) {
+    // prevent trigger click outside
+    this.stopPropagation(e);
+
     this._adapter.notifyRangeInputClear(e);
   }
 

package/lib/es/datePicker/monthsGridFoundation.d.ts

@@ -13,6 +13,7 @@ interface MonthsGridElementProps {
     renderFullDate?: () => React.ReactNode;
 }
 export declare type PanelType = 'left' | 'right';
+export declare type YearMonthChangeType = 'prevMonth' | 'nextMonth' | 'prevYear' | 'nextYear';
 export interface MonthsGridFoundationProps extends MonthsGridElementProps {
     type?: Type;
     defaultValue?: ValueType;
@@ -104,11 +105,34 @@ export default class MonthsGridFoundation extends BaseFoundation<MonthsGridAdapt
     _initDateTimePickerFromValue(values: BaseValueType[]): void;
     _initDateTimeRangePickerFormValue(values: BaseValueType[]): void;
     destroy(): void;
+    /**
+     * sync change another panel month when change months from the else yam panel
+     * call it when
+     *  - current change panel targe date month is same with another panel date
+     *
+     * @example
+     *  - panelType=right, target=new Date('2022-09-01') and left panel is in '2022-09' => call it, left panel minus one month to '2022-08'
+     *  - panelType=left, target=new Date('2021-12-01') and right panel is in '2021-12' => call it, right panel add one month to '2021-01'
+     */
+    handleSyncChangeMonths(options: {
+        panelType: PanelType;
+        target: Date;
+    }): void;
+    /**
+     * Get the target date based on the panel type and switch type
+     */
+    getTargetChangeDate(options: {
+        panelType: PanelType;
+        switchType: YearMonthChangeType;
+    }): Date;
+    /**
+     * Change month by yam panel
+     */
     toMonth(panelType: PanelType, target: Date): void;
     toYear(panelType: PanelType, target: Date): void;
     toYearMonth(panelType: PanelType, target: Date): void;
     isRangeType(type?: Type): boolean;
-    handleSwitchMonth(switchType: 'prevMonth' | 'nextMonth', panelType: PanelType): void;
+    handleSwitchMonthOrYear(switchType: YearMonthChangeType, panelType: PanelType): void;
     prevMonth(panelType: PanelType): void;
     nextMonth(panelType: PanelType): void;
     prevYear(panelType: PanelType): void;
@@ -158,13 +182,13 @@ export default class MonthsGridFoundation extends BaseFoundation<MonthsGridAdapt
         notifyValue: any;
         notifyDate: any;
     };
-    handleYearOrMonthChange(type: 'prevMonth' | 'nextMonth' | 'prevYear' | 'nextYear', panelType?: PanelType, step?: number, notSeparateInRange?: boolean): void;
+    handleYearOrMonthChange(type: YearMonthChangeType, panelType?: PanelType, step?: number, notSeparateInRange?: boolean): void;
     /**
      * You have chosen to switch the year and month in the future to directly update the Date without closing the date panel
      * @param {*} type
      * @param {*} targetDate
      */
-    updateDateAfterChangeYM(type: 'prevMonth' | 'nextMonth' | 'prevYear' | 'nextYear', targetDate: Date): void;
+    updateDateAfterChangeYM(type: YearMonthChangeType, targetDate: Date): void;
     _isMultiple(): boolean;
     _isRange(): void;
     handleDayClick(day: MonthDayInfo, panelType: PanelType): void;
@@ -214,5 +238,13 @@ export default class MonthsGridFoundation extends BaseFoundation<MonthsGridAdapt
     showYearPicker(panelType: PanelType): void;
     showTimePicker(panelType: PanelType, opt?: boolean): void;
     showDatePanel(panelType: PanelType): void;
+    /**
+     * Get year and month panel open type
+     *
+     * It is useful info to set minHeight of weeks.
+     *  - When yam open type is 'left' or 'right', weeks minHeight should be set
+     *    If the minHeight is not set, the change of the number of weeks will cause the scrollList to be unstable
+     */
+    getYAMOpenType(): "left" | "right" | "none" | "both";
 }
 export {};