@douyinfe/semi-foundation 2.28.0-beta.0 → 2.28.0

package/lib/es/backtop/foundation.js

@@ -0,0 +1,96 @@
+import BaseFoundation from '../base/foundation';
+import { Animation } from '@douyinfe/semi-animation';
+export default class BackTopFoundation extends BaseFoundation {
+  constructor(adapter) {
+    super(Object.assign({}, adapter));
+
+    this.scrollTo = (targetNode, from, to) => {
+      const {
+        duration
+      } = this.getProps();
+      this.animation = new Animation({
+        from: {
+          scrollTop: from
+        },
+        to: {
+          scrollTop: to
+        }
+      }, {
+        duration,
+        easing: 'easeInOutCubic'
+      });
+      this.animation.on('frame', _ref => {
+        let {
+          scrollTop
+        } = _ref;
+
+        this._adapter.targetScrollToTop(targetNode, scrollTop);
+      });
+      this.animation.start();
+    };
+
+    this.handleScroll = () => {
+      const {
+        target,
+        visibilityHeight
+      } = this.getProps();
+      const targetNode = target();
+
+      const update = () => {
+        const scrollTop = this.getScroll(targetNode);
+
+        this._adapter.updateVisible(scrollTop > visibilityHeight);
+      };
+
+      requestAnimationFrame(update);
+    };
+  }
+
+  init() {
+    const {
+      target
+    } = this.getProps();
+    const targetNode = target();
+    targetNode.addEventListener('scroll', this.handleScroll);
+    this.handleScroll();
+  }
+
+  destroy() {
+    const {
+      target
+    } = this.getProps();
+    const targetNode = target();
+    targetNode && targetNode.removeEventListener('scroll', this.handleScroll);
+    this.animation && this.animation.destroy();
+  }
+
+  getScroll(target) {
+    if (this._adapter.isWindowUndefined()) {
+      return 0;
+    }
+
+    const prop = 'pageYOffset';
+    const method = 'scrollTop';
+
+    const isWindow = this._adapter.targetIsWindow(target);
+
+    const scroll = isWindow ? target[prop] : target[method];
+    return scroll;
+  }
+
+  setScrollTop(to) {
+    const {
+      target
+    } = this.getProps();
+    const targetNode = target();
+    const from = this.getScroll(targetNode);
+    this.scrollTo(targetNode, from, to);
+  }
+
+  onClick(e) {
+    this.setScrollTop(0);
+
+    this._adapter.notifyClick(e);
+  }
+
+}

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

@@ -0,0 +1,10 @@
+declare const cssClasses: {
+    PREFIX: string;
+};
+declare const strings: {
+    TYPE_SET: string[];
+    THEME_SET: string[];
+    POS_SET: string[];
+};
+declare const numbers: {};
+export { cssClasses, strings, numbers };

package/lib/es/badge/constants.js

@@ -0,0 +1,11 @@
+import { BASE_CLASS_PREFIX } from '../base/constants';
+const cssClasses = {
+  PREFIX: `${BASE_CLASS_PREFIX}-badge`
+};
+const strings = {
+  TYPE_SET: ['primary', 'secondary', 'tertiary', 'warning', 'danger'],
+  THEME_SET: ['solid', 'light', 'inverted'],
+  POS_SET: ['leftTop', 'leftBottom', 'rightTop', 'rightBottom']
+};
+const numbers = {};
+export { cssClasses, strings, numbers };

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

@@ -0,0 +1,7 @@
+declare const cssClasses: {
+    PREFIX: string;
+};
+declare const strings: {
+    TYPE: string[];
+};
+export { cssClasses, strings };

package/lib/es/banner/constants.js

@@ -0,0 +1,8 @@
+import { BASE_CLASS_PREFIX } from '../base/constants';
+const cssClasses = {
+  PREFIX: `${BASE_CLASS_PREFIX}-banner`
+};
+const strings = {
+  TYPE: ['info', 'success', 'danger', 'warning']
+};
+export { cssClasses, strings };

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

