@pisell/materials 6.3.25 → 6.3.27

package/es/components/pisellSingleLineText/components/ReadOnlyView.js

@@ -0,0 +1,153 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import React from 'react';
+import { Typography, Tooltip, Badge, Tag } from 'antd';
+/**
+ * PisellSingleLineText 只读态视图组件
+ * 
+ * 负责渲染只读态的文本展示，支持多种展示样式变体（基于 Figma 设计规范）
+ * 
+ * 功能：
+ * - 普通文本展示（默认）- 16px, Medium, Gray/900
+ * - 超链接样式 - 链接色，带下划线
+ * - 徽标样式 - 圆形红色徽标（类似通知数量）
+ * - 标签样式 - 灰色边框标签
+ * - 文本截断（ellipsis）
+ * - Tooltip 悬停提示完整内容
+ * - 自定义样式（字号、字重、颜色、对齐）
+ * 
+ * @param props 组件 Props
+ */
+var ReadOnlyView = function ReadOnlyView(props) {
+  var value = props.value,
+    _props$displayVariant = props.displayVariant,
+    displayVariant = _props$displayVariant === void 0 ? 'text' : _props$displayVariant,
+    onLinkClick = props.onLinkClick,
+    _props$badgeStatus = props.badgeStatus,
+    badgeStatus = _props$badgeStatus === void 0 ? 'default' : _props$badgeStatus,
+    tagColor = props.tagColor,
+    _props$tagClosable = props.tagClosable,
+    tagClosable = _props$tagClosable === void 0 ? false : _props$tagClosable,
+    onTagClose = props.onTagClose,
+    _props$ellipsis = props.ellipsis,
+    ellipsis = _props$ellipsis === void 0 ? true : _props$ellipsis,
+    _props$showTooltip = props.showTooltip,
+    showTooltip = _props$showTooltip === void 0 ? true : _props$showTooltip,
+    fontSize = props.fontSize,
+    fontWeight = props.fontWeight,
+    color = props.color,
+    _props$textAlign = props.textAlign,
+    textAlign = _props$textAlign === void 0 ? 'left' : _props$textAlign,
+    className = props.className,
+    style = props.style;
+
+  // 默认样式（基于 Figma 设计规范）
+  var defaultTextStyle = {
+    fontSize: fontSize || 16,
+    fontWeight: fontWeight || 500,
+    // Medium
+    color: color || '#101828',
+    // Gray/900
+    lineHeight: '24px',
+    textAlign: textAlign
+  };
+
+  // 组合文本样式
+  var textStyle = _objectSpread(_objectSpread({}, defaultTextStyle), style);
+
+  /**
+   * 渲染不同样式变体的内容
+   */
+  var renderContent = function renderContent() {
+    switch (displayVariant) {
+      case 'link':
+        // 超链接样式（基于 Figma 设计：蓝色+双下划线）
+        return /*#__PURE__*/React.createElement("span", {
+          className: "pisell-single-line-text-link ".concat(className || ''),
+          onClick: onLinkClick,
+          style: _objectSpread({
+            fontSize: fontSize || 16,
+            fontWeight: fontWeight || 500,
+            color: color || '#7F56DA',
+            // 使用项目统一链接色
+            textDecoration: 'underline',
+            textDecorationStyle: 'double',
+            cursor: 'pointer',
+            display: 'inline-block',
+            lineHeight: '24px'
+          }, style),
+          role: "link",
+          tabIndex: 0,
+          onKeyDown: function onKeyDown(e) {
+            if (e.key === 'Enter' || e.key === ' ') {
+              onLinkClick === null || onLinkClick === void 0 || onLinkClick();
+            }
+          }
+        }, value || '');
+      case 'badge':
+        // 徽标样式 - 圆形红色徽标（基于 Figma 设计）
+        // 使用 Badge.count 样式
+        return /*#__PURE__*/React.createElement(Badge, {
+          count: value || '',
+          style: _objectSpread({
+            backgroundColor: badgeStatus === 'error' ? '#D92D20' : undefined,
+            color: '#FFFFFF',
+            fontSize: '14px',
+            fontWeight: 400,
+            lineHeight: '20px',
+            borderRadius: '16px',
+            padding: '0 4px',
+            minWidth: '20px',
+            height: '20px',
+            border: '1px solid white'
+          }, style),
+          className: className
+        });
+      case 'tag':
+        // 标签样式（基于 Figma 设计：灰色边框）
+        return /*#__PURE__*/React.createElement(Tag, {
+          color: tagColor,
+          closable: tagClosable,
+          onClose: onTagClose,
+          style: _objectSpread({
+            backgroundColor: tagColor ? undefined : '#F9FAFB',
+            // Gray/50
+            borderColor: tagColor ? undefined : '#EAECF0',
+            // Gray/200
+            color: tagColor ? undefined : '#344054',
+            // Gray/700
+            fontSize: '14px',
+            fontWeight: 500,
+            // Medium
+            lineHeight: '20px',
+            padding: '4px 12px',
+            borderRadius: '16px'
+          }, textStyle),
+          className: className
+        }, value || '');
+      case 'text':
+      default:
+        // 普通文本样式（默认，基于 Figma 设计）
+        return /*#__PURE__*/React.createElement(Typography.Text, {
+          ellipsis: ellipsis,
+          style: textStyle,
+          className: "pisell-single-line-text-read ".concat(className || '')
+        }, value || '');
+    }
+  };
+  var content = renderContent();
+
+  // 如果启用 tooltip 且内容被截断，显示悬浮提示
+  // 注意：Badge 和 Tag 样式不需要 Tooltip
+  if (showTooltip && ellipsis && value && (displayVariant === 'text' || displayVariant === 'link')) {
+    return /*#__PURE__*/React.createElement(Tooltip, {
+      title: value
+    }, content);
+  }
+  return content;
+};
+export default ReadOnlyView;

