@pisell/materials 6.11.3 → 6.11.5

package/lib/components/pisellRating/PisellRating.stories.d.ts

@@ -0,0 +1,53 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellRating } from './PisellRating';
+declare const meta: Meta<typeof PisellRating>;
+export default meta;
+declare type Story = StoryObj<typeof PisellRating>;
+/**
+ * 基础示例
+ */
+export declare const Basic: Story;
+/**
+ * 只读态
+ */
+export declare const ReadOnly: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 半星评分
+ */
+export declare const HalfStar: Story;
+/**
+ * 显示数值
+ */
+export declare const WithValue: Story;
+/**
+ * 显示评分人数
+ */
+export declare const WithCount: Story;
+/**
+ * 带评分描述
+ */
+export declare const WithTooltips: Story;
+/**
+ * 自定义星星数量
+ */
+export declare const CustomCount: Story;
+/**
+ * 自定义图标 - 爱心
+ */
+export declare const HeartIcon: Story;
+/**
+ * 自定义图标 - 笑脸
+ */
+export declare const SmileIcon: Story;
+/**
+ * 商品评分场景
+ */
+export declare const ProductReview: Story;
+/**
+ * 不同尺寸
+ */
+export declare const Sizes: Story;

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

@@ -0,0 +1,6 @@
+/**
+ * PisellRating 组件导出
+ */
+export { default as PisellRating } from './PisellRating';
+export type { PisellRatingProps } from './types';
+export type { DisplayState } from './types';

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

@@ -18,5 +18,5 @@ export interface PisellRowProps extends React.DetailedHTMLProps<React.HTMLAttrib
  * @Author: zhiwei.Wang
  * @Date: 2024-08-16 10:38
  */
-declare const PisellRow: (props: PisellRowProps) => JSX.Element;
+declare const PisellRow: (props: PisellRowProps) => React.JSX.Element;
 export default PisellRow;

package/lib/components/pisellSingleLineText/PisellSingleLineText.less

