@pisell/materials 6.11.204 → 6.11.205

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

@@ -0,0 +1,175 @@
+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/lib/components/pisellTimeNavigator/utils/index.d.ts

@@ -0,0 +1,79 @@
+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/lib/components/productCard/cartSkuCard/components/packages/utils.d.ts

@@ -17,4 +17,4 @@ export declare const minusSign: (item: any, type?: string) => "" | "-";
  * @Author: WangHan
  * @Date: 2024-11-22 10:58
  */
-export declare const _formatAmount: (price?: number, amountSymbol?: string, digit?: number) => any;
+export declare const _formatAmount: (price?: number, amountSymbol?: string, digit?: number) => string | number;

package/lib/components/productCard/components/Packages/utils.d.ts

@@ -17,4 +17,4 @@ export declare const minusSign: (item: any, type?: string) => "" | "-";
  * @Author: WangHan
  * @Date: 2024-11-22 10:58
  */
-export declare const _formatAmount: (price?: number, amountSymbol?: string, digit?: number) => any;
+export declare const _formatAmount: (price?: number, amountSymbol?: string, digit?: number) => string | number;

package/lib/components/table/Gallery/components/VirtualGrid/useGapSize.d.ts

@@ -1,5 +1,5 @@
 declare const useGapSize: (gap: number | number[]) => {
-    horizontal: any;
-    vertical: any;
+    horizontal: number;
+    vertical: number;
 };
 export default useGapSize;

package/lib/components/table/Table/fields/date/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

package/lib/components/table/Table/fields/image/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 declare const _default: {
     field: {
         field_icon: string;

package/lib/components/table/Table/fields/link/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 declare const _default: {
     field: {
         field_icon: string;

package/lib/components/table/Table/fields/number/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

package/lib/components/table/Table/fields/numberRange/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

package/lib/components/table/Table/fields/oldRangePicker/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

package/lib/components/table/Table/fields/pSwitch/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 declare const _default: {
     field: {
         field_icon: string;

package/lib/components/table/Table/fields/rangePicker/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

package/lib/components/table/Table/fields/search/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

package/lib/components/table/Table/fields/select/Edit/index.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { EditPropsType } from "../../types";
+declare const _default: React.ForwardRefExoticComponent<Omit<EditPropsType, "ref"> & React.RefAttributes<any>>;
+export default _default;

package/lib/components/table/Table/fields/select/filterUtil/index.d.ts

@@ -2,4 +2,4 @@ export default function ({ value, key, item, }: {
     value: string | string[];
     key: string | string[];
     item: Record<string, any>;
-}): any;
+}): boolean;

package/lib/components/table/Table/fields/select/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

package/lib/components/table/Table/fields/treeSelect/filterUtil/index.d.ts

@@ -2,4 +2,4 @@ export default function ({ value, key, item, }: {
     value: string | string[] | Record<string, any>[];
     key: string | string[];
     item: Record<string, any>;
-}): any;
+}): boolean;

package/lib/components/table/Table/fields/treeSelect/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

package/lib/components/table/Table/utils.d.ts

@@ -155,7 +155,7 @@ export declare const getSettingKeyArrByMode: ({ filter, columnSetting, dataSourc
     sort?: SortType | undefined;
     mode: "" | "localStorage" | "remote";
     currentViewMode: ModeType;
-}) => ("filters" | "order_by" | "group_by" | "column_setting" | "gallery_setting" | "filter_setting" | "view_mode")[];
+}) => ("filter_setting" | "group_by" | "order_by" | "column_setting" | "view_mode" | "gallery_setting" | "filters")[];
 export declare const omit: (obj: Record<string, any>, keys: string[]) => Record<string, any>;
 export declare const stringify: (obj: Record<string, any>) => string;
 export {};

package/lib/utils/index.d.ts

@@ -1,4 +1,4 @@
 export declare const isBrowser: boolean;
-export declare const getCssNumber: (val: string | number) => string | number;
+export declare const getCssNumber: (val: string | number) => string;
 export declare function uuid(): string;
 export * from './mergeWith';

package/lib/utils/platform.d.ts

@@ -1 +1 @@
-export declare const isMobile: () => any;
+export declare const isMobile: () => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pisell/materials",
-  "version": "6.11.204",
+  "version": "6.11.205",
   "main": "./lib/index.js",
   "module": "./es/index.js",
   "types": "./lib/index.d.ts",