@pisell/materials 6.11.16 → 6.11.18

package/es/components/pisellRecordBoard/utils/recordBoardColumns.d.ts

@@ -0,0 +1,41 @@
+import type { RecordBoardColumnType } from '../types';
+import type { FilterValueType } from '../../filter/components/FilterButton/types';
+import type { SortItemProps } from '../../sort/types';
+/** 获取列唯一 key，供列显示隐藏等使用 */
+export declare function getRecordBoardColumnKey(column: RecordBoardColumnType): string;
+export interface UniformColumnSummaryItem {
+    columnKey: string;
+    title: string;
+    type: 'uniform' | 'empty';
+    /** 无 render 时的回退展示 */
+    displayValue?: string;
+    /** 仅用于判断是否相等的值（uniformCompare 的返回值或 dataIndex 取值），不参与 render */
+    value?: any;
+    /** 表格里该列单元格的值（dataIndex 从 record 取值），传给 render 的与表格单元格一致 */
+    cellValue?: any;
+    /** 代表行（如首行），供列 render 使用 */
+    record?: any;
+}
+/**
+ * 根据当前页 data 计算：哪些列「全列同值」或「全空」应隐藏，以及总结区展示项。
+ * 仅当 grid.collapseUniformColumns 为 true 时使用。
+ */
+export declare function computeUniformColumnSummary(data: any[], columns: RecordBoardColumnType[]): {
+    uniformHiddenColumnKeys: string[];
+    summaryItems: UniformColumnSummaryItem[];
+};
+/**
+ * 处理列配置：对带 type 的列注入基于 Pisell 组件的 render，其余列保持不变。
+ * 有 type 时若列上传入了 render 则优先使用（覆盖自动派生）。
+ */
+export declare function processColumnsForGrid<RecordType = any>(columns: RecordBoardColumnType<RecordType>[] | undefined): RecordBoardColumnType<RecordType>[];
+/**
+ * 从 columns 派生排序列表（SortItemProps[]）。
+ * 有 type 的列：根据组件 SortOptions（或默认）生成；无 type 的列：根据 sortable + sort 生成。
+ */
+export declare function deriveSortFromColumns(columns: RecordBoardColumnType[] | undefined): SortItemProps[];
+/**
+ * 从 columns 派生 filter 列表（quickFilter + otherFilter）。
+ * 有 type 的列：根据 type + fieldProps 生成筛选项；无 type 的列：根据 filterable + filter 生成。
+ */
+export declare function deriveFilterFromColumns(columns: RecordBoardColumnType[] | undefined): FilterValueType;

package/es/components/pisellRecordBoard/utils/withRecordBoard.d.ts

@@ -0,0 +1,9 @@
+import React, { ComponentType } from 'react';
+import type { RecordBoardContextValue, RecordBoardChildComponentProps } from '../types';
+declare type RecordBoardDisplayName = keyof RecordBoardChildComponentProps;
+/**
+ * 为 RecordBoard 下的子组件注入 context，并合并 childComponentProps[displayName]。
+ * 用于 Search / ToolBar / Pagination / Grid / CardList 等「被接管」的通用组件封装。
+ */
+declare function withRecordBoard<P extends object, R = any>(WrappedComponent: ComponentType<P & RecordBoardContextValue>, displayName: RecordBoardDisplayName): React.ForwardRefExoticComponent<React.PropsWithoutRef<P> & React.RefAttributes<R>>;
+export default withRecordBoard;

package/es/components/pisellReservationSchedule/PisellReservationSchedule.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { PisellReservationScheduleProps } from './types';
+import './PisellReservationSchedule.less';
+/**
+ * 营业日导航条：上一日、中间日期文案、下一日（深色条样式，适配预约顶栏）
+ */
+export declare function PisellReservationSchedule(props: PisellReservationScheduleProps): React.JSX.Element;
+export declare namespace PisellReservationSchedule {
+    var displayName: string;
+}

package/es/components/pisellReservationSchedule/PisellReservationSchedule.js

