@pisell/materials 1.8.20 → 1.8.21

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

@@ -81,6 +81,11 @@ export interface FloorMapZoomConfig {
     max?: number;
     /** 缩放步进，默认 0.1 (10%) */
     step?: number;
+    /**
+     * 为 false 时关闭；未传或其它值时默认开启（平面图像素模式且当前画布有图元时，每画布自动 fitBounds 一次，可视区域刚好容纳全部图元）。
+     * 开启时跳过「首帧 defaultScale 左上对齐」，避免与 fit 闪动叠加。
+     */
+    autoFitOnMount?: boolean;
 }
 /**
  * 平移配置
@@ -103,6 +108,10 @@ export interface FloorMapControlsConfig {
     showFitBounds?: boolean;
     /** 是否显示全屏按钮，默认 false */
     showFullscreen?: boolean;
+    /**
+     * 是否显示网格开关（写入当前画布 draft 的 mapLayer.showGrid），默认 false
+     */
+    showGridToggle?: boolean;
 }
 /**
  * 布局模式（规则网格 vs 完全自由坐标）
@@ -312,7 +321,10 @@ export declare type FloorMapPlaceMode = null | {
     type: 'scene';
     elementKind: string;
     dataSourceKey?: string;
+    /** 单选落一条；与 {@link recordIds} 二选一，多选时优先 {@link recordIds} */
     recordId?: string;
+    /** 多选后在画布一次落多条，按锚点阶梯偏移 */
+    recordIds?: string[];
 };
 /** 阅读态 renderItem 可选第三参数 */
 export interface FloorMapRenderOptions {
@@ -377,6 +389,11 @@ export interface FloorMapEditPanelParams {
      * 用于提示用户点击顶部「保存」持久化布局草稿。
      */
     layoutDraftDirty?: boolean;
+    /**
+     * 为 false 时不渲染「数据绑定」下方的数据源记录编辑表单（FloorMapDataForm / 自定义 record 表单）；
+     * 数据绑定选数据源与选行仍可展示。
+     */
+    showDataSourceRecordFormBlock?: boolean;
 }
 /**
  * 合并当前画布的 sceneElements 为 items（用于 Layout 渲染）
@@ -400,7 +417,7 @@ export declare type FloorMapFullscreenMode = 'toggle' | 'locked' | 'disabled';
  * 平面图 Layout 注入上下文：数据、保存、侧栏表单与状态等（不包含 renderItem/mapLayer 等展示向 props）。
  * 由 `FloorMapLayoutProvider` / RecordBoard `floorMapLayoutContext` 提供，与 `PisellFloorMapLayout` props 按 `??` 合并，props 优先。
  */
-export declare type FloorMapLayoutContextValue = Partial<Pick<PisellFloorMapLayoutProps<FloorMapItemBase>, 'floorMapConfig' | 'dataSources' | 'onSave' | 'onDataSourceRecordSave' | 'dataSourceLabels' | 'dataSourceFormColumns' | 'dataSourceRecordForm' | 'loading' | 'saveError' | 'onElementRenderError' | 'toolbarShowSave' | 'floorMapFullscreenMode'>>;
+export declare type FloorMapLayoutContextValue = Partial<Pick<PisellFloorMapLayoutProps<FloorMapItemBase>, 'floorMapConfig' | 'dataSources' | 'onSave' | 'onDataSourceRecordSave' | 'dataSourceLabels' | 'dataSourceFormColumns' | 'dataSourceRecordForm' | 'loading' | 'saveError' | 'onElementRenderError' | 'toolbarShowSave' | 'floorMapFullscreenMode' | 'showDataSourceRecordFormBlock'>>;
 /**
  * PisellFloorMapLayout 组件 Props
  * @template T - 资源项类型，需继承 FloorMapItemBase 或兼容 id/x/y
@@ -527,7 +544,30 @@ export interface PisellFloorMapLayoutProps<T extends FloorMapItemBase = FloorMap
      * 是否在左侧工具栏底部显示「保存」（默认 true；非全屏时顶栏为 Tab+全屏，保存多在侧栏；全屏时保存仅在顶栏）
      */
     toolbarShowSave?: boolean;
+    /**
+     * 为 false 时隐藏侧栏「数据源记录」表单区（保留数据绑定选源/选行）。
+     */
+    showDataSourceRecordFormBlock?: boolean;
+    /**
+     * 画布 Tab 行右侧扩展（阅读态顶栏、编辑态 compact/full 顶栏），如业务「编辑平面图 / 完成编辑」。
+     * 传入且阅读态仅单画布时仍会显示顶栏以便放置该插槽；全屏入口由布局内建，可与本插槽同排展示。
+     */
+    canvasTabsBarTrailing?: ReactNode;
+    /**
+     * 平面图模式：在地图视口内悬浮层（不随画布缩放平移），如状态统计。
+     * 传入函数时可拿到当前画布合并后的 items 与数据源。
+     */
+    floorMapViewportOverlay?: ReactNode | ((args: FloorMapViewportOverlayRenderArgs<T>) => ReactNode);
 }