@@ -0,0 +1,9 @@
+import BaseFoundation, { DefaultAdapter } from '../base/foundation';
+export interface BannerAdapter<P = Record<string, any>, S = Record<string, any>> extends DefaultAdapter<P, S> {
+    setVisible: () => void;
+    notifyClose: (e: any) => void;
+}
+export default class BannerFoundation<P = Record<string, any>, S = Record<string, any>> extends BaseFoundation<BannerAdapter<P, S>, P, S> {
+    constructor(adapter: BannerAdapter<P, S>);
+    removeBanner(e: any): void;
+}

package/lib/es/banner/foundation.js

@@ -0,0 +1,13 @@
+import BaseFoundation from '../base/foundation';
+export default class BannerFoundation extends BaseFoundation {
+  constructor(adapter) {
+    super(Object.assign(Object.assign({}, BannerFoundation.defaultAdapter), adapter));
+  }
+
+  removeBanner(e) {
+    this._adapter.notifyClose(e);
+
+    this._adapter.setVisible();
+  }
+
+}

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

@@ -0,0 +1,3 @@
+import { BASE_CLASS_PREFIX } from './env';
+declare const VALIDATE_STATUS: readonly ["default", "error", "warning", "success"];
+export { BASE_CLASS_PREFIX, VALIDATE_STATUS };

package/lib/es/base/constants.js

@@ -0,0 +1,4 @@
+import { BASE_CLASS_PREFIX } from './env';
+const VALIDATE_STATUS = ['default', 'error', 'warning', 'success']; // const VALIDATE_STATUS = ['default', 'error', 'warning', 'success', 'validating'] as const;
+
+export { BASE_CLASS_PREFIX, VALIDATE_STATUS };

package/lib/es/base/env.d.ts

@@ -0,0 +1 @@
+export declare const BASE_CLASS_PREFIX = "semi";

package/lib/es/base/env.js

@@ -0,0 +1 @@
+export const BASE_CLASS_PREFIX = 'semi';

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

@@ -0,0 +1,62 @@
+/**
+ * The Semi Foundation / Adapter architecture split was inspired by Material Component For Web. （https://github.com/material-components/material-components-web）
+ * We re-implemented our own code based on the principle and added more functions we need according to actual needs.
+ *
+ */
+export declare type noopFunction = (...args: any) => any;
+export interface DefaultAdapter<P = Record<string, any>, S = Record<string, any>> {
+    getContext(key: string): any;
+    getContexts(): any;
+    getProp(key: string): any;
+    getProps(): P;
+    getState(key: string): any;
+    getStates(): S;
+    setState<K extends keyof S>(s: Pick<S, K>, callback?: any): void;
+    getCache(c: string): any;
+    getCaches(): any;
+    setCache(key: any, value: any): void;
+    stopPropagation(e: any): void;
+    persistEvent: (event: any) => void;
+}
+declare class BaseFoundation<T extends Partial<DefaultAdapter<P, S>>, P = Record<string, any>, S = Record<string, any>> {
+    /** @return enum{css className} */
+    static get cssClasses(): {};
+    /** @return enum{strings} */
+    static get strings(): {};
+    /** @return enum{numbers} */
+    static get numbers(): {};
+    static get defaultAdapter(): {
+        getProp: (...args: any[]) => void;
+        getProps: (...args: any[]) => void;
+        getState: (...args: any[]) => void;
+        getStates: (...args: any[]) => void;
+        setState: (...args: any[]) => void;
+        getContext: (...args: any[]) => void;
+        getContexts: (...args: any[]) => void;
+        getCache: (...args: any[]) => void;
+        setCache: (...args: any[]) => void;
+        getCaches: (...args: any[]) => void;
+        stopPropagation: (...args: any[]) => void;
+        persistEvent: (...args: any[]) => void;
+    };
+    _adapter: T;
+    constructor(adapter: T);
+    getProp(key: string): any;
+    getProps(): any;
+    getState(key: string): any;
+    getStates(): any;
+    setState<K extends keyof S>(states: Pick<S, K>, cb?: (...args: any) => void): void;
+    getContext(key: string): any;
+    getContexts(): any;
+    getCaches(): any;
+    getCache(key: string): any;
+    setCache(key: string, value: any): void;
+    stopPropagation(e: any): void;
+    _isControlledComponent(key?: string): boolean;
+    _isInProps(key: string): boolean;
+    init(lifecycle?: any): void;
+    destroy(): void;
+    log(text: string, ...rest: any): void;
+    _persistEvent(e: any): void;
+}
+export default BaseFoundation;

