@pisell/materials 1.0.1057 → 1.0.1059

package/es/components/pisellActionPanel/PisellActionPanel.stories.d.ts

@@ -0,0 +1,19 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellActionPanel } from './PisellActionPanel';
+declare const meta: Meta<typeof PisellActionPanel>;
+export default meta;
+declare type Story = StoryObj<typeof PisellActionPanel>;
+/** 默认：单组两按钮 */
+export declare const Default: Story;
+/** 右对齐（表单底部常见） */
+export declare const AlignRight: Story;
+/** 多组：主操作 + 危险操作 */
+export declare const MultipleGroups: Story;
+/** 竖向布局 */
+export declare const VerticalLayout: Story;
+/** 条件显隐（某条 visible: false） */
+export declare const ConditionalVisible: Story;
+/** 居中 */
+export declare const AlignCenter: Story;
+/** space-between 两端对齐 */
+export declare const SpaceBetween: Story;

package/es/components/pisellActionPanel/PisellActionPanel.stories.js

@@ -0,0 +1,208 @@
+import { DeleteOutlined, EditOutlined, SaveOutlined } from '@ant-design/icons';
+import { PisellActionPanel } from "./PisellActionPanel";
+var meta = {
+  title: 'General/PisellActionPanel',
+  component: PisellActionPanel,
+  tags: ['autodocs'],
+  argTypes: {
+    layout: {
+      description: '布局方式',
+      control: 'select',
+      options: ['horizontal', 'vertical', 'grid']
+    },
+    align: {
+      description: '对齐方式',
+      control: 'select',
+      options: ['left', 'center', 'right', 'space-between']
+    },
+    overflowStrategy: {
+      description: '溢出策略',
+      control: 'select',
+      options: ['wrap', 'scroll', 'moreMenu']
+    }
+  },
+  args: {
+    groups: [{
+      items: [{
+        label: '取消',
+        onClick: function onClick() {
+          return console.log('取消');
+        }
+      }, {
+        label: '确定',
+        priority: 'primary',
+        onClick: function onClick() {
+          return console.log('确定');
+        }
+      }]
+    }]
+  }
+};
+export default meta;
+/** 默认：单组两按钮 */
+export var Default = {
+  args: {
+    groups: [{
+      items: [{
+        label: '取消',
+        onClick: function onClick() {
+          return console.log('取消');
+        }
+      }, {
+        label: '确定',
+        priority: 'primary',
+        onClick: function onClick() {
+          return console.log('确定');
+        }
+      }]
+    }]
+  }
+};
+
+/** 右对齐（表单底部常见） */
+export var AlignRight = {
+  args: {
+    groups: [{
+      items: [{
+        label: '取消',
+        onClick: function onClick() {
+          return console.log('取消');
+        }
+      }, {
+        label: '提交',
+        priority: 'primary',
+        onClick: function onClick() {
+          return console.log('提交');
+        }
+      }]
+    }],
+    align: 'right',
+    groupGap: 16,
+    itemGap: 8
+  }
+};
+
+/** 多组：主操作 + 危险操作 */
+export var MultipleGroups = {
+  args: {
+    groups: [{
+      items: [{
+        label: '编辑',
+        icon: /*#__PURE__*/React.createElement(EditOutlined, null),
+        onClick: function onClick() {
+          return console.log('编辑');
+        }
+      }, {
+        label: '删除',
+        icon: /*#__PURE__*/React.createElement(DeleteOutlined, null),
+        priority: 'danger',
+        onClick: function onClick() {
+          return console.log('删除');
+        }
+      }]
+    }, {
+      items: [{
+        label: '取消',
+        onClick: function onClick() {
+          return console.log('取消');
+        }
+      }, {
+        label: '保存',
+        icon: /*#__PURE__*/React.createElement(SaveOutlined, null),
+        priority: 'primary',
+        onClick: function onClick() {
+          return console.log('保存');
+        }
+      }]
+    }],
+    align: 'right',
+    groupGap: 24,
+    itemGap: 8
+  }
+};
+
+/** 竖向布局 */
+export var VerticalLayout = {
+  args: {
+    layout: 'vertical',
+    groups: [{
+      items: [{
+        label: '主操作',
+        priority: 'primary',
+        onClick: function onClick() {
+          return console.log('主操作');
+        }
+      }, {
+        label: '次操作',
+        onClick: function onClick() {
+          return console.log('次操作');
+        }
+      }]
+    }]
+  }
+};
+
+/** 条件显隐（某条 visible: false） */
+export var ConditionalVisible = {
+  args: {
+    groups: [{
+      items: [{
+        label: '始终显示',
+        onClick: function onClick() {}
+      }, {
+        label: '隐藏项',
+        visible: false,
+        onClick: function onClick() {}
+      }, {
+        label: '确定',
+        priority: 'primary',
+        onClick: function onClick() {}
+      }]
+    }]
+  }
+};
+
+/** 居中 */
+export var AlignCenter = {
+  args: {
+    align: 'center',
+    groups: [{
+      items: [{
+        label: '取消',
+        onClick: function onClick() {}
+      }, {
+        label: '确定',
+        priority: 'primary',
+        onClick: function onClick() {}
+      }]
+    }]
+  }
+};
+
+/** space-between 两端对齐 */
+export var SpaceBetween = {
+  args: {
+    align: 'space-between',
+    groups: [{
+      items: [{
+        label: '返回',
+        onClick: function onClick() {
+          return console.log('返回');
+        }
+      }]
+    }, {
+      items: [{
+        label: '保存草稿',
+        onClick: function onClick() {
+          return console.log('草稿');
+        }
+      }, {
+        label: '发布',
+        priority: 'primary',
+        onClick: function onClick() {
+          return console.log('发布');
+        }
+      }]
+    }]
+  }
+};

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

