@pisell/materials 1.0.983 → 1.0.988

package/es/components/PisellProcedure/utils/classNames.js

@@ -0,0 +1,45 @@
+/**
+ * 类名合并工具函数
+ * @description 用于合并多个类名，过滤掉 undefined、null、空字符串
+ */
+
+/**
+ * 合并类名
+ * @param classNames 类名数组
+ * @returns 合并后的类名字符串
+ * @example
+ * mergeClassNames('base', 'active', undefined, 'extra')
+ * // => 'base active extra'
+ */
+export var mergeClassNames = function mergeClassNames() {
+  for (var _len = arguments.length, classNames = new Array(_len), _key = 0; _key < _len; _key++) {
+    classNames[_key] = arguments[_key];
+  }
+  return classNames.filter(Boolean).join(' ');
+};
+
+/**
+ * 生成带前缀的类名
+ * @param prefix 前缀
+ * @param suffix 后缀（可选）
+ * @returns 类名字符串
+ * @example
+ * prefixClassName('pisell-procedure', 'header')
+ * // => 'pisell-procedure-header'
+ */
+export var prefixClassName = function prefixClassName(prefix, suffix) {
+  return suffix ? "".concat(prefix, "-").concat(suffix) : prefix;
+};
+
+/**
+ * 生成带修饰符的 BEM 类名
+ * @param block 块名
+ * @param modifier 修饰符
+ * @returns 类名字符串
+ * @example
+ * modifierClassName('pisell-procedure-footer', 'float-sidebar')
+ * // => 'pisell-procedure-footer--float-sidebar'
+ */
+export var modifierClassName = function modifierClassName(block, modifier) {
+  return modifier ? "".concat(block, "--").concat(modifier) : block;
+};

package/es/components/PisellProcedure/utils/extractText.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+/**
+ * 从 React 节点中提取文本内容
+ * @param node React 节点
+ * @returns 提取的文本字符串
+ * @example
+ * extractTextFromNode(<span>Hello</span>) // => 'Hello'
+ * extractTextFromNode('Hello') // => 'Hello'
+ * extractTextFromNode([<span>Hello</span>, ' ', <span>World</span>]) // => 'Hello World'
+ */
+export declare const extractTextFromNode: (node: React.ReactNode) => string;
+/**
+ * 从按钮 props 中提取显示文本
+ * @param buttonProps 按钮的 props
+ * @param fallback 默认文本
+ * @returns 显示文本
+ */
+export declare const extractButtonLabel: (buttonProps: {
+    children?: React.ReactNode;
+} | undefined, fallback: string) => string;

package/es/components/PisellProcedure/utils/extractText.js

@@ -0,0 +1,40 @@
+import { isValidElement } from 'react';
+
+/**
+ * 从 React 节点中提取文本内容
+ * @param node React 节点
+ * @returns 提取的文本字符串
+ * @example
+ * extractTextFromNode(<span>Hello</span>) // => 'Hello'
+ * extractTextFromNode('Hello') // => 'Hello'
+ * extractTextFromNode([<span>Hello</span>, ' ', <span>World</span>]) // => 'Hello World'
+ */
+export var extractTextFromNode = function extractTextFromNode(node) {
+  if (typeof node === 'string') return node;
+  if (typeof node === 'number') return String(node);
+  if (!node) return '';
+
+  // 处理数组
+  if (Array.isArray(node)) {
+    return node.map(extractTextFromNode).join('');
+  }
+
+  // 处理 React 元素
+  if ( /*#__PURE__*/isValidElement(node)) {
+    var props = node.props;
+    return extractTextFromNode(props.children);
+  }
+  return '';
+};
+
+/**
+ * 从按钮 props 中提取显示文本
+ * @param buttonProps 按钮的 props
+ * @param fallback 默认文本
+ * @returns 显示文本
+ */
+export var extractButtonLabel = function extractButtonLabel(buttonProps, fallback) {
+  if (!(buttonProps !== null && buttonProps !== void 0 && buttonProps.children)) return fallback;
+  var text = extractTextFromNode(buttonProps.children);
+  return text || fallback;
+};

package/es/components/PisellProcedure/utils/footerPosition.d.ts