@@ -0,0 +1,156 @@
+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 React, { useMemo, useCallback, useState } from 'react';
+import dayjs from 'dayjs';
+import classNames from 'classnames';
+import { Modal } from 'antd';
+import { DateCalendar } from '@pisell/date-picker';
+import ChevronLeft from '@pisell/icon/es/ChevronLeft';
+import ChevronRight from '@pisell/icon/es/ChevronRight';
+import { locales } from '@pisell/utils';
+import useEngineContext from "../../hooks/useEngineContext";
+import pisellReservationScheduleLocales from "./locales";
+import "./PisellReservationSchedule.less";
+var I18N_TODAY = 'pisell-reservation-schedule.today';
+var I18N_PREV = 'pisell-reservation-schedule.prev';
+var I18N_NEXT = 'pisell-reservation-schedule.next';
+var I18N_PICK_DATE = 'pisell-reservation-schedule.pick-date';
+var I18N_PICK_DATE_TITLE = 'pisell-reservation-schedule.pick-date-title';
+function parseDay(input, fallback) {
+  if (input == null) return fallback.startOf('day');
+  var d = dayjs(input);
+  return (d.isValid() ? d : fallback).startOf('day');
+}
+function toDayjsLocale(engineLocale) {
+  if (!engineLocale || engineLocale === 'en') return 'en';
+  if (engineLocale === 'zh-HK') return 'zh-hk';
+  return 'zh-cn';
+}
+
+/**
+ * 营业日导航条：上一日、中间日期文案、下一日（深色条样式，适配预约顶栏）
+ */
+export function PisellReservationSchedule(props) {
+  var _context$engine;
+  var valueProp = props.value,
+    onChange = props.onChange,
+    defaultValue = props.defaultValue,
+    minDateProp = props.minDate,
+    maxDateProp = props.maxDate,
+    _props$navigationLock = props.navigationLocked,
+    navigationLocked = _props$navigationLock === void 0 ? false : _props$navigationLock,
+    className = props.className,
+    style = props.style;
+  var context = useEngineContext();
+  var engineLocale = (context === null || context === void 0 || (_context$engine = context.engine) === null || _context$engine === void 0 || (_context$engine = _context$engine.props) === null || _context$engine === void 0 ? void 0 : _context$engine.locale) || 'en';
+  locales.init(pisellReservationScheduleLocales, engineLocale);
+  var today = useMemo(function () {
+    return dayjs().startOf('day');
+  }, []);
+  var isControlled = valueProp !== undefined;
+  var _useState = useState(function () {
+      return parseDay(valueProp !== null && valueProp !== void 0 ? valueProp : defaultValue, today);
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    internal = _useState2[0],
+    setInternal = _useState2[1];
+  var value = isControlled ? parseDay(valueProp, today) : internal;
+  var minDate = useMemo(function () {
+    return minDateProp != null ? parseDay(minDateProp, today) : undefined;
+  }, [minDateProp, today]);
+  var maxDate = useMemo(function () {
+    return maxDateProp != null ? parseDay(maxDateProp, today) : undefined;
+  }, [maxDateProp, today]);
+  var emit = useCallback(function (next) {
+    var d = next.startOf('day');
+    if (minDate && d.isBefore(minDate)) d = minDate;
+    if (maxDate && d.isAfter(maxDate)) d = maxDate;
+    if (!isControlled) setInternal(d);
+    onChange === null || onChange === void 0 || onChange(d);
+  }, [isControlled, onChange, minDate, maxDate]);
+  var prevDisabled = navigationLocked || (minDate ? value.isSame(minDate, 'day') : false);
+  var nextDisabled = navigationLocked || (maxDate ? value.isSame(maxDate, 'day') : false);
+  var _useState3 = useState(false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    calendarOpen = _useState4[0],
+    setCalendarOpen = _useState4[1];
+  var centerLabel = useMemo(function () {
+    var djLoc = toDayjsLocale(engineLocale);
+    var dl = value.locale(djLoc);
+    var isToday = value.isSame(today, 'day');
+    var todayText = locales.getText(I18N_TODAY);
+    var dateStr = djLoc === 'en' ? dl.format('MMM D') : dl.format('M月D日');
+    var weekStr = dl.format('ddd');
+    var parts = [];
+    if (isToday && todayText) parts.push(todayText);
+    parts.push(dateStr);
+    parts.push(weekStr);
+    return parts.join(djLoc === 'en' ? ' · ' : ' · ');
+  }, [value, today, engineLocale]);
+  return /*#__PURE__*/React.createElement("div", {
+    className: classNames('pisell-reservation-schedule', className),
+    style: style
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "pisell-reservation-schedule-inner"
+  }, /*#__PURE__*/React.createElement("button", {
+    type: "button",
+    className: "pisell-reservation-schedule-btn",
+    "aria-label": locales.getText(I18N_PREV),
+    disabled: prevDisabled,
+    onClick: function onClick() {
+      if (navigationLocked) return;
+      emit(value.subtract(1, 'day'));
+    }
+  }, /*#__PURE__*/React.createElement(ChevronLeft, {
+    className: "pisell-reservation-schedule-btn-icon"
+  })), navigationLocked ? /*#__PURE__*/React.createElement("span", {
+    className: "pisell-reservation-schedule-label pisell-reservation-schedule-label--static",
+    "aria-label": centerLabel
+  }, centerLabel) : /*#__PURE__*/React.createElement("button", {
+    type: "button",
+    className: "pisell-reservation-schedule-label pisell-reservation-schedule-label-trigger",
+    "aria-label": locales.getText(I18N_PICK_DATE),
+    "aria-haspopup": "dialog",
+    "aria-expanded": calendarOpen,
+    onClick: function onClick() {
+      return setCalendarOpen(true);
+    }
+  }, centerLabel), /*#__PURE__*/React.createElement("button", {
+    type: "button",
+    className: "pisell-reservation-schedule-btn",
+    "aria-label": locales.getText(I18N_NEXT),
+    disabled: nextDisabled,
+    onClick: function onClick() {
+      if (navigationLocked) return;
+      emit(value.add(1, 'day'));
+    }
+  }, /*#__PURE__*/React.createElement(ChevronRight, {
+    className: "pisell-reservation-schedule-btn-icon"
+  }))), /*#__PURE__*/React.createElement(Modal, {
+    title: locales.getText(I18N_PICK_DATE_TITLE),
+    open: !navigationLocked && calendarOpen,
+    onCancel: function onCancel() {
+      return setCalendarOpen(false);
+    },
+    footer: null,
+    width: "auto",
+    centered: true,
+    destroyOnClose: true,
+    wrapClassName: "pisell-reservation-schedule-date-modal"
+  }, /*#__PURE__*/React.createElement(DateCalendar, {
+    value: value,
+    minDate: minDate,
+    maxDate: maxDate,
+    onChange: function onChange(d) {
+      if (d) {
+        emit(dayjs(d));
+        setCalendarOpen(false);
+      }
+    }
+  })));
+}
+PisellReservationSchedule.displayName = 'PisellReservationSchedule';

package/es/components/pisellReservationSchedule/PisellReservationSchedule.less

@@ -0,0 +1,88 @@
+.pisell-reservation-schedule {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+}
+
+.pisell-reservation-schedule-inner {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  max-width: 100%;
+  padding: 6px 10px;
+  border-radius: 8px;
+  background: rgba(255, 255, 255, 0.1);
+  box-sizing: border-box;
+}
+
+.pisell-reservation-schedule-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+  padding: 0;
+  margin: 0;
+  border: none;
+  border-radius: 8px;
+  background: rgba(255, 255, 255, 0.08);
+  color: rgba(255, 255, 255, 0.85);
+  cursor: pointer;
+  flex-shrink: 0;
+
+  &:hover:not(:disabled) {
+    background: rgba(255, 255, 255, 0.14);
+    color: #fff;
+  }
+
+  &:disabled {
+    opacity: 0.35;
+    cursor: not-allowed;
+  }
+}
+
+.pisell-reservation-schedule-btn-icon {
+  width: 16px;
+  height: 16px;
+}
+
+.pisell-reservation-schedule-label {
+  flex: 1;
+  min-width: 0;
+  padding: 0 12px;
+  font-size: 15px;
+  font-weight: 500;
+  line-height: 1.35;
+  color: rgba(255, 255, 255, 0.92);
+  text-align: center;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.pisell-reservation-schedule-label--static {
+  cursor: default;
+}
+
+.pisell-reservation-schedule-label-trigger {
+  margin: 0;
+  border: none;
+  background: transparent;
+  cursor: pointer;
+  font-size: inherit;
+  font-weight: inherit;
+  line-height: inherit;
+  color: rgba(255, 255, 255, 0.92);
+  width: 100%;
+
+  &:hover {
+    color: #fff;
+  }
+
+  &:focus-visible {
+    outline: 2px solid rgba(255, 255, 255, 0.45);
+    outline-offset: 2px;
+    border-radius: 4px;
+  }
+}

package/es/components/pisellReservationSchedule/PisellReservationSchedule.stories.d.ts

@@ -0,0 +1,12 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellReservationSchedule } from './PisellReservationSchedule';
+/**
+ * PisellReservationSchedule：预约营业日导航（上一天 / 日期文案 / 下一天）。
+ * 多语言与日期格式依赖 LowCode 引擎 locale。详见组件目录下 docs/PisellReservationSchedule.md。
+ */
+declare const meta: Meta<typeof PisellReservationSchedule>;
+export default meta;
+declare type Story = StoryObj<typeof PisellReservationSchedule>;
+export declare const Default: Story;
+export declare const WithMinMax: Story;
+export declare const Controlled: Story;

package/es/components/pisellReservationSchedule/PisellReservationSchedule.stories.js

@@ -0,0 +1,105 @@
+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 React, { useState } from 'react';
+import dayjs from 'dayjs';
+import { PisellReservationSchedule } from "./PisellReservationSchedule";
+
+/**
+ * PisellReservationSchedule：预约营业日导航（上一天 / 日期文案 / 下一天）。
+ * 多语言与日期格式依赖 LowCode 引擎 locale。详见组件目录下 docs/PisellReservationSchedule.md。
+ */
+var meta = {
+  title: 'Data Entry/PisellReservationSchedule',
+  component: PisellReservationSchedule,
+  tags: ['autodocs'],
+  parameters: {
+    layout: 'padded',
+    docs: {
+      description: {
+        component: '深色圆角营业日条：左右切换日历日，中间展示「今天（若当日）· 日期 · 星期」。可与 PisellTimeNavigator 组合为 PisellReservationScheduleBand。支持受控 `value` / `onChange(dayjs)`，以及 `minDate` / `maxDate`。'
+      }
+    }
+  },
+  argTypes: {
+    value: {
+      description: '当前选中日（受控），dayjs 或可解析字符串',
+      control: 'text'
+    },
+    defaultValue: {
+      description: '非受控初始日',
+      control: 'text'
+    },
+    minDate: {
+      description: '不可早于该日（含）',
+      control: 'text'
+    },
+    maxDate: {
+      description: '不可晚于该日（含）',
+      control: 'text'
+    },
+    onChange: {
+      action: 'onChange',
+      description: '选中日变更，参数为 Dayjs（当日 0 点）'
+    },
+    className: {
+      control: 'text'
+    }
+  }
+};
+export default meta;
+export var Default = {
+  args: {
+    defaultValue: dayjs().format('YYYY-MM-DD')
+  },
+  decorators: [function (StoryComp) {
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        maxWidth: 440
+      }
+    }, /*#__PURE__*/React.createElement(StoryComp, null));
+  }]
+};
+export var WithMinMax = {
+  args: {
+    defaultValue: dayjs().format('YYYY-MM-DD'),
+    minDate: dayjs().startOf('day'),
+    maxDate: dayjs().add(14, 'day').endOf('day')
+  },
+  decorators: [function (StoryComp) {
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        maxWidth: 440
+      }
+    }, /*#__PURE__*/React.createElement(StoryComp, null));
+  }]
+};
+export var Controlled = {
+  render: function ControlledRender() {
+    var _useState = useState(dayjs().startOf('day')),
+      _useState2 = _slicedToArray(_useState, 2),
+      value = _useState2[0],
+      setValue = _useState2[1];
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        maxWidth: 440
+      }
+    }, /*#__PURE__*/React.createElement(PisellReservationSchedule, {
+      value: value,
+      onChange: function onChange(d) {
+        setValue(d);
+        // eslint-disable-next-line no-console
+        console.log('onChange', d.format('YYYY-MM-DD'));
+      }
+    }), /*#__PURE__*/React.createElement("p", {
+      style: {
+        marginTop: 12,
+        fontSize: 12,
+        color: '#666'
+      }
+    }, "\u5F53\u524D\uFF1A", value.format('YYYY-MM-DD dddd')));
+  }
+};

