@pisell/materials 3.3.100 → 3.3.101

package/es/components/pisellFloorMapLayout/shopFloorPlan/shopFloorPlanTypes.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 店铺平面图 HTTP 契约（/shop/schedule/floor-plan）与 {@link FloorMapViewConfig} 映射所用类型。
+ * 具体请求由 {@link ShopFloorPlanHttpAdapter} 注入，便于 materials 不依赖宿主 request 实现。
+ */
+/** 遇 code 重复（接口 5001）时，{@link isFloorPlanDuplicateCodeError} 依赖此字段 */
+export declare const SHOP_FLOOR_PLAN_DUPLICATE_CODE = "floorPlanDuplicateCode";
+export interface ShopFloorPlanDetail {
+    id: number;
+    shop_id?: number;
+    code?: string;
+    name?: string | Record<string, string>;
+    layout: unknown;
+    canvas_width?: number;
+    canvas_height?: number;
+    sort?: number;
+    status?: number;
+    created_at?: string;
+    updated_at?: string;
+    [key: string]: unknown;
+}
+export interface ShopFloorPlanLayoutItem {
+    id: string;
+    type: 'rect' | 'circle';
+    label: string;
+    x: number;
+    y: number;
+    rotation: number;
+    color: string;
+    border_color: string;
+    resource_id: number | null;
+    width?: number;
+    height?: number;
+    radius?: number;
+    [key: string]: unknown;
+}
+export interface PostShopFloorPlanBody {
+    code: string;
+    name: Record<string, string>;
+    layout?: unknown;
+    canvas_width?: number;
+    canvas_height?: number;
+    sort?: number;
+    status?: number;
+}
+export interface PutShopFloorPlanBody {
+    code?: string;
+    name?: Record<string, string>;
+    layout?: unknown;
+    canvas_width?: number;
+    canvas_height?: number;
+    sort?: number;
+    status?: number;
+}
+export interface ShopFloorPlanByCodeRequestOptions {
+    osServer?: boolean;
+    subscriberId?: string;
+    callback?: (res: unknown) => void;
+}
+export declare type ShopFloorPlanHttpAdapter = {
+    get: (url: string, params?: unknown, config?: Record<string, unknown>) => Promise<unknown>;
+    post: (url: string, body?: unknown, config?: Record<string, unknown>) => Promise<unknown>;
+    put: (url: string, body?: unknown, config?: Record<string, unknown>) => Promise<unknown>;
+};
+export declare type CreateShopFloorPlanClientOptions = {
+    http: ShopFloorPlanHttpAdapter;
+    /** POST/PUT 失败且无更具体 message 时的兜底文案（静态；若需随语言切换请用 getSaveFailedMessage） */
+    saveFailedMessage?: string;
+    /** 保存失败时按当前运行时语言解析兜底文案（优先于 saveFailedMessage） */
+    getSaveFailedMessage?: () => string;
+    /**
+     * 是否走宿主 shop request 通道（`isShopApi`）。
+     * 默认 true：本 client 仅用于 `/shop/schedule/floor-plan`；拓扑单次 GET（无订阅）也需 shop 路由。
+     * 仅在极少数非 shop 宿主探测场景传 false。
+     */
+    useShopApi?: boolean;
+};
+/** ensure 流程可选：404 时 POST 创建体由调用方注入 */
+export declare type EnsureShopFloorPlanByCodeOptions = ShopFloorPlanByCodeRequestOptions & {
+    buildDefaultPostBody?: (code: string) => PostShopFloorPlanBody;
+};