@@ -0,0 +1,41 @@
+import type { FooterPositionMode } from '../types';
+/**
+ * 底部位置判断工具函数
+ * @description 用于判断底部操作区的位置模式
+ */
+/**
+ * 判断底部是否在内容区
+ * @param position 底部位置模式
+ * @returns 是否在内容区
+ */
+export declare const isFooterInContent: (position: FooterPositionMode) => boolean;
+/**
+ * 判断底部是否在信息区
+ * @param position 底部位置模式
+ * @returns 是否在信息区
+ */
+export declare const isFooterInSidebar: (position: FooterPositionMode) => boolean;
+/**
+ * 判断底部是否全局显示
+ * @param position 底部位置模式
+ * @returns 是否全局显示
+ */
+export declare const isFooterGlobal: (position: FooterPositionMode) => boolean;
+/**
+ * 判断底部是否固定模式
+ * @param position 底部位置模式
+ * @returns 是否固定模式
+ */
+export declare const isFooterFixed: (position: FooterPositionMode) => boolean;
+/**
+ * 判断底部是否悬浮模式
+ * @param position 底部位置模式
+ * @returns 是否悬浮模式
+ */
+export declare const isFooterFloat: (position: FooterPositionMode) => boolean;
+/**
+ * 获取底部位置的目标区域
+ * @param position 底部位置模式
+ * @returns 目标区域: 'content' | 'sidebar' | 'global'
+ */
+export declare const getFooterTargetArea: (position: FooterPositionMode) => 'content' | 'sidebar' | 'global';

package/es/components/PisellProcedure/utils/footerPosition.js

@@ -0,0 +1,60 @@
+/**
+ * 底部位置判断工具函数
+ * @description 用于判断底部操作区的位置模式
+ */
+
+/**
+ * 判断底部是否在内容区
+ * @param position 底部位置模式
+ * @returns 是否在内容区
+ */
+export var isFooterInContent = function isFooterInContent(position) {
+  return position === 'fixed-content-bottom' || position === 'float-content';
+};
+
+/**
+ * 判断底部是否在信息区
+ * @param position 底部位置模式
+ * @returns 是否在信息区
+ */
+export var isFooterInSidebar = function isFooterInSidebar(position) {
+  return position === 'fixed-sidebar-bottom' || position === 'float-sidebar';
+};
+
+/**
+ * 判断底部是否全局显示
+ * @param position 底部位置模式
+ * @returns 是否全局显示
+ */
+export var isFooterGlobal = function isFooterGlobal(position) {
+  return position === 'fixed-bottom' || position === 'float-all';
+};
+
+/**
+ * 判断底部是否固定模式
+ * @param position 底部位置模式
+ * @returns 是否固定模式
+ */
+export var isFooterFixed = function isFooterFixed(position) {
+  return position.startsWith('fixed-');
+};
+
+/**
+ * 判断底部是否悬浮模式
+ * @param position 底部位置模式
+ * @returns 是否悬浮模式
+ */
+export var isFooterFloat = function isFooterFloat(position) {
+  return position.startsWith('float-');
+};
+
+/**
+ * 获取底部位置的目标区域
+ * @param position 底部位置模式
+ * @returns 目标区域: 'content' | 'sidebar' | 'global'
+ */
+export var getFooterTargetArea = function getFooterTargetArea(position) {
+  if (isFooterInContent(position)) return 'content';
+  if (isFooterInSidebar(position)) return 'sidebar';
+  return 'global';
+};

package/es/components/PisellProcedure/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * PisellProcedure 工具函数导出
+ */
+export { mergeClassNames, prefixClassName, modifierClassName, } from './classNames';
+export { wrapSlotWithClick, isValidSlot, renderSlotOrDefault, } from './slotHelper';
+export { isFooterInContent, isFooterInSidebar, isFooterGlobal, isFooterFixed, isFooterFloat, getFooterTargetArea, } from './footerPosition';
+export { extractTextFromNode, extractButtonLabel, } from './extractText';
+export { parseLayoutRatio, calculateRatioPercent, generateRatioStyles, LAYOUT_RATIO_PRESETS, } from './layoutRatio';

package/es/components/PisellProcedure/utils/index.js

@@ -0,0 +1,18 @@
+/**
+ * PisellProcedure 工具函数导出
+ */
+
+// 类名合并工具
+export { mergeClassNames, prefixClassName, modifierClassName } from "./classNames";
+
+// 插槽包装工具
+export { wrapSlotWithClick, isValidSlot, renderSlotOrDefault } from "./slotHelper";
+
+// 底部位置判断工具
+export { isFooterInContent, isFooterInSidebar, isFooterGlobal, isFooterFixed, isFooterFloat, getFooterTargetArea } from "./footerPosition";
+
+// 文本提取工具
+export { extractTextFromNode, extractButtonLabel } from "./extractText";
+
+// 布局比例工具
+export { parseLayoutRatio, calculateRatioPercent, generateRatioStyles, LAYOUT_RATIO_PRESETS } from "./layoutRatio";

