@pisell/materials 1.8.41 → 1.8.43

package/es/components/hardwareErrorTip/readme.md

@@ -1,309 +0,0 @@
-# HardwareErrorTip 硬件报错标准提示
-
-## 组件接口
-
-```typescript
-interface ErrorItem {
-  id: string;
-  level: 'fatal' | 'critical' | 'normal' | 'info';
-  code: string;
-  time: string;
-  description: string;
-  solution: string;
-  device?: string;
-}
-
-interface LogItem {
-  id: string;
-  timestamp: string;
-  level: 'ERROR' | 'INFO' | 'DEBUG';
-  device: string;
-  service: string;
-  message: string;
-  details?: any;
-}
-
-interface HardwareErrorTipProps {
-  statistics: StatisticsData;
-  errors?: ErrorItem[];
-  logs?: LogItem[];
-  onExportLogs?: (logs: any) => void;
-  onCloseError?: (error: ErrorCardData, index?: number) => void;
-  onTabChange?: (activeTab: string) => void;
-  activeTab?: string;
-  isLoadingErrors?: boolean;
-  isLoadingLogs?: boolean;
-  style?: React.CSSProperties;
-}
-```
-
-## 使用示例
-
-```tsx
-import HardwareErrorTip from '@/components/hardware-error-tip';
-
-const errors = [
-  {
-    id: '1',
-    level: 'fatal',
-    code: 'ERR001',
-    time: '2024-02-07 14:30:00',
-    description: '打印机连接失败',
-    solution: '请检查打印机电源和连接线',
-    device: 'PRINTER_001'
-  }
-];
-
-const logs = [
-  {
-    id: '1',
-    timestamp: '2024-02-07 14:30:00.123',
-    level: 'ERROR',
-    device: 'PRINTER_001',
-    service: 'PrinterService',
-    message: '连接失败 - 端口CM3无响应',
-    details: {
-      operation: '打印操作',
-      orderId: 'ORDER123456',
-      printerStatus: 'OFFLINE'
-    }
-  }
-];
-
-function App() {
-  const handleExportLogs = () => {
-    console.log('导出日志');
-  };
-
-  return (
-    <HardwareErrorTip
-      statistics={statistics}
-      errors={errors}
-      logs={logs}
-      onExportLogs={handleExportLogs}
-    />
-  );
-}
-```
-
-## 懒加载功能
-
-组件支持懒加载功能，可以在切换到对应tab时才加载数据，避免不必要的数据请求。
-
-### 懒加载使用示例
-
-```tsx
-import React, { useState, useCallback, useEffect } from 'react';
-import HardwareErrorTip from '@/components/hardware-error-tip';
-
-function LazyLoadApp() {
-  const [activeTab, setActiveTab] = useState('errors');
-  const [errors, setErrors] = useState([]);
-  const [logs, setLogs] = useState([]);
-  const [isLoadingErrors, setIsLoadingErrors] = useState(false);
-  const [isLoadingLogs, setIsLoadingLogs] = useState(false);
-
-  // 加载错误数据
-  const loadErrors = useCallback(async () => {
-    if (errors.length > 0) return; // 避免重复加载
-    
-    setIsLoadingErrors(true);
-    try {
-      const response = await fetch('/api/hardware-errors');
-      const data = await response.json();
-      setErrors(data);
-    } catch (error) {
-      console.error('加载错误数据失败:', error);
-    } finally {
-      setIsLoadingErrors(false);
-    }
-  }, [errors.length]);
-
-  // 加载日志数据
-  const loadLogs = useCallback(async () => {
-    if (logs.length > 0) return; // 避免重复加载
-    
-    setIsLoadingLogs(true);
-    try {
-      const response = await fetch('/api/hardware-logs');
-      const data = await response.json();
-      setLogs(data);
-    } catch (error) {
-      console.error('加载日志数据失败:', error);
-    } finally {
-      setIsLoadingLogs(false);
-    }
-  }, [logs.length]);
-
-  // 处理tab切换
-  const handleTabChange = useCallback((newTab: string) => {
-    setActiveTab(newTab);
-    
-    // 根据切换的tab懒加载对应数据
-    if (newTab === 'errors') {
-      loadErrors();
-    } else if (newTab === 'logs') {
-      loadLogs();
-    }
-  }, [loadErrors, loadLogs]);
-
-  // 初始加载默认tab的数据
-  useEffect(() => {
-    if (activeTab === 'errors') {
-      loadErrors();
-    }
-  }, [activeTab, loadErrors]);
-
-  return (
-    <HardwareErrorTip
-      statistics={statistics}
-      errors={errors}
-      logs={logs}
-      activeTab={activeTab}
-      onTabChange={handleTabChange}
-      isLoadingErrors={isLoadingErrors}
-      isLoadingLogs={isLoadingLogs}
-      onExportLogs={(logs) => {
-        // 导出日志逻辑
-        console.log('导出日志:', logs);
-      }}
-    />
-  );
-}
-```
-
-### 懒加载API说明
-
-- **activeTab**: 当前激活的tab，可选值为 `'errors'` 或 `'logs'`
-- **onTabChange**: tab切换时的回调函数，参数为新的tab值
-- **isLoadingErrors**: 错误列表的加载状态，为true时显示loading效果
-- **isLoadingLogs**: 日志列表的加载状态，为true时显示loading效果
-- 当传入 `activeTab` 属性时，组件变为受控模式，tab切换完全由外部控制
-- 当不传入 `activeTab` 属性时，组件为非受控模式，内部管理tab状态
-
-### 懒加载优势
-
-1. **性能优化**: 只在需要时加载数据，减少初始加载时间
-2. **减少网络请求**: 避免加载用户可能不会查看的数据
-3. **更好的用户体验**: 快速显示界面，按需加载内容，loading状态提供视觉反馈
-4. **灵活控制**: 外部可以完全控制数据加载时机和逻辑
-5. **Loading状态**: 内置Spin组件，在数据加载时提供优雅的loading效果
-
-### Loading状态说明
-
-- 当 `isLoadingErrors` 为 `true` 时，错误列表区域会显示loading旋转图标
-- 当 `isLoadingLogs` 为 `true` 时，日志列表区域会显示loading旋转图标
-- Loading状态下不会显示Empty组件，避免闪烁效果
-- Loading完成后，如果没有数据才会显示Empty提示
-
-## 功能详细说明
-
-### 1. 错误统计
-显示不同等级错误的数量统计，包括：
-- 致命错误（Fatal）：红色
-- 严重错误（Critical）：橙色
-- 一般错误（Normal）：黄色
-- 提示信息（Info）：绿色
-
-### 2. 筛选功能
-- **设备筛选**：展示此终端设备的所连接的所有设备类型，默认为"全部设备"
-- **错误级别筛选**：
-  - 全部错误(All)：默认选项
-  - 致命错误(Fatal)
-  - 严重错误(Critical)
-  - 一般错误(Normal)
-  - 提示信息(Info)
-
-### 3. 错误展示内容
-- 错误级别
-- 错误代码(唯一标识)
-- 发生时间
-- 具体错误描述
-- 解决方案
-- 设备信息
-
-### 4. 错误日志功能
-- **搜索功能**：可以搜索日志内容
-- **导出功能**：支持导出日志文件
-- **日志分级**：
-  - ERROR: 错误信息
-  - INFO: 重要操作信息
-  - DEBUG: 调试信息
-- **详细信息**：
-  - 时间信息：错误发生的精确时间戳
-  - 设备信息：设备ID和类型、设备状态信息、连接信息
-  - 上下文信息：当前执行的操作、相关的业务数据、系统环境信息
-  - 操作信息：用户进行的操作、操作的参数、操作的结果
-
-### 5. 日志保存策略
-- 保留天数：默认保留30天
-
-### 6. 报错提示关闭机制
-1. 错误解决后自动清除相关提示
-2. 系统重启后恢复未解决的错误状态
-3. 网络恢复后同步最新设备状态
-4. 定期检查并清理过期的错误信息
-5. 对于手动关闭机制需要对错误类型进行分级处理：
-   - 致命错误（fatal）：不允许手动关闭
-   - 严重错误（critical）：不允许手动关闭
-   - 一般错误：可以手动关闭
-   - 提示信息：可以手动关闭
-
-## 数据结构说明
-
-### 日志数据结构
-```json
-[
-  {
-    "log_level": 0,
-    "message": "开始打印任务",
-    "time": "2024-02-02 12:00:00",
-    "device": {
-      "device_type": "printer",
-      "device_name": "Xprinter 1234",
-      "device_idfa": "192.168.1.1"
-    },
-    "data": ""
-  }
-]
-```
-
-### 错误数据结构
-```json
-[
-  {
-    "error_level": 0,
-    "error_message": "打印机无法连接",
-    "error_code": "99",
-    "time": "2024-02-02 12:00:00",
-    "device": {
-      "device_type": "printer",
-      "device_name": "Xprinter 1234",
-      "device_idfa": "192.168.1.1"
-    }
-  }
-]
-```
-
-### 相关数据释义
-
-#### 1. 错误信息等级 - error_level
-- 提示信息： 0
-- 一般错误： 1
-- 严重错误： 2
-- 致命错误： 3
-
-#### 2. 日志等级 - log_level
-- 调试信息： 0
-- 重要操作信息： 1
-- 错误信息： 2
-
-#### 3. 设备类型 - device_type
-- 打印机： printer
-- 扫码枪： barcode_scanner
-- CDS客显： cds
-- KDS厨显：kds
-- 扩展屏：display
-- 刷卡机：card_reader
-- 钱箱：till
-- 称重设备：scale

