@pisell/materials 3.3.103 → 3.3.104

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

@@ -1,52 +0,0 @@
-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;
-    /**
-     * `navigationLocked` 时的展示形态：`full` 保留左右箭头占位；`labelOnly` 仅展示中间日期文案（如场控页）。
-     * @default 'full'
-     */
-    navigationLockedDisplay?: 'full' | 'labelOnly';
-    /**
-     * 顶栏切换步长：`day` 按日；`week` 按周；`month` 按月（与 RecordBoard 日历视图联动）。
-     * @default 'day'
-     */
-    navigationUnit?: 'day' | 'week' | 'month';
-}

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

@@ -1,68 +0,0 @@
-import type { CSSProperties, ReactNode } from 'react';
-import type { Dayjs } from 'dayjs';
-import type { PisellTimeNavigatorProps } from '../pisellTimeNavigator/types';
-import type { PisellReservationScheduleProps } from '../pisellReservationSchedule/types';
-/**
- * 组合值：顶栏选中日（营业日锚定）+ 时间轴游标绝对时刻 `at`。
- * 跨日营业时 `at` 可为其它自然日时刻，顶栏 `date` 通常不变；展示用 {@link formatScheduleAtLabel}（带日期）。
- */
-export interface ReservationScheduleBandValue {
-    date: Dayjs;
-    at: Dayjs;
-}
-export declare type TimeNavigatorPassthroughProps = Omit<PisellTimeNavigatorProps, 'value' | 'onChange' | '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;
-    /**
-     * 顶栏日程行：紧挨在选日组件之后（如「跟随当前」），与中间列同一 flex 区
-     */
-    scheduleAfterDateSlot?: ReactNode;
-    /**
-     * 为 true 时隐藏下方时间导航轴（如日历视图仅需要选日/选周/选月）
-     */
-    hideTimeNavigator?: boolean;
-    /**
-     * 为 true 时在整个日程带上叠加载层（如切换营业日后拉预约列表期间）
-     */
-    dataLoading?: boolean;
-    /**
-     * 加载层内文案，由业务侧 {@link locales.getText} 等注入
-     */
-    dataLoadingTip?: ReactNode;
-    className?: string;
-    style?: CSSProperties;
-    /**
-     * 追加到内部 `.pisell-reservation-schedule-band-schedule-row` 的类名（如手机端无视图切换时改为一行布局）。
-     */
-    scheduleRowClassName?: string;
-}

package/es/components/pisellReservationScheduleBand/utils/formatScheduleAtLabel.d.ts

@@ -1,9 +0,0 @@
-import type { Dayjs } from 'dayjs';
-/**
- * 预约顶栏游标文案：与顶栏锚定日同一天只显示 HH:mm；跨自然日则带日期（MM-DD HH:mm）。
- * 顶栏 `date` 不变，仅展示层标明 `at` 的真实日历日。
- *
- * @param at 时间轴绝对时刻（可落在锚定日的次日等）
- * @param anchorDate 顶栏选中的日历日（营业日锚定，不因拖轴而改）
- */
-export declare function formatScheduleAtLabel(at: Dayjs, anchorDate: Dayjs): string;

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

@@ -1,3 +0,0 @@
-import { PisellSortProps } from './type';
-declare const PisellSort: (props: PisellSortProps) => JSX.Element;
-export default PisellSort;

package/es/components/pisellSort/type.d.ts

@@ -1,7 +0,0 @@
-import { SortListProps } from '../sort/types';
-import { FormInstance } from 'antd';
-export declare type PisellSortProps = SortListProps & {
-    name?: string;
-} & FormInstance & {
-    hasForm?: boolean;
-};

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

@@ -1,14 +0,0 @@
-import React from 'react';
-export interface BackgroundLayerProps {
-    orientation: 'horizontal' | 'vertical';
-    /** 过去时间淡化色 */
-    pastTimeFade?: string;
-    /** 营业时间区间 [startPx, endPx]，用于视觉高亮 */
-    businessHoursPx?: [number, number];
-    className?: string;
-    style?: React.CSSProperties;
-}
-/**
- * 背景区间层：营业时间高亮、过去时间淡化等（当前时间渐变已拆为独立块，见 axis-wrap 内 .pisell-time-navigator-current-gradient）
- */
-export declare function BackgroundLayer({ orientation, pastTimeFade, businessHoursPx, className, style, }: BackgroundLayerProps): JSX.Element;

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