package/lib/es/base/foundation.js

@@ -0,0 +1,147 @@
+import _noop from "lodash/noop";
+
+/**
+ * The Semi Foundation / Adapter architecture split was inspired by Material Component For Web. （https://github.com/material-components/material-components-web）
+ * We re-implemented our own code based on the principle and added more functions we need according to actual needs.
+ *
+ */
+import log from '../utils/log';
+
+class BaseFoundation {
+  constructor(adapter) {
+    this._adapter = Object.assign(Object.assign({}, BaseFoundation.defaultAdapter), adapter);
+  }
+  /** @return enum{css className} */
+
+  /* istanbul ignore next */
+
+
+  static get cssClasses() {
+    // Classes extending Foundation should implement this method to return an object which exports every
+    // CSS class the foundation class needs as a property. e.g. {ACTIVE: 'component--active'}
+    return {};
+  }
+  /** @return enum{strings} */
+
+  /* istanbul ignore next */
+
+
+  static get strings() {
+    // Classes extending Foundation should implement this method to return an object which exports all
+    // semantic strings as constants. e.g. {ARIA_ROLE: 'tablist'}
+    return {};
+  }
+  /** @return enum{numbers} */
+
+  /* istanbul ignore next */
+
+
+  static get numbers() {
+    // Classes extending Foundation should implement this method to return an object which exports all
+    // of its semantic numbers as constants. e.g. {ANIMATION_DELAY_MS: 350}
+    return {};
+  }
+
+  static get defaultAdapter() {
+    return {
+      getProp: _noop,
+      getProps: _noop,
+      getState: _noop,
+      getStates: _noop,
+      setState: _noop,
+      getContext: _noop,
+      getContexts: _noop,
+      getCache: _noop,
+      setCache: _noop,
+      getCaches: _noop,
+      stopPropagation: _noop,
+      persistEvent: _noop
+    };
+  }
+
+  getProp(key) {
+    return this._adapter.getProp(key);
+  }
+
+  getProps() {
+    return this._adapter.getProps();
+  }
+
+  getState(key) {
+    return this._adapter.getState(key);
+  }
+
+  getStates() {
+    return this._adapter.getStates();
+  }
+
+  setState(states, cb) {
+    return this._adapter.setState(Object.assign({}, states), cb);
+  }
+
+  getContext(key) {
+    return this._adapter.getContext(key);
+  }
+  /* istanbul ignore next */
+
+
+  getContexts() {
+    return this._adapter.getContexts();
+  }
+  /* istanbul ignore next */
+
+
+  getCaches() {
+    return this._adapter.getCaches();
+  }
+
+  getCache(key) {
+    return this._adapter.getCache(key);
+  }
+
+  setCache(key, value) {
+    return key && this._adapter.setCache(key, value);
+  }
+
+  stopPropagation(e) {
+    this._adapter.stopPropagation(e);
+  } // Determine whether a controlled component
+
+
+  _isControlledComponent() {
+    let key = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'value';
+    const props = this.getProps();
+    const isControlComponent = (key in props);
+    return isControlComponent;
+  } // Does the user have incoming props, eg: _isInProps (value)
+
+
+  _isInProps(key) {
+    const props = this.getProps();
+    return key in props;
+  }
+
+  init(lifecycle) {// Subclasses should override this method to perform initialization routines (registering events, etc.)
+  }
+
+  destroy() {// Subclasses should override this method to perform de-initialization routines (de-registering events, etc.)
+  }
+  /* istanbul ignore next */
+
+
+  log(text) {
+    for (var _len = arguments.length, rest = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+      rest[_key - 1] = arguments[_key];
+    }
+
+    log(text, ...rest);
+  }
+
+  _persistEvent(e) {
+    // only work for react adapter for now
+    this._adapter.persistEvent(e);
+  }
+
+}
+
+export default BaseFoundation;