+/**
+ * {@link PisellFloorMapLayoutProps.floorMapViewportOverlay} 函数形态时的参数
+ */
+export declare type FloorMapViewportOverlayRenderArgs<T extends FloorMapItemBase = FloorMapItemBase> = {
+    items: T[];
+    dataSources: FloorMapDataSources | undefined;
+    currentCanvasId: string | null;
+    mode: 'read' | 'edit';
+};
 /**
  * PisellFloorMapLayout Ref 方法
  * @description 供外部调用缩放、复位、区域定位等
@@ -541,4 +581,6 @@ export interface PisellFloorMapLayoutRef {
     reset: () => void;
     /** 区域定位：使所有 items 落在视口内 */
     fitBounds: () => void;
+    /** 提交当前布局草稿（与顶栏/侧栏「保存」一致） */
+    saveLayout: () => void;
 }

package/es/components/pisellFloorMapLayout/types.js

@@ -142,6 +142,10 @@ export var FLOOR_MAP_IMAGE_ELEMENT_KIND = 'floorMapImage';
  * @template T - 资源项类型，需继承 FloorMapItemBase 或兼容 id/x/y
  */
 
+/**
+ * {@link PisellFloorMapLayoutProps.floorMapViewportOverlay} 函数形态时的参数
+ */
+
 /**
  * PisellFloorMapLayout Ref 方法
  * @description 供外部调用缩放、复位、区域定位等

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

@@ -0,0 +1,9 @@
+/**
+ * 平面图数据行在下拉选项中的展示文案（侧栏「选择数据行」、工具栏绑定行）
+ * 展示顺序：名称侧（main_field / code / name）→ 可选（status）→ 「 · 」后缀 id、form_code。
+ * form_code 可读 `form_code` 或预约行里的 `area`。
+ */
+export declare function formatDataRecordOptionLabel(record: {
+    id: string;
+    [k: string]: unknown;
+}): string;

package/es/components/pisellFloorMapLayout/utils/floorMapDataRecordLabel.js

@@ -0,0 +1,24 @@
+/**
+ * 平面图数据行在下拉选项中的展示文案（侧栏「选择数据行」、工具栏绑定行）
+ * 展示顺序：名称侧（main_field / code / name）→ 可选（status）→ 「 · 」后缀 id、form_code。
+ * form_code 可读 `form_code` 或预约行里的 `area`。
+ */
+export function formatDataRecordOptionLabel(record) {
+  var _rawMain$split$, _record$id;
+  var rawMain = record.main_field != null ? String(record.main_field) : '';
+  var mainField = rawMain ? ((_rawMain$split$ = rawMain.split(' ## ')[0]) !== null && _rawMain$split$ !== void 0 ? _rawMain$split$ : rawMain).trim() : '';
+  var code = record.code != null && String(record.code).trim() ? String(record.code).trim() : '';
+  var name = record.name != null ? String(record.name).trim() : '';
+  var status = record.status != null ? String(record.status) : '';
+  var idStr = String((_record$id = record.id) !== null && _record$id !== void 0 ? _record$id : '').trim();
+  var formCodeRaw = record.form_code != null && String(record.form_code).trim() ? String(record.form_code).trim() : record.area != null && String(record.area).trim() ? String(record.area).trim() : '';
+  var primary = mainField || code || name;
+  var tailParts = [idStr, formCodeRaw].filter(function (s) {
+    return s.length > 0;
+  });
+  var tail = tailParts.length ? " \xB7 ".concat(tailParts.join(' · ')) : '';
+  if (primary && status) return "".concat(primary, "\uFF08").concat(status, "\uFF09").concat(tail);
+  if (primary) return "".concat(primary).concat(tail);
+  if (tailParts.length) return tailParts.join(' · ');
+  return idStr || '—';
+}

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