package/es/components/hardwareErrorTip/types.js

@@ -1,54 +0,0 @@
-import { getText } from "../../locales/index.js";
-import { CloseCircleOutlined, ExclamationCircleOutlined } from "@ant-design/icons";
-//#region src/components/hardwareErrorTip/types.ts
-const prefix = "pisell-lowcode";
-const ErrorTypeTheme = {
-	fatal: {
-		iconColor: "#cf1322",
-		backgroundColor: "#fff1f0",
-		shadowColor: "#ffa39e",
-		badgeColor: "#fee2e1"
-	},
-	critical: {
-		iconColor: "#d4380d",
-		backgroundColor: "#fff2e8",
-		shadowColor: "#ffbb96",
-		badgeColor: "#ffedd5"
-	},
-	normal: {
-		iconColor: "#0958d9",
-		backgroundColor: "#e6f4ff",
-		shadowColor: "#91caff",
-		badgeColor: "#d2eafd"
-	},
-	info: {
-		iconColor: "#389e0d",
-		backgroundColor: "#f6ffed",
-		shadowColor: "#b7eb8f",
-		badgeColor: "#dcfce7"
-	}
-};
-const errorTypes = [
-	{
-		type: "fatal",
-		title: () => getText("pisell2.text.hardware-error.fatal"),
-		icon: CloseCircleOutlined
-	},
-	{
-		type: "critical",
-		title: () => getText("pisell2.text.hardware-error.critical"),
-		icon: ExclamationCircleOutlined
-	},
-	{
-		type: "normal",
-		title: () => getText("pisell2.text.hardware-error.normal"),
-		icon: ExclamationCircleOutlined
-	},
-	{
-		type: "info",
-		title: () => getText("pisell2.text.hardware-error.info"),
-		icon: ExclamationCircleOutlined
-	}
-];
-//#endregion
-export { ErrorTypeTheme, errorTypes, prefix };

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