package/es/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/es/components/pisellSingleLineText/index.js

@@ -0,0 +1,7 @@
+/**
+ * PisellSingleLineText 组件导出
+ */
+
+export { default as PisellSingleLineText } from "./PisellSingleLineText";
+
+// 公共类型从 types 中重新导出，方便使用

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

@@ -0,0 +1,139 @@
+import type { CSSProperties, ReactNode } from 'react';
+import type { BaseTextInputProps } from '@pisell/utils';
+/**
+ * PisellSingleLineText 组件 Props 类型定义
+ *
+ * 继承 BaseTextInputProps，添加单行文本特有的配置
+ */
+export interface PisellSingleLineTextProps extends BaseTextInputProps {
+    /**
+     * 状态模式
+     * @default 'edit'
+     */
+    mode?: 'read' | 'edit';
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 展示样式变体
+     * - text: 普通文本（默认）
+     * - link: 超链接样式
+     * - badge: 徽标样式
+     * - tag: 标签样式
+     * @default 'text'
+     */
+    displayVariant?: 'text' | 'link' | 'badge' | 'tag';
+    /**
+     * 超链接点击回调（displayVariant='link' 时有效）
+     */
+    onLinkClick?: () => void;
+    /**
+     * 徽标状态（displayVariant='badge' 时有效）
+     */
+    badgeStatus?: 'success' | 'processing' | 'default' | 'error' | 'warning';
+    /**
+     * 标签颜色（displayVariant='tag' 时有效）
+     */
+    tagColor?: string;
+    /**
+     * 标签是否可关闭（displayVariant='tag' 时有效）
+     */
+    tagClosable?: boolean;
+    /**
+     * 标签关闭回调（displayVariant='tag' 时有效）
+     */
+    onTagClose?: () => void;
+    /**
+     * 超出是否省略
+     * @default true
+     */
+    ellipsis?: boolean;
+    /**
+     * 悬停是否显示完整内容（Tooltip）
+     * @default true
+     */
+    showTooltip?: boolean;
+    /**
+     * 字号
+     * @example '14px' 或 14
+     */
+    fontSize?: string | number;
+    /**
+     * 字重
+     * @example 'bold' 或 600
+     */
+    fontWeight?: string | number;
+    /**
+     * 文本颜色
+     * @example '#000000'
+     */
+    color?: string;
+    /**
+     * 文本对齐方式
+     * @default 'left'
+     */
+    textAlign?: 'left' | 'center' | 'right';
+    /**
+     * 占位文本
+     */
+    placeholder?: string;
+    /**
+     * 最大长度（字符数）
+     */
+    maxLength?: number;
+    /**
+     * 是否显示字数统计
+     * @default false
+     */
+    showCount?: boolean;
+    /**
+     * 是否显示清空按钮
+     * @default false
+     */
+    allowClear?: boolean;
+    /**
+     * 是否自动聚焦
+     * @default false
+     */
+    autoFocus?: boolean;
+    /**
+     * 前缀图标或文本
+     */
+    prefix?: ReactNode;
+    /**
+     * 后缀图标或文本
+     */
+    suffix?: ReactNode;
+    /**
+     * 前置标签
+     */
+    addonBefore?: ReactNode;
+    /**
+     * 后置标签
+     */
+    addonAfter?: ReactNode;
+    /**
+     * 回车键回调
+     * @param value 当前值
+     */
+    onPressEnter?: (value: string) => void;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * ARIA 标签
+     */
+    'aria-label'?: string;
+    /**
+     * ARIA 描述
+     */
+    'aria-describedby'?: string;
+}
+export type { DisplayState, ValidationResult, TextInputState } from '@pisell/utils';