@@ -0,0 +1,6 @@
+/**
+ * PisellActionPanel 组件导出
+ * 操作面板：统一承载、编排一组用户可执行操作
+ */
+export { PisellActionPanel } from './PisellActionPanel';
+export type { PisellActionPanelProps, PisellActionPanelGroup, PisellActionPanelItem, ActionPanelLayout, ActionPanelAlign, ActionPanelOverflowStrategy, ActionPanelItemPriority, } from './types';

package/es/components/pisellActionPanel/index.js

@@ -0,0 +1,5 @@
+/**
+ * PisellActionPanel 组件导出
+ * 操作面板：统一承载、编排一组用户可执行操作
+ */
+export { PisellActionPanel } from "./PisellActionPanel";

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

@@ -0,0 +1,83 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * 操作项层级（主/次/危险）
+ */
+export declare type ActionPanelItemPriority = 'primary' | 'secondary' | 'danger' | 'default';
+/**
+ * Action Panel 单条操作项
+ * 对应设计文档 Action Item，可渲染为 Button / IconButton
+ */
+export interface PisellActionPanelItem {
+    /** 唯一 key，用于 React key；不传则用 index */
+    key?: string;
+    /** 展示文案（Button 时显示） */
+    label?: string;
+    /** 图标节点（可单独图标或与 label 同显） */
+    icon?: ReactNode;
+    /** 点击回调 */
+    onClick?: () => void;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否显示（条件显隐） @default true */
+    visible?: boolean;
+    /** 层级：主/次/危险/默认，影响按钮样式 */
+    priority?: ActionPanelItemPriority;
+    /** 单项内联样式 */
+    style?: CSSProperties;
+    /** 单项类名 */
+    className?: string;
+}
+/**
+ * Action Panel 分组
+ * 对应设计文档 Action Group，内包含多个 Action Item
+ */
+export interface PisellActionPanelGroup {
+    /** 唯一 key；不传则用 index */
+    key?: string;
+    /** 本组操作项 */
+    items: PisellActionPanelItem[];
+    /** 组内整体优先级（可影响组内按钮默认 priority） */
+    priority?: ActionPanelItemPriority;
+    /** 是否显示该组 @default true */
+    visible?: boolean;
+    /** 组内对齐方式（组内多个 item 时的对齐） */
+    align?: 'start' | 'center' | 'end';
+    /** 组容器类名 */
+    className?: string;
+    /** 组容器样式 */
+    style?: CSSProperties;
+}
+/**
+ * Panel 布局方式
+ */
+export declare type ActionPanelLayout = 'horizontal' | 'vertical' | 'grid';
+/**
+ * Panel 对齐方式
+ */
+export declare type ActionPanelAlign = 'left' | 'center' | 'right' | 'space-between';
+/**
+ * 溢出策略：换行 / 滚动 / 更多菜单收纳
+ */
+export declare type ActionPanelOverflowStrategy = 'wrap' | 'scroll' | 'moreMenu';
+/**
+ * PisellActionPanel 组件 Props
+ * 设计文档：Action Panel (pcp_ge_actionPanel_V1.0)
+ */
+export interface PisellActionPanelProps {
+    /** 操作分组列表，顺序即展示顺序 */
+    groups: PisellActionPanelGroup[];
+    /** 布局方式 @default 'horizontal' */
+    layout?: ActionPanelLayout;
+    /** 整体对齐方式 @default 'left' */
+    align?: ActionPanelAlign;
+    /** 溢出策略 @default 'wrap' */
+    overflowStrategy?: ActionPanelOverflowStrategy;
+    /** 组与组之间的间距（CSS gap 或 number px） */
+    groupGap?: number | string;
+    /** 组内操作项之间的间距（CSS gap 或 number px） */
+    itemGap?: number | string;
+    /** 根节点类名 */
+    className?: string;
+    /** 根节点样式 */
+    style?: CSSProperties;
+}

