@pisell/materials 1.8.18 → 1.8.19

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

@@ -0,0 +1,2 @@
+export { PisellReservationScheduleBand } from './PisellReservationScheduleBand';
+export type { PisellReservationScheduleBandProps, ReservationScheduleBandValue, TimeNavigatorPassthroughProps, } from './types';

package/es/components/pisellReservationScheduleBand/index.js

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

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

@@ -0,0 +1,45 @@
+import type { CSSProperties, ReactNode } from 'react';
+import type { Dayjs } from 'dayjs';
+import type { PisellTimeNavigatorProps } from '../pisellTimeNavigator/types';
+import type { PisellReservationScheduleProps } from '../pisellReservationSchedule/types';
+/** 组合值：日历日 + 该日上的时刻（与 PisellTimeNavigator 对齐） */
+export interface ReservationScheduleBandValue {
+    date: Dayjs;
+    at: Dayjs;
+}
+export declare type TimeNavigatorPassthroughProps = Omit<PisellTimeNavigatorProps, 'value' | 'onChange' | 'referenceDate' | 'defaultValue'>;
+/**
+ * PisellReservationScheduleBand：营业日条 + 横向时间轴
+ */
+export interface PisellReservationScheduleBandProps {
+    /**
+     * 受控：选中日 + 轴上时刻
+     */
+    value?: ReservationScheduleBandValue;
+    /**
+     * 日历日或时刻任一变化时触发
+     */
+    onChange?: (next: ReservationScheduleBandValue) => void;
+    /**
+     * 非受控初始值（可只传部分字段）
+     */
+    defaultValue?: Partial<ReservationScheduleBandValue>;
+    /**
+     * 透传给 PisellReservationSchedule（如 minDate / maxDate）
+     */
+    scheduleProps?: Omit<PisellReservationScheduleProps, 'value' | 'onChange' | 'defaultValue'>;
+    /**
+     * 透传给 PisellTimeNavigator（不含 value/onChange/referenceDate）
+     */
+    timeNavigatorProps?: TimeNavigatorPassthroughProps;
+    /**
+     * 顶栏日程行：PisellReservationSchedule 左侧自定义内容（如标题）
+     */
+    scheduleStartSlot?: ReactNode;
+    /**
+     * 顶栏日程行：PisellReservationSchedule 右侧自定义内容（如状态、主按钮）
+     */
+    scheduleEndSlot?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}

package/es/components/pisellReservationScheduleBand/types.js

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

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

@@ -9,5 +9,5 @@ export interface PisellTagsProps extends React.DetailedHTMLProps<React.HTMLAttri
     icon?: React.ReactNode;
     color?: PisellTagsColor;
 }
-declare const PisellTags: (props: PisellTagsProps) => React.JSX.Element;
+declare const PisellTags: (props: PisellTagsProps) => JSX.Element;
 export default PisellTags;

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

@@ -2,8 +2,8 @@ import React from 'react';
 export interface PisellTextProps extends React.HTMLAttributes<HTMLSpanElement> {
 }
 declare const PisellText: {
-    (props: PisellTextProps): React.JSX.Element;
-    Amount: (props: import("./components/Amount").AmountProps) => React.JSX.Element;
+    (props: PisellTextProps): JSX.Element;
+    Amount: (props: import("./components/Amount").AmountProps) => JSX.Element;
     Editable: React.FC<import("./components/Editable").EditableProps>;
 };
 export default PisellText;

package/es/components/pisellTimeNavigator/PisellTimeNavigator.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import type { PisellTimeNavigatorProps } from './types';
+import './PisellTimeNavigator.less';
+/**
+ * PisellTimeNavigator：可拖动的时间导航轴，时间范围内浏览、选择、控制
+ */
+export declare function PisellTimeNavigator(props: PisellTimeNavigatorProps): JSX.Element;
+export declare namespace PisellTimeNavigator {
+    var displayName: string;
+}

package/es/components/pisellTimeNavigator/PisellTimeNavigator.js

