@pisell/materials 1.8.23 → 1.8.24

package/lib/components/pisellFloorMapLayout/locales.js

@@ -1,6 +1,8 @@
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -14,6 +16,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/components/pisellFloorMapLayout/locales.ts
@@ -22,6 +32,8 @@ __export(locales_exports, {
   default: () => locales_default
 });
 module.exports = __toCommonJS(locales_exports);
+var import_locales_ja = __toESM(require("./locales-ja"));
+var import_locales_pt = __toESM(require("./locales-pt"));
 var locales_default = {
   en: {
     "pisell-floor-map-layout.loading": "Loading...",
@@ -83,7 +95,45 @@ var locales_default = {
     "pisell-floor-map-layout.edit-panel.pop-desc": "It will be removed from the floor plan draft; click Save at the top to persist.",
     "pisell-floor-map-layout.edit-panel.btn-delete": "Delete",
     "pisell-floor-map-layout.edit-panel.btn-cancel": "Cancel",
-    "pisell-floor-map-layout.edit-panel.btn-ok-delete": "Delete"
+    "pisell-floor-map-layout.edit-panel.btn-ok-delete": "Delete",
+    "pisell-floor-map-layout.toolbar.category-fallback": "Elements",
+    "pisell-floor-map-layout.toolbar.palette-card-title": "Click to place on canvas, or drag onto canvas to add 「{name}」",
+    "pisell-floor-map-layout.toolbar.data-binding-optional": "Data binding (optional)",
+    "pisell-floor-map-layout.toolbar.hint-after-select-ds": "After choosing a data source, you may bind rows or place placeholders directly.",
+    "pisell-floor-map-layout.toolbar.hint-no-unplaced-rows": "No unbound rows in this data source, or the list is empty; you can still place placeholders on the canvas.",
+    "pisell-floor-map-layout.toolbar.ph-select-records": "Select records to show (optional, multiple)",
+    "pisell-floor-map-layout.toolbar.hint-multi-drop": "Select multiple to place several items in one click (staggered). Leave empty to place a placeholder and bind later in the sidebar.",
+    "pisell-floor-map-layout.toolbar.no-data-sources": "No data sources available",
+    "pisell-floor-map-layout.toolbar.cancel-place": "Cancel",
+    "pisell-floor-map-layout.toolbar.layout-dirty-hint": "Layout changed — click Save to persist.",
+    "pisell-floor-map-layout.toolbar.save": "Save",
+    "pisell-floor-map-layout.toolbar.saving": "Saving…",
+    "pisell-floor-map-layout.view-controls.zoom-out-aria": "Zoom out",
+    "pisell-floor-map-layout.view-controls.zoom-in-aria": "Zoom in",
+    "pisell-floor-map-layout.view-controls.reset-aria": "Reset view",
+    "pisell-floor-map-layout.view-controls.fit-bounds-aria": "Fit to content",
+    "pisell-floor-map-layout.view-controls.grid-hide-aria": "Hide grid",
+    "pisell-floor-map-layout.view-controls.grid-show-aria": "Show grid",
+    "pisell-floor-map-layout.view-controls.fullscreen-aria": "Fullscreen",
+    "pisell-floor-map-layout.view-controls.fullscreen-exit-aria": "Exit fullscreen",
+    "pisell-floor-map-layout.image-element.default-name": "Image",
+    "pisell-floor-map-layout.placement.fallback-image-name": "Background",
+    "pisell-floor-map-layout.image-element.hint-no-url": "Enter the image URL in the sidebar; lower the layer to place under tables.",
+    "pisell-floor-map-layout.image-element.hint-load-fail": "Failed to load image; check the URL.",
+    "pisell-floor-map-layout.data-form.empty": "No extra fields to edit",
+    "pisell-floor-map-layout.data-form.save-record": "Save record",
+    "pisell-floor-map-layout.binding-error.required-row": "This element must be bound to a data row.",
+    "pisell-floor-map-layout.binding-error.ds-not-allowed": 'Data source "{key}" is not allowed for this element type.',
+    "pisell-floor-map-layout.binding-error.missing-field": "Row is missing required field: {field}",
+    "pisell-floor-map-layout.card-placeholder.hint-select-row": "Data source selected. Choose a row in the sidebar.",
+    "pisell-floor-map-layout.card-placeholder.hint-bind-datasource": "No row bound: select a data source and record in the sidebar.",
+    "pisell-floor-map-layout.card-placeholder.hint-new-slot": "New {kind} placeholder. Bind a record in the sidebar.",
+    "pisell-floor-map-layout.card-placeholder.hint-row-not-found": "Record not found: check binding or data list.",
+    "pisell-floor-map-layout.figma-card.kind-round-table": "Round table",
+    "pisell-floor-map-layout.figma-card.kind-square-table": "Table",
+    "pisell-floor-map-layout.figma-card.default-table": "Table",
+    "pisell-floor-map-layout.figma-card.capacity-seats": "Seats {n}",
+    "pisell-floor-map-layout.figma-card.guests-count": "{n} guests"
   },
   "zh-CN": {
     "pisell-floor-map-layout.loading": "加载中…",
@@ -145,7 +195,45 @@ var locales_default = {
     "pisell-floor-map-layout.edit-panel.pop-desc": "将从当前平面图草稿中移除；删除后请点击顶部「保存」以持久化布局。",
     "pisell-floor-map-layout.edit-panel.btn-delete": "删除",
     "pisell-floor-map-layout.edit-panel.btn-cancel": "取消",
-    "pisell-floor-map-layout.edit-panel.btn-ok-delete": "删除"
+    "pisell-floor-map-layout.edit-panel.btn-ok-delete": "删除",
+    "pisell-floor-map-layout.toolbar.category-fallback": "图元",
+    "pisell-floor-map-layout.toolbar.palette-card-title": "点击后画布落点，或拖拽到画布生成「{name}」",
+    "pisell-floor-map-layout.toolbar.data-binding-optional": "数据绑定（可选）",
+    "pisell-floor-map-layout.toolbar.hint-after-select-ds": "选择数据源后可选绑定数据行，或直接落点占位。",
+    "pisell-floor-map-layout.toolbar.hint-no-unplaced-rows": "当前数据源无未绑定记录，或列表为空；可直接在画布落点占位。",
+    "pisell-floor-map-layout.toolbar.ph-select-records": "选择要展示的记录（可选，可多选）",
+    "pisell-floor-map-layout.toolbar.hint-multi-drop": "可选多条，在画布点击一次将按阶梯偏移落多条；留空则先占位，稍后在侧栏绑定。",
+    "pisell-floor-map-layout.toolbar.no-data-sources": "无可用数据源",
+    "pisell-floor-map-layout.toolbar.cancel-place": "取消新建",
+    "pisell-floor-map-layout.toolbar.layout-dirty-hint": "布局已修改，请点击「保存」持久化。",
+    "pisell-floor-map-layout.toolbar.save": "保存",
+    "pisell-floor-map-layout.toolbar.saving": "保存中…",
+    "pisell-floor-map-layout.view-controls.zoom-out-aria": "缩小",
+    "pisell-floor-map-layout.view-controls.zoom-in-aria": "放大",
+    "pisell-floor-map-layout.view-controls.reset-aria": "复位",
+    "pisell-floor-map-layout.view-controls.fit-bounds-aria": "区域定位",
+    "pisell-floor-map-layout.view-controls.grid-hide-aria": "隐藏网格",
+    "pisell-floor-map-layout.view-controls.grid-show-aria": "显示网格",
+    "pisell-floor-map-layout.view-controls.fullscreen-aria": "全屏",
+    "pisell-floor-map-layout.view-controls.fullscreen-exit-aria": "退出全屏",
+    "pisell-floor-map-layout.image-element.default-name": "图片图元",
+    "pisell-floor-map-layout.placement.fallback-image-name": "底图",
+    "pisell-floor-map-layout.image-element.hint-no-url": "在侧栏填写图片地址；可调层级置于桌位下方作底图",
+    "pisell-floor-map-layout.image-element.hint-load-fail": "图片加载失败，请检查地址",
+    "pisell-floor-map-layout.data-form.empty": "无额外字段可编辑",
+    "pisell-floor-map-layout.data-form.save-record": "保存记录",
+    "pisell-floor-map-layout.binding-error.required-row": "该图元须绑定数据源行",
+    "pisell-floor-map-layout.binding-error.ds-not-allowed": "数据源「{key}」不在该图元允许列表内",
+    "pisell-floor-map-layout.binding-error.missing-field": "数据行缺少必填字段：{field}",
+    "pisell-floor-map-layout.card-placeholder.hint-select-row": "已选择数据源，请在侧栏选择数据行",
+    "pisell-floor-map-layout.card-placeholder.hint-bind-datasource": "未绑定数据行：请在侧栏选择数据源与记录",
+    "pisell-floor-map-layout.card-placeholder.hint-new-slot": "新{kind}占位，可在侧栏绑定具体记录",
+    "pisell-floor-map-layout.card-placeholder.hint-row-not-found": "未找到对应记录：请检查绑定或数据列表",
+    "pisell-floor-map-layout.figma-card.kind-round-table": "圆桌",
+    "pisell-floor-map-layout.figma-card.kind-square-table": "餐桌",
+    "pisell-floor-map-layout.figma-card.default-table": "餐桌",
+    "pisell-floor-map-layout.figma-card.capacity-seats": "可坐 {n} 人",
+    "pisell-floor-map-layout.figma-card.guests-count": "{n} 人"
   },
   "zh-HK": {
     "pisell-floor-map-layout.loading": "載入中…",
@@ -207,6 +295,46 @@ var locales_default = {
     "pisell-floor-map-layout.edit-panel.pop-desc": "將從當前平面圖草稿中移除；刪除後請點擊頂部「儲存」以持久化佈局。",
     "pisell-floor-map-layout.edit-panel.btn-delete": "刪除",
     "pisell-floor-map-layout.edit-panel.btn-cancel": "取消",
-    "pisell-floor-map-layout.edit-panel.btn-ok-delete": "刪除"
-  }
+    "pisell-floor-map-layout.edit-panel.btn-ok-delete": "刪除",
+    "pisell-floor-map-layout.toolbar.category-fallback": "圖元",
+    "pisell-floor-map-layout.toolbar.palette-card-title": "點擊後畫布落點，或拖曳到畫布生成「{name}」",
+    "pisell-floor-map-layout.toolbar.data-binding-optional": "數據綁定（可選）",
+    "pisell-floor-map-layout.toolbar.hint-after-select-ds": "選擇數據源後可選綁定數據列，或直接落點占位。",
+    "pisell-floor-map-layout.toolbar.hint-no-unplaced-rows": "當前數據源無未綁定記錄，或清單為空；可直接在畫布落點占位。",
+    "pisell-floor-map-layout.toolbar.ph-select-records": "選擇要展示的記錄（可選，可多選）",
+    "pisell-floor-map-layout.toolbar.hint-multi-drop": "可選多條，在畫布點擊一次將按階梯偏移落多條；留空則先占位，稍後在側欄綁定。",
+    "pisell-floor-map-layout.toolbar.no-data-sources": "無可用數據源",
+    "pisell-floor-map-layout.toolbar.cancel-place": "取消新建",
+    "pisell-floor-map-layout.toolbar.layout-dirty-hint": "佈局已修改，請點擊「儲存」持久化。",
+    "pisell-floor-map-layout.toolbar.save": "儲存",
+    "pisell-floor-map-layout.toolbar.saving": "儲存中…",
+    "pisell-floor-map-layout.view-controls.zoom-out-aria": "縮小",
+    "pisell-floor-map-layout.view-controls.zoom-in-aria": "放大",
+    "pisell-floor-map-layout.view-controls.reset-aria": "復位",
+    "pisell-floor-map-layout.view-controls.fit-bounds-aria": "區域定位",
+    "pisell-floor-map-layout.view-controls.grid-hide-aria": "隱藏網格",
+    "pisell-floor-map-layout.view-controls.grid-show-aria": "顯示網格",
+    "pisell-floor-map-layout.view-controls.fullscreen-aria": "全螢幕",
+    "pisell-floor-map-layout.view-controls.fullscreen-exit-aria": "退出全螢幕",
+    "pisell-floor-map-layout.image-element.default-name": "圖片圖元",
+    "pisell-floor-map-layout.placement.fallback-image-name": "底圖",
+    "pisell-floor-map-layout.image-element.hint-no-url": "在側欄填寫圖片地址；可調層級置於桌位下方作底圖",
+    "pisell-floor-map-layout.image-element.hint-load-fail": "圖片載入失敗，請檢查地址",
+    "pisell-floor-map-layout.data-form.empty": "無額外欄位可編輯",
+    "pisell-floor-map-layout.data-form.save-record": "儲存記錄",
+    "pisell-floor-map-layout.binding-error.required-row": "該圖元須綁定數據源列",
+    "pisell-floor-map-layout.binding-error.ds-not-allowed": "數據源「{key}」不在該圖元允許列表內",
+    "pisell-floor-map-layout.binding-error.missing-field": "數據列缺少必填欄位：{field}",
+    "pisell-floor-map-layout.card-placeholder.hint-select-row": "已選擇數據源，請在側欄選擇數據列",
+    "pisell-floor-map-layout.card-placeholder.hint-bind-datasource": "未綁定數據列：請在側欄選擇數據源與記錄",
+    "pisell-floor-map-layout.card-placeholder.hint-new-slot": "新{kind}占位，可在側欄綁定具體記錄",
+    "pisell-floor-map-layout.card-placeholder.hint-row-not-found": "找不到對應記錄：請檢查綁定或數據清單",
+    "pisell-floor-map-layout.figma-card.kind-round-table": "圓桌",
+    "pisell-floor-map-layout.figma-card.kind-square-table": "餐桌",
+    "pisell-floor-map-layout.figma-card.default-table": "餐桌",
+    "pisell-floor-map-layout.figma-card.capacity-seats": "可坐 {n} 人",
+    "pisell-floor-map-layout.figma-card.guests-count": "{n} 人"
+  },
+  ja: import_locales_ja.default,
+  pt: import_locales_pt.default
 };

package/lib/components/pisellFloorMapLayout/utils/floorMapCanvasDisplay.d.ts

@@ -0,0 +1,20 @@
+import type { FloorMapCanvas, FloorMapCanvasNameI18n } from '../types';
+/**
+ * 合并平面图 Tab 用多语言包（与业务侧 `locales.init` 可叠加）。
+ */
+export declare function initFloorMapLayoutLocales(engineLocale: string): void;
+/**
+ * 从多语言对象中取当前 locale 下展示字符串，缺省按 en → 其余首个非空。
+ */
+export declare function pickFloorMapCanvasI18nString(obj: FloorMapCanvasNameI18n, engineLocale: string): string;
+/**
+ * 画布在 Tab / 下拉中的展示名：
+ * 1. `name` 为多语言对象时 **优先** 按引擎 locale 取字段（与配置内嵌文案一致）；
+ * 2. 否则 `nameKey` + `locales.getText`（需业务侧已 init 对应语言包）；
+ * 3. 否则 `name` 字符串。
+ */
+export declare function getFloorMapCanvasDisplayName(canvas: FloorMapCanvas, engineLocale: string): string;
+/**
+ * 打开重命名弹层时的初始多语言值（与 Translation 表单一致）。
+ */
+export declare function seedFloorMapCanvasNameI18n(canvas: FloorMapCanvas, displayFallback: string): FloorMapCanvasNameI18n;

package/lib/components/pisellFloorMapLayout/utils/floorMapConfigMerge.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 将当前画布的 sceneElements 合并为 Layout 使用的 FloorMapMergedItem[]
+ */
+import type { FloorMapViewConfig, FloorMapMergedItem } from '../types';
+/**
+ * 合并指定画布下的 sceneElements 为一份 items（用于 ItemLayer / EditableItemLayer）
+ */
+export declare function mergeCanvasItems(canvasId: string, config: Pick<FloorMapViewConfig, 'sceneElements' | 'elementKinds'>, defaultCellSize?: number): FloorMapMergedItem[];

package/lib/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/lib/components/pisellFloorMapLayout/utils/floorMapDataRecordLabel.js

@@ -27,15 +27,9 @@ function formatDataRecordOptionLabel(record) {
   const mainField = rawMain ? (rawMain.split(" ## ")[0] ?? rawMain).trim() : "";
   const code = record.code != null && String(record.code).trim() ? String(record.code).trim() : "";
   const name = record.name != null ? String(record.name).trim() : "";
-  const status = record.status != null ? String(record.status) : "";
   const idStr = String(record.id ?? "").trim();
-  const 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() : "";
   const primary = mainField || code || name;
-  const tailParts = [idStr, formCodeRaw].filter((s) => s.length > 0);
-  const tail = tailParts.length ? ` · ${tailParts.join(" · ")}` : "";
-  if (primary && status) return `${primary}（${status}）${tail}`;
-  if (primary) return `${primary}${tail}`;
-  if (tailParts.length) return tailParts.join(" · ");
+  if (primary) return primary;
   return idStr || "—";
 }
 // Annotate the CommonJS export names for ESM import in node:

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

@@ -0,0 +1,22 @@
+/**
+ * 图元种类解析与绑定展示前校验（供合并项渲染、工具栏逻辑复用）
+ */
+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
+ */
+export declare function getSceneElementRenderIssue(element: FloorMapSceneElement, kind: FloorMapElementKindConfig | undefined, dataSources: FloorMapDataSources | undefined): string | null;

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

@@ -28,6 +28,7 @@ __export(floorMapElementKindUtils_exports, {
 });
 module.exports = __toCommonJS(floorMapElementKindUtils_exports);
 var import_types = require("../types");
+var import_utils = require("@pisell/utils");
 var import_floorMapStageDefaults = require("./floorMapStageDefaults");
 function isFloorMapImageElementKind(kind) {
   return kind === import_types.FLOOR_MAP_IMAGE_ELEMENT_KIND;
@@ -102,12 +103,14 @@ function getSceneElementRenderIssue(element, kind, dataSources) {
   const policy = resolveDataBindingPolicy(kind);
   const binding = element.dataBinding;
   if (policy === "required" && !binding) {
-    return "该图元须绑定数据源行";
+    return import_utils.locales.getText(
+      "pisell-floor-map-layout.binding-error.required-row"
+    );
   }
   if (!binding) return null;
   const keys = kind == null ? void 0 : kind.allowedDataSourceKeys;
   if ((keys == null ? void 0 : keys.length) && !keys.includes(binding.dataSourceKey)) {
-    return `数据源「${binding.dataSourceKey}」不在该图元允许列表内`;
+    return import_utils.locales.getText("pisell-floor-map-layout.binding-error.ds-not-allowed").replace(/\{key\}/g, binding.dataSourceKey);
   }
   const rows = dataSources == null ? void 0 : dataSources[binding.dataSourceKey];
   const rid = binding.recordId != null ? String(binding.recordId).trim() : "";
@@ -122,7 +125,7 @@ function getSceneElementRenderIssue(element, kind, dataSources) {
   if (expected == null ? void 0 : expected.length) {
     for (const f of expected) {
       if (row[f] === void 0 || row[f] === null || row[f] === "") {
-        return `数据行缺少必填字段：${f}`;
+        return import_utils.locales.getText("pisell-floor-map-layout.binding-error.missing-field").replace(/\{field\}/g, f);
       }
     }
   }

package/lib/components/pisellFloorMapLayout/utils/floorMapFallbackRender.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 无 renderItemByKind 时的占位渲染（装饰、舞台等），避免画布上不显示
+ */
+import React from 'react';
+import type { FloorMapMergedItem } from '../types';
+/**
+ * @returns 与 PisellFloorMapLayout 内联 fallback 一致的渲染函数（useCallback 由调用方包裹）
+ */
+/** 绑定校验失败或 renderItemByKind 抛错时的占位 */
+export declare function renderFloorMapRenderError(message: string): React.ReactNode;
+export declare function renderFloorMapFallbackPlaceholder(item: FloorMapMergedItem): React.ReactNode;

package/lib/components/pisellInput/components/Copy/index.d.ts

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

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

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

package/lib/components/pisellLongText/PisellLongText.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+import type { PisellLongTextProps } from './types';
+import './PisellLongText.less';
+/**
+ * PisellLongText 长文本/多行文本组件
+ *
+ * 多行文本输入/展示组件，支持只读、编辑、禁用三种状态。
+ * 基于 Ant Design TextArea 组件开发，提供展开/折叠功能和完整的校验框架。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 编辑态
+ * <PisellLongText
+ *   placeholder="请输入内容"
+ *   rows={3}
+ *   maxLength={500}
+ *   showCount
+ * />
+ *
+ * @example
+ * // 只读态（展开折叠）
+ * <PisellLongText
+ *   mode="read"
+ *   value={longText}
+ *   maxLines={3}
+ *   enableExpand
+ * />
+ *
+ * @example
+ * // 自动高度
+ * <PisellLongText
+ *   autoSize={{ minRows: 3, maxRows: 10 }}
+ *   placeholder="自动调整高度"
+ * />
+ */
+export declare const PisellLongText: React.FC<PisellLongTextProps>;
+declare const _default: React.NamedExoticComponent<PisellLongTextProps>;
+export default _default;

package/lib/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/lib/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;

package/lib/components/pisellLongText/components/EditView.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { PisellLongTextProps } from '../types';
+/**
+ * PisellLongText 编辑态视图组件
+ *
+ * 负责渲染编辑态的多行输入框，基于 Ant Design TextArea 组件
+ *
+ * 功能：
+ * - 多行文本输入
+ * - 自动高度调整（autoSize）
+ * - 实时或失焦校验
+ * - 错误提示展示
+ * - 字数统计
+ * - 清空按钮
+ *
+ * @param props 组件 Props
+ */
+declare const EditView: React.FC<PisellLongTextProps>;
+export default EditView;

package/lib/components/pisellLongText/components/ReadOnlyView.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { PisellLongTextProps } from '../types';
+/**
+ * PisellLongText 只读态视图组件
+ *
+ * 负责渲染只读态的多行文本展示，支持展开/折叠功能
+ *
+ * 功能：
+ * - 多行文本展示
+ * - 根据 maxLines 截断内容
+ * - 展开/收起按钮（超出行数时显示）
+ * - 字数统计（可选）
+ * - 保留换行和空格（whiteSpace: 'pre-wrap'）
+ *
+ * @param props 组件 Props
+ */
+declare const ReadOnlyView: React.FC<PisellLongTextProps>;
+export default ReadOnlyView;

package/lib/components/pisellLongText/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * PisellLongText 组件导出
+ */
+import PisellLongText from './PisellLongText';
+export { PisellLongText };
+export type { PisellLongTextProps } from './types';
+export type { DisplayState, ValidationResult, TextInputState } from './types';