package/es/components/pisellFloorMapLayout/utils/alignSnap.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 拖动/缩放图元时的「边缘对齐吸附」：对照其他图元的 6 条候选线
+ * （左/中/右 + 上/中/下），如果当前 rect 的对应边距离它们小于
+ * 阈值（内容坐标），就把 rect 平移到精确贴合，并返回参考辅助线，
+ * 供画布上渲染红色对齐线。
+ *
+ * 阈值应保持小（典型 4~8 px / scale），避免吞掉正常拖动手感。
+ */
+export interface AlignSnapRect {
+    /** 用于排除自身。可为 undefined 表示参与对齐的"其他" rect */
+    id?: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export declare type AlignGuideEdgeX = 'left' | 'centerX' | 'right';
+export declare type AlignGuideEdgeY = 'top' | 'centerY' | 'bottom';
+export interface AlignGuide {
+    orientation: 'v' | 'h';
+    /** 该参考线所在坐标（v: x；h: y） */
+    position: number;
+    /** 沿参考线方向的覆盖范围 [min, max]，便于 SVG 渲染端到端 */
+    start: number;
+    end: number;
+    /** 命中的当前 rect 边 */
+    selfEdge: AlignGuideEdgeX | AlignGuideEdgeY;
+    /** 命中的对方 rect 边 */
+    otherEdge: AlignGuideEdgeX | AlignGuideEdgeY;
+    /** 命中的对方 rect id（如果有） */
+    otherId?: string;
+}
+export interface AlignSnapResult {
+    rect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    guides: AlignGuide[];
+}
+/** 拖动模式：x/y 两轴可独立平移；不改尺寸 */
+export interface AlignSnapDragOptions {
+    mode: 'drag';
+    threshold: number;
+}
+/** 缩放模式：根据 handle 决定 left/right/top/bottom 哪条边可动 */
+export interface AlignSnapResizeOptions {
+    mode: 'resize';
+    threshold: number;
+    /** 哪些边在当前缩放手柄下「可动」 */
+    movableEdgesX?: ('left' | 'right')[];
+    movableEdgesY?: ('top' | 'bottom')[];
+}
+export declare type AlignSnapOptions = AlignSnapDragOptions | AlignSnapResizeOptions;
+/**
+ * 对一个 rect 做边对齐吸附。返回 snap 后的 rect + 实际命中的辅助线（0~2 条）。
+ *
+ * 算法：对 x、y 轴独立处理；每轴在所有「自身 3 边 × 所有 other 3 边」组合
+ * 中选距离最小且 < threshold 的一对，把自身整体平移让它们贴齐；同时记录
+ * 所有「平移后仍精确贴齐」的参考线（可能不止 1 条，例如 left 和 centerX
+ * 同时与他人对齐时只有 1 条平移量但 2 条 guide）。
+ */
+export declare function snapRectToOthers(rect: AlignSnapRect, others: AlignSnapRect[], options: AlignSnapOptions): AlignSnapResult;

package/es/components/pisellFloorMapLayout/utils/floorMapBuiltinShapes.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 内置图形图元（`floorMapBuiltinShape`）的预设清单。
+ *
+ * 每个预设：
+ * - `key`：持久化在 `sceneElement.builtinShapeKey`，跨语言稳定；
+ * - `labelKey`：展示名 i18n key（在 `locales.ts` / `-ja` / `-pt` 中维护）；
+ * - `defaultSize`：调色板落点 / 切换 kind 时的初始像素尺寸，比例与下文 viewBox 一致；
+ * - `render(props)`：内置 SVG 图形（统一 `preserveAspectRatio="xMidYMid meet"`，
+ *   按 viewBox 自然比例缩放并居中，容器尺寸变化时不会被拉伸变形）。
+ *
+ * 不引入图片资源 / 字体图标，全部 inline SVG，避免额外构建依赖与请求。
+ */
+import React from 'react';
+/** 内置图形渲染函数共享 props（容器已限定 100% 宽高） */
+export interface FloorMapBuiltinShapeRenderProps {
+    /** 主体填充色（壳层为浅灰），允许通过 sceneElement.fillColor 覆盖 */
+    fillColor?: string;
+    /** 描边色，允许通过 sceneElement.strokeColor 覆盖 */
+    strokeColor?: string;
+}
+export interface FloorMapBuiltinShapeDef {
+    key: string;
+    /** i18n 文案 key（在 locales.ts 中维护中英繁日葡） */
+    labelKey: string;
+    /** 调色板落点时的默认像素尺寸；比例与 viewBox 对齐，避免落点后立刻变形 */
+    defaultSize: {
+        width: number;
+        height: number;
+    };
+    /** 内置 SVG 渲染（按 viewBox 比例缩放，容器变化时居中保比例） */
+    render: (props: FloorMapBuiltinShapeRenderProps) => React.ReactElement;
+    /**
+     * 是否随容器宽高自动切换横/竖方向。
+     * - `true`：容器高 > 宽时，wrapper 自动给整张图形 rotate 90deg，让图形在画
+     *   布上看起来始终「贴墙 / 贴边」。比追加一个 `*-vertical` key 更直观，
+     *   也不需要持久化方向，纯几何 fit。
+     * - 默认 `false`（厕所 / 柱子 / 分隔等无方向语义或自带 stretch 策略的图形）。
+     */
+    orientationAware?: boolean;
+}
+/** 默认主色 / 描边色：偏中性灰，与地面其它图元（房间 / 桌位）调性一致 */
+declare const DEFAULT_FILL = "#f1f3f5";
+declare const DEFAULT_STROKE = "#6b7280";
+/**
+ * 内置图形预设清单（顺序即调色板 / 编辑面板下拉的展示顺序）。
+ * `defaultSize` 比例严格跟随对应 SVG 的 viewBox：
+ * - 厕所 / 柱子 / 大门：正方形（viewBox 100×100）
+ * - 分隔：viewBox 100×100，但渲染层用 `preserveAspectRatio="none"`，
+ *   `defaultSize` 给个常用的瘦高比例（32×160）作为「默认竖分隔」落点，
+ *   用户可直接拖宽变横分隔，不需要换 key。
+ * - 沙发：2:1 水平（viewBox 200×100）
+ *
+ * 新增预设：在此追加一项即可，编辑面板 / 调色板 / fallback 渲染会自动适配。
+ */
+export declare const FLOOR_MAP_BUILTIN_SHAPES: FloorMapBuiltinShapeDef[];
+/** 通过 key 查找预设，未命中返回 undefined（让上层显示「未选择」占位） */
+export declare function getFloorMapBuiltinShapeDef(key: string | undefined): FloorMapBuiltinShapeDef | undefined;
+export { DEFAULT_FILL as FLOOR_MAP_BUILTIN_SHAPE_DEFAULT_FILL };
+export { DEFAULT_STROKE as FLOOR_MAP_BUILTIN_SHAPE_DEFAULT_STROKE };

package/es/components/pisellFloorMapLayout/utils/floorMapDataRecordLabel.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 平面图数据行在下拉选项中的展示文案（侧栏「选择数据行」、工具栏多选记录）
+ * 仅展示名称侧一条：main_field（取 ## 前段）→ code → name；不再拼接 id、form_code、status。
+ */
+export declare function formatDataRecordOptionLabel(record: {
+    id: string;
+    [k: string]: unknown;
+}): string;

package/es/components/pisellFloorMapLayout/utils/floorMapDropUtils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 平面图编辑态：侧栏图元拖拽到画布的 DataTransfer 与坐标
+ */
+/** 与 setData 一致，用于识别左侧图元栏发起的拖拽 */
+export declare const FLOOR_MAP_PALETTE_DRAG_MIME = "application/x-pisell-floor-map-element";
+export interface FloorMapPaletteDragPayload {
+    elementKind: string;
+    dataSourceKey?: string;
+    recordId?: string;
+    recordIds?: string[];
+    /**
+     * 内置图形 kind 拖拽时，侧栏预选的图形 key（{@link FLOOR_MAP_BUILTIN_SHAPES}）；
+     * 落点会以此为初始 `sceneElement.builtinShapeKey` 与默认像素尺寸。
+     * 其它 kind 不读取此字段。
+     */
+    builtinShapeKey?: string;
+}
+/**
+ * 与 {@link useFloorMapEditState} 落点一致：内容区 drop 的 offset 减去内容区 padding 偏移
+ */
+export declare function sceneXYFromContentDropOffset(offsetX: number, offsetY: number, contentOffset: {
+    x: number;
+    y: number;
+}): {
+    x: number;
+    y: number;
+};
+/** 是否为左侧图元栏拖拽（非本地文件 / 外链图片） */
+export declare function isFloorMapPaletteDrag(dt: DataTransfer | null): boolean;
+/**
+ * 解析侧栏拖拽 payload；非法时返回 null
+ */
+export declare function parsePaletteDragPayload(dt: DataTransfer): FloorMapPaletteDragPayload | null;

package/es/components/pisellFloorMapLayout/utils/floorMapElementNameAsTitle.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 「将图元名作为资源标题」开关：通用读写 + 标题解析。
+ *
+ * - 持久化在 `sceneElement.extensions[NAME_AS_TITLE_EXT_KEY]`，避免污染顶层 schema、
+ *   不影响未启用该能力的旧 / 新 kind。
+ * - 是否在编辑面板「显示」该选项，由 `FloorMapElementKindConfig.nameAsTitleConfigurable`
+ *   控制；展示侧（业务卡片渲染）只读 extensions，不依赖 kindConfig，确保即便业务方
+ *   后续撤回 kindConfig 开关，已落库的偏好仍生效。
+ */
+/** 持久化字段名：固定字符串，跨包共用，勿改 */
+export declare const NAME_AS_TITLE_EXT_KEY: "nameAsTitle";
+interface ElementWithExtensions {
+    name?: string;
+    extensions?: Record<string, unknown>;
+}
+/** 安全读取「图元名作为标题」开关 */
+export declare function isElementNameAsTitleEnabled(el: ElementWithExtensions | null | undefined): boolean;
+/**
+ * 计算 `extensions` patch：返回值供调用方写入 `sceneElement.extensions`。
+ *
+ * - `enabled === true` 时写入 `true`；
+ * - `enabled === false` 时**移除**该 key（而非写 `false`），避免持久化里残留无意义字段；
+ * - 返回 `undefined` 表示「extensions 整体可清空」（仅当结果是空对象时）。
+ *
+ * @example
+ * const nextExt = buildNameAsTitleExtensionsPatch(el.extensions, true);
+ * onUpdate({ extensions: nextExt });
+ */
+export declare function buildNameAsTitleExtensionsPatch(prev: Record<string, unknown> | undefined, enabled: boolean): Record<string, unknown> | undefined;
+/**
+ * 通用图元标题解析：业务展示层（卡片标题、占位标题等）统一调用本函数，
+ * 让「图元名作为资源标题」这一偏好对所有接入方一致生效。
+ *
+ * 优先级：
+ *   1. 启用了 nameAsTitle 且 `el.name` 非空 → `el.name`
+ *   2. `recordTitle`（业务侧按自己规则算出来的，如预约页 `row.main_field` / `row.code`）
+ *   3. `el.name`（业务字段缺失时的兜底，与历史行为一致）
+ *   4. `fallback`（如 kindLabel）
+ *   5. 空串
+ *
+ * 不更改 `displayRoomTitleFromRow` / `record.name` 等业务函数本身，
+ * 业务方只需把"按业务字段"算出来的结果以 `recordTitle` 传入即可，
+ * `bookingDetailModal` 等下游不会被联动改坏。
+ */
+export declare function resolveSceneElementDisplayTitle(opts: {
+    sceneElement?: ElementWithExtensions | null;
+    recordTitle?: string;
+    fallback?: string;
+}): string;
+export {};

package/es/components/pisellFloorMapLayout/utils/floorMapResourcePickerDisplay.d.ts

@@ -0,0 +1,27 @@
+import type { PisellCardPickerCardBadge, PisellCardPickerCardMeta, PisellCardPickerCategoryConfig, PisellCardPickerItem } from './floorMapResourcePickerTypes';
+import { parseNestedPathSegments } from './floorMapResourcePickerTypes';
+/** @deprecated 使用 PisellCardPickerItem */
+export declare type FloorMapResourcePickerRecord = PisellCardPickerItem;
+/** 平面图资源选择卡片 meta：在通用 meta 基础上确保 id 存在，便于搜索文本拼接 */
+export interface FloorMapResourcePickerCardMeta extends PisellCardPickerCardMeta {
+    id: string;
+}
+/** 人数/容量：无值或为 0 时不展示 */
+export declare function resolveResourcePickerCapacity(record: PisellCardPickerItem): string | undefined;
+/**
+ * 预约桌位：从 `area` 解析路径，最多 3 段。
+ * 当前资源多为单段（如 `party_room1`）；将来 `广东/中山/三乡` 会自动出现二、三级筛选行。
+ */
+export declare function getFloorMapResourcePickerCategoryPath(record: PisellCardPickerItem): ReturnType<typeof parseNestedPathSegments>;
+/** 平面图 / 预约：area 最多三级；仅展示 chip，不显示行左侧「区域」等标签 */
+export declare function getFloorMapCardPickerCategoryConfig(): PisellCardPickerCategoryConfig;
+/**
+ * 把 capacity 字符串包装成「人数图标 + 数值」badge。
+ * 抽出来便于业务侧组合（如再追加 status badge 等）。
+ */
+export declare function buildResourceCapacityBadge(capacity?: string): PisellCardPickerCardBadge | null;
+/**
+ * 小卡片主标题 + 标签（人数等；区域已在筛选区展示，副文案不再重复 area）。
+ */
+export declare function getFloorMapResourcePickerCardMeta(record: PisellCardPickerItem): FloorMapResourcePickerCardMeta;
+export declare function floorMapResourcePickerRecordSearchText(record: PisellCardPickerItem): string;

package/es/components/pisellFloorMapLayout/utils/floorMapResourcePickerTypes.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 平面图资源选择槽位的通用类型与工具。
+ * 默认由 `@pisell/materials` 的 `PisellResourcePickerModal` 承担；
+ * 业务可通过 `renderFilterBar` 注入 Tabbar 等筛选区，或通过 `renderResourcePickerModal` 整页覆盖。
+ */
+import type { ReactNode } from 'react';
+/** 选择模式 */
+export declare type PisellCardPickerMode = 'single' | 'multiple';
+/** 可选条目：至少包含稳定主键 id */
+export interface PisellCardPickerItem {
+    id: string;
+    [key: string]: unknown;
+}
+/** 分类路径，最多 3 级（不足时后续为 null；未选层级表示「全部」） */
+export declare type PisellCardPickerCategoryPath = [
+    string | null | undefined,
+    string | null | undefined,
+    string | null | undefined
+];
+/** 单级分类配置（最多 3 级） */
+export interface PisellCardPickerCategoryLevelConfig {
+    /** 嵌套模式下该级行左侧标签（如「省」「市」「区/镇」） */
+    label?: string;
+    /**
+     * parallel 模式：从 item[field] 读取该维度的 key。
+     * nested 模式：请用 getCategoryPath / nestedPathField 从单字段拆路径。
+     */
+    field?: string;
+}
+/**
+ * nested：同一维度嵌套分级（广东 → 中山 → 三乡），子级依赖父级已选。
+ * parallel：三个独立维度（每级互不影响）。
+ */
+export declare type PisellCardPickerCategoryMode = 'nested' | 'parallel';
+/** 分类筛选配置（最多 3 级；数据只有 1 级时 UI 只展示有值的那一行） */
+export interface PisellCardPickerCategoryConfig {
+    /** 默认 nested */
+    mode?: PisellCardPickerCategoryMode;
+    /**
+     * 最多 3 级配置位。
+     * nested：单字段拆路径；仅 1 段时只出现第 1 行，多段时再逐级出现。
+     */
+    levels: [
+        PisellCardPickerCategoryLevelConfig?,
+        PisellCardPickerCategoryLevelConfig?,
+        PisellCardPickerCategoryLevelConfig?
+    ];
+    /** 自定义 [L1,L2,L3]；优先于 levels[].field */
+    getCategoryPath?: (item: PisellCardPickerItem) => PisellCardPickerCategoryPath;
+    /**
+     * nested 便捷项：从 item[nestedPathField] 用 `/` `>` 等拆成最多 3 段。
+     * 与 getCategoryPath 同时存在时以 getCategoryPath 为准。
+     */
+    nestedPathField?: string;
+}
+/**
+ * 卡片小标签（如人数、状态、面积等）。
+ * - text：必填，纯文本内容
+ * - icon：可选 ReactNode，前置图标（如 TeamOutlined）
+ * 业务自由组合多个；空数组等价于不展示。
+ */
+export interface PisellCardPickerCardBadge {
+    text: string;
+    icon?: ReactNode;
+}
+export interface PisellCardPickerCardMeta {
+    title: string;
+    subtitles: string[];
+    /**
+     * 卡片末行的标签数组（如人数 / 状态）。比 subtitle 更紧凑，支持前置 icon。
+     */
+    badges?: PisellCardPickerCardBadge[];
+    /**
+     * 左侧缩略图/预览节点。传入字符串走内置 `<img>`，传入 ReactNode 直接渲染
+     * （如平面图 View All 的 palette preview cell）。
+     */
+    image?: ReactNode | string;
+}
+/**
+ * 平面图工具栏「打开资源选择」槽位 props。
+ * 与 `PisellProResourcePickerModalProps` 字段对齐；业务注入 modal 时可透传
+ * `categoryConfig` / `getSearchText` / `getCardMeta` 等扩展项。
+ */
+export interface FloorMapResourcePickerSlotProps {
+    open: boolean;
+    onClose: () => void;
+    onConfirm: (selectedIds: string[]) => void;
+    records: PisellCardPickerItem[];
+    mode?: PisellCardPickerMode;
+    value?: string[];
+    title?: string;
+    disabledIds?: string[];
+    /** 最多三级分类；不传则仅搜索 + 列表 */
+    categoryConfig?: PisellCardPickerCategoryConfig;
+    getSearchText?: (record: PisellCardPickerItem) => string;
+    getCardMeta?: (record: PisellCardPickerItem) => PisellCardPickerCardMeta;
+    renderCard?: (record: PisellCardPickerItem, ctx: {
+        selected: boolean;
+        disabled: boolean;
+    }) => ReactNode;
+    zIndex?: number;
+    width?: number;
+    className?: string;
+}
+/**
+ * 把单字段中的层级路径解析为 [L1, L2, L3]。
+ * 例：`广东/中山/三乡` → `['广东','中山','三乡']`；不足三级后续为 null。
+ */
+export declare function parseNestedPathSegments(raw: unknown, maxDepth?: number): PisellCardPickerCategoryPath;

package/es/components/pisellFloorMapLayout/utils/floorMapStageDefaults.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 舞台/区域类装饰：落点默认尺寸与默认显示名（与 FLOOR_MAP_STAGE_ELEMENT_KIND 配套）
+ */
+export declare const STAGE_DECO_DEFAULT: {
+    readonly width: 320;
+    readonly height: 120;
+    readonly name: "舞台";
+};

package/es/components/pisellFloorMapLayout/utils/snap.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 吸附：将坐标或尺寸按 snapStep 取整；snapStep 为 0 不吸附
+ */
+export declare function snapValue(value: number, snapStep: number): number;
+export declare function snapRect(x: number, y: number, width: number, height: number, snapStep: number): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};