@@ -1,29 +0,0 @@
-import React from 'react';
-import type { Dayjs } from 'dayjs';
-export interface CursorLayerProps {
-    orientation: 'horizontal' | 'vertical';
-    value: Dayjs | null;
-    timeFormat: string;
-    /** 优先于 timeFormat + locale */
-    formatTimeLabel?: (value: Dayjs) => string;
-    locale?: string;
-    isRealtime: boolean;
-    offsetPx: number;
-    /** axis-moves 时固定于视口中央，不应用 offsetPx */
-    fixedCenter?: boolean;
-    style?: React.CSSProperties;
-    className?: string;
-    /** cursor-moves：允许拖指针改时间 */
-    dragInteractive?: boolean;
-    /** 当前是否正处于拖拽（按下未抬起）：用于驱动气泡放大反馈样式 */
-    isDragging?: boolean;
-    onDragPointerDown?: React.PointerEventHandler<HTMLDivElement>;
-    onDragPointerMove?: React.PointerEventHandler<HTMLDivElement>;
-    onDragPointerUp?: React.PointerEventHandler<HTMLDivElement>;
-    onDragPointerCancel?: React.PointerEventHandler<HTMLDivElement>;
-}
-/**
- * 时间指示器层：横向为「顶三角 + 竖长方条」SVG，竖向为横线 + 时间气泡
- * 对齐基准为几何中心。Realtime 态 #FF692E，浏览态 #344054
- */
-export declare function CursorLayer({ orientation, value, timeFormat, formatTimeLabel, locale, isRealtime, offsetPx, fixedCenter, style, className, dragInteractive, isDragging, onDragPointerDown, onDragPointerMove, onDragPointerUp, onDragPointerCancel, }: CursorLayerProps): JSX.Element | null;

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

@@ -1,41 +0,0 @@
-import React from 'react';
-import type { Dayjs } from 'dayjs';
-export interface GestureLayerProps {
-    orientation: 'horizontal' | 'vertical';
-    cellSizePx: number;
-    /** 轴在滚动内容中的起始边距（左/上），用于把「滚动内容坐标」转为「轴内偏移」（与 dot 对齐） */
-    axisStartMarginPx: number;
-    /**
-     * 偏移 → 整点对齐的「最近 tick」时间。`snapToStep=true` 时点击 / 方向键吸到 step 网格上用。
-     */
-    offsetToTime: (offset: number) => Dayjs | null;
-    /**
-     * 偏移 → 连续时间（不吸附）。`snapToStep=false` 时点击与方向键都走这条，
-     * 让用户点哪儿就跳到哪一秒，不再被 stepMinutes 强行回弹。
-     */
-    offsetToTimeContinuous: (offset: number) => Dayjs | null;
-    onSelectTime: (t: Dayjs) => void;
-    isInDisabledRanges: (t: Dayjs) => boolean;
-    snapToStep: boolean;
-    stepMinutes: number;
-    snapFn: (t: Dayjs) => Dayjs;
-    scrollPosition: {
-        scrollLeft: number;
-        scrollTop: number;
-    };
-    viewportSize: {
-        w: number;
-        h: number;
-    };
-    onPointerDown?: React.PointerEventHandler;
-    onPointerMove?: React.PointerEventHandler;
-    onPointerUp?: React.PointerEventHandler;
-    onPointerLeave?: React.PointerEventHandler;
-    /** 轴上任意指针按下（含惯性拖轴） */
-    onUserInteraction?: () => void;
-    children: React.ReactNode;
-}
-/**
- * 交互层：点击刻度跳转、键盘左右/上下 + 回车
- */
-export declare function GestureLayer({ orientation, cellSizePx, axisStartMarginPx, offsetToTime, offsetToTimeContinuous, onSelectTime, isInDisabledRanges, snapToStep, stepMinutes, snapFn, scrollPosition, viewportSize, onPointerDown, onPointerMove, onPointerUp, onPointerLeave, onUserInteraction, children, }: GestureLayerProps): JSX.Element;

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