package/es/components/PisellProcedure/utils/layoutRatio.d.ts

@@ -0,0 +1,42 @@
+import type { BodyLayoutRatio } from '../types';
+/**
+ * 布局比例工具函数
+ * @description 用于解析和计算内容区与信息区的布局比例
+ */
+/**
+ * 解析比例字符串
+ * @param ratio 比例字符串，如 '7:3'
+ * @returns [内容区比例, 信息区比例]
+ * @example
+ * parseLayoutRatio('7:3') // => [7, 3]
+ * parseLayoutRatio('6:4') // => [6, 4]
+ */
+export declare const parseLayoutRatio: (ratio: BodyLayoutRatio) => [number, number];
+/**
+ * 计算百分比
+ * @param ratio 比例字符串，如 '7:3'
+ * @returns { contentPercent, sidebarPercent }
+ * @example
+ * calculateRatioPercent('7:3') // => { contentPercent: 70, sidebarPercent: 30 }
+ */
+export declare const calculateRatioPercent: (ratio: BodyLayoutRatio) => {
+    contentPercent: number;
+    sidebarPercent: number;
+};
+/**
+ * 生成 flex 比例样式
+ * @param ratio 比例字符串，如 '7:3'
+ * @param gap 间距（px）
+ * @returns { contentStyle, sidebarStyle }
+ */
+export declare const generateRatioStyles: (ratio: BodyLayoutRatio, gap?: number) => {
+    contentStyle: React.CSSProperties;
+    sidebarStyle: React.CSSProperties;
+};
+/**
+ * 预设比例选项
+ */
+export declare const LAYOUT_RATIO_PRESETS: {
+    label: string;
+    value: BodyLayoutRatio;
+}[];

package/es/components/PisellProcedure/utils/layoutRatio.js

@@ -0,0 +1,100 @@
+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; }
+/*
+ * @Author: han.wang
+ * @Date: 2025-12-11 12:30:12
+ * @LastEditors: han.wang
+ * @LastEditTime: 2025-12-11 16:33:54
+ * @Description: 
+ */
+
+/**
+ * 布局比例工具函数
+ * @description 用于解析和计算内容区与信息区的布局比例
+ */
+
+/**
+ * 解析比例字符串
+ * @param ratio 比例字符串，如 '7:3'
+ * @returns [内容区比例, 信息区比例]
+ * @example
+ * parseLayoutRatio('7:3') // => [7, 3]
+ * parseLayoutRatio('6:4') // => [6, 4]
+ */
+export var parseLayoutRatio = function parseLayoutRatio(ratio) {
+  if (!ratio || typeof ratio !== 'string') {
+    return [7, 3]; // 默认比例
+  }
+  var parts = ratio.split(':');
+  if (parts.length !== 2) {
+    return [7, 3]; // 默认比例
+  }
+  var content = Number(parts[0]);
+  var sidebar = Number(parts[1]);
+  // 确保解析出的数字是有效的
+  if (isNaN(content) || isNaN(sidebar) || content <= 0 || sidebar <= 0) {
+    return [7, 3]; // 默认比例
+  }
+  return [content, sidebar];
+};
+
+/**
+ * 计算百分比
+ * @param ratio 比例字符串，如 '7:3'
+ * @returns { contentPercent, sidebarPercent }
+ * @example
+ * calculateRatioPercent('7:3') // => { contentPercent: 70, sidebarPercent: 30 }
+ */
+export var calculateRatioPercent = function calculateRatioPercent(ratio) {
+  var _parseLayoutRatio = parseLayoutRatio(ratio),
+    _parseLayoutRatio2 = _slicedToArray(_parseLayoutRatio, 2),
+    content = _parseLayoutRatio2[0],
+    sidebar = _parseLayoutRatio2[1];
+  var total = content + sidebar;
+  return {
+    contentPercent: content / total * 100,
+    sidebarPercent: sidebar / total * 100
+  };
+};
+
+/**
+ * 生成 flex 比例样式
+ * @param ratio 比例字符串，如 '7:3'
+ * @param gap 间距（px）
+ * @returns { contentStyle, sidebarStyle }
+ */
+export var generateRatioStyles = function generateRatioStyles(ratio) {
+  var gap = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 16;
+  var _calculateRatioPercen = calculateRatioPercent(ratio),
+    contentPercent = _calculateRatioPercen.contentPercent,
+    sidebarPercent = _calculateRatioPercen.sidebarPercent;
+  var sidebarWidth = "calc(".concat(sidebarPercent, "% - ").concat(gap / 2, "px)");
+  var sidebarFlex = "0 0 ".concat(sidebarWidth);
+  return {
+    contentStyle: {
+      flex: "0 0 calc(".concat(contentPercent, "% - ").concat(gap / 2, "px)"),
+      maxWidth: "calc(".concat(contentPercent, "% - ").concat(gap / 2, "px)")
+    },
+    sidebarStyle: {
+      // 使用 CSS 变量，让 CSS 中的 !important 可以引用这些值
+      '--sidebar-ratio-width': sidebarWidth,
+      '--sidebar-ratio-max-width': sidebarWidth,
+      '--sidebar-ratio-flex': sidebarFlex
+    }
+  };
+};
+
+/**
+ * 预设比例选项
+ */
+export var LAYOUT_RATIO_PRESETS = [{
+  label: '7:3',
+  value: '7:3'
+}, {
+  label: '6:4',
+  value: '6:4'
+}];