package/es/components/pisellGridPro/GridPro.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import './index.less';
+export interface GridProProps {
+    className?: string;
+    children?: React.ReactNode;
+    style?: React.CSSProperties;
+}
+declare const PisellGridPro: (props: GridProProps) => JSX.Element;
+export default PisellGridPro;

package/es/components/pisellGridPro/ToolBar/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import './index.less';
+import { ToolBarProps } from './type';
+export type { ToolBarProps };
+declare const Toolbar: React.FC<ToolBarProps>;
+export default Toolbar;

package/es/components/pisellGridPro/ToolBar/type.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+export interface ToolBarProps {
+    className?: string;
+    style?: React.CSSProperties;
+    tabs?: React.ReactNode;
+    topLeft?: React.ReactNode;
+    topRight?: React.ReactNode;
+    bottomLeft?: React.ReactNode;
+    bottomRight?: React.ReactNode;
+}

package/es/components/pisellGridPro/components/DataCard/components/StatCard/index.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { StatCardItem } from '../../types';
+import './index.less';
+/**
+ * StatCard 统计卡片组件
+ * @description 用于展示单个统计数据，包含标题、数值和对比信息
+ * @author Pisell Team
+ */
+declare const StatCard: React.FC<StatCardItem>;
+export default StatCard;