@@ -7,6 +7,7 @@ export interface FloorMapPaletteDragPayload {
     elementKind: string;
     dataSourceKey?: string;
     recordId?: string;
+    recordIds?: string[];
 }
 /**
  * 与 {@link useFloorMapEditState} 落点一致：内容区 drop 的 offset 减去内容区 padding 偏移

package/es/components/pisellFloorMapLayout/utils/floorMapDropUtils.js

@@ -36,10 +36,19 @@ export function parsePaletteDragPayload(dt) {
     if (typeof elementKind !== 'string' || !elementKind) return null;
     var dataSourceKey = typeof rec.dataSourceKey === 'string' ? rec.dataSourceKey : undefined;
     var recordId = typeof rec.recordId === 'string' ? rec.recordId : undefined;
+    var recordIds;
+    var rawIds = rec.recordIds;
+    if (Array.isArray(rawIds)) {
+      recordIds = rawIds.filter(function (x) {
+        return typeof x === 'string' && x;
+      });
+      if (recordIds.length === 0) recordIds = undefined;
+    }
     return {
       elementKind: elementKind,
       dataSourceKey: dataSourceKey,
-      recordId: recordId
+      recordId: recordId,
+      recordIds: recordIds
     };
   } catch (_unused) {
     return null;

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

@@ -2,9 +2,20 @@
  * 图元种类解析与绑定展示前校验（供合并项渲染、工具栏逻辑复用）
  */
 import type { FloorMapElementKindConfig, FloorMapViewConfig, FloorMapSceneElement, FloorMapDataSources, FloorMapElementDataBindingPolicy } from '../types';
+/** 与 RecordBoard Story 一致：`floorMapImage` */
+export declare function isFloorMapImageElementKind(kind: string | undefined): boolean;
 /** dataBindingPolicy 缺省视为 none */
 export declare function resolveDataBindingPolicy(kind: FloorMapElementKindConfig | undefined): FloorMapElementDataBindingPolicy;
 export declare function getElementKindConfig(config: Pick<FloorMapViewConfig, 'elementKinds'> | undefined, elementKind: string | undefined): FloorMapElementKindConfig | undefined;
+/**
+ * 与调色板分组一致：取与当前图元 **同一 categoryId**（含未填 categoryId 时落到首个分类）下的可切换种类，
+ * 排除舞台、底图。若仅有一种则编辑面板可不展示切换器。
+ */
+export declare function getSwappableElementKindsInSameCategory(config: FloorMapViewConfig, elementKind: string | undefined): FloorMapElementKindConfig[];
+/**
+ * 在右侧编辑面板将图元改为同分类下的另一种 kind 时的草稿 patch（绑定不兼容则清空）
+ */
+export declare function patchSceneElementForKindSwitch(config: FloorMapViewConfig, element: FloorMapSceneElement, nextKindValue: string): Partial<FloorMapSceneElement>;
 /**
  * @returns 人类可读错误文案；无问题时返回 null
  */

package/es/components/pisellFloorMapLayout/utils/floorMapElementKindUtils.js

@@ -1,10 +1,22 @@
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
 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; }
 /**
  * 图元种类解析与绑定展示前校验（供合并项渲染、工具栏逻辑复用）
  */
 
+import { FLOOR_MAP_IMAGE_ELEMENT_KIND, FLOOR_MAP_STAGE_ELEMENT_KIND } from "../types";
+import { STAGE_DECO_DEFAULT } from "./floorMapStageDefaults";
+
+/** 与 RecordBoard Story 一致：`floorMapImage` */
+export function isFloorMapImageElementKind(kind) {
+  return kind === FLOOR_MAP_IMAGE_ELEMENT_KIND;
+}
+
 /** dataBindingPolicy 缺省视为 none */
 export function resolveDataBindingPolicy(kind) {
   var _kind$dataBindingPoli;
@@ -18,6 +30,80 @@ export function getElementKindConfig(config, elementKind) {
   });
 }
 