@@ -1,40 +0,0 @@
-import React from 'react';
-import type { Dayjs } from 'dayjs';
-export interface ScaleLayerProps {
-    orientation: 'horizontal' | 'vertical';
-    ticks: Dayjs[];
-    stepMinutes: number;
-    majorStepMinutes: number;
-    timeFormat: string;
-    locale?: string;
-    style?: React.CSSProperties;
-    className?: string;
-    /**
-     * 横向每格宽度（px），须与 useTimeAxis 的 cellSizePx 一致；
-     * 不传时样式表默认 82（axis-moves）；cursor-moves 压缩比例时必传
-     */
-    horizontalCellSizePx?: number;
-    /**
-     * 每个 tick 对应「格」的实际宽度（px）。范围起止不在 step 网格上时，首尾会出现宽度
-     * 小于 `horizontalCellSizePx` 的 head/tail 格；中间仍保持整步宽。
-     * 不传时退化为「全部按 horizontalCellSizePx 等宽」。
-     */
-    cellWidthsPx?: number[];
-    /**
-     * 横向时，整体两端各留出 `cellSize/2` 的居中留白（与 `useTimeAxis.dotOffsetPx` 一致），
-     * 使 rangeStart / rangeEnd 的实际像素位置落在头格 / 尾格的左 / 右边沿，
-     * 与拖拽光标的 `timeToOffset` 像素对齐。
-     */
-    leadingPaddingPx?: number;
-    trailingPaddingPx?: number;
-}
-/**
- * 刻度层：渲染时间刻度与标签
- * - 横向：整点数字 + 小圆点；当 range 起止不在 step 网格上时，首尾两个格按时间比例**变窄**
- *   （宽度 = `widthMinutes / step × cellSize`），中间格保持整步宽并落在整点 / 半点等对齐位置上。
- * - 竖向：整点数字 + 分割线。
- *
- * 标签仅在「整点」（`tick.minute() === 0` 且秒为 0）时显示数字；非整点格只渲染圆点 / 分割线，
- * 配合变窄的 head/tail 让起止时刻在视觉上自然衔接到第一个 / 最后一个整点。
- */
-export declare function ScaleLayer({ orientation, ticks, stepMinutes, majorStepMinutes, timeFormat, locale, style, className, horizontalCellSizePx, cellWidthsPx, leadingPaddingPx, trailingPaddingPx, }: ScaleLayerProps): JSX.Element;

package/es/components/pisellTimeNavigator/hooks/index.d.ts

@@ -1,5 +0,0 @@
-export { useTimeAxis } from './useTimeAxis';
-export type { UseTimeAxisOptions, TimeAxisState } from './useTimeAxis';
-export { useRealtime } from './useRealtime';
-export { useDragInertia } from './useDragInertia';
-export type { UseDragInertiaOptions } from './useDragInertia';

package/es/components/pisellTimeNavigator/hooks/useDragInertia.d.ts

@@ -1,14 +0,0 @@
-export interface UseDragInertiaOptions {
-    enabled: boolean;
-    orientation: 'horizontal' | 'vertical';
-    getScrollContainer: () => HTMLElement | null;
-}
-/**
- * 惯性滚动：根据拖动末段速度在松手后继续滚动并衰减
- */
-export declare function useDragInertia(options: UseDragInertiaOptions): {
-    onPointerDown: (e: React.PointerEvent) => void;
-    onPointerMove: (e: React.PointerEvent) => void;
-    onPointerUp: (e: React.PointerEvent) => void;
-    stopInertia: () => void;
-};

package/es/components/pisellTimeNavigator/hooks/useRealtime.d.ts

@@ -1,5 +0,0 @@
-import type { Dayjs } from 'dayjs';
-/**
- * Realtime 模式：每秒将当前系统时间通过 onTick 回传
- */
-export declare function useRealtime(enabled: boolean, onTick: (now: Dayjs) => void): void;

package/es/components/pisellTimeNavigator/hooks/useTimeAxis.d.ts