package/es/components/pisellReservationSchedule/index.d.ts

@@ -0,0 +1,2 @@
+export { PisellReservationSchedule } from './PisellReservationSchedule';
+export type { PisellReservationScheduleProps, ReservationScheduleValue, } from './types';

package/es/components/pisellReservationSchedule/index.js

@@ -0,0 +1 @@
+export { PisellReservationSchedule } from "./PisellReservationSchedule";

package/es/components/pisellReservationSchedule/locales.d.ts

@@ -0,0 +1,25 @@
+/** PisellReservationSchedule 多语言；使用前 locales.init 合并 */
+declare const _default: {
+    en: {
+        'pisell-reservation-schedule.today': string;
+        'pisell-reservation-schedule.prev': string;
+        'pisell-reservation-schedule.next': string;
+        'pisell-reservation-schedule.pick-date': string;
+        'pisell-reservation-schedule.pick-date-title': string;
+    };
+    'zh-CN': {
+        'pisell-reservation-schedule.today': string;
+        'pisell-reservation-schedule.prev': string;
+        'pisell-reservation-schedule.next': string;
+        'pisell-reservation-schedule.pick-date': string;
+        'pisell-reservation-schedule.pick-date-title': string;
+    };
+    'zh-HK': {
+        'pisell-reservation-schedule.today': string;
+        'pisell-reservation-schedule.prev': string;
+        'pisell-reservation-schedule.next': string;
+        'pisell-reservation-schedule.pick-date': string;
+        'pisell-reservation-schedule.pick-date-title': string;
+    };
+};
+export default _default;