+/**
+ * 与调色板分组一致：取与当前图元 **同一 categoryId**（含未填 categoryId 时落到首个分类）下的可切换种类，
+ * 排除舞台、底图。若仅有一种则编辑面板可不展示切换器。
+ */
+export function getSwappableElementKindsInSameCategory(config, elementKind) {
+  var _config$elementKinds2, _config$elementKindCa, _sorted$0$id, _sorted$, _self$categoryId;
+  if (!elementKind || !((_config$elementKinds2 = config.elementKinds) !== null && _config$elementKinds2 !== void 0 && _config$elementKinds2.length)) return [];
+  var rawCats = (_config$elementKindCa = config.elementKindCategories) !== null && _config$elementKindCa !== void 0 ? _config$elementKindCa : [];
+  var sorted = _toConsumableArray(rawCats).sort(function (a, b) {
+    var _a$order, _b$order;
+    return ((_a$order = a.order) !== null && _a$order !== void 0 ? _a$order : 0) - ((_b$order = b.order) !== null && _b$order !== void 0 ? _b$order : 0);
+  });
+  var fallbackId = (_sorted$0$id = (_sorted$ = sorted[0]) === null || _sorted$ === void 0 ? void 0 : _sorted$.id) !== null && _sorted$0$id !== void 0 ? _sorted$0$id : '_uncat';
+  var self = config.elementKinds.find(function (k) {
+    return k.value === elementKind;
+  });
+  if (!self) return [];
+  var cid = (_self$categoryId = self.categoryId) !== null && _self$categoryId !== void 0 ? _self$categoryId : fallbackId;
+  return config.elementKinds.filter(function (k) {
+    var _k$categoryId;
+    if (k.showInPalette === false) return false;
+    if (k.value === FLOOR_MAP_STAGE_ELEMENT_KIND) return false;
+    if (k.value === FLOOR_MAP_IMAGE_ELEMENT_KIND) return false;
+    return ((_k$categoryId = k.categoryId) !== null && _k$categoryId !== void 0 ? _k$categoryId : fallbackId) === cid;
+  });
+}
+var DEFAULT_PLACE_W = 180;
+var DEFAULT_PLACE_H = 120;
+var IMAGE_PLACE_W = 400;
+var IMAGE_PLACE_H = 240;
+var DECO_SIZE = 48;
+
+/**
+ * 在右侧编辑面板将图元改为同分类下的另一种 kind 时的草稿 patch（绑定不兼容则清空）
+ */
+export function patchSceneElementForKindSwitch(config, element, nextKindValue) {
+  var _nextCfg$allowedDataS, _element$width, _element$width2, _element$height, _element$height2, _nextCfg$defaultPrese;
+  var nextCfg = getElementKindConfig(config, nextKindValue);
+  var nextPol = resolveDataBindingPolicy(nextCfg);
+  var binding = element.dataBinding;
+  var isNextImage = isFloorMapImageElementKind(nextKindValue);
+  var isNextStage = nextKindValue === FLOOR_MAP_STAGE_ELEMENT_KIND;
+  var clearBinding = false;
+  if (nextPol === 'none') {
+    clearBinding = true;
+  } else if (binding && nextCfg !== null && nextCfg !== void 0 && (_nextCfg$allowedDataS = nextCfg.allowedDataSourceKeys) !== null && _nextCfg$allowedDataS !== void 0 && _nextCfg$allowedDataS.length) {
+    if (!nextCfg.allowedDataSourceKeys.includes(binding.dataSourceKey)) {
+      clearBinding = true;
+    }
+  }
+  var nextW = isNextImage ? IMAGE_PLACE_W : isNextStage ? STAGE_DECO_DEFAULT.width : DEFAULT_PLACE_W;
+  var nextH = isNextImage ? IMAGE_PLACE_H : isNextStage ? STAGE_DECO_DEFAULT.height : DEFAULT_PLACE_H;
+  var useDecoSize = nextPol === 'none' && nextKindValue !== FLOOR_MAP_STAGE_ELEMENT_KIND && !isNextImage;
+  var width = useDecoSize ? Math.max((_element$width = element.width) !== null && _element$width !== void 0 ? _element$width : DECO_SIZE, DECO_SIZE) : Math.max((_element$width2 = element.width) !== null && _element$width2 !== void 0 ? _element$width2 : nextW, nextW);
+  var height = useDecoSize ? Math.max((_element$height = element.height) !== null && _element$height !== void 0 ? _element$height : DECO_SIZE, DECO_SIZE) : Math.max((_element$height2 = element.height) !== null && _element$height2 !== void 0 ? _element$height2 : nextH, nextH);
+  var patch = {
+    elementKind: nextKindValue,
+    shape: isNextStage || isNextImage ? 'rect' : nextCfg === null || nextCfg === void 0 ? void 0 : nextCfg.defaultShape,
+    width: width,
+    height: height,
+    name: (nextCfg === null || nextCfg === void 0 || (_nextCfg$defaultPrese = nextCfg.defaultPresentation) === null || _nextCfg$defaultPrese === void 0 ? void 0 : _nextCfg$defaultPrese.title) != null && String(nextCfg.defaultPresentation.title).trim() !== '' ? String(nextCfg.defaultPresentation.title) : element.name
+  };
+  if (clearBinding) {
+    patch.dataBinding = undefined;
+  }
+  if (isNextImage) {
+    var _element$imageUrl;
+    patch.imageUrl = (_element$imageUrl = element.imageUrl) !== null && _element$imageUrl !== void 0 ? _element$imageUrl : '';
+  } else {
+    patch.imageUrl = undefined;
+  }
+  return patch;
+}
+
 /**
  * @returns 人类可读错误文案；无问题时返回 null
  */

