@pisell/materials 3.3.77 → 3.3.79

package/lib/components/PisellSteps/utils/index.js

@@ -0,0 +1,88 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellSteps/utils/index.ts
+var utils_exports = {};
+__export(utils_exports, {
+  calculateProgress: () => calculateProgress,
+  getChangeDirection: () => getChangeDirection,
+  getStepStatus: () => getStepStatus,
+  isStepClickable: () => isStepClickable,
+  isValidStepIndex: () => isValidStepIndex,
+  mergeStepClassName: () => mergeStepClassName
+});
+module.exports = __toCommonJS(utils_exports);
+function calculateProgress(current, total) {
+  if (total <= 0) return 0;
+  if (current < 0) return 0;
+  if (current >= total) return 100;
+  return Math.round((current + 1) / total * 100);
+}
+function isStepClickable(index, current, status, clickable, allowClickFinished) {
+  if (!clickable) {
+    return false;
+  }
+  if (index === current) {
+    return false;
+  }
+  if (status === "finish" || index < current) {
+    return allowClickFinished;
+  }
+  if (status === "wait") {
+    return false;
+  }
+  if (status === "error") {
+    return true;
+  }
+  return true;
+}
+function getStepStatus(index, current, customStatus) {
+  if (customStatus) {
+    return customStatus;
+  }
+  if (index < current) {
+    return "finish";
+  } else if (index === current) {
+    return "process";
+  } else {
+    return "wait";
+  }
+}
+function mergeStepClassName(baseClass, status, customClass) {
+  const classes = [baseClass];
+  classes.push(`${baseClass}-${status}`);
+  if (customClass) {
+    classes.push(customClass);
+  }
+  return classes.join(" ");
+}
+function getChangeDirection(from, to) {
+  return to > from ? "forward" : "backward";
+}
+function isValidStepIndex(index, total) {
+  return index >= 0 && index < total;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  calculateProgress,
+  getChangeDirection,
+  getStepStatus,
+  isStepClickable,
+  isValidStepIndex,
+  mergeStepClassName
+});

package/lib/components/PisellSuperTabs/PisellSuperTabs.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { PisellSuperTabsProps } from './types';
+import './PisellSuperTabs.less';
+interface PisellSuperTabsRef {
+    scrollItemByRowKey: (key: string) => void;
+}
+declare const _default: React.ForwardRefExoticComponent<PisellSuperTabsProps<unknown> & React.RefAttributes<PisellSuperTabsRef>>;
+export default _default;

package/lib/components/PisellSuperTabs/PisellSuperTabs.js