package/es/components/pisellSingleLineText/types.js

@@ -0,0 +1 @@
+export {};

package/es/components/pisellSingleSelect/PisellSingleSelect.d.ts

@@ -0,0 +1,9 @@
+/**
+ * PisellSingleSelect - 单选下拉组件
+ * 基于 Ant Design Select 封装，提供符合 Pisell 设计规范的单选功能
+ */
+import React from 'react';
+import type { PisellSingleSelectProps, SingleSelectRef } from './types';
+import './PisellSingleSelect.less';
+declare const PisellSingleSelect: React.ForwardRefExoticComponent<PisellSingleSelectProps<string | number> & React.RefAttributes<SingleSelectRef<string | number>>>;
+export default PisellSingleSelect;

package/es/components/pisellSingleSelect/PisellSingleSelect.js

@@ -0,0 +1,70 @@
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+/**
+ * PisellSingleSelect - 单选下拉组件
+ * 基于 Ant Design Select 封装，提供符合 Pisell 设计规范的单选功能
+ */
+
+import React, { forwardRef, useRef, useImperativeHandle } from 'react';
+import { useSelectState } from '@pisell/utils';
+import EditView from "./components/EditView";
+import DisabledView from "./components/DisabledView";
+import ReadOnlyView from "./components/ReadOnlyView";
+import "./PisellSingleSelect.less";
+var PisellSingleSelect = /*#__PURE__*/forwardRef(function (props, ref) {
+  var value = props.value,
+    defaultValue = props.defaultValue,
+    onChange = props.onChange,
+    disabled = props.disabled,
+    readOnly = props.readOnly;
+
+  // Select 内部 ref
+  var selectRef = useRef(null);
+
+  // 状态管理（从 @pisell/utils 导入）
+  var state = useSelectState({
+    value: value,
+    defaultValue: defaultValue,
+    onChange: onChange,
+    mode: 'single'
+  });
+
+  // 暴露 Ref 方法
+  useImperativeHandle(ref, function () {
+    return {
+      focus: function focus() {
+        var _selectRef$current;
+        return (_selectRef$current = selectRef.current) === null || _selectRef$current === void 0 ? void 0 : _selectRef$current.focus();
+      },
+      blur: function blur() {
+        var _selectRef$current2;
+        return (_selectRef$current2 = selectRef.current) === null || _selectRef$current2 === void 0 ? void 0 : _selectRef$current2.blur();
+      },
+      getValue: function getValue() {
+        var _state$value;
+        return (_state$value = state.value) !== null && _state$value !== void 0 ? _state$value : null;
+      },
+      setValue: function setValue(newValue) {
+        return state.setValue(newValue);
+      },
+      clearValue: function clearValue() {
+        return state.clearValue();
+      }
+    };
+  });
+
+  // 根据不同状态渲染不同视图
+  if (disabled) {
+    return /*#__PURE__*/React.createElement(DisabledView, _extends({}, props, {
+      ref: selectRef
+    }));
+  }
+  if (readOnly) {
+    return /*#__PURE__*/React.createElement(ReadOnlyView, props);
+  }
+  return /*#__PURE__*/React.createElement(EditView, _extends({}, props, {
+    state: state,
+    ref: selectRef
+  }));
+});
+PisellSingleSelect.displayName = 'PisellSingleSelect';
+export default PisellSingleSelect;