package/es/components/pisellReservationSchedule/locales.js

@@ -0,0 +1,24 @@
+/** PisellReservationSchedule 多语言；使用前 locales.init 合并 */
+export default {
+  en: {
+    'pisell-reservation-schedule.today': 'Today',
+    'pisell-reservation-schedule.prev': 'Previous day',
+    'pisell-reservation-schedule.next': 'Next day',
+    'pisell-reservation-schedule.pick-date': 'Pick a date',
+    'pisell-reservation-schedule.pick-date-title': 'Pick a date'
+  },
+  'zh-CN': {
+    'pisell-reservation-schedule.today': '今天',
+    'pisell-reservation-schedule.prev': '上一天',
+    'pisell-reservation-schedule.next': '下一天',
+    'pisell-reservation-schedule.pick-date': '选择日期',
+    'pisell-reservation-schedule.pick-date-title': '选择日期'
+  },
+  'zh-HK': {
+    'pisell-reservation-schedule.today': '今天',
+    'pisell-reservation-schedule.prev': '上一日',
+    'pisell-reservation-schedule.next': '下一日',
+    'pisell-reservation-schedule.pick-date': '選擇日期',
+    'pisell-reservation-schedule.pick-date-title': '選擇日期'
+  }
+};

package/es/components/pisellReservationSchedule/types.d.ts