@@ -1,37 +0,0 @@
-import type { Dayjs } from 'dayjs';
-import type { TimeRangeOption } from '../types';
-export interface UseTimeAxisOptions {
-    range?: TimeRangeOption;
-    stepMinutes: number;
-    referenceDate: Dayjs;
-    orientation: 'horizontal' | 'vertical';
-    /** 横向时每格宽度（px），竖向时每格高度（px） */
-    cellSizePx: number;
-}
-export interface TimeAxisState {
-    rangeStart: Dayjs;
-    rangeEnd: Dayjs;
-    /** 每格起点时间序列（含 head / tail，对齐到 step 网格） */
-    ticks: Dayjs[];
-    /** 与 `ticks` 一一对应的格宽（px）；head / tail 可 < cellSizePx，中间格 = cellSizePx */
-    cellWidthsPx: number[];
-    /** 时间转主轴偏移（px） */
-    timeToOffset: (t: Dayjs) => number;
-    /** 主轴偏移（px）转时间（最近刻度，用于刻度对齐） */
-    offsetToTime: (offset: number) => Dayjs | null;
-    /** 主轴偏移（px）转时间（连续插值，用于拖动时按分钟步长显示） */
-    offsetToTimeContinuous: (offset: number) => Dayjs | null;
-    /** 主轴总长度（px） */
-    totalLengthPx: number;
-}
-/**
- * 时间轴刻度与时间↔像素换算。
- *
- * 格子拆分策略见 {@link getAxisCells}：当 `range.start` / `range.end` 不在 `stepMinutes` 网格上时，
- * 首尾出现宽度按时间比例缩小的 head/tail 格，中间格保持 step 整步并落在网格整点上。
- *
- * 时间→像素仍是线性映射 `dotOffsetPx + (t - rangeStart) / step × cellSize`，与 head/tail 是否存在无关：
- * `dotOffsetPx`（横向 = `cellSize/2`，竖向 = 0）为 rangeStart 在轴内的像素位置；轴两端各保留 `dotOffsetPx`
- * 留白以居中 rangeStart / rangeEnd。
- */
-export declare function useTimeAxis(options: UseTimeAxisOptions): TimeAxisState;

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

@@ -1,22 +0,0 @@
-/**
- * PisellTimeNavigator 多语言文案
- * 使用前请在应用内通过 locales.init() 合并本模块导出的 key
- */
-declare const _default: {
-    en: {
-        'pisell-time-navigator.now': string;
-    };
-    'zh-CN': {
-        'pisell-time-navigator.now': string;
-    };
-    'zh-HK': {
-        'pisell-time-navigator.now': string;
-    };
-    ja: {
-        'pisell-time-navigator.now': string;
-    };
-    pt: {
-        'pisell-time-navigator.now': string;
-    };
-};
-export default _default;

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

@@ -1,20 +0,0 @@
-/**
- * PisellTimeNavigator 布局与尺寸常量（与 Figma / 交互 spec 对齐）
- */
-/** 横向每格宽度（px），Figma 约 82；axis-moves 固定用此值 */
-export declare const CELL_SIZE_H = 82;
-/**
- * 横向「此刻」橙区目标宽度（px）：按 axis-moves 下一格多的比例换算；
- * 滚动轴与 cursor-moves 压格时同宽。
- */
-export declare const CURRENT_TIME_GRADIENT_WIDTH_H_PX: number;
-/** 竖向每格高度（px） */
-export declare const CELL_SIZE_V = 20;
-/** 横向「Now」按钮占位，避免刻度被挡 */
-export declare const CURSOR_MOVES_NOW_RESERVE_PX = 56;
-/** cursor-moves 横向：轴与视口左右边距 */
-export declare const CURSOR_MOVES_H_PADDING_PX = 8;
-/** cursor-moves 横向：每格最小宽度（再小刻度不可读） */
-export declare const CURSOR_MOVES_MIN_CELL_PX = 8;
-/** 密度层高度：时间轴 48px 内留少量上下边距 */
-export declare const DENSITY_LAYER_HEIGHT = 46;

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