@@ -1,5 +1,6 @@
 /**
  * PisellSingleLineText 组件样式
+ * 不依赖全局 antd token，使用内置样式
  */
 
 .pisell-single-line-text {
@@ -7,16 +8,154 @@
     position: relative;
     width: 100%;
 
-    // 可以在这里添加自定义输入框样式
-    .ant-input {
-      // 保持 Ant Design 默认样式
+    // Input 组件内置样式，覆盖 antd token 配置
+    .ant-input,
+    .ant-input-affix-wrapper {
+      // 基础样式（基于 Figma 设计规范）
+      font-size: 16px !important;
+      line-height: 24px !important;
+      
+      // 边框和圆角
+      border-radius: 8px !important;
+      border: 1px solid #D0D5DD !important; // Gray/300
+      
+      // 内边距（Figma: 16px 12px）
+      padding: 12px 16px !important;
+      height: 48px !important; // 12px + 24px + 12px = 48px
+      
+      // 颜色
+      color: #101828 !important; // Gray/900 - 输入文本
+      background-color: #FFFFFF !important; // 背景色
+      
+      &::placeholder {
+        color: #667085 !important; // Gray/500 - 占位符
+      }
+      
+      // 聚焦态
+      &:focus,
+      &:focus-within {
+        border-color: #D6BBFB !important; // Primary/300
+        box-shadow: 0 0 0 4px #F4EBFF !important; // Primary/100
+        outline: none !important;
+      }
+      
+      // Hover 态
+      &:hover:not(:focus):not(:focus-within):not([disabled]) {
+        border-color: #B692F6 !important; // Primary/400
+      }
+      
+      // 禁用态
+      &[disabled],
+      &.ant-input-disabled {
+        background-color: #F9FAFB !important; // Gray/50
+        color: #98A2B3 !important; // Gray/400
+        border-color: #D0D5DD !important;
+        cursor: not-allowed !important;
+      }
+    }
+    
+    // 前后缀容器样式
+    .ant-input-affix-wrapper {
+      padding: 0 !important;
+      
+      .ant-input-prefix {
+        margin-right: 8px;
+        margin-left: 16px;
+        color: #667085; // Gray/500
+        font-size: 16px;
+      }
+      
+      .ant-input-suffix {
+        margin-left: 8px;
+        margin-right: 16px;
+        color: #667085; // Gray/500
+        font-size: 16px;
+      }
+      
+      .ant-input {
+        padding: 12px 0 !important;
+        border: none !important;
+        box-shadow: none !important;
+        
+        &:focus {
+          box-shadow: none !important;
+        }
+      }
+    }
+    
+    // 前后置标签样式
+    .ant-input-group-wrapper {
+      .ant-input-group-addon {
+        background-color: #FFFFFF !important;
+        border: 1px solid #D0D5DD !important;
+        color: #344054 !important; // Gray/700
+        font-size: 16px !important;
+        padding: 12px 16px !important;
+        
+        &:first-child {
+          border-right: none !important;
+          border-radius: 8px 0 0 8px !important;
+        }
+        
+        &:last-child {
+          border-left: none !important;
+          border-radius: 0 8px 8px 0 !important;
+        }
+      }
+      
+      .ant-input-wrapper {
+        .ant-input,
+        .ant-input-affix-wrapper {
+          border-radius: 0 !important;
+          
+          &:first-child {
+            border-radius: 8px 0 0 8px !important;
+          }
+          
+          &:last-child {
+            border-radius: 0 8px 8px 0 !important;
+          }
+        }
+      }
+    }
+    
+    // 清空按钮样式
+    .ant-input-clear-icon {
+      color: #667085 !important; // Gray/500
+      font-size: 14px !important;
+      
+      &:hover {
+        color: #344054 !important; // Gray/700
+      }
+    }
+    
+    // 字数统计样式
+    .ant-input-show-count-suffix {
+      color: #667085 !important; // Gray/500
+      font-size: 14px !important;
+    }
+    
+    // 错误状态样式
+    .ant-input-status-error,
+    .ant-input-affix-wrapper-status-error {
+      border-color: #FDA29B !important; // Error/300
+      
+      &:focus,
+      &:focus-within {
+        border-color: #F97066 !important; // Error/400
+        box-shadow: 0 0 0 4px #FEE4E2 !important; // Error/100
+      }
+      
+      &:hover:not(:focus):not(:focus-within) {
+        border-color: #F97066 !important; // Error/400
+      }
     }
   }
 
   &-error {
     margin-top: 4px;
     font-size: 12px;
-    color: #ff4d4f;
+    color: #D92D20; // Error/600
     line-height: 1.5;
     animation: fadeIn 0.3s ease-in-out;
   }

package/lib/components/pisellSingleLineText/PisellSingleLineText.stories.d.ts

@@ -0,0 +1,102 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellSingleLineText } from './PisellSingleLineText';
+/**
+ * PisellSingleLineText 是一个通用的单行文本输入/展示组件。
+ *
+ * ## 功能特性
+ * - 支持三种状态：只读、编辑、禁用
+ * - 完整的校验框架
+ * - 受控/非受控模式
+ * - 丰富的配置项
+ */
+declare const meta: Meta<typeof PisellSingleLineText>;
+export default meta;
+declare type Story = StoryObj<typeof PisellSingleLineText>;
+/**
+ * 基础编辑态示例
+ */
+export declare const Basic: Story;
+/**
+ * 只读态示例 - 展示文本内容
+ */
+export declare const ReadMode: Story;
+/**
+ * 只读态 - 超长文本截断
+ */
+export declare const ReadModeEllipsis: Story;
+/**
+ * 禁用态示例
+ */
+export declare const Disabled: Story;
+/**
+ * 必填校验示例
+ */
+export declare const Required: Story;
+/**
+ * 长度校验示例
+ */
+export declare const LengthValidation: Story;
+/**
+ * 正则校验 - 仅数字
+ */
+export declare const PatternValidation: Story;
+/**
+ * 自定义校验函数
+ */
+export declare const CustomValidator: Story;
+/**
+ * 前缀图标
+ */
+export declare const WithPrefix: Story;
+/**
+ * 后缀文本
+ */
+export declare const WithSuffix: Story;
+/**
+ * 前置标签
+ */
+export declare const WithAddonBefore: Story;
+/**
+ * 后置标签 - 按钮
+ */
+export declare const WithAddonAfter: Story;
+/**
+ * 完整配置示例
+ */
+export declare const FullFeatures: Story;
+/**
+ * 自定义样式 - 只读态
+ */
+export declare const CustomStyle: Story;
+/**
+ * 只读态 - 普通文本样式（默认）
+ */
+export declare const DisplayVariantText: Story;
+/**
+ * 只读态 - 超链接样式
+ */
+export declare const DisplayVariantLink: Story;
+/**
+ * 只读态 - 徽标样式（圆形红色徽标）
+ */
+export declare const DisplayVariantBadge: Story;
+/**
+ * 只读态 - 徽标样式（文本内容）
+ */
+export declare const DisplayVariantBadgeText: Story;
+/**
+ * 只读态 - 标签样式（默认灰色边框）
+ */
+export declare const DisplayVariantTag: Story;
+/**
+ * 只读态 - 标签样式（自定义颜色）
+ */
+export declare const DisplayVariantTagColored: Story;
+/**
+ * 只读态 - 标签样式（可关闭）
+ */
+export declare const DisplayVariantTagClosable: Story;
+/**
+ * 展示样式对比 - 所有变体（基于 Figma 设计）
+ */
+export declare const AllDisplayVariants: Story;