package/es/components/pisellGridPro/components/DataCard/index.d.ts

@@ -0,0 +1,5 @@
+import { DataCardProps } from './types';
+export type { DataCardProps };
+import './index.less';
+declare const DataCard: (props: DataCardProps) => JSX.Element | null;
+export default DataCard;

package/es/components/pisellGridPro/components/DataCard/types.d.ts

@@ -0,0 +1,70 @@
+import React from 'react';
+/**
+ * PisellGridProDataCard 组件属性接口
+ */
+export interface DataCardProps {
+    /**
+     * 统计卡片数据列表
+     */
+    dataItems?: StatCardItem[];
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: React.CSSProperties;
+}
+/**
+ * 统计卡片数据项接口
+ */
+export interface StatCardItem {
+    /**
+     * 唯一标识
+     */
+    key: string;
+    /**
+     * 卡片标题
+     * @example "Total Orders"
+     */
+    title: React.ReactNode;
+    /**
+     * 主要数值
+     * @example 50 或 "$1580"
+     */
+    value: React.ReactNode;
+    /**
+     * 对比数值
+     * @example "+12" 或 "-230"
+     */
+    compareValue?: React.ReactNode;
+    /**
+     * 对比趋势
+     * @description up-增长(绿色), down-下降(红色)
+     * @default undefined
+     */
+    trend?: 'up' | 'down';
+    /**
+     * 对比前缀文本
+     * @default "v.s. pre"
+     */
+    comparePrefix?: string;
+    /**
+     * 是否显示对比信息
+     * @default true
+     */
+    showCompare?: boolean;
+    /**
+     * 自定义卡片样式
+     */
+    style?: React.CSSProperties;
+    /**
+     * 自定义卡片类名
+     */
+    className?: string;
+    /**
+     * 点击回调
+     */
+    onClick?: () => void;
+}