@@ -1,175 +0,0 @@
-import type { CSSProperties, ReactNode } from 'react';
-import type { Dayjs } from 'dayjs';
-/**
- * value / defaultValue 的 dayjs 兼容类型（组件内部统一为 Dayjs）
- */
-export declare type TimeNavigatorValue = Dayjs | string | null;
-/**
- * 时间范围（HH:mm 或 HH:mm:ss，相对 referenceDate 的营业日）
- * - 同自然日：如 08:00–22:00
- * - 跨日：结束钟面 ≤ 开始时视为次日结束，如 02:01–02:00 表示至次日 02:00
- */
-export interface TimeRangeOption {
-    start: string;
-    end: string;
-}
-/**
- * 拖动/指示器模式
- * - axis-moves：指示器固定视口中央，刻度移动（默认）
- * - cursor-moves：刻度固定，指示器在轴上移动
- */
-export declare type CursorMode = 'axis-moves' | 'cursor-moves';
-/**
- * 布局方向
- */
-export declare type TimeNavigatorOrientation = 'horizontal' | 'vertical';
-/**
- * PisellTimeNavigator 组件 Props
- */
-export interface PisellTimeNavigatorProps {
-    /**
-     * 当前选中时间（受控）。支持 dayjs 实例或可被 dayjs 解析的字符串
-     */
-    value?: TimeNavigatorValue;
-    /**
-     * 时间变更回调（受控时必传）
-     */
-    onChange?: (value: Dayjs) => void;
-    /**
-     * 默认选中时间（非受控）
-     */
-    defaultValue?: TimeNavigatorValue;
-    /**
-     * 时间轴锚定到的日历日（startOf day）。`range` 的 HH:mm 均相对于该日。
-     * 不传则与历史一致：取「当天」0 点，避免跨天后刻度错位。
-     */
-    referenceDate?: TimeNavigatorValue;
-    /**
-     * 是否 Realtime 模式：value 自动跟随系统当前时间更新
-     * @default false
-     */
-    realtime?: boolean;
-    /**
-     * 时间范围（支持跨日营业，见 {@link TimeRangeOption}）。不传则默认当日 00:00–24:00
-     */
-    range?: TimeRangeOption;
-    /**
-     * 吸附步长（分钟），如 15、30、60
-     * @default 15
-     */
-    stepMinutes?: number;
-    /**
-     * 大刻度间隔（分钟），用于整点刻度；不传则与 stepMinutes 一致或 60
-     * @default 60
-     */
-    majorStepMinutes?: number;
-    /**
-     * 指示器/轴移动模式
-     * @default 'axis-moves'
-     */
-    cursorMode?: CursorMode;
-    /**
-     * 横向或竖向展示
-     * @default 'horizontal'
-     */
-    orientation?: TimeNavigatorOrientation;
-    /**
-     * 横向且 `cursorMode === 'axis-moves'` 时，每个时间槽的像素宽度（格间距）。
-     * 不传则 **82**（`CELL_SIZE_H`）。`cursor-moves` 时格宽由视口压缩计算，本字段不生效。
-     */
-    horizontalAxisCellSizePx?: number;
-    /**
-     * 横向时间轴轨道高度（px）：滚动容器、轴、`scale`/`cursor` 层共用的高度。
-     * 仅 `orientation === 'horizontal'` 时生效；不传为 **48**（默认设计规格）。
-     */
-    horizontalTrackHeightPx?: number;
-    /**
-     * 营业时间范围（视觉高亮，可选限制选择范围）
-     */
-    businessHours?: TimeRangeOption;
-    /**
-     * 禁用时间段，禁止选中（点击/吸附到该区间无效）
-     */
-    disabledRanges?: TimeRangeOption[];
-    /**
-     * 是否显示 Now 按钮（固定入口）
-     * @default true
-     */
-    showNowButton?: boolean;
-    /**
-     * 为 true 时禁止用户拖动/滚动时间轴、点击刻度改时间（仍随 `value` 程序性对齐视口；用于「跟随当前时刻」等只读轴）
-     * @default false
-     */
-    userInteractionLocked?: boolean;
-    /**
-     * 是否吸附到 step 刻度
-     * @default false
-     */
-    snapToStep?: boolean;
-    /**
-     * 是否开启惯性滚动（拖动松手后减速）
-     * @default false
-     */
-    inertia?: boolean;
-    /**
-     * 过去时间淡化背景色（CSS 颜色值）
-     */
-    pastTimeFade?: string;
-    /**
-     * 容器样式覆盖
-     */
-    containerStyle?: CSSProperties;
-    /**
-     * 刻度层样式覆盖
-     */
-    scaleStyle?: CSSProperties;
-    /**
-     * 时间气泡/竖线样式覆盖（区分 realtime 时由组件内部应用主题色）
-     */
-    cursorStyle?: CSSProperties;
-    /**
-     * Now 按钮样式覆盖
-     */
-    nowButtonStyle?: CSSProperties;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-    /**
-     * 根节点自定义样式
-     */
-    style?: CSSProperties;
-    /**
-     * dayjs locale
-     */
-    locale?: string;
-    /**
-     * 时间气泡展示格式（dayjs format）
-     * @default 'HH:mm'
-     */
-    timeFormat?: string;
-    /**
-     * 自定义游标/拖拽气泡文案；不传则按 `timeFormat` 格式化 `value`。
-     * 预约跨日营业可传相对顶栏锚定日的「次日 HH:mm」。
-     */
-    formatTimeLabel?: (value: Dayjs) => string;
-    /**
-     * 自定义 Now 按钮内容（覆盖默认文案与图标时使用）
-     */
-    renderNowButton?: () => ReactNode;
-    /**
-     * 横向轴上与刻度槽位数一致的密度序列（任意正数，内部按最大值归一化折线高度）
-     */
-    densitySeries?: number[];
-    /**
-     * 未传 `densitySeries` 时按 `referenceDate` 拉取；日历日变更会重新请求，过期响应丢弃
-     */
-    loadDensity?: (params: {
-        referenceDate: Dayjs;
-        stepMinutes: number;
-    }) => Promise<number[]>;
-    /**
-     * 用户开始操作时间轴（拖轴、点刻度、键盘、拖指针等）时回调；用于上层关闭「跟随当前」等。
-     */
-    onUserInteraction?: () => void;
-}

