@pisell/materials 6.11.20 → 6.11.21

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

@@ -1,248 +0,0 @@
-import type React from 'react';
-import type { CSSProperties } from 'react';
-export declare type PisellHierarchicalSummaryListKey = React.Key;
-export interface PisellHierarchicalSummaryListItem {
-    /**
-     * 行标题。最小字段（必填）
-     */
-    label: React.ReactNode;
-    /**
-     * 行数值。允许 ReactNode（string/number/组合展示）。
-     * 若不传且开启聚合，可能由 children 聚合得到。
-     */
-    value?: React.ReactNode;
-    /**
-     * 子级数据（无限层级递归）
-     */
-    children?: PisellHierarchicalSummaryListItem[];
-    /**
-     * 可选：稳定 key（推荐传入以保证展开态稳定）。
-     * 不传时组件会基于层级路径生成 key。
-     */
-    key?: PisellHierarchicalSummaryListKey;
-    /**
-     * 可选：是否隐藏该项
-     */
-    hidden?: boolean;
-    /**
-     * 可选：排序权重，值越小越靠前
-     */
-    order?: number;
-    /**
-     * 可选：条目数提示（如 "N items" / "N 条"），允许 ReactNode
-     */
-    itemsCount?: React.ReactNode;
-    /**
-     * 可选：信息提示 tooltip 内容（hover 触达）
-     */
-    infoTooltip?: React.ReactNode;
-    /**
-     * 可选：右侧 value 后附加轻量操作（tag/pill/button 等）
-     */
-    extra?: React.ReactNode;
-    /**
-     * 可选：覆盖当前行样式
-     */
-    rowStyle?: CSSProperties;
-    /**
-     * 可选：覆盖当前行类名
-     */
-    rowClassName?: string;
-    /**
-     * 可选：自定义展开内容。若设置，行可展开且展开后渲染此内容（不再渲染 children 列表）。
-     * 用于在列表中嵌入 Collapse 等自定义区块。
-     */
-    expandedContent?: React.ReactNode;
-}
-export interface PisellHierarchicalSummaryListLevelTextStyle {
-    fontSize?: number | string;
-    fontWeight?: number | string;
-    color?: string;
-    /** 行高，如 24 或 '24px' */
-    lineHeight?: number | string;
-}
-export interface PisellHierarchicalSummaryListIconStyle {
-    /** 图标尺寸（px），用于 fontSize 或宽高一致时的边长） */
-    size?: number;
-    color?: string;
-    /** 图标容器宽（px），不传则用 size */
-    width?: number;
-    /** 图标容器高（px），不传则用 size */
-    height?: number;
-}
-export interface PisellHierarchicalSummaryListDividerStyle {
-    show?: boolean;
-    color?: string;
-    style?: 'solid' | 'dashed' | 'dotted';
-}
-export interface PisellHierarchicalSummaryListLevelConfig {
-    /**
-     * 层级缩进（px）。不传则继承全局 indent 规则。
-     */
-    indent?: number;
-    /**
-     * 是否显示 "·" 分隔符（标题区元信息前的点）
-     */
-    showDotSeparator?: boolean;
-    /**
-     * 层级内分割线
-     */
-    divider?: PisellHierarchicalSummaryListDividerStyle;
-    /**
-     * 行容器样式（背景/边框/padding/圆角/阴影等）
-     */
-    rowStyle?: CSSProperties;
-    /**
-     * 行容器类名
-     */
-    rowClassName?: string;
-    /**
-     * 标题文本样式
-     */
-    labelTextStyle?: PisellHierarchicalSummaryListLevelTextStyle;
-    /**
-     * 数值文本样式
-     */
-    valueTextStyle?: PisellHierarchicalSummaryListLevelTextStyle;
-    /**
-     * info icon 样式（size/color）
-     */
-    infoIconStyle?: PisellHierarchicalSummaryListIconStyle;
-    /**
-     * 展开/收起箭头 icon 样式（size/color）
-     */
-    expandIconStyle?: PisellHierarchicalSummaryListIconStyle;
-    /**
-     * 行内元信息样式（如 "·"、N items、info icon 的文案颜色/字号等）
-     */
-    metaTextStyle?: PisellHierarchicalSummaryListLevelTextStyle;
-}
-export declare type PisellHierarchicalSummaryListAggregateMode = 'none' | 'sum';
-export interface PisellHierarchicalSummaryListAggregateConfig {
-    /**
-     * 聚合模式
-     * - none: 不聚合
-     * - sum: 对子级 number 值求和（或使用 getNumberValue 提取）
-     * @default 'none'
-     */
-    mode?: PisellHierarchicalSummaryListAggregateMode;
-    /**
-     * 从条目提取 number 值，用于 sum 聚合。
-     * 默认：若 item.value 是 number，则使用该值；否则忽略。
-     */
-    getNumberValue?: (item: PisellHierarchicalSummaryListItem) => number | null | undefined;
-    /**
-     * 聚合结果格式化（sum 输出到 value 区）
-     */
-    format?: (sum: number, ctx: {
-        item: PisellHierarchicalSummaryListItem;
-        level: number;
-    }) => React.ReactNode;
-}
-export interface PisellHierarchicalSummaryListRenderContext {
-    level: number;
-    pathKeys: PisellHierarchicalSummaryListKey[];
-    expanded: boolean;
-    hasChildren: boolean;
-    aggregatedValue?: React.ReactNode;
-}
-export interface PisellHierarchicalSummaryListProps {
-    /**
-     * 数据源
-     */
-    items: PisellHierarchicalSummaryListItem[];
-    /**
-     * 展开项 keys（受控）
-     */
-    expandedKeys?: PisellHierarchicalSummaryListKey[];
-    /**
-     * 默认展开项 keys（非受控）
-     */
-    defaultExpandedKeys?: PisellHierarchicalSummaryListKey[];
-    /**
-     * 默认展开层级（非受控初始化）。0 表示只展示 L1（不默认展开子级）。
-     * @default 0
-     */
-    defaultExpandedLevel?: number;
-    /**
-     * 展开项变化回调
-     */
-    onExpandedKeysChange?: (keys: PisellHierarchicalSummaryListKey[]) => void;
-    /**
-     * 手风琴模式：同一层级下仅允许一个子项展开
-     * @default false
-     */
-    accordion?: boolean;
-    /**
-     * 最大渲染层级（从 1 开始）。超过层级仍保留行，但不再渲染 children。
-     */
-    maxRenderLevel?: number;
-    /**
-     * 最大可展开层级（从 1 开始）。超过层级不显示展开箭头。
-     */
-    maxExpandLevel?: number;
-    /**
-     * 全局缩进（px），作用于 L2+；也可通过 levelConfig 覆盖。
-     * @default 16
-     */
-    indent?: number;
-    /**
-     * 行间距（px）
-     * @default 8
-     */
-    rowGap?: number;
-    /**
-     * 容器内边距（px 或 CSS 值），不传则使用 less 默认 20px
-     */
-    padding?: number | string;
-    /**
-     * 行内间距（px），用于 1:1 复刻设计稿
-     * - row: 行内左右两栏间距
-     * - rowLeft: 左侧 label 与 meta（· / N items）间距
-     * - meta: meta 内 dot / items-count / info 间距
-     * - rowRight: 右侧 value 与 extra / 展开图标间距
-     */
-    gaps?: {
-        row?: number;
-        rowLeft?: number;
-        meta?: number;
-        rowRight?: number;
-    };
-    /**
-     * 按层级配置样式与功能开关（key 为 level，从 1 开始）
-     */
-    levelConfig?: Record<number, PisellHierarchicalSummaryListLevelConfig>;
-    /**
-     * 自定义渲染 label
-     */
-    renderLabel?: (item: PisellHierarchicalSummaryListItem, ctx: PisellHierarchicalSummaryListRenderContext) => React.ReactNode;
-    /**
-     * 自定义渲染 value
-     */
-    renderValue?: (item: PisellHierarchicalSummaryListItem, ctx: PisellHierarchicalSummaryListRenderContext) => React.ReactNode;
-    /**
-     * 自定义 key 生成（当 item.key 不存在时使用）
-     */
-    getKey?: (item: PisellHierarchicalSummaryListItem, ctx: {
-        level: number;
-        index: number;
-        parentPathKeys: PisellHierarchicalSummaryListKey[];
-    }) => PisellHierarchicalSummaryListKey;
-    /**
-     * 聚合配置：支持内置或外部传入
-     */
-    aggregate?: PisellHierarchicalSummaryListAggregateConfig;
-    /**
-     * 根节点类名
-     */
-    className?: string;
-    /**
-     * 根节点样式
-     */
-    style?: CSSProperties;
-    /**
-     * 是否渲染根节点 div。为 false 时只渲染内部内容（用于外层用同一 DOM 包裹列表与其它区块）。
-     * @default true
-     */
-    renderRoot?: boolean;
-}

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