@@ -0,0 +1,207 @@
+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)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  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/PisellSuperTabs/PisellSuperTabs.tsx
+var PisellSuperTabs_exports = {};
+__export(PisellSuperTabs_exports, {
+  default: () => PisellSuperTabs_default
+});
+module.exports = __toCommonJS(PisellSuperTabs_exports);
+var import_react = __toESM(require("react"));
+var import_classnames = __toESM(require("classnames"));
+var import_hooks = require("./hooks");
+var import_utils = require("./utils");
+var import_PisellBasicGrid = __toESM(require("../PisellBasicGrid"));
+var import_PisellScrollView = __toESM(require("../PisellScrollView"));
+var import_PisellSuperTabs = require("./PisellSuperTabs.less");
+var PisellSuperTabs = (props, ref) => {
+  const {
+    // 基础属性
+    className,
+    style,
+    dataSource = [],
+    rowKey = "key",
+    value,
+    id,
+    defaultValue,
+    onChange,
+    renderItem,
+    // Grid Props（已分组）
+    gridProps = {},
+    // ScrollView Props（已分组）
+    scrollViewProps = {},
+    children,
+    slotLeft,
+    slotRight,
+    slotTop,
+    slotBottom,
+    tabItemClassName,
+    tabItemStyle,
+    slotLeftClassName,
+    slotRightClassName,
+    slotTopClassName,
+    slotBottomClassName,
+    slotLeftStyle,
+    slotRightStyle,
+    slotTopStyle,
+    slotBottomStyle,
+    __designMode
+  } = props;
+  const containerRef = (0, import_react.useRef)(null);
+  const { activeKey, handleTabChange } = (0, import_hooks.useTabsState)({
+    value,
+    defaultValue,
+    onChange
+  });
+  const scrollItemByRowKey = (key) => {
+    const item = document.querySelector(`.pisell-super-tabs-item-${id}-${key}`);
+    console.log(`.pisell-super-tabs-item-${id}-${key}`);
+    if (item) {
+      item.scrollIntoView({ behavior: "smooth" });
+    }
+  };
+  (0, import_react.useImperativeHandle)(ref, () => {
+    if (__designMode) {
+      return containerRef.current;
+    }
+    return {
+      scrollItemByRowKey
+    };
+  });
+  return /* @__PURE__ */ import_react.default.createElement(
+    "div",
+    {
+      className: (0, import_classnames.default)("pisell-super-tabs", className),
+      style,
+      id,
+      ref: containerRef
+    },
+    /* @__PURE__ */ import_react.default.createElement(
+      "div",
+      {
+        className: (0, import_classnames.default)(
+          "pisell-super-tabs-slot-top-" + id,
+          slotTopClassName
+        ),
+        style: slotTopStyle
+      },
+      slotTop
+    ),
+    /* @__PURE__ */ import_react.default.createElement(
+      "div",
+      {
+        className: (0, import_classnames.default)(
+          "pisell-super-tabs-slot-left-" + id,
+          slotLeftClassName
+        ),
+        style: slotLeftStyle
+      },
+      slotLeft
+    ),
+    /* @__PURE__ */ import_react.default.createElement(import_PisellScrollView.default, { ...scrollViewProps }, /* @__PURE__ */ import_react.default.createElement(
+      import_PisellBasicGrid.default,
+      {
+        ...gridProps,
+        dataSource,
+        rowKey,
+        renderItem: (item, index) => {
+          const key = (0, import_utils.getRowKey)(item, index, rowKey);
+          const active = key === String(activeKey);
+          let content;
+          if (renderItem) {
+            if (typeof renderItem === "function") {
+              content = renderItem({
+                dataSource: item,
+                index,
+                onClick: () => {
+                  if (item.customClick) {
+                    return;
+                  }
+                  handleTabChange(key, item);
+                },
+                tabsState: {
+                  activeKey,
+                  handleTabChange
+                },
+                tabsProps: props,
+                active: {
+                  value: active
+                }
+              });
+            } else {
+              content = renderItem;
+            }
+          } else {
+            content = item["label"];
+          }
+          return /* @__PURE__ */ import_react.default.createElement(
+            "div",
+            {
+              key,
+              className: (0, import_classnames.default)(
+                "pisell-super-tabs-item",
+                `pisell-super-tabs-item-${id}-${key}`,
+                {
+                  "pisell-super-tabs-item--active": active
+                },
+                tabItemClassName
+              ),
+              style: tabItemStyle
+            },
+            content
+          );
+        }
+      }
+    )),
+    /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-super-tabs-content" }, children),
+    /* @__PURE__ */ import_react.default.createElement(
+      "div",
+      {
+        className: (0, import_classnames.default)(
+          "pisell-super-tabs-slot-right-" + id,
+          slotRightClassName
+        ),
+        style: slotRightStyle
+      },
+      slotRight
+    ),
+    /* @__PURE__ */ import_react.default.createElement(
+      "div",
+      {
+        className: (0, import_classnames.default)(
+          "pisell-super-tabs-slot-bottom-" + id,
+          slotBottomClassName
+        ),
+        style: slotBottomStyle
+      },
+      slotBottom
+    )
+  );
+};
+PisellSuperTabs.displayName = "PisellSuperTabs";
+var PisellSuperTabs_default = (0, import_react.forwardRef)(PisellSuperTabs);

package/lib/components/PisellSuperTabs/PisellSuperTabs.less

@@ -0,0 +1,35 @@
+/**
+ * PisellSuperTabs 组件样式
+ */
+
+.pisell-super-tabs {
+  // 基础容器样式
+  width: 100%;
+  height: 100%;
+  box-sizing: border-box;
+  position: relative;
+
+  // TabItem 基础样式
+  &-item {
+    // 基础样式
+    cursor: pointer;
+    user-select: none;
+    box-sizing: border-box;
+    height: 100%;
+    // 过渡动画
+    // transition: all 0.3s ease;
+
+    // 激活状态
+    &--active {
+      // 激活状态由具体的 Card 组件自己实现
+      // 这里只提供一个默认的 class，方便外部自定义样式
+    }
+
+    // 禁用样式（预留）
+    &--disabled {
+      cursor: not-allowed;
+      opacity: 0.5;
+      pointer-events: none;
+    }
+  }
+}

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

@@ -0,0 +1 @@
+export { useTabsState } from './useTabsState';