package/lib/es/base/index.d.ts

@@ -0,0 +1,5 @@
+import BaseFoundation from './foundation';
+declare const _default: {
+    BaseFoundation: typeof BaseFoundation;
+};
+export default _default;

package/lib/es/base/index.js

@@ -0,0 +1,4 @@
+import BaseFoundation from './foundation';
+export default {
+  BaseFoundation
+};

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

@@ -0,0 +1,7 @@
+declare const cssClasses: {
+    PREFIX: string;
+};
+declare const strings: {
+    MORE_TYPE: string[];
+};
+export { cssClasses, strings };

package/lib/es/breadcrumb/constants.js

@@ -0,0 +1,8 @@
+import { BASE_CLASS_PREFIX } from '../base/constants';
+const cssClasses = {
+  PREFIX: `${BASE_CLASS_PREFIX}-breadcrumb`
+};
+const strings = {
+  MORE_TYPE: ['default', 'popover']
+};
+export { cssClasses, strings };

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

@@ -0,0 +1,28 @@
+import BaseFoundation, { DefaultAdapter } from '../base/foundation';
+import { BreadcrumbItemInfo, Route } from './itemFoundation';
+export interface BreadcrumbAdapter<P = Record<string, any>, S = Record<string, any>> extends DefaultAdapter<P, S> {
+    notifyClick: (itemInfo: BreadcrumbItemInfo, event: any) => void;
+    expandCollapsed: (clickEvent?: any) => void;
+}
+export default class BreadcrumbFoundation<P = Record<string, any>, S = Record<string, any>> extends BaseFoundation<BreadcrumbAdapter<P, S>, P, S> {
+    constructor(adapter: BreadcrumbAdapter<P, S>);
+    handleClick(info: BreadcrumbItemInfo, event: any): void;
+    handleExpand(clickEvent: any): void;
+    /**
+     * A11y: simulate clear button click
+     */
+    handleExpandEnterPress(keyboardEvent: any): void;
+    genRoutes(routes: Array<Route>): ({
+        name: never;
+        _origin: {
+            name: never;
+        };
+    } | {
+        [x: string]: any;
+        path?: string;
+        href?: string;
+        name?: string;
+        icon?: any;
+        _origin?: undefined;
+    })[];
+}

package/lib/es/breadcrumb/foundation.js

@@ -0,0 +1,44 @@
+/* eslint-disable prefer-const */
+import BaseFoundation from '../base/foundation';
+import isEnterPress from '../utils/isEnterPress';
+export default class BreadcrumbFoundation extends BaseFoundation {
+  constructor(adapter) {
+    super(Object.assign({}, adapter));
+  }
+
+  handleClick(info, event) {
+    this._adapter.notifyClick(info, event);
+  }
+
+  handleExpand(clickEvent) {
+    this._adapter.expandCollapsed(clickEvent);
+  }
+  /**
+   * A11y: simulate clear button click
+   */
+
+
+  handleExpandEnterPress(keyboardEvent) {
+    if (isEnterPress(keyboardEvent)) {
+      this.handleExpand(keyboardEvent);
+    }
+  }
+
+  genRoutes(routes) {
+    return routes.map(route => {
+      if (typeof route !== 'object') {
+        return {
+          name: route,
+          _origin: {
+            name: route
+          }
+        };
+      }
+
+      let config = {};
+      config._origin = route;
+      return Object.assign(Object.assign({}, config), route);
+    });
+  }
+
+}

package/lib/es/breadcrumb/itemFoundation.d.ts