package/es/components/pisellTimeNavigator/utils/index.d.ts

@@ -1,79 +0,0 @@
-import { type Dayjs } from 'dayjs';
-import type { TimeNavigatorValue, TimeRangeOption } from '../types';
-/**
- * 解析 value 为 Dayjs，无效则返回 null。
- * 支持 dayjs 可解析的日期时间；纯时间字符串（如 '12:00'、'14:30'）会基于 reference 的日期解析。
- */
-export declare function parseValue(value: TimeNavigatorValue, reference?: Dayjs): Dayjs | null;
-/** 日历时间轴默认步长（分钟），与历史「整点列」一致 */
-export declare const DEFAULT_CALENDAR_SLOT_STEP_MINUTES = 60;
-/**
- * 按营业日 {@link TimeRangeOption} 在锚定自然日零点展开，生成日视图时间轴「列左边界」：
- * 值为相对 `reference.startOf('day')` 的**浮点小时**（可 ≥24，表示次日时刻），步长为 `slotStepMinutes`。
- */
-export declare function buildCalendarTimelineSlotStartsFromRange(range: TimeRangeOption | undefined, anchorDate: Date | Dayjs, slotStepMinutes?: number): number[];
-/**
- * @deprecated 语义上等价于 {@link buildCalendarTimelineSlotStartsFromRange}(..., 60)；保留兼容导出。
- */
-export declare function buildCalendarHourSlotsFromRange(range: TimeRangeOption | undefined, anchorDate: Date | Dayjs): number[];
-/**
- * 将 range 转为 [startDayjs, endDayjs]（reference 为营业锚定日的 0 点）
- * - 同日内：如 08:00–22:00
- * - 跨日营业：结束钟面早于或等于开始（如 02:01–次日 02:00）时，end 解析为 reference 的次日同一时刻
- */
-export declare function getRangeBounds(range: TimeRangeOption | undefined, reference: Dayjs): [Dayjs, Dayjs];
-/**
- * 自动挑选「能让 `now` 落入 [refDay + range.start, refDay + range.end] 营业窗口」的锚定日。
- *
- * 调用方未显式传入 `referenceDate` 时使用：保证当前时刻始终在轴可视范围内，
- * 横向「现在」橙色高亮 / 竖向当前时间横线永远展示。
- *
- * 解析顺序：
- * 1. 先尝试 `now.startOf('day')`（典型场景：跨日营业 18:00–04:00 时，下午 20:00 直接命中今天的窗口）；
- * 2. 命中失败时尝试前一日（如营业 16:00–次日 16:00，now = 中午 12:00 时窗口需锚到昨天）；
- * 3. 再尝试次日（如营业 16:00–次日 16:00，now 处于「即将进入下一个营业日」的边界附近）；
- * 4. 三个候选都不包含 now（营业时段较短且 now 落在闭店时段，如 09:00–22:00 + now=23:00）时，
- *    回退到 `now.startOf('day')`，保持原有行为，不强行扭曲日期。
- */
-export declare function pickReferenceDateContainingNow(range: TimeRangeOption | undefined, now: Dayjs): Dayjs;
-/**
- * 将时间吸附到 step 分钟刻度（0、15、30、45 等）：四舍五入到最近刻度。
- */
-export declare function snapToStepMinutes(t: Dayjs, stepMinutes: number): Dayjs;
-/**
- * 判断时间是否落在任一禁用区间内（按绝对时间与区间 [start,end) 比较）
- * 注：与主时间轴同 reference 的跨日 range 一致时需传入同一营业锚定日解析出的区间。
- */
-export declare function isInDisabledRanges(t: Dayjs, disabledRanges: TimeRangeOption[] | undefined): boolean;
-/**
- * 在 [rangeStart, rangeEnd] 内按 stepMinutes 生成等步刻度时间列表（Dayjs）。
- *
- * @deprecated 仅用于不需要「头/尾 partial 格」的场景；时间轴渲染请用 {@link getAxisCells}。
- */
-export declare function getTicks(rangeStart: Dayjs, rangeEnd: Dayjs, stepMinutes: number): Dayjs[];
-/**
- * 时间轴上一格的描述：起始时间 + 跨度（分钟）。
- * - 中间格：跨度 = `stepMinutes`，起点对齐到 step 网格（如 15 分钟一格时落在 `:00/:15/:30/:45`）；
- * - head 格：当 `rangeStart` 不在网格上时存在，起点 = `rangeStart`，跨度 < step；
- * - tail 格：当 `rangeEnd` 不在网格上时存在，起点 = 最后一个对齐点，跨度 < step。
- */
-export interface AxisCell {
-    start: Dayjs;
-    widthMinutes: number;
-}
-/**
- * 把 [`rangeStart`, `rangeEnd`] 切成「对齐到 step 网格」的格子序列：
- *
- * 1. 找到第一个 ≥ `rangeStart` 且分钟为 `stepMinutes` 整数倍的对齐点；
- * 2. 若对齐点严格大于 `rangeStart`，先放一格 head（`rangeStart` → 对齐点），跨度 < step；
- * 3. 中间按 step 步进，每格起点都落在网格上；
- * 4. 若 `rangeEnd` 落在两个对齐点之间，最后多出一格 tail（最后对齐点 → `rangeEnd`），跨度 < step。
- *
- * `rangeStart` / `rangeEnd` 都恰落在网格上时退化为完全等步格。
- */
-export declare function getAxisCells(rangeStart: Dayjs, rangeEnd: Dayjs, stepMinutes: number): AxisCell[];
-/**
- * 横向时间轴「格」数量，与 useTimeAxis 中 cells 算法一致。
- * 用于 cursor-moves 模式下计算压缩后的每格像素宽度。
- */
-export declare function getHorizontalAxisSlotCount(range: TimeRangeOption | undefined, referenceDate: Dayjs, stepMinutes: number): number;

package/es/components/pisellTimeRangeDisplay/utils/formatDuration.d.ts

@@ -1,14 +0,0 @@
-/**
- * 将毫秒数格式化为持续时间字符串（d h m s 或 天/时/分/秒）
- *
- * @param ms 持续时间（毫秒）
- * @param showSeconds 是否显示秒，默认 false
- * @param locale 语言代码，zh 时使用「天/时/分/秒」，否则使用 d/h/m/s
- * @returns 如 "2h30m"、"1d2h30m23s" 或 "2时30分"、"1天2时30分23秒"
- *
- * @example
- * formatDuration(9000000, false)        // => "2h30m"
- * formatDuration(9000000, false, 'zh-cn') // => "2时30分"
- * formatDuration(86400000, false)       // => "1d"
- */
-export declare function formatDuration(ms: number, showSeconds?: boolean, locale?: string): string;

package/es/components/pisellUrl/utils/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * PisellUrl 工具函数导出
- */
-export * from './urlValidator';
-export * from './urlHelper';
-export * from './urlFormatter';