@@ -1,14 +0,0 @@
-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/lib/components/pisellLongText/PisellLongText.d.ts

@@ -1,39 +0,0 @@
-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

@@ -1,123 +0,0 @@
-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

@@ -1,16 +0,0 @@
-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/ReadOnlyView.d.ts

@@ -1,18 +0,0 @@
-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

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

package/lib/components/pisellLookup/PisellLookup.d.ts

@@ -1,4 +0,0 @@
-import React from 'react';
-import type { PisellLookupProps, PisellLookupRef } from './types';
-import './PisellLookup.less';
-export declare const PisellLookup: React.ForwardRefExoticComponent<PisellLookupProps & React.RefAttributes<PisellLookupRef>>;

package/lib/components/pisellLookup/PisellLookup.stories.d.ts

@@ -1,129 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import { PisellLookup } from './PisellLookup';
-/**
- * PisellLookup 组件 Storybook
- * 搜索交互协议组件，提供统一的搜索入口、状态管理和结果承载能力
- */
-declare const meta: Meta<typeof PisellLookup>;
-export default meta;
-declare type Story = StoryObj<typeof PisellLookup>;
-/**
- * 基础示例 - Input 触发器 + Inline 展示
- */
-export declare const Basic: Story;
-/**
- * Input 触发器 - 默认尺寸（Middle）
- */
-export declare const InputTriggerMiddle: Story;
-/**
- * Input 触发器 - 大号尺寸
- */
-export declare const InputTriggerLarge: Story;
-/**
- * Button 触发器 + Modal 展示
- */
-export declare const ButtonTrigger: Story;
-/**
- * Icon 触发器 + Modal 展示
- */
-export declare const IconTrigger: Story;
-/**
- * Text 触发器 + Modal 展示
- */
-export declare const TextTrigger: Story;
-/**
- * 自定义触发器 + Modal 展示
- */
-export declare const CustomTrigger: Story;
-/**
- * Drawer 展示模式
- */
-export declare const DrawerDisplay: Story;
-/**
- * 搜索历史功能
- */
-export declare const WithSearchHistory: Story;
-/**
- * 联想词功能
- */
-export declare const WithSuggestions: Story;
-/**
- * 热门搜索功能
- */
-export declare const WithHotWords: Story;
-/**
- * 完整功能 - 历史 + 联想词 + 热门搜索
- */
-export declare const FullFeatures: Story;
-/**
- * 实时搜索模式
- */
-export declare const RealtimeSearch: Story;
-/**
- * 确认触发模式
- */
-export declare const ConfirmSearch: Story;
-/**
- * 受控模式示例
- */
-export declare const Controlled: Story;
-/**
- * 加载状态
- */
-export declare const Loading: Story;
-/**
- * 禁用状态
- */
-export declare const Disabled: Story;
-/**
- * Modal 自定义宽度
- */
-export declare const ModalCustomWidth: Story;
-/**
- * Modal 显示遮罩层
- */
-export declare const ModalWithMask: Story;
-/**
- * Modal 挂载到容器并使用 100% 宽度
- */
-export declare const ModalFullWidth: Story;
-/**
- * Drawer 不同方向
- */
-export declare const DrawerPlacements: Story;
-/**
- * 自定义空状态
- */
-export declare const CustomEmpty: Story;
-/**
- * 移动端场景
- */
-export declare const MobileScenario: Story;
-/**
- * 保留搜索内容（默认行为）
- */
-export declare const PreserveKeyword: Story;
-/**
- * 关闭时清空内容
- */
-export declare const ClearOnClose: Story;
-/**
- * 隐藏 Lookup 按钮（输入即搜索）
- */
-export declare const NoConfirmButton: Story;
-/**
- * 监听打开和关闭事件
- */
-export declare const WithOpenCloseEvents: Story;
-/**
- * 使用 Ref 控制
- */
-export declare const WithRef: Story;
-/**
- * 仅触发搜索（不展示结果）
- */
-export declare const OnlyTriggerSearch: Story;
-/**
- * Playground - 自由配置
- */
-export declare const Playground: Story;