package/es/components/pisellFloorMapLayout/utils/floorMapFallbackRender.js

@@ -2,7 +2,8 @@
  * 无 renderItemByKind 时的占位渲染（装饰、舞台等），避免画布上不显示
  */
 import React from 'react';
-import { FLOOR_MAP_IMAGE_ELEMENT_KIND, FLOOR_MAP_STAGE_ELEMENT_KIND } from "../types";
+import { FLOOR_MAP_STAGE_ELEMENT_KIND } from "../types";
+import { isFloorMapImageElementKind } from "./floorMapElementKindUtils";
 import { FloorMapImageElement } from "../components/FloorMapImageElement";
 import { STAGE_DECO_DEFAULT } from "./floorMapStageDefaults";
 
@@ -35,7 +36,7 @@ export function renderFloorMapFallbackPlaceholder(item) {
   var isStage = kind === FLOOR_MAP_STAGE_ELEMENT_KIND;
   var nameText = (item === null || item === void 0 ? void 0 : item.name) != null ? String(item.name).trim() : '';
   var fallbackLabel = nameText || kind;
-  if (kind === FLOOR_MAP_IMAGE_ELEMENT_KIND) {
+  if (isFloorMapImageElementKind(kind)) {
     var _item$_sceneElement, _item$name, _item$_sceneElement2;
     var url = (_item$_sceneElement = item._sceneElement) === null || _item$_sceneElement === void 0 ? void 0 : _item$_sceneElement.imageUrl;
     return /*#__PURE__*/React.createElement(FloorMapImageElement, {

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/GridView/index.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="react" />
+import './index.less';
+import { GridViewProps } from './type';
+export type { GridViewProps };
+declare const GridView: (props: GridViewProps) => JSX.Element;
+export default GridView;

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

@@ -0,0 +1,3 @@
+import { PisellScrollViewProps } from '../../PisellScrollView/types';
+export interface GridViewProps extends PisellScrollViewProps {
+}

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,6 @@
+/// <reference types="react" />
+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/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/pisellInput/components/Copy/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { InputProps, ButtonProps } from 'antd';
 import { PisellContextType } from "../../../pisell-config-provider/context";
 export interface CopyProps extends InputProps {

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

@@ -0,0 +1,14 @@
+import type { LayoutProps } from 'antd';
+import { Layout } from 'antd';
+import React from 'react';
+export interface PisellLayoutProps extends LayoutProps {
+    children?: React.ReactNode;
+}
+export interface CompoundedComponent extends React.FC<PisellLayoutProps> {
+    Header: typeof Layout.Header;
+    Content: typeof Layout.Content;
+    Footer: typeof Layout.Footer;
+    Sider: typeof Layout.Sider;
+}
+declare const PisellLayout: CompoundedComponent;
+export default PisellLayout;

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { SpinProps } from 'antd';
 import './index.less';
 declare type MaskType = {

package/es/components/pisellLongText/PisellLongText.stories.d.ts

@@ -0,0 +1,123 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellLongText } from './PisellLongText';
+/**
+ * PisellLongText 是一个多行文本输入/展示组件。
+ *
+ * ## 功能特性
+ * - 支持三种状态：只读、编辑、禁用
+ * - 展开/折叠功能（只读态）
+ * - 自动高度调整
+ * - 完整的校验框架
+ * - 字数统计
+ */
+declare const meta: Meta<typeof PisellLongText>;
+export default meta;
+declare type Story = StoryObj<typeof PisellLongText>;
+/**
+ * 基础编辑态示例
+ */
+export declare const Basic: Story;
+/**
+ * 只读态示例 - 短文本
+ */
+export declare const ReadMode: Story;
+/**
+ * 只读态 - 展开/折叠功能（核心）
+ */
+export declare const ReadModeExpandCollapse: Story;
+/**
+ * 只读态 - 自定义展开/收起文案
+ */
+export declare const ReadModeCustomExpandText: Story;
+/**
+ * 只读态 - 禁用展开功能
+ */
+export declare const ReadModeDisableExpand: Story;
+/**
+ * 只读态 - 字数统计
+ */
+export declare const ReadModeWithWordCount: Story;
+/**
+ * 只读态 - 展开 + 字数统计
+ */
+export declare const ReadModeExpandAndWordCount: Story;
+/**
+ * 禁用态示例
+ */
+export declare const Disabled: Story;
+/**
+ * 编辑态 - 默认行数
+ */
+export declare const EditModeCustomRows: Story;
+/**
+ * 编辑态 - 自动高度（boolean）
+ */
+export declare const EditModeAutoSize: Story;
+/**
+ * 编辑态 - 自动高度（范围限定）
+ */
+export declare const EditModeAutoSizeRange: Story;
+/**
+ * 编辑态 - minRows 和 maxRows
+ */
+export declare const EditModeMinMaxRows: Story;
+/**
+ * 编辑态 - 字数统计
+ */
+export declare const EditModeWithCount: Story;
+/**
+ * 编辑态 - 清空按钮
+ */
+export declare const EditModeWithClear: Story;
+/**
+ * 必填校验
+ */
+export declare const Required: Story;
+/**
+ * 长度校验
+ */
+export declare const LengthValidation: Story;
+/**
+ * 自定义校验 - 段落数量限制
+ */
+export declare const CustomValidatorParagraphs: Story;
+/**
+ * 组合校验
+ */
+export declare const CombinedValidation: Story;
+/**
+ * 自动高度 + 字数统计
+ */
+export declare const AutoSizeWithCount: Story;
+/**
+ * 保留换行和空格
+ */
+export declare const PreserveWhitespace: Story;
+/**
+ * 自定义样式（只读态）
+ */
+export declare const CustomStyle: Story;
+/**
+ * 完整功能示例
+ */
+export declare const FullFeatures: Story;
+/**
+ * 所有展开/折叠场景对比
+ */
+export declare const AllExpandScenarios: Story;
+/**
+ * 所有自动高度场景对比
+ */
+export declare const AllAutoSizeScenarios: Story;
+/**
+ * 校验场景对比
+ */
+export declare const ValidationScenarios: Story;
+/**
+ * 边界情况测试
+ */
+export declare const EdgeCases: Story;
+/**
+ * 完整功能演示
+ */
+export declare const CompleteExample: Story;

package/es/components/pisellLongText/components/DisabledView.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { PisellLongTextProps } from '../types';
+/**
+ * PisellLongText 禁用态视图组件
+ *
+ * 负责渲染禁用态视图，基于原始 mode 渲染对应的视图，并添加禁用样式
+ *
+ * 设计规则：
+ * - 基于编辑态或只读态的视觉
+ * - 透明度 40%
+ * - 禁止所有交互行为
+ *
+ * @param props 组件 Props
+ */
+declare const DisabledView: React.FC<PisellLongTextProps>;
+export default DisabledView;