@@ -0,0 +1,42 @@
+import type { CSSProperties } from 'react';
+import type { Dayjs } from 'dayjs';
+/** 与 PisellTimeNavigator 一致：dayjs 或可解析字符串 */
+export declare type ReservationScheduleValue = Dayjs | string | null | undefined;
+/**
+ * PisellReservationSchedule：营业日切换条（上一日 / 文案 / 下一日）
+ */
+export interface PisellReservationScheduleProps {
+    /**
+     * 当前选中日（受控），日历日语义，建议使用 startOf('day') 对齐
+     */
+    value?: ReservationScheduleValue;
+    /**
+     * 选中日变更
+     */
+    onChange?: (date: Dayjs) => void;
+    /**
+     * 非受控初始日
+     */
+    defaultValue?: ReservationScheduleValue;
+    /**
+     * 不可早于该日（含）
+     */
+    minDate?: ReservationScheduleValue;
+    /**
+     * 不可晚于该日（含）
+     */
+    maxDate?: ReservationScheduleValue;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 根节点样式
+     */
+    style?: CSSProperties;
+    /**
+     * 为 true 时禁用上一日/下一日、日期点选（弹日历）；用于「跟随当前时刻」等只读日期条
+     * @default false
+     */
+    navigationLocked?: boolean;
+}

package/es/components/pisellReservationSchedule/types.js

@@ -0,0 +1 @@
+export {};

package/es/components/pisellReservationScheduleBand/PisellReservationScheduleBand.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { PisellReservationScheduleBandProps } from './types';
+import './PisellReservationScheduleBand.less';
+/**
+ * 预约顶栏组合：营业日切换 + 锚定到选中日的时间导航轴
+ */
+export declare function PisellReservationScheduleBand(props: PisellReservationScheduleBandProps): React.JSX.Element;
+export declare namespace PisellReservationScheduleBand {
+    var displayName: string;
+}