package/es/components/pisellActionPanel/types.js

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

package/es/components/pisellBaseCard/PisellBaseCard.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="react" />
+import type { PisellBaseCardProps } from './types';
+import './PisellBaseCard.less';
+/**
+ * PisellBaseCard 基础卡片容器
+ * 提供可定制的容器用于承载子内容，支持默认/悬停/按下/禁用四态样式，可点击时支持焦点与键盘触发
+ */
+export declare function PisellBaseCard({ children, className, style, hoverStyle, activeStyle, disabledStyle, clickable, disabled, onClick, }: PisellBaseCardProps): JSX.Element;

package/es/components/pisellBaseCard/PisellBaseCard.js

@@ -0,0 +1,96 @@
+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 _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure 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 _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; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+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, { useCallback, useState } from 'react';
+import classNames from 'classnames';
+import "./PisellBaseCard.less";
+
+/**
+ * 合并默认样式与状态样式
+ */
+function mergeStateStyle(base, hover, active, disabled, isHover, isActive, isDisabled) {
+  var s = _objectSpread({}, base);
+  if (isDisabled && disabled) {
+    Object.assign(s, disabled);
+    return s;
+  }
+  if (isActive && active) Object.assign(s, active);
+  if (isHover && hover) Object.assign(s, hover);
+  return s;
+}
+
+/**
+ * PisellBaseCard 基础卡片容器
+ * 提供可定制的容器用于承载子内容，支持默认/悬停/按下/禁用四态样式，可点击时支持焦点与键盘触发
+ */
+export function PisellBaseCard(_ref) {
+  var children = _ref.children,
+    className = _ref.className,
+    style = _ref.style,
+    hoverStyle = _ref.hoverStyle,
+    activeStyle = _ref.activeStyle,
+    disabledStyle = _ref.disabledStyle,
+    _ref$clickable = _ref.clickable,
+    clickable = _ref$clickable === void 0 ? true : _ref$clickable,
+    _ref$disabled = _ref.disabled,
+    disabled = _ref$disabled === void 0 ? false : _ref$disabled,
+    onClick = _ref.onClick;
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    isHover = _useState2[0],
+    setIsHover = _useState2[1];
+  var _useState3 = useState(false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    isActive = _useState4[0],
+    setIsActive = _useState4[1];
+  var mergedStyle = mergeStateStyle(style, hoverStyle, activeStyle, disabledStyle, isHover, isActive, disabled);
+  var handleClick = useCallback(function (e) {
+    if (!clickable || disabled) return;
+    onClick === null || onClick === void 0 || onClick(e);
+  }, [clickable, disabled, onClick]);
+  var handleKeyDown = useCallback(function (e) {
+    if (!clickable || disabled) return;
+    if (e.key === 'Enter' || e.key === ' ') {
+      e.preventDefault();
+      e.target.click();
+    }
+  }, [clickable, disabled]);
+  var handlePointerEnter = useCallback(function () {
+    if (!disabled) setIsHover(true);
+  }, [disabled]);
+  var handlePointerLeave = useCallback(function () {
+    setIsHover(false);
+    setIsActive(false);
+  }, []);
+  var handlePointerDown = useCallback(function () {
+    if (clickable && !disabled) setIsActive(true);
+  }, [clickable, disabled]);
+  var handlePointerUp = useCallback(function () {
+    setIsActive(false);
+  }, []);
+  var canInteract = clickable && !disabled;
+  return /*#__PURE__*/React.createElement("div", {
+    className: classNames('pisell-base-card-root', className),
+    style: mergedStyle,
+    "data-clickable": clickable,
+    "data-disabled": disabled,
+    role: canInteract ? 'button' : undefined,
+    "aria-disabled": disabled ? true : undefined,
+    tabIndex: canInteract ? 0 : undefined,
+    onClick: handleClick,
+    onKeyDown: handleKeyDown,
+    onPointerEnter: handlePointerEnter,
+    onPointerLeave: handlePointerLeave,
+    onPointerDown: handlePointerDown,
+    onPointerUp: handlePointerUp
+  }, children);
+}

package/es/components/pisellBaseCard/PisellBaseCard.less

@@ -0,0 +1,25 @@
+/**
+ * PisellBaseCard 样式
+ * 默认态依设计稿写死：背景 #FFF、边框 #EAECF0、圆角 12px、padding 16px、阴影
+ */
+.pisell-base-card-root {
+  box-sizing: border-box;
+  /* 设计稿默认：背景、边框、圆角、内边距、阴影 */
+  background-color: #ffffff;
+  border: 1px solid #eaecf0;
+  border-radius: 12px;
+  padding: 16px;
+  box-shadow: 0 1px 2px 0 rgba(16, 24, 40, 0.05);
+  /* 最小 padding 避免内容贴边 */
+  min-height: 0;
+  min-width: 0;
+
+  /* 可点击时鼠标指针 */
+  &[data-clickable='true'] {
+    cursor: pointer;
+  }
+
+  &[data-disabled='true'] {
+    cursor: not-allowed;
+  }
+}

package/es/components/pisellBaseCard/PisellBaseCard.stories.d.ts

@@ -0,0 +1,19 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellBaseCard } from './PisellBaseCard';
+declare const meta: Meta<typeof PisellBaseCard>;
+export default meta;
+declare type Story = StoryObj<typeof PisellBaseCard>;
+/** 默认：可点击、无内容 */
+export declare const Default: Story;
+/** 带内容 */
+export declare const WithChildren: Story;
+/** 可点击并带点击回调 */
+export declare const Clickable: Story;
+/** 禁用态 */
+export declare const Disabled: Story;
+/** 不可点击（仅容器） */
+export declare const NotClickable: Story;
+/** 自定义默认样式 */
+export declare const CustomStyle: Story;
+/** 悬停/按下/禁用样式 */
+export declare const StateStyles: Story;