@@ -1,24 +0,0 @@
-import { PisellActionPanelProps } from "./types.js";
-import React from "react";
-//#region src/components/pisellActionPanel/PisellActionPanel.d.ts
-/**
- * PisellActionPanel 操作面板
- * 用于统一承载、编排和呈现一组用户可执行操作（Actions）的 Pro 组件。
- * 支持分组、布局、对齐、主/次/危险层级与条件显隐。
- *
- * 设计文档：Action Panel (pcp_ge_actionPanel_V1.0)
- *
- * @param props 组件 Props
- */
-declare function PisellActionPanel({
-  groups,
-  layout,
-  align,
-  overflowStrategy,
-  groupGap,
-  itemGap,
-  className,
-  style
-}: PisellActionPanelProps): React.JSX.Element;
-//#endregion
-export { PisellActionPanel };

package/es/components/pisellActionPanel/PisellActionPanel.js

@@ -1,68 +0,0 @@
-import { _objectSpread2 } from "../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js";
-import React, { useMemo } from "react";
-import { Button, Space } from "antd";
-import classNames from "classnames";
-import "./PisellActionPanel.less";
-//#region src/components/pisellActionPanel/PisellActionPanel.tsx
-/**
-* 单条操作项渲染为 Button（带可选 icon）
-* 根据 priority 映射为 antd Button type
-*/
-function renderActionItem(item, index) {
-	var _item$key, _item$priority;
-	if (!(item.visible !== false)) return null;
-	const key = (_item$key = item.key) !== null && _item$key !== void 0 ? _item$key : `action-${index}`;
-	const priority = (_item$priority = item.priority) !== null && _item$priority !== void 0 ? _item$priority : "default";
-	const buttonType = priority === "danger" ? "primary" : priority === "primary" ? "primary" : "default";
-	const danger = priority === "danger";
-	return /* @__PURE__ */ React.createElement(Button, {
-		key,
-		type: buttonType,
-		danger,
-		icon: item.icon,
-		onClick: item.onClick,
-		disabled: item.disabled,
-		className: classNames("pisell-action-panel-btn", item.className),
-		style: item.style
-	}, item.label);
-}
-/**
-* PisellActionPanel 操作面板
-* 用于统一承载、编排和呈现一组用户可执行操作（Actions）的 Pro 组件。
-* 支持分组、布局、对齐、主/次/危险层级与条件显隐。
-*
-* 设计文档：Action Panel (pcp_ge_actionPanel_V1.0)
-*
-* @param props 组件 Props
-*/
-function PisellActionPanel({ groups, layout = "horizontal", align = "left", overflowStrategy = "wrap", groupGap, itemGap, className, style }) {
-	/** 过滤可见分组，并过滤每组内可见项 */
-	const effectiveGroups = useMemo(() => {
-		return groups.filter((g) => g.visible !== false).map((g) => _objectSpread2(_objectSpread2({}, g), {}, { items: g.items.filter((i) => i.visible !== false) })).filter((g) => g.items.length > 0);
-	}, [groups]);
-	const rootStyle = useMemo(() => {
-		const s = _objectSpread2({}, style);
-		if (groupGap !== void 0) s.gap = typeof groupGap === "number" ? `${groupGap}px` : groupGap;
-		return s;
-	}, [style, groupGap]);
-	const itemGapValue = typeof itemGap === "number" ? itemGap : itemGap !== null && itemGap !== void 0 ? itemGap : 8;
-	const isVertical = layout === "vertical";
-	return /* @__PURE__ */ React.createElement("div", {
-		className: classNames("pisell-action-panel-root", `pisell-action-panel-layout-${layout}`, `pisell-action-panel-align-${align}`, overflowStrategy === "scroll" && "pisell-action-panel-overflow-scroll", overflowStrategy === "wrap" && "pisell-action-panel-overflow-wrap", className),
-		style: rootStyle
-	}, effectiveGroups.map((group, groupIndex) => {
-		var _group$key;
-		return /* @__PURE__ */ React.createElement("div", {
-			key: (_group$key = group.key) !== null && _group$key !== void 0 ? _group$key : `group-${groupIndex}`,
-			className: classNames("pisell-action-panel-group", group.className),
-			style: group.style
-		}, /* @__PURE__ */ React.createElement(Space, {
-			size: itemGapValue,
-			direction: isVertical ? "vertical" : "horizontal",
-			wrap: !isVertical && overflowStrategy === "wrap",
-			className: "pisell-action-panel-group-space"
-		}, group.items.map((item, itemIndex) => renderActionItem(item, itemIndex))));
-	}));
-}
-//#endregion
-export { PisellActionPanel };