package/lib/components/pisellLookup/components/HotWords.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-import type { HotWordsProps } from '../types';
-/**
- * HotWords 组件
- * 展示热门搜索
- */
-export declare const HotWords: React.FC<HotWordsProps>;

package/lib/components/pisellLookup/components/LookupAuxiliary.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-import type { LookupAuxiliaryProps } from '../types';
-/**
- * LookupAuxiliary 组件
- * 辅助信息层：搜索历史、联想词、热门搜索
- */
-export declare const LookupAuxiliary: React.FC<LookupAuxiliaryProps>;

package/lib/components/pisellLookup/components/LookupResultHost.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-import type { LookupResultHostProps } from '../types';
-/**
- * LookupResultHost 组件
- * 结果承载层：根据展示类型渲染不同的容器
- */
-export declare const LookupResultHost: React.FC<LookupResultHostProps>;

package/lib/components/pisellLookup/components/LookupTrigger.d.ts

@@ -1,3 +0,0 @@
-import React from 'react';
-import type { LookupTriggerProps, LookupTriggerRef } from '../types';
-export declare const LookupTrigger: React.ForwardRefExoticComponent<LookupTriggerProps & React.RefAttributes<LookupTriggerRef>>;

package/lib/components/pisellLookup/components/SearchHistory.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-import type { SearchHistoryProps } from '../types';
-/**
- * SearchHistory 组件
- * 展示搜索历史记录
- */
-export declare const SearchHistory: React.FC<SearchHistoryProps>;

package/lib/components/pisellLookup/components/SuggestWords.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-import type { SuggestWordsProps } from '../types';
-/**
- * SuggestWords 组件
- * 展示搜索联想词
- */
-export declare const SuggestWords: React.FC<SuggestWordsProps>;

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

@@ -1,9 +0,0 @@
-/**
- * 子组件统一导出
- */
-export { SearchHistory } from './SearchHistory';
-export { SuggestWords } from './SuggestWords';
-export { HotWords } from './HotWords';
-export { LookupAuxiliary } from './LookupAuxiliary';
-export { LookupTrigger } from './LookupTrigger';
-export { LookupResultHost } from './LookupResultHost';

package/lib/components/pisellLookup/hooks/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * 自定义 Hooks 统一导出
- */
-export * from './useSearchState';
-export * from './useSearchHistory';
-export * from './useDebounceSearch';