package/es/components/pisellBaseCard/PisellBaseCard.stories.js

@@ -0,0 +1,99 @@
+import { PisellBaseCard } from "./PisellBaseCard";
+var meta = {
+  title: 'Data Display/PisellBaseCard',
+  component: PisellBaseCard,
+  tags: ['autodocs'],
+  argTypes: {
+    clickable: {
+      description: '是否可点击',
+      control: 'boolean'
+    },
+    disabled: {
+      description: '是否禁用',
+      control: 'boolean'
+    },
+    children: {
+      description: '卡片内容',
+      control: 'text'
+    }
+  }
+};
+export default meta;
+/** 默认：可点击、无内容 */
+export var Default = {
+  args: {}
+};
+
+/** 带内容 */
+export var WithChildren = {
+  args: {
+    children: /*#__PURE__*/React.createElement("div", {
+      style: {
+        padding: 8
+      }
+    }, /*#__PURE__*/React.createElement("div", null, "\u6807\u9898"), /*#__PURE__*/React.createElement("div", {
+      style: {
+        color: '#666',
+        fontSize: 14
+      }
+    }, "\u63CF\u8FF0\u6587\u5B57"))
+  }
+};
+
+/** 可点击并带点击回调 */
+export var Clickable = {
+  args: {
+    children: '点击我',
+    onClick: function onClick() {
+      return alert('卡片被点击');
+    }
+  }
+};
+
+/** 禁用态 */
+export var Disabled = {
+  args: {
+    children: '禁用卡片',
+    disabled: true
+  }
+};
+
+/** 不可点击（仅容器） */
+export var NotClickable = {
+  args: {
+    children: '不可点击，无 role',
+    clickable: false
+  }
+};
+
+/** 自定义默认样式 */
+export var CustomStyle = {
+  args: {
+    children: '自定义背景与圆角',
+    style: {
+      backgroundColor: '#f0f5ff',
+      borderRadius: 16,
+      padding: 24
+    }
+  }
+};
+
+/** 悬停/按下/禁用样式 */
+export var StateStyles = {
+  args: {
+    children: '悬停与按下有样式变化',
+    style: {
+      padding: 16
+    },
+    hoverStyle: {
+      backgroundColor: '#e6f4ff',
+      borderColor: '#91caff'
+    },
+    activeStyle: {
+      backgroundColor: '#bae0ff'
+    },
+    disabledStyle: {
+      opacity: 0.6
+    }
+  }
+};

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