package/es/components/pisellActionPanel/PisellActionPanel.less

@@ -1,69 +0,0 @@
-/**
- * PisellActionPanel 样式
- * 操作面板：分组、布局、对齐；不设置 font-family，使用项目统一配置
- * 覆盖 antd 时使用 pisell-lowcode-xxx
- */
-
-.pisell-action-panel-root {
-  display: flex;
-  flex-wrap: wrap;
-  align-items: center;
-  min-width: 0;
-  box-sizing: border-box;
-
-  &.pisell-action-panel-layout-horizontal {
-    flex-direction: row;
-  }
-
-  &.pisell-action-panel-layout-vertical {
-    flex-direction: column;
-    align-items: stretch;
-  }
-
-  &.pisell-action-panel-layout-grid {
-    display: grid;
-    grid-auto-flow: column;
-    align-items: center;
-  }
-
-  &.pisell-action-panel-align-left {
-    justify-content: flex-start;
-  }
-
-  &.pisell-action-panel-align-center {
-    justify-content: center;
-  }
-
-  &.pisell-action-panel-align-right {
-    justify-content: flex-end;
-  }
-
-  &.pisell-action-panel-align-space-between {
-    justify-content: space-between;
-  }
-
-  &.pisell-action-panel-overflow-wrap {
-    flex-wrap: wrap;
-  }
-
-  &.pisell-action-panel-overflow-scroll {
-    flex-wrap: nowrap;
-    overflow-x: auto;
-    overflow-y: hidden;
-  }
-}
-
-.pisell-action-panel-group {
-  display: inline-flex;
-  align-items: center;
-  min-width: 0;
-}
-
-.pisell-action-panel-group-space {
-  display: inline-flex;
-  min-width: 0;
-}
-
-.pisell-action-panel-btn {
-  flex-shrink: 0;
-}