package/es/components/pisellSingleSelect/PisellSingleSelect.less

@@ -0,0 +1,159 @@
+/**
+ * PisellSingleSelect 组件样式
+ * 
+ * 注意：大部分样式通过 tokens.ts 中的 Select Token 配置实现
+ * 此文件仅包含 Token 无法实现的样式
+ */
+
+.pisell-single-select {
+  width: 100%;
+
+  // 包装器布局（Token 无法配置）
+  &-wrapper {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+  }
+
+  // 标签（Token 无法配置的自定义元素）
+  &-label {
+    font-family: 'Inter', sans-serif;
+    font-size: 14px;
+    font-weight: 600;
+    color: #344054;
+    line-height: 20px;
+
+    &-required::after {
+      content: ' *';
+      color: #D92D20;
+      margin-left: 0;
+    }
+  }
+
+  // 辅助文本（Token 无法配置的自定义元素）
+  &-helper-text {
+    font-size: 14px;
+    font-weight: 400;
+    color: #667085;
+    line-height: 20px;
+  }
+
+  // 错误文本（Token 无法配置的自定义元素）
+  &-error-text {
+    font-size: 14px;
+    font-weight: 400;
+    color: #D92D20;
+    line-height: 20px;
+    animation: fadeIn 0.3s ease-in-out;
+  }
+
+  // 下拉选项中的勾选图标（Figma 设计）
+  &-option-content {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    width: 100%;
+  }
+
+  &-option-check {
+    color: #7F56D9; // Primary/600
+    font-size: 16px;
+    margin-left: 8px;
+  }
+
+  // hover 边框颜色（Token 不支持 colorBorderHover）
+  :global {
+    // 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;
+      }
+    }
+  }
+}
+
+// 下拉框内的搜索框样式（Figma 设计）
+:global {
+  .pisell-select-search-wrapper {
+    padding: 6px;
+    border-bottom: 1px solid #EAECF0;
+  }
+
+  .pisell-select-search-input {
+    padding: 9px 10px !important;
+    font-size: 14px;
+
+    .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;
+    }
+  }
+}
+
+.pisell-single-select {
+  // 错误状态（Token 无法单独配置错误边框颜色）
+  &-error {
+    :global(.ant-select-selector) {
+      border-color: #D92D20 !important;
+
+      &:hover {
+        border-color: #D92D20 !important;
+      }
+    }
+
+    :global(.ant-select-focused .ant-select-selector) {
+      border-color: #D92D20 !important;
+      box-shadow: 0px 0px 0px 4px rgba(217, 45, 32, 0.1), 0px 1px 2px 0px rgba(16, 24, 40, 0.05) !important;
+    }
+  }
+
+  // 只读状态（完全自定义的显示，不使用 Select 组件）
+  &-readonly {
+    &-display {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      padding: 12px 16px;
+      background-color: #F9FAFB;
+      border: 1px solid #EAECF0;
+      border-radius: 8px;
+      min-height: 48px;
+      font-size: 16px;
+      font-weight: 500;
+      line-height: 24px;
+      color: #101828;
+    }
+
+    &-icon {
+      display: flex;
+      align-items: center;
+    }
+
+    &-empty {
+      color: #667085;
+      font-weight: 400;
+    }
+  }
+}
+
+// 动画
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+    transform: translateY(-4px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}

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