package/lib/components/pisellSingleLineText/components/DisabledView.d.ts

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

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

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { PisellSingleLineTextProps } from '../types';
+/**
+ * PisellSingleLineText 只读态视图组件
+ *
+ * 负责渲染只读态的文本展示，支持多种展示样式变体（基于 Figma 设计规范）
+ *
+ * 功能：
+ * - 普通文本展示（默认）- 16px, Medium, Gray/900
+ * - 超链接样式 - 链接色，带下划线
+ * - 徽标样式 - 圆形红色徽标（类似通知数量）
+ * - 标签样式 - 灰色边框标签
+ * - 文本截断（ellipsis）
+ * - Tooltip 悬停提示完整内容
+ * - 自定义样式（字号、字重、颜色、对齐）
+ *
+ * @param props 组件 Props
+ */
+declare const ReadOnlyView: React.FC<PisellSingleLineTextProps>;
+export default ReadOnlyView;

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

@@ -0,0 +1,6 @@
+/**
+ * PisellSingleLineText 组件导出
+ */
+export { default as PisellSingleLineText } from './PisellSingleLineText';
+export type { PisellSingleLineTextProps } from './types';
+export type { DisplayState, ValidationResult, TextInputState } from './types';

package/lib/components/pisellSingleSelect/PisellSingleSelect.less