package/es/components/pisellActionPanel/docs/pisellActionPanel.$tab-design.md

@@ -1,148 +0,0 @@
----
-title: 设计文档
-order: 2
-category: atom
----
-
-# 资源链接
-
-## 任务链接
-
- 
-
-## Figma链接
-
-Implement this design from Figma.
-@https://www.figma.com/design/pM8Ho6d7kCMv9vIBvFHUlj/Pisell-2.0-Component-Library?node-id=1624-526&m=dev
-
-# 1. 组件概述
-
-| **组件名称（英文）** | Action Panel                                                                                                                                                     |
-|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **组件编号**     | pcp\_ge\_actionPanel\_V1.0                                                                                                                                       |
-| **组件类型**     | Pro Components                                                                                                                                                   |
-| **组件分类**     | General                                                                                                                                                          |
-| **简介**<br /> | Action Panel 是一个用于统一承载、编排和呈现一组用户可执行操作（Actions）的Pro组件。<br />它不直接绑定业务数据，而是通过标准化 Action 结构，处理操作的布局、分组、层级、状态、权限以及多终端自适应。<br />Action Panel 是行为编排容器，而不是 Button 的简单集合。 |
-
-# 2. 版本
-
-| **版本**   | 1.0  |
-|----------|------|
-| **更新简介** | 首次发布 |
-
-# 3. 组件设计目的
-
-* 统一页面操作区范式，避免按钮随意堆叠&#x20;
-
-* 解耦“行为语义”与“视觉表现”
-
-* 支持复杂业务（权限/条件显隐 /危险操作）
-
-* 适配低代码/无代码配置体系
-
-# 4. 适用场景
-
-* 表单页底部操作区
-
-* 详情页主/次操作区
-
-* 列表页批量操作区
-
-* 弹窗 / Drawer 操作区
-
-* Kiosk /POS 大按钮操作区
-
-# 5. 组件能力说明
-
-### 核心能力
-
-* Action 分组与对齐
-
-* 主/次/危险操作层级
-
-* 条件显隐与权限控制
-
-* 二次确认（Confirm）
-
-* 响应式与终端策略
-
-* 操作溢出自动收纳
-
-# 6. UI 设计
-
-## 6.1 组件结构
-
-* Action Panel（Pro）
-
-  * Action Group （1..n）
-
-    * Action Item （1..n）
-
-      * Button / IconButton / MenuItem（Atom）
-
-## 6.2 展示样式
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=YTc3MTQ0ZTM1MTAxNjE0NDRjM2UwZmQ2NTlmZGU1YmJfMVI3OWZzbnBzaXl1bTNBYjlEalNvQkg0V2NQMjl3VzBfVG9rZW46R3c2cWJlQVJvb2JlTjB4S3FpZ2MyckZhbndiXzE3NzI5OTE1MTM6MTc3Mjk5NTExM19WNA)
-
-## 6.3 **视觉设计规范（需要主题模块完成）**
-
-### 6.3.1 颜色规范
-
-### 6.3.2 尺寸规范
-
-### 6.3.3 间距规范
-
-# 7. 配置项
-
-## 7.1 低代码配置项
-
-### 7.1.1 Panel级
-
-* 布局方式layout：horizontal / vertical /grid
-
-* 对齐方式align：left / center / right /space-between
-
-* 溢出策略overflowStrategy：wrap / scroll / moreMenu
-
-* 响应策略responsiveStrategy：PC/ Mobile / Kiosk 策略
-
-* 组间距自定义
-
-* 操作间距自定义
-
-* 背景边框圆角阴影样式自定义
-
-### 7.1.2 Action Group
-
-* 组内对齐方式
-
-* 优先级priority：primary / secondary / danger
-
-* 条件显隐visible
-
-* 是否进入更多collapseToMore
-
-* 背景边框圆角阴影样式自定义
-
-### 7.1.3 Action Item
-
-* 文案自定义
-
-* 图标更换自定义
-
-* button样式自定义
-
-## 7.2 无代码配置项
-
-* 操作显隐开关
-
-* 操作排序
-
-* 移动到「更多」
-
-* 设置默认主操作
-
-* 保存为个人/ 页面 / 商家 View
-
-# 8. 示例
-