@@ -0,0 +1,5 @@
+/**
+ * PisellBaseCard 组件导出
+ */
+export { PisellBaseCard } from './PisellBaseCard';
+export type { PisellBaseCardProps } from './types';

package/es/components/pisellBaseCard/index.js

@@ -0,0 +1,4 @@
+/**
+ * PisellBaseCard 组件导出
+ */
+export { PisellBaseCard } from "./PisellBaseCard";

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

@@ -0,0 +1,45 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * PisellBaseCard 组件 Props
+ * @description 基础卡片容器，支持四态样式与可点击配置，无选中逻辑（选中由低代码处理）
+ */
+export interface PisellBaseCardProps {
+    /**
+     * 卡片内容，由低代码插槽或直接传入
+     */
+    children?: ReactNode;
+    /**
+     * 自定义类名，应用于根节点
+     */
+    className?: string;
+    /**
+     * 默认状态下的内联样式（背景、圆角、边框、阴影、padding、宽高等）
+     */
+    style?: CSSProperties;
+    /**
+     * 悬停时的样式覆盖，与 style 合并后应用
+     */
+    hoverStyle?: CSSProperties;
+    /**
+     * 按下（active）时的样式覆盖，与 style 合并后应用
+     */
+    activeStyle?: CSSProperties;
+    /**
+     * 禁用时的样式覆盖，与 style 合并后应用
+     */
+    disabledStyle?: CSSProperties;
+    /**
+     * 是否可点击（可聚焦并触发 onClick）
+     * @default true
+     */
+    clickable?: boolean;
+    /**
+     * 是否禁用，禁用时应用 disabledStyle 且不响应点击与焦点
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 点击回调，仅在 clickable 且非 disabled 时触发
+     */
+    onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;
+}

package/es/components/pisellBaseCard/types.js

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