@@ -64,8 +64,8 @@
   // hover 边框颜色（Token 不支持 colorBorderHover）
   :global {
     // hover 边框颜色
-    .ant-select:not(.ant-select-disabled):not(.ant-select-customize-input):not(.ant-select-open) {
-      .ant-select-selector:hover {
+    .pisell-lowcode-select:not(.pisell-lowcode-select-disabled):not(.pisell-lowcode-select-customize-input):not(.pisell-lowcode-select-open) {
+      .pisell-lowcode-select-selector:hover {
         border-color: #D6BBFB !important;
       }
     }
@@ -82,17 +82,17 @@
   .pisell-select-search-input {
     padding: 9px 10px !important;
     font-size: 14px;
-    
-    .ant-input {
+
+    .pisell-lowcode-input {
       font-size: 14px !important;
       color: #344054 !important;
-      
+
       &::placeholder {
         color: #98A2B3 !important;
         font-size: 12px !important;
       }
     }
-    
+
     &:hover,
     &:focus-within {
       background-color: transparent !important;

package/lib/components/pisellSingleSelect/PisellSingleSelect.stories.d.ts

@@ -0,0 +1,66 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import PisellSingleSelect from './PisellSingleSelect';
+/**
+ * PisellSingleSelect 组件 Storybook
+ *
+ * 用于展示和测试组件的各种状态和配置
+ */
+declare const meta: Meta<typeof PisellSingleSelect>;
+export default meta;
+declare type Story = StoryObj<typeof PisellSingleSelect>;
+/**
+ * 基础示例
+ */
+export declare const Basic: Story;
+/**
+ * 带标签
+ */
+export declare const WithLabel: Story;
+/**
+ * 带辅助文本
+ */
+export declare const WithHelperText: Story;
+/**
+ * 带搜索功能
+ */
+export declare const WithSearch: Story;
+/**
+ * 带清空按钮
+ */
+export declare const WithClear: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 只读态
+ */
+export declare const ReadOnly: Story;
+/**
+ * 只读态 - 空值
+ */
+export declare const ReadOnlyEmpty: Story;
+/**
+ * 错误状态
+ */
+export declare const WithError: Story;
+/**
+ * 不同尺寸
+ */
+export declare const Sizes: Story;
+/**
+ * 表单场景
+ */
+export declare const InForm: Story;
+/**
+ * 自定义过滤
+ */
+export declare const CustomFilter: Story;
+/**
+ * 回调事件演示
+ */
+export declare const WithCallbacks: Story;
+/**
+ * 所有状态组合
+ */
+export declare const AllStates: Story;

package/lib/components/pisellSingleSelect/components/DisabledView.d.ts

@@ -0,0 +1,8 @@
+/**
+ * PisellSingleSelect - DisabledView (禁用态视图)
+ * 禁用状态下的渲染
+ */
+import React from 'react';
+import type { DisabledViewProps } from '../types';
+declare const DisabledView: React.ForwardRefExoticComponent<DisabledViewProps<string | number> & React.RefAttributes<any>>;
+export default DisabledView;

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

@@ -0,0 +1,6 @@
+/**
+ * PisellSingleSelect 组件导出
+ */
+export { default as PisellSingleSelect } from './PisellSingleSelect';
+export type { PisellSingleSelectProps, SingleSelectRef, EditViewProps, DisabledViewProps, ReadOnlyViewProps, } from './types';
+export type { SelectOption, FilterOptionFunc, SortDirection, SelectState, } from './types';

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

@@ -0,0 +1,4 @@
+import React from 'react';
+import { PisellSortProps } from './type';
+declare const PisellSort: (props: PisellSortProps) => React.JSX.Element;
+export default PisellSort;

package/lib/components/pisellSort/type.d.ts

@@ -0,0 +1,7 @@
+import { SortListProps } from '../sort/types';
+import { FormInstance } from 'antd';
+export declare type PisellSortProps = SortListProps & {
+    name?: string;
+} & FormInstance & {
+    hasForm?: boolean;
+};

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

@@ -17,5 +17,5 @@ export interface PisellStatisticListProps extends React.HTMLAttributes<HTMLDivEl
         }[];
     }[];
 }
-declare const PisellStatisticList: (props: PisellStatisticListProps) => JSX.Element;
+declare const PisellStatisticList: (props: PisellStatisticListProps) => React.JSX.Element;
 export default PisellStatisticList;

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

@@ -9,5 +9,5 @@ export interface PisellTagsProps extends React.DetailedHTMLProps<React.HTMLAttri
     icon?: React.ReactNode;
     color?: PisellTagsColor;
 }
-declare const PisellTags: (props: PisellTagsProps) => JSX.Element;
+declare const PisellTags: (props: PisellTagsProps) => React.JSX.Element;
 export default PisellTags;

package/lib/components/pisellText/components/Amount/index.d.ts

@@ -16,5 +16,5 @@ export interface AmountProps extends React.HTMLAttributes<HTMLSpanElement> {
     /** 货币符号 */
     symbol?: string;
 }
-declare const Amount: (props: AmountProps) => JSX.Element;
+declare const Amount: (props: AmountProps) => React.JSX.Element;
 export default Amount;

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

@@ -2,8 +2,8 @@ import React from 'react';
 export interface PisellTextProps extends React.HTMLAttributes<HTMLSpanElement> {
 }
 declare const PisellText: {
-    (props: PisellTextProps): JSX.Element;
-    Amount: (props: import("./components/Amount").AmountProps) => JSX.Element;
+    (props: PisellTextProps): React.JSX.Element;
+    Amount: (props: import("./components/Amount").AmountProps) => React.JSX.Element;
     Editable: React.FC<import("./components/Editable").EditableProps>;
 };
 export default PisellText;

package/lib/components/pisellToast/squareToast/index.d.ts

@@ -0,0 +1,15 @@
+import { clear, show, success, info, loading, fail, hide } from './methods';
+import './index.less';
+interface ToastInstance {
+    show: typeof show;
+    clear: typeof clear;
+    success: typeof success;
+    info: typeof info;
+    loading: typeof loading;
+    fail: typeof fail;
+    error: typeof fail;
+    hide: typeof hide;
+}
+declare const Toast: ToastInstance;
+export declare const useToast: () => ToastInstance;
+export default Toast;

package/lib/components/pisellToast/squareToast/methods.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { ToastProps } from './toast';
+interface ToastInstance {
+    close: () => void;
+}
+declare const show: (configOrContent: Partial<ToastProps> | React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const clear: () => void;
+declare const success: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const info: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const loading: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const fail: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const hide: () => void;
+export { show, clear, success, info, loading, fail, hide };

package/lib/components/pisellToast/squareToast/renderImperatively.d.ts

@@ -0,0 +1,28 @@
+import type { ReactElement } from 'react';
+import type { Root } from 'react-dom/client';
+import React from 'react';
+declare type ImperativeProps = {
+    open?: boolean;
+    onCancel?: () => void;
+    afterClose?: () => void;
+};
+declare type TargetElement = ReactElement<ImperativeProps>;
+export declare type ImperativeHandler = {
+    close: () => void;
+    replace: (element: TargetElement) => void;
+    isRendered?: () => boolean;
+};
+export declare type UnmountType = () => Promise<void>;
+export declare type RenderType = (node: React.ReactElement, container: Element | DocumentFragment) => UnmountType;
+declare const MARK = "__pisell_react_root__";
+declare type ContainerType = (Element | DocumentFragment) & {
+    [MARK]?: Root;
+};
+export declare function render(node: React.ReactElement, container: ContainerType): void;
+export declare function unmount(container: ContainerType): Promise<void>;
+/**
+ * @deprecated 设置 React 渲染函数以兼容使用。
+ */
+export declare function unstableSetRender(render?: RenderType): RenderType;
+export declare function renderImperatively(element: TargetElement): ImperativeHandler;
+export {};

package/lib/components/pisellToast/squareToast/toast.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import './index.less';
+export declare type ToastType = 'success' | 'error' | 'warning' | 'info' | 'loading';
+export interface ToastProps {
+    /** Toast 类型 */
+    icon?: ToastType | React.ReactNode;
+    /** 显示的内容，支持文本或 React 节点 */
+    content: React.ReactNode;
+    /** 是否显示 */
+    open?: boolean;
+    /** 自动关闭时间，单位毫秒，0 表示不自动关闭 */
+    duration?: number;
+    /** 关闭 */
+    onCancel?: () => void;
+    /** 关闭后回调 */
+    afterClose?: () => void;
+    /** 自定义样式类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 是否显示遮罩 */
+    mask?: boolean;
+}
+declare const Toast: React.FC<ToastProps>;
+export default Toast;

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

@@ -1,3 +1,4 @@
+import React from 'react';
 import { TooltipPropsWithTitle } from 'antd/es/tooltip';
 import { PisellContextType } from "../pisell-config-provider/context";
 import './index.less';
@@ -5,5 +6,5 @@ export interface PisellTooltipProps extends TooltipPropsWithTitle {
     /** 平台 */
     platform?: PisellContextType['platform'];
 }
-declare const PisellTooltip: (props: PisellTooltipProps) => JSX.Element;
+declare const PisellTooltip: (props: PisellTooltipProps) => React.JSX.Element;
 export default PisellTooltip;

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

@@ -1,3 +1,4 @@
+import React from 'react';
 import type { UploadProps } from 'antd';
 import './index.less';
 export interface PisellUploadProps extends UploadProps {
@@ -6,5 +7,5 @@ export interface PisellUploadProps extends UploadProps {
     text2?: string;
     uploadType?: 'button' | 'drop' | 'custom';
 }
-declare const PisellUpload: (props: PisellUploadProps) => JSX.Element;
+declare const PisellUpload: (props: PisellUploadProps) => React.JSX.Element;
 export default PisellUpload;

package/lib/components/pisellUrl/PisellUrl.less

@@ -20,7 +20,7 @@
     align-items: center;
 
     // 链接样式
-    .ant-typography-link {
+    .pisell-lowcode-typography-link {
       cursor: pointer;
       transition: all 0.3s;