@@ -0,0 +1,22 @@
+import BaseFoundation, { DefaultAdapter } from '../base/foundation';
+export interface BreadcrumbItemInfo {
+    name?: any;
+    href?: string;
+    icon?: any;
+    path?: string;
+}
+export interface Route {
+    [x: string]: any;
+    path?: string;
+    href?: string;
+    name?: string;
+    icon?: any;
+}
+export interface BreadcrumbItemAdapter<P = Record<string, any>, S = Record<string, any>> extends DefaultAdapter<P, S> {
+    notifyClick: (item: BreadcrumbItemInfo, e: any) => void;
+    notifyParent: (item: BreadcrumbItemInfo, e: any) => void;
+}
+export default class BreadcrumbItemFoundation<P = Record<string, any>, S = Record<string, any>> extends BaseFoundation<BreadcrumbItemAdapter<P, S>, P, S> {
+    constructor(adapter: BreadcrumbItemAdapter<P, S>);
+    handleClick(item: BreadcrumbItemInfo, e: any): void;
+}

package/lib/es/breadcrumb/itemFoundation.js

@@ -0,0 +1,14 @@
+import BaseFoundation from '../base/foundation';
+export default class BreadcrumbItemFoundation extends BaseFoundation {
+  constructor(adapter) {
+    super(Object.assign({}, adapter));
+  }
+
+  handleClick(item, e) {
+    // Trigger its own onClick first, then trigger the parent
+    this._adapter.notifyClick(item, e);
+
+    this._adapter.notifyParent(item, e);
+  }
+
+}

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

@@ -0,0 +1,14 @@
+declare const cssClasses: {
+    PREFIX: string;
+};
+declare const strings: {
+    readonly sizes: readonly ["default", "small", "large"];
+    readonly iconPositions: readonly ["left", "right"];
+    readonly htmlTypes: readonly ["button", "reset", "submit"];
+    readonly btnTypes: readonly ["primary", "secondary", "tertiary", "warning", "danger"];
+    readonly themes: readonly ["solid", "borderless", "light"];
+    readonly DEFAULT_ICON_SIZE: "default";
+    readonly DEFAULT_ICON_POSITION: "left";
+};
+declare const numbers: {};
+export { cssClasses, strings, numbers };

package/lib/es/button/constants.js

@@ -0,0 +1,15 @@
+import { BASE_CLASS_PREFIX } from '../base/constants';
+const cssClasses = {
+  PREFIX: `${BASE_CLASS_PREFIX}-button`
+};
+const strings = {
+  sizes: ['default', 'small', 'large'],
+  iconPositions: ['left', 'right'],
+  htmlTypes: ['button', 'reset', 'submit'],
+  btnTypes: ['primary', 'secondary', 'tertiary', 'warning', 'danger'],
+  themes: ['solid', 'borderless', 'light'],
+  DEFAULT_ICON_SIZE: 'default',
+  DEFAULT_ICON_POSITION: 'left'
+};
+const numbers = {};
+export { cssClasses, strings, numbers };

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

@@ -0,0 +1,7 @@
+declare const cssClasses: {
+    PREFIX: string;
+};
+declare const strings: {
+    readonly MODE: readonly ["day", "week", "month", "range"];
+};
+export { cssClasses, strings };

package/lib/es/calendar/constants.js

@@ -0,0 +1,8 @@
+import { BASE_CLASS_PREFIX } from '../base/constants';
+const cssClasses = {
+  PREFIX: `${BASE_CLASS_PREFIX}-calendar`
+};
+const strings = {
+  MODE: ['day', 'week', 'month', 'range']
+};
+export { cssClasses, strings };

package/lib/es/calendar/eventUtil.d.ts