package/es/components/PisellProcedure/utils/slotHelper.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+/**
+ * 插槽包装工具函数
+ * @description 用于包装 React 插槽元素，添加额外的事件处理
+ */
+/**
+ * 包装插槽元素，添加点击事件
+ * @param slotContent 插槽内容
+ * @param onClick 点击回调
+ * @returns 包装后的插槽内容
+ * @example
+ * wrapSlotWithClick(leftSlot, handleBackClick)
+ */
+export declare const wrapSlotWithClick: (slotContent: React.ReactNode, onClick?: () => void | boolean) => React.ReactNode;
+/**
+ * 检查插槽是否为有效的 React 元素
+ * @param slotContent 插槽内容
+ * @returns 是否为有效元素
+ */
+export declare const isValidSlot: (slotContent: React.ReactNode) => boolean;
+/**
+ * 渲染插槽内容，如果为空则返回默认内容
+ * @param slotContent 插槽内容
+ * @param defaultContent 默认内容
+ * @returns 最终渲染内容
+ */
+export declare const renderSlotOrDefault: (slotContent: React.ReactNode, defaultContent?: React.ReactNode) => React.ReactNode;

package/es/components/PisellProcedure/utils/slotHelper.js

@@ -0,0 +1,50 @@
+import { isValidElement, cloneElement } from 'react';
+
+/**
+ * 插槽包装工具函数
+ * @description 用于包装 React 插槽元素，添加额外的事件处理
+ */
+
+/**
+ * 包装插槽元素，添加点击事件
+ * @param slotContent 插槽内容
+ * @param onClick 点击回调
+ * @returns 包装后的插槽内容
+ * @example
+ * wrapSlotWithClick(leftSlot, handleBackClick)
+ */
+export var wrapSlotWithClick = function wrapSlotWithClick(slotContent, _onClick) {
+  if (!slotContent) return null;
+  if ( /*#__PURE__*/isValidElement(slotContent)) {
+    return /*#__PURE__*/cloneElement(slotContent, {
+      onClick: function onClick(e) {
+        var _props;
+        // 先调用原有的 onClick
+        var originalOnClick = (_props = slotContent.props) === null || _props === void 0 ? void 0 : _props.onClick;
+        originalOnClick === null || originalOnClick === void 0 || originalOnClick(e);
+        // 再调用传入的 onClick
+        _onClick === null || _onClick === void 0 || _onClick();
+      }
+    });
+  }
+  return slotContent;
+};
+
+/**
+ * 检查插槽是否为有效的 React 元素
+ * @param slotContent 插槽内容
+ * @returns 是否为有效元素
+ */
+export var isValidSlot = function isValidSlot(slotContent) {
+  return slotContent !== null && slotContent !== undefined;
+};
+
+/**
+ * 渲染插槽内容，如果为空则返回默认内容
+ * @param slotContent 插槽内容
+ * @param defaultContent 默认内容
+ * @returns 最终渲染内容
+ */
+export var renderSlotOrDefault = function renderSlotOrDefault(slotContent, defaultContent) {
+  return isValidSlot(slotContent) ? slotContent : defaultContent;
+};

package/es/components/PisellScrollView/PisellScrollView.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { PisellScrollViewProps, PisellScrollViewRef } from './types';
+import './PisellScrollView.less';
+declare const PisellScrollView: React.ForwardRefExoticComponent<Omit<PisellScrollViewProps, "ref"> & React.RefAttributes<PisellScrollViewRef>>;
+export default PisellScrollView;