package/lib/components/PisellSuperTabs/hooks/index.js

@@ -0,0 +1,29 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellSuperTabs/hooks/index.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useTabsState: () => import_useTabsState.useTabsState
+});
+module.exports = __toCommonJS(hooks_exports);
+var import_useTabsState = require("./useTabsState");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useTabsState
+});

package/lib/components/PisellSuperTabs/hooks/useTabsState.d.ts

@@ -0,0 +1,7 @@
+import { UseTabsStateParams, UseTabsStateReturn } from '../types';
+/**
+ * Tabs 状态管理 Hook
+ * @description 处理受控/非受控模式的状态管理
+ * @template T - 数据项类型
+ */
+export declare const useTabsState: <T = any>(params: UseTabsStateParams<T>) => UseTabsStateReturn<T>;

package/lib/components/PisellSuperTabs/hooks/useTabsState.js

@@ -0,0 +1,50 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellSuperTabs/hooks/useTabsState.ts
+var useTabsState_exports = {};
+__export(useTabsState_exports, {
+  useTabsState: () => useTabsState
+});
+module.exports = __toCommonJS(useTabsState_exports);
+var import_react = require("react");
+var useTabsState = (params) => {
+  const { value, defaultValue, onChange } = params;
+  const [innerValue, setInnerValue] = (0, import_react.useState)(
+    defaultValue
+  );
+  const isControlled = (0, import_react.useMemo)(() => value !== void 0, [value]);
+  const activeKey = isControlled ? value : innerValue;
+  const handleTabChange = (0, import_react.useCallback)(
+    (key, item) => {
+      if (!isControlled) {
+        setInnerValue(key);
+      }
+      onChange == null ? void 0 : onChange(key, item);
+    },
+    [isControlled, onChange]
+  );
+  return {
+    activeKey,
+    handleTabChange
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useTabsState
+});

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

@@ -0,0 +1,3 @@
+import PisellSuperTabs from './PisellSuperTabs';
+export default PisellSuperTabs;
+export type { PisellSuperTabsProps, TabDataItem } from './types';

package/lib/components/PisellSuperTabs/index.js

@@ -0,0 +1,36 @@
+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)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  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/PisellSuperTabs/index.tsx
+var PisellSuperTabs_exports = {};
+__export(PisellSuperTabs_exports, {
+  default: () => PisellSuperTabs_default
+});
+module.exports = __toCommonJS(PisellSuperTabs_exports);
+var import_PisellSuperTabs = __toESM(require("./PisellSuperTabs"));
+var PisellSuperTabs_default = import_PisellSuperTabs.default;

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