@@ -0,0 +1,94 @@
+import { Locale } from 'date-fns';
+import { EventObject, ParsedRangeEvent } from './foundation';
+export declare const sortDate: (a: Date | string, b: Date | string) => 1 | -1;
+export declare const checkWeekend: (val: Date) => boolean;
+export declare const getCurrDate: () => Date;
+export declare const round: (value: number) => number;
+export declare const getPos: (value: Date | number) => number;
+export declare const isAllDayEvent: (event: EventObject) => boolean;
+/**
+ *
+ * @param {object} event
+ * normalize event object:
+ * if event object does not have start time, add start time = end time - 1h; if not same day, then startday of the end
+ * if event object does not have end time, add end time = start time + 1h; if not same day, then endday of the start
+ */
+export declare const amendEvent: (event: EventObject) => EventObject;
+/**
+ *
+ * @param {arr} events
+ * find the max topInd and used as row height
+ */
+export declare const calcRowHeight: (events: ParsedRangeEvent[]) => number;
+export interface DateObj {
+    ind: number;
+    date: Date;
+    dayString: string;
+    weekday: string;
+    isToday: boolean;
+    isWeekend: boolean;
+    isSameMonth: boolean;
+    month: string;
+}
+export declare type weeekStartsOnEnum = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+export declare const calcRangeData: (value: Date, start: Date, rangeLen: number, mode: string, locale: Locale, weekStartsOn: weeekStartsOnEnum) => DateObj[];
+/**
+ *
+ * @param {value} date
+ * @param {string} mode
+ * @param {string} locale
+ * @returns {object[]} { date: Date, dayString: string, ind: number, isToday: boolean, isWeekend: boolean, weekday: string }
+ * create weekly object array
+ */
+export declare const calcWeekData: (value: Date, mode: string, locale: Locale, weekStartsOn: weeekStartsOnEnum) => DateObj[];
+/**
+ *
+ * @param {object} event
+ * @param {boolean} allDay
+ * @returns {object[]} { allDay: boolean, data: Date, start: Date, end: Date, children: ReactNode }
+ * parsed a spanned all-day event into multiple dates
+ */
+export declare const parseAllDayEvent: (event: EventObject, allDay?: boolean, currDate?: Date) => any[];
+/**
+ *
+ * @param {object} event
+ * @returns {object[]} { allDay: boolean, data: Date, start: Date, end: Date, children: ReactNode }
+ * parsed events
+ */
+export declare const parseEvent: (event: EventObject) => any[];
+/**
+ *
+ * @param {arr} arr
+ * @param  {key}
+ * @param {function} func callback function
+ * @returns {map}
+ * convert events array to may, use datestring as key
+ */
+export declare const convertEventsArrToMap: (arr: EventObject[], key: 'start' | 'date', func: (val: Date) => Date, displayValue?: Date) => Map<any, any>;
+/**
+ * @returns {arr}
+ * filter out event that is not in the date range
+ */
+export declare const filterEvents: (events: Map<string, EventObject[]>, start: Date, end: Date) => Map<string, EventObject[]>;
+/**
+ * @returns {arr}
+ * filter out event that is not in the week range
+ */
+export declare const filterWeeklyEvents: (events: Map<string, EventObject[]>, weekStart: Date, weekStartsOn: weeekStartsOnEnum) => Map<string, EventObject[]>;
+/**
+ * @returns {arr}
+ * arrange and sort all day event for a range
+ */
+export declare const parseRangeAllDayEvent: (event: EventObject[], startDate: Date, rangeStart: Date, rangeEnd: Date, parsed: Array<Array<ParsedRangeEvent>>) => ParsedRangeEvent[][];
+/**
+ * @returns {arr}
+ * arrange and sort weekly all day event
+ */
+export declare const parseWeeklyAllDayEvent: (event: EventObject[], startDate: Date, weekStart: Date, parsed: Array<Array<ParsedRangeEvent>>, weekStartsOn: weeekStartsOnEnum) => ParsedRangeEvent[][];
+export declare const collectDailyEvents: (events: ParsedRangeEvent[][]) => ParsedRangeEvent[][];
+export declare const renderDailyEvent: (event: EventObject) => {
+    startPos: number;
+    endPos: number;
+    children: any;
+    allDay: boolean;
+};