package/es/components/pisellGridPro/components/Footer/index.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import './index.less';
+export interface FooterProps {
+    className?: string;
+    children?: React.ReactNode;
+    style?: React.CSSProperties;
+}
+declare const Footer: (props: FooterProps) => JSX.Element;
+export default Footer;

package/es/components/pisellGridPro/components/Header/index.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import './index.less';
+export interface HeaderProps {
+    title?: React.ReactNode;
+    badge?: React.ReactNode;
+    subTitle?: React.ReactNode;
+    actionsList?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const Header: React.FC<HeaderProps>;
+export default Header;

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

@@ -0,0 +1,4 @@
+import { GridProProps } from './GridPro';
+export type { GridProProps };
+declare const PisellGridPro: any;
+export default PisellGridPro;

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

@@ -0,0 +1,29 @@
+import React from 'react';
+import './index.less';
+export interface PisellHeaderProgressBarProps {
+    title?: React.ReactNode;
+    stepText?: React.ReactNode;
+    showClose?: boolean;
+    /** 是否启用投影 */
+    enableShadow?: boolean;
+    /** 是否启用描边 */
+    enableBorder?: boolean;
+    /** 描边粗细 */
+    borderWidth?: number;
+    /** 描边颜色 */
+    borderColor?: string;
+    /** 头部背景颜色 */
+    backgroundColor?: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 是否显示返回键 */
+    showBack?: boolean;
+    /** 返回按钮点击事件 */
+    onBack?: () => void;
+    /** 关闭按钮点击事件 */
+    onClose?: () => void;
+}
+declare const PisellHeaderProgressBar: React.FC<PisellHeaderProgressBarProps>;
+export default PisellHeaderProgressBar;

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

@@ -0,0 +1,18 @@
+import React from 'react';
+import 'swiper/swiper-bundle.css';
+import './index.less';
+export interface PisellImageCarouselsProps {
+    dataSource?: string[];
+    width?: number | string;
+    height?: number;
+    showArrows?: boolean;
+    showDots?: boolean;
+    autoplay?: boolean;
+    interval?: number;
+    borderRadius?: number;
+    loop?: boolean;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const PisellImageCarousels: React.FC<PisellImageCarouselsProps>;
+export default PisellImageCarousels;

package/es/components/pisellInformationEntry/Scan/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 export interface ScanProps {
     onChange: (val: string) => void;

package/es/components/pisellInformationEntry/hooks/useNativeScanner.d.ts

@@ -0,0 +1,4 @@
+export declare const useNativeScanner: (onChange?: ((val: string) => void) | undefined) => {
+    activeNativeScanner: () => void;
+    isTerminal: any;
+};