package/es/components/pisellReservationScheduleBand/PisellReservationScheduleBand.js

@@ -0,0 +1,94 @@
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+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 React, { useState, useCallback } from 'react';
+import dayjs from 'dayjs';
+import classNames from 'classnames';
+import { PisellReservationSchedule } from "../pisellReservationSchedule";
+import { PisellTimeNavigator } from "../pisellTimeNavigator";
+import "./PisellReservationScheduleBand.less";
+function startOfDay(d) {
+  return d.startOf('day');
+}
+function withTimeOnDate(dateDay, timeSource) {
+  return startOfDay(dateDay).hour(timeSource.hour()).minute(timeSource.minute()).second(0).millisecond(0);
+}
+
+/**
+ * 预约顶栏组合：营业日切换 + 锚定到选中日的时间导航轴
+ */
+export function PisellReservationScheduleBand(props) {
+  var valueProp = props.value,
+    onChange = props.onChange,
+    defaultValue = props.defaultValue,
+    scheduleProps = props.scheduleProps,
+    timeNavigatorProps = props.timeNavigatorProps,
+    scheduleStartSlot = props.scheduleStartSlot,
+    scheduleEndSlot = props.scheduleEndSlot,
+    scheduleAfterDateSlot = props.scheduleAfterDateSlot,
+    className = props.className,
+    style = props.style;
+  var isControlled = valueProp !== undefined;
+  var _useState = useState(function () {
+      var _defaultValue$date, _defaultValue$at;
+      var d = (_defaultValue$date = defaultValue === null || defaultValue === void 0 ? void 0 : defaultValue.date) !== null && _defaultValue$date !== void 0 ? _defaultValue$date : dayjs().startOf('day');
+      var atSrc = (_defaultValue$at = defaultValue === null || defaultValue === void 0 ? void 0 : defaultValue.at) !== null && _defaultValue$at !== void 0 ? _defaultValue$at : dayjs();
+      return {
+        date: startOfDay(dayjs(d)),
+        at: withTimeOnDate(dayjs(d), dayjs(atSrc))
+      };
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    internal = _useState2[0],
+    setInternal = _useState2[1];
+  var effective = isControlled ? valueProp : internal;
+  var emit = useCallback(function (next) {
+    /** at 保留时间轴返回的绝对时刻（跨日营业时可能为锚定日的次日） */
+    var normalized = {
+      date: startOfDay(next.date),
+      at: next.at
+    };
+    if (!isControlled) setInternal(normalized);
+    onChange === null || onChange === void 0 || onChange(normalized);
+  }, [isControlled, onChange]);
+  var handleDateChange = useCallback(function (d) {
+    emit({
+      date: startOfDay(d),
+      at: withTimeOnDate(d, effective.at)
+    });
+  }, [emit, effective.at]);
+  var handleTimeChange = useCallback(function (t) {
+    emit({
+      date: startOfDay(effective.date),
+      at: t
+    });
+  }, [emit, effective.date]);
+  return /*#__PURE__*/React.createElement("div", {
+    className: classNames('pisell-reservation-schedule-band', className),
+    style: style
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "pisell-reservation-schedule-band-schedule-row"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "pisell-reservation-schedule-band-slot-start"
+  }, scheduleStartSlot), /*#__PURE__*/React.createElement("div", {
+    className: "pisell-reservation-schedule-band-schedule"
+  }, /*#__PURE__*/React.createElement(PisellReservationSchedule, _extends({
+    value: effective.date,
+    onChange: handleDateChange
+  }, scheduleProps)), scheduleAfterDateSlot ? /*#__PURE__*/React.createElement("div", {
+    className: "pisell-reservation-schedule-band-after-date"
+  }, scheduleAfterDateSlot) : null), /*#__PURE__*/React.createElement("div", {
+    className: "pisell-reservation-schedule-band-slot-end"
+  }, scheduleEndSlot)), /*#__PURE__*/React.createElement("div", {
+    className: "pisell-reservation-schedule-band-navigator"
+  }, /*#__PURE__*/React.createElement(PisellTimeNavigator, _extends({
+    referenceDate: effective.date,
+    value: effective.at,
+    onChange: handleTimeChange
+  }, timeNavigatorProps))));
+}
+PisellReservationScheduleBand.displayName = 'PisellReservationScheduleBand';