@@ -0,0 +1,210 @@
+import { CSSProperties, ReactNode } from 'react';
+import type { PisellBasicGridProps } from '../PisellBasicGrid/types';
+import type { PisellScrollViewProps } from '../PisellScrollView/types';
+import type { PisellBasicCardProps } from '../PisellCards/types';
+/**
+ * useTabsState Hook 参数
+ */
+export interface UseTabsStateParams<T = any> {
+    /**
+     * 当前激活的 Tab key（受控）
+     */
+    value?: string;
+    /**
+     * 默认激活的 Tab key（非受控）
+     */
+    defaultValue?: string;
+    /**
+     * Tab 切换时的回调
+     */
+    onChange?: (key: string, item: T) => void;
+}
+/**
+ * useTabsState Hook 返回值
+ */
+export interface UseTabsStateReturn<T = any> {
+    /**
+     * 当前激活的 Tab key
+     */
+    activeKey: string | undefined;
+    /**
+     * 切换 Tab 的方法
+     */
+    handleTabChange: (key: string, item: T) => void;
+}
+export interface RenderItemProps<T = any> extends PisellBasicCardProps {
+    index: number;
+    tabsState: UseTabsStateReturn<T>;
+    tabsProps: PisellSuperTabsProps<T>;
+}
+/**
+ * PisellSuperTabs 组件 Props
+ * @template T - 数据源项的类型
+ * @description 通用导航框架封装的全能型 Tab 组件
+ */
+export interface PisellSuperTabsProps<T = any> {
+    /**
+     * 自定义类名
+     * @description 添加到最外层容器的类名
+     */
+    className?: string;
+    tabItemClassName?: string;
+    tabItemStyle?: CSSProperties;
+    /**
+     * 自定义样式
+     * @description 添加到最外层容器的样式
+     */
+    style?: CSSProperties;
+    /**
+     * 唯一标识
+     * @description 必填，用于区分不同的 TabItem
+     */
+    id?: string;
+    /**
+     * 数据源
+     * @description 支持多级嵌套，递归字段为 children
+     * @example
+     * [
+     *   { key: 'home', label: '首页' },
+     *   { key: 'products', label: '产品', children: [...] }
+     * ]
+     */
+    dataSource?: T[];
+    /**
+     * 数据项的唯一标识字段
+     * @default 'key'
+     * @description 可以是字符串（字段名）或函数（自定义获取逻辑）
+     * @example
+     * // 字符串形式
+     * rowKey="id"
+     *
+     * // 函数形式
+     * rowKey={(record, index) => `${record.type}-${index}`}
+     */
+    rowKey?: string | ((record: T, index: number) => string);
+    /**
+     * 当前激活的 Tab key
+     * @description 受控模式，需配合 onChange 使用
+     */
+    value?: string;
+    /**
+     * 默认激活的 Tab key
+     * @description 非受控模式，仅初始化时生效
+     */
+    defaultValue?: string;
+    /**
+     * Tab 切换时的回调
+     * @param key - 切换到的 Tab key
+     * @param item - 切换到的数据项
+     */
+    onChange?: (key: string, item: T) => void;
+    /**
+     * 自定义 TabItem 渲染
+     * @description 支持两种模式：
+     * 1. 函数模式：(item, index, active) => ReactNode
+     * 2. 插槽模式：直接传入 ReactNode
+     * @example
+     * // 函数模式
+     * renderItem={(item, index, active) => (
+     *   <PisellCards.TabCard
+     *     {...item}
+     *     active={{ value: active }}
+     *   />
+     * )}
+     *
+     * // 插槽模式
+     * renderItem={<PisellCards.TabCard />}
+     */
+    renderItem?: ((props: RenderItemProps<T>) => ReactNode) | ReactNode;
+    /**
+     * PisellBasicGrid 组件的配置
+     * @description 透传给 PisellBasicGrid 组件的所有 Props
+     * @see PisellBasicGridProps
+     * @example
+     * gridProps={{
+     *   direction: 'horizontal',
+     *   gap: 16,
+     *   wrap: 'wrap',
+     *   columns: 4,
+     * }}
+     */
+    gridProps?: Omit<PisellBasicGridProps<T>, 'dataSource' | 'renderItem' | 'rowKey' | 'children'>;
+    /**
+     * PisellScrollView 组件的配置
+     * @description 透传给 PisellScrollView 组件的所有 Props
+     * @see PisellScrollViewProps
+     * @example
+     * scrollViewProps={{
+     *   overflow: 'x',
+     *   scrollbarStyle: 'thin',
+     *   scrollActionsConfig: { show: true, type: 'lrArrows' },
+     * }}
+     */
+    scrollViewProps?: Omit<PisellScrollViewProps, 'children'>;
+    children?: ReactNode;
+    /**
+     * 左侧插槽
+     */
+    slotLeft?: ReactNode;
+    slotLeftClassName?: string;
+    slotLeftStyle?: CSSProperties;
+    /**
+     * 右侧插槽
+     */
+    slotRight?: ReactNode;
+    slotRightClassName?: string;
+    slotRightStyle?: CSSProperties;
+    /**
+     * 顶部插槽
+     */
+    slotTop?: ReactNode;
+    slotTopClassName?: string;
+    slotTopStyle?: CSSProperties;
+    /**
+     * 底部插槽
+     */
+    slotBottom?: ReactNode;
+    slotBottomClassName?: string;
+    slotBottomStyle?: CSSProperties;
+    __designMode?: boolean;
+}
+/**
+ * 数据项基础类型
+ * @description 建议数据源中的每一项都包含这些字段
+ */
+export interface TabDataItem {
+    /**
+     * 唯一标识
+     * @description 必填，用于区分不同的 TabItem
+     */
+    key: string;
+    /**
+     * 标签文本
+     */
+    label?: string;
+    /**
+     * 图标
+     */
+    icon?: ReactNode;
+    /**
+     * 徽章配置
+     */
+    badge?: {
+        count?: number;
+        dot?: boolean;
+        text?: string;
+    };
+    /**
+     * 子级数据（多级嵌套）
+     * @description 用于多级导航场景，具体渲染逻辑由 Card 组件实现
+     */
+    children?: TabDataItem[];
+    /**
+     * 是否禁用
+     */
+    disabled?: boolean;
+    /**
+     * 其他自定义字段
+     */
+    [key: string]: any;
+}