@@ -0,0 +1,512 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+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; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+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, useEffect, useRef, useCallback, useMemo } from 'react';
+import dayjs from 'dayjs';
+import classNames from 'classnames';
+import PisellScrollView from "../PisellScrollView";
+import { parseValue, getRangeBounds, snapToStepMinutes, isInDisabledRanges as checkDisabledRanges } from "./utils";
+import { useTimeAxis, useRealtime, useDragInertia } from "./hooks";
+import { BackgroundLayer, CursorLayer, GestureLayer, NowButton, ScaleLayer } from "./components";
+import { locales } from '@pisell/utils';
+import pisellTimeNavigatorLocales from "./locales";
+import "./PisellTimeNavigator.less";
+import useEngineContext from "../../hooks/useEngineContext";
+
+/** 横向每格宽度（px），Figma 约 82 */
+var CELL_SIZE_H = 82;
+/** 竖向每格高度（px） */
+var CELL_SIZE_V = 20;
+
+/**
+ * PisellTimeNavigator：可拖动的时间导航轴，时间范围内浏览、选择、控制
+ */
+export function PisellTimeNavigator(props) {
+  var _context$engine;
+  var valueProp = props.value,
+    onChange = props.onChange,
+    defaultValue = props.defaultValue,
+    referenceDateProp = props.referenceDate,
+    _props$realtime = props.realtime,
+    realtime = _props$realtime === void 0 ? false : _props$realtime,
+    range = props.range,
+    _props$stepMinutes = props.stepMinutes,
+    stepMinutes = _props$stepMinutes === void 0 ? 15 : _props$stepMinutes,
+    _props$majorStepMinut = props.majorStepMinutes,
+    majorStepMinutes = _props$majorStepMinut === void 0 ? 60 : _props$majorStepMinut,
+    _props$cursorMode = props.cursorMode,
+    cursorMode = _props$cursorMode === void 0 ? 'axis-moves' : _props$cursorMode,
+    _props$orientation = props.orientation,
+    orientation = _props$orientation === void 0 ? 'horizontal' : _props$orientation,
+    disabledRanges = props.disabledRanges,
+    _props$showNowButton = props.showNowButton,
+    showNowButton = _props$showNowButton === void 0 ? true : _props$showNowButton,
+    _props$userInteractio = props.userInteractionLocked,
+    userInteractionLocked = _props$userInteractio === void 0 ? false : _props$userInteractio,
+    _props$snapToStep = props.snapToStep,
+    snapToStep = _props$snapToStep === void 0 ? true : _props$snapToStep,
+    _props$inertia = props.inertia,
+    inertia = _props$inertia === void 0 ? false : _props$inertia,
+    businessHours = props.businessHours,
+    pastTimeFade = props.pastTimeFade,
+    containerStyle = props.containerStyle,
+    scaleStyle = props.scaleStyle,
+    cursorStyle = props.cursorStyle,
+    nowButtonStyle = props.nowButtonStyle,
+    className = props.className,
+    style = props.style,
+    locale = props.locale,
+    _props$timeFormat = props.timeFormat,
+    timeFormat = _props$timeFormat === void 0 ? 'HH:mm' : _props$timeFormat,
+    renderNowButton = props.renderNowButton;
+  var context = useEngineContext();
+  locales.init(pisellTimeNavigatorLocales, (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');
+
+  /**
+   * 锚定日历日：传入 prop 时以 prop 为准；不传则每帧取当天 0 点（与历史行为一致，便于跨自然日）
+   */
+  var referenceDateFromProp = useMemo(function () {
+    if (referenceDateProp == null) return undefined;
+    var d = parseValue(referenceDateProp, dayjs());
+    return (d !== null && d !== void 0 ? d : dayjs()).startOf('day');
+  }, [referenceDateProp]);
+  var referenceDate = referenceDateFromProp !== null && referenceDateFromProp !== void 0 ? referenceDateFromProp : dayjs().startOf('day');
+  var isHorizontal = orientation === 'horizontal';
+  var cellSizePx = isHorizontal ? CELL_SIZE_H : CELL_SIZE_V;
+  var axis = useTimeAxis({
+    range: range,
+    stepMinutes: stepMinutes,
+    referenceDate: referenceDate,
+    orientation: orientation,
+    cellSizePx: cellSizePx
+  });
+  var isControlled = valueProp !== undefined;
+  var _useState = useState(function () {
+      var v = valueProp !== null && valueProp !== void 0 ? valueProp : defaultValue;
+      return parseValue(v, referenceDate);
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    internalValue = _useState2[0],
+    setInternalValue = _useState2[1];
+  var value = isControlled ? valueProp != null ? parseValue(valueProp, referenceDate) : null : internalValue;
+  var effectiveValue = value !== null && value !== void 0 ? value : axis.rangeStart;
+  var scrollRef = useRef(null);
+  var viewportWrapRef = useRef(null);
+  /** 标记当前是否为「程序性滚动到中心」：其触发的 onScrollEnd 不再做时间判定 */
+  var scrollToCenterInProgressRef = useRef(false);
+  /** 标记 value 是否由滚动/松手更新：若是则不再根据 value 做「滚动到中心」 */
+  var valueUpdatedByScrollRef = useRef(false);
+  /** 手指是否仍按在滚动区域上；仅当完全松手后才执行吸附 */
+  var isPointerDownRef = useRef(false);
+  var _useState3 = useState({
+      scrollLeft: 0,
+      scrollTop: 0
+    }),
+    _useState4 = _slicedToArray(_useState3, 2),
+    scrollPosition = _useState4[0],
+    setScrollPosition = _useState4[1];
+  var _useState5 = useState({
+      w: 0,
+      h: 0
+    }),
+    _useState6 = _slicedToArray(_useState5, 2),
+    viewportSize = _useState6[0],
+    setViewportSize = _useState6[1];
+  /** 每分钟更新一次，使当前时间线/渐变块随真实时间移动 */
+  var _useState7 = useState(0),
+    _useState8 = _slicedToArray(_useState7, 2),
+    setNowTick = _useState8[1];
+  useEffect(function () {
+    var id = setInterval(function () {
+      return setNowTick(function (n) {
+        return n + 1;
+      });
+    }, 60 * 1000);
+    return function () {
+      return clearInterval(id);
+    };
+  }, []);
+  var isAxisMoves = cursorMode === 'axis-moves';
+  var getScrollContainer = useCallback(function () {
+    var _scrollRef$current$ge, _scrollRef$current, _scrollRef$current$ge2;
+    return (_scrollRef$current$ge = (_scrollRef$current = scrollRef.current) === null || _scrollRef$current === void 0 || (_scrollRef$current$ge2 = _scrollRef$current.getScrollContainer) === null || _scrollRef$current$ge2 === void 0 ? void 0 : _scrollRef$current$ge2.call(_scrollRef$current)) !== null && _scrollRef$current$ge !== void 0 ? _scrollRef$current$ge : null;
+  }, []);
+
+  /** 挂载和视口变化时同步尺寸，保证两端半屏留白从首帧就正确 */
+  useEffect(function () {
+    var el = viewportWrapRef.current;
+    if (!el) return;
+    var setSize = function setSize() {
+      var w = el.clientWidth;
+      var h = el.clientHeight;
+      setViewportSize(function (prev) {
+        return prev.w === w && prev.h === h ? prev : {
+          w: w,
+          h: h
+        };
+      });
+    };
+    setSize();
+    var ro = new ResizeObserver(setSize);
+    ro.observe(el);
+    return function () {
+      return ro.disconnect();
+    };
+  }, []);
+  var inertiaHandlers = useDragInertia({
+    enabled: inertia && !userInteractionLocked,
+    orientation: orientation,
+    getScrollContainer: getScrollContainer
+  });
+
+  /** 横向：点位于每格中心 cellSizePx/2；竖向：对齐整点上面的粗线（格顶），dotOffsetPx=0 */
+  /** 视口未量到前用默认值，避免首帧 axisStartMargin 为 0 导致错位 */
+  var effectiveViewportW = viewportSize.w || 400;
+  var effectiveViewportH = viewportSize.h || 300;
+  var halfViewportW = effectiveViewportW / 2;
+  var halfViewportH = effectiveViewportH / 2;
+  var dotOffsetPx = isHorizontal ? cellSizePx / 2 : 0;
+  var axisStartMarginW = Math.max(0, halfViewportW - dotOffsetPx);
+  var axisStartMarginH = Math.max(0, halfViewportH - dotOffsetPx);
+
+  /** 拖动中：用连续映射按 1 分钟步长显示时间（不吸附到 stepMinutes） */
+  var handleScroll = useCallback(function (data) {
+    /** 程序性滚动到中心（如点 Now）过程中不更新任何状态，避免时间轴再动、value 被覆盖 */
+    if (scrollToCenterInProgressRef.current) return;
+    setScrollPosition({
+      scrollLeft: data.scrollLeft,
+      scrollTop: data.scrollTop
+    });
+    setViewportSize({
+      w: data.clientWidth,
+      h: data.clientHeight
+    });
+    if (userInteractionLocked) return;
+    if (!isAxisMoves || data.clientWidth <= 0 && data.clientHeight <= 0) return;
+    var halfW = data.clientWidth / 2;
+    var halfH = data.clientHeight / 2;
+    var hasPadding = isHorizontal ? effectiveViewportW > 0 : effectiveViewportH > 0;
+    var centerOffset = isHorizontal ? hasPadding ? data.scrollLeft + dotOffsetPx : data.scrollLeft + halfW : hasPadding ? data.scrollTop + dotOffsetPx : data.scrollTop + halfH;
+    var t = axis.offsetToTimeContinuous(centerOffset);
+    if (!t) return;
+    var tMinute = t.startOf('minute');
+    if (checkDisabledRanges(tMinute, disabledRanges)) return;
+    valueUpdatedByScrollRef.current = true;
+    if (!isControlled) setInternalValue(tMinute);
+    onChange === null || onChange === void 0 || onChange(tMinute);
+  }, [isAxisMoves, isHorizontal, isControlled, axis.offsetToTimeContinuous, disabledRanges, onChange, effectiveViewportW, effectiveViewportH, dotOffsetPx, userInteractionLocked]);
+
+  /** 根据当前视口中心吸附到 0/15/30/45 分钟并更新 value；由松手后的 scrollEnd 或 pointerUp 调用 */
+  var performSnapFromScrollPosition = useCallback(function (scrollLeft, scrollTop, clientWidth, clientHeight) {
+    if (!isAxisMoves || clientWidth <= 0 && clientHeight <= 0) return;
+    valueUpdatedByScrollRef.current = false;
+    var hasPadding = isHorizontal ? effectiveViewportW > 0 : effectiveViewportH > 0;
+    var centerOffset = isHorizontal ? hasPadding ? scrollLeft + dotOffsetPx : scrollLeft + clientWidth / 2 : hasPadding ? scrollTop + dotOffsetPx : scrollTop + clientHeight / 2;
+    var t = axis.offsetToTimeContinuous(centerOffset);
+    if (!t) return;
+    var snapped = snapToStep ? snapToStepMinutes(t, stepMinutes) : t.startOf('minute');
+    if (checkDisabledRanges(snapped, disabledRanges)) return;
+    if (!isControlled) setInternalValue(snapped);
+    onChange === null || onChange === void 0 || onChange(snapped);
+  }, [isAxisMoves, isHorizontal, isControlled, axis.offsetToTimeContinuous, snapToStep, stepMinutes, disabledRanges, onChange, effectiveViewportW, effectiveViewportH, dotOffsetPx]);
+
+  /** 程序性滚动结束后延迟清除标记，避免同一次滚动触发的后续 scrollEnd 误走吸附（导致轴动、值被改） */
+  var scrollEndClearTimeoutRef = useRef(null);
+
+  /** 滚动结束：仅当手指已松开时才吸附（避免拖动中停顿就吸附）；若仍按着则等 pointerUp 再吸附 */
+  var handleScrollEnd = useCallback(function (data) {
+    if (userInteractionLocked) return;
+    if (scrollToCenterInProgressRef.current) {
+      if (scrollEndClearTimeoutRef.current) clearTimeout(scrollEndClearTimeoutRef.current);
+      /** 不立即清除：程序性滚动的 scrollEnd 会在动画结束时才触发（可能数百 ms 后），延迟清除才能跳过那次吸附 */
+      scrollEndClearTimeoutRef.current = setTimeout(function () {
+        scrollToCenterInProgressRef.current = false;
+        scrollEndClearTimeoutRef.current = null;
+      }, 500);
+      return;
+    }
+    if (isPointerDownRef.current) return;
+    performSnapFromScrollPosition(data.scrollLeft, data.scrollTop, data.clientWidth, data.clientHeight);
+  }, [performSnapFromScrollPosition, userInteractionLocked]);
+
+  /** 手指松开时若尚未吸附（例如按住不动再松手），用当前滚动位置做一次吸附；点 Now 按钮松手不吸附 */
+  var handlePointerUp = useCallback(function (e) {
+    var _e$target, _e$target$closest, _scrollRef$current2, _scrollRef$current2$g;
+    isPointerDownRef.current = false;
+    if (userInteractionLocked) return;
+    if ((_e$target = e.target) !== null && _e$target !== void 0 && (_e$target$closest = _e$target.closest) !== null && _e$target$closest !== void 0 && _e$target$closest.call(_e$target, '.pisell-time-navigator-now')) return;
+    if (!isAxisMoves) return;
+    var container = (_scrollRef$current2 = scrollRef.current) === null || _scrollRef$current2 === void 0 || (_scrollRef$current2$g = _scrollRef$current2.getScrollContainer) === null || _scrollRef$current2$g === void 0 ? void 0 : _scrollRef$current2$g.call(_scrollRef$current2);
+    if (!container) return;
+    performSnapFromScrollPosition(container.scrollLeft, container.scrollTop, container.clientWidth, container.clientHeight);
+  }, [isAxisMoves, performSnapFromScrollPosition, userInteractionLocked]);
+  var snapFn = useCallback(function (t) {
+    return snapToStepMinutes(t, stepMinutes);
+  }, [stepMinutes]);
+  var isInDisabled = useCallback(function (t) {
+    return checkDisabledRanges(t, disabledRanges);
+  }, [disabledRanges]);
+  var handleChange = useCallback(function (next) {
+    if (isInDisabled(next)) return;
+    if (!isControlled) setInternalValue(next);
+    onChange === null || onChange === void 0 || onChange(next);
+  }, [isControlled, onChange, isInDisabled]);
+  useRealtime(realtime, function () {
+    var wall = dayjs().startOf('minute');
+    var _getRangeBounds = getRangeBounds(range, referenceDate),
+      _getRangeBounds2 = _slicedToArray(_getRangeBounds, 2),
+      rangeStart = _getRangeBounds2[0],
+      rangeEnd = _getRangeBounds2[1];
+    /** 跨日营业：用真实此刻落在 [rangeStart, rangeEnd] 内，而非仅 reference 当日钟面 */
+    var clamped = wall.isBefore(rangeStart) ? rangeStart : wall.isAfter(rangeEnd) ? rangeEnd : wall;
+    var snapped = snapToStep ? snapFn(clamped) : clamped;
+    if (!isInDisabled(snapped)) handleChange(snapped);
+  });
+  useEffect(function () {
+    if (!isControlled && valueProp !== undefined) {
+      setInternalValue(parseValue(valueProp, referenceDate));
+    }
+  }, [isControlled, valueProp, referenceDate]);
+
+  /** 锚定日切换时保留非受控下的时分，落到新日上 */
+  var referenceDayMs = referenceDate.valueOf();
+  useEffect(function () {
+    if (isControlled) return;
+    setInternalValue(function (prev) {
+      if (!prev) {
+        return parseValue(defaultValue, referenceDate);
+      }
+      return referenceDate.hour(prev.hour()).minute(prev.minute()).second(0).millisecond(0);
+    });
+  }, [referenceDayMs, isControlled, defaultValue]);
+  var cursorOffsetPx = axis.timeToOffset(effectiveValue);
+  /** 刻度「现在线」：真实系统时刻落在轴区间内时绘制（含跨日营业次日凌晨） */
+  var wallAligned = dayjs().startOf('minute');
+  var currentTimeInRange = !wallAligned.isBefore(axis.rangeStart) && !wallAligned.isAfter(axis.rangeEnd);
+  var currentTimeOffsetPx = currentTimeInRange ? axis.timeToOffset(wallAligned) : undefined;
+
+  // 以点为基准：有留白时 targetScroll = cursorOffsetPx - dotOffsetPx（使该点对准视口中心）
+  var SCROLL_SYNC_THRESHOLD_PX = 2;
+  var hasScrollPadding = isHorizontal ? effectiveViewportW > 0 : effectiveViewportH > 0;
+  /**
+   * 竖向：上留白用 axis marginTop，下留白用 axis marginBottom（均为半屏）
+   * axis-wrap 高度 = marginTop + 轴内容 + marginBottom
+   */
+  var verticalTailPx = effectiveViewportH / 2;
+  var verticalWrapHeight = axisStartMarginH + axis.totalLengthPx + verticalTailPx;
+  var maxScrollPx = isHorizontal ? Math.max(0, axis.totalLengthPx - cellSizePx) : Math.max(0, verticalWrapHeight - effectiveViewportH);
+  useEffect(function () {
+    var _scrollRef$current3, _scrollRef$current3$g;
+    if (valueUpdatedByScrollRef.current) {
+      valueUpdatedByScrollRef.current = false;
+      return;
+    }
+    var container = (_scrollRef$current3 = scrollRef.current) === null || _scrollRef$current3 === void 0 || (_scrollRef$current3$g = _scrollRef$current3.getScrollContainer) === null || _scrollRef$current3$g === void 0 ? void 0 : _scrollRef$current3$g.call(_scrollRef$current3);
+    if (!container) return;
+    var viewportPx = isHorizontal ? container.clientWidth : container.clientHeight;
+    var targetScroll = hasScrollPadding ? Math.max(0, Math.min(cursorOffsetPx - dotOffsetPx, maxScrollPx)) : Math.max(0, Math.min(cursorOffsetPx - viewportPx / 2, Math.max(0, axis.totalLengthPx - viewportPx)));
+    var currentScroll = isHorizontal ? container.scrollLeft : container.scrollTop;
+    if (Math.abs(currentScroll - targetScroll) <= SCROLL_SYNC_THRESHOLD_PX) return;
+    scrollToCenterInProgressRef.current = true;
+    if (isHorizontal) {
+      container.scrollTo({
+        left: targetScroll,
+        behavior: 'smooth'
+      });
+    } else {
+      container.scrollTo({
+        top: targetScroll,
+        behavior: 'smooth'
+      });
+    }
+  }, [effectiveValue.valueOf(), isHorizontal, cursorOffsetPx, maxScrollPx, hasScrollPadding, dotOffsetPx, cellSizePx, axis.totalLengthPx]);
+  var scrollToCenterTime = useCallback(function (t) {
+    var container = getScrollContainer();
+    if (!container) return;
+    var offset = axis.timeToOffset(t);
+    var viewportPx = isHorizontal ? container.clientWidth : container.clientHeight;
+    var maxScroll = hasScrollPadding ? maxScrollPx : Math.max(0, axis.totalLengthPx - viewportPx);
+    var target = hasScrollPadding ? Math.max(0, Math.min(offset - dotOffsetPx, maxScrollPx)) : Math.max(0, Math.min(offset - viewportPx / 2, maxScroll));
+    scrollToCenterInProgressRef.current = true;
+    container.scrollTo({
+      left: isHorizontal ? target : 0,
+      top: isHorizontal ? 0 : target,
+      behavior: 'smooth'
+    });
+  }, [getScrollContainer, axis.timeToOffset, axis.totalLengthPx, isHorizontal, hasScrollPadding, dotOffsetPx, maxScrollPx]);
+  var handleSelectTime = useCallback(function (t) {
+    handleChange(t);
+    if (isAxisMoves) scrollToCenterTime(t);
+  }, [handleChange, isAxisMoves, scrollToCenterTime]);
+
+  /** 点 Now：系统当前时刻映射到锚定日，再 clamp 到 range */
+  var handleNow = useCallback(function () {
+    valueUpdatedByScrollRef.current = false;
+    var wall = dayjs().startOf('minute');
+    var _getRangeBounds3 = getRangeBounds(range, referenceDate),
+      _getRangeBounds4 = _slicedToArray(_getRangeBounds3, 2),
+      rangeStart = _getRangeBounds4[0],
+      rangeEnd = _getRangeBounds4[1];
+    var clamped = wall.isBefore(rangeStart) ? rangeStart : wall.isAfter(rangeEnd) ? rangeEnd : wall;
+    handleChange(clamped);
+  }, [range, referenceDate, handleChange]);
+  var businessHoursPx = useMemo(function () {
+    if (!businessHours) return undefined;
+    var _getRangeBounds5 = getRangeBounds(businessHours, referenceDate),
+      _getRangeBounds6 = _slicedToArray(_getRangeBounds5, 2),
+      s = _getRangeBounds6[0],
+      e = _getRangeBounds6[1];
+    return [axis.timeToOffset(s), axis.timeToOffset(e)];
+  }, [businessHours, referenceDate, axis.timeToOffset]);
+  var scrollConfig = useMemo(function () {
+    return {
+      show: false,
+      type: isHorizontal ? 'lrArrows' : 'tbArrows',
+      scrollDistance: cellSizePx
+    };
+  }, [isHorizontal, cellSizePx]);
+  return /*#__PURE__*/React.createElement("div", {
+    className: classNames('pisell-time-navigator', "pisell-time-navigator--".concat(orientation), userInteractionLocked && 'pisell-time-navigator--interaction-locked', className),
+    style: isHorizontal ? style : _objectSpread({
+      height: '100%',
+      minHeight: 200
+    }, style)
+  }, /*#__PURE__*/React.createElement("div", {
+    ref: viewportWrapRef,
+    className: "pisell-time-navigator-viewport-wrap",
+    style: isHorizontal ? undefined : {
+      height: '100%',
+      minHeight: 200,
+      maxHeight: 800
+    },
+    onPointerDownCapture: function onPointerDownCapture() {
+      isPointerDownRef.current = true;
+    },
+    onPointerUpCapture: handlePointerUp,
+    onPointerLeaveCapture: handlePointerUp
+  }, /*#__PURE__*/React.createElement("div", {
+    className: classNames('pisell-time-navigator-scroll-host', userInteractionLocked && 'pisell-time-navigator-scroll-host--interaction-locked')
+  }, /*#__PURE__*/React.createElement(PisellScrollView, {
+    ref: scrollRef,
+    width: '100%',
+    height: '100%',
+    overflow: isHorizontal ? 'x' : 'y',
+    showScrollButtons: false,
+    scrollbarStyle: "none",
+    scrollActionsConfig: scrollConfig,
+    onScroll: handleScroll,
+    onScrollEnd: handleScrollEnd,
+    style: _objectSpread(_objectSpread({}, isHorizontal ? {
+      height: 48
+    } : {
+      width: 54,
+      minHeight: 200,
+      height: '100%',
+      maxHeight: 800
+    }), containerStyle)
+  }, /*#__PURE__*/React.createElement(GestureLayer, {
+    orientation: orientation,
+    cellSizePx: cellSizePx,
+    axisStartMarginPx: isHorizontal ? axisStartMarginW : axisStartMarginH,
+    offsetToTime: axis.offsetToTime,
+    onSelectTime: handleSelectTime,
+    isInDisabledRanges: isInDisabled,
+    snapToStep: snapToStep,
+    stepMinutes: stepMinutes,
+    snapFn: snapFn,
+    scrollPosition: scrollPosition,
+    viewportSize: viewportSize,
+    onPointerDown: inertiaHandlers.onPointerDown,
+    onPointerMove: inertiaHandlers.onPointerMove,
+    onPointerUp: inertiaHandlers.onPointerUp,
+    onPointerLeave: inertiaHandlers.onPointerUp
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "pisell-time-navigator-axis-wrap",
+    style: isHorizontal ? {
+      width: axis.totalLengthPx + (effectiveViewportW - cellSizePx),
+      minHeight: 48
+    } : {
+      width: '100%'
+      /* 不设 height，由轴（marginTop + 内容 + marginBottom）自然撑开，避免固定高度与 margin 的 CSS 盒模型歧义 */
+    }
+  }, isHorizontal && currentTimeOffsetPx != null && currentTimeOffsetPx >= 0 && /*#__PURE__*/React.createElement("div", {
+    className: "pisell-time-navigator-current-gradient pisell-time-navigator-current-gradient--horizontal",
+    style: {
+      left: axisStartMarginW + Math.max(0, currentTimeOffsetPx - CELL_SIZE_H),
+      top: 0,
+      width: Math.min(CELL_SIZE_H, currentTimeOffsetPx),
+      height: 48
+    },
+    "aria-hidden": true
+  }), /*#__PURE__*/React.createElement("div", {
+    className: classNames('pisell-time-navigator-axis', "pisell-time-navigator-axis--".concat(orientation)),
+    "data-time-navigator-axis": true,
+    style: isHorizontal ? {
+      width: axis.totalLengthPx,
+      height: 48,
+      marginLeft: axisStartMarginW
+    } : {
+      height: axis.totalLengthPx,
+      width: '100%',
+      marginTop: axisStartMarginH,
+      marginBottom: verticalTailPx
+    }
+  }, /*#__PURE__*/React.createElement(BackgroundLayer, {
+    orientation: orientation,
+    pastTimeFade: pastTimeFade,
+    businessHoursPx: businessHoursPx
+  }), /*#__PURE__*/React.createElement(ScaleLayer, {
+    orientation: orientation,
+    ticks: axis.ticks,
+    stepMinutes: stepMinutes,
+    majorStepMinutes: majorStepMinutes,
+    timeFormat: timeFormat,
+    locale: locale,
+    style: scaleStyle
+  }), !isHorizontal && currentTimeOffsetPx != null && currentTimeOffsetPx >= 0 && /*#__PURE__*/React.createElement("div", {
+    className: "pisell-time-navigator-current-line",
+    style: {
+      left: 0,
+      top: currentTimeOffsetPx - 1,
+      width: '100%',
+      height: 2,
+      background: '#FF692E'
+    },
+    "aria-hidden": true
+  }), !isAxisMoves && /*#__PURE__*/React.createElement(CursorLayer, {
+    orientation: orientation,
+    value: effectiveValue,
+    timeFormat: timeFormat,
+    locale: locale,
+    isRealtime: realtime,
+    offsetPx: cursorOffsetPx,
+    style: cursorStyle
+  })))))), isAxisMoves && /*#__PURE__*/React.createElement("div", {
+    className: classNames('pisell-time-navigator-cursor-fixed', "pisell-time-navigator-cursor-fixed--".concat(orientation)),
+    "aria-hidden": true
+  }, /*#__PURE__*/React.createElement(CursorLayer, {
+    orientation: orientation,
+    value: effectiveValue,
+    timeFormat: timeFormat,
+    locale: locale,
+    isRealtime: realtime,
+    offsetPx: 0,
+    fixedCenter: true,
+    style: cursorStyle
+  })), showNowButton && /*#__PURE__*/React.createElement(NowButton, {
+    orientation: orientation,
+    onClick: handleNow,
+    style: nowButtonStyle,
+    renderCustom: renderNowButton
+  })));
+}
+PisellTimeNavigator.displayName = 'PisellTimeNavigator';