@pisell/materials 6.3.27 → 6.3.29

package/lib/components/pisellUrl/PisellUrl.less

@@ -1,37 +1,135 @@
 /**
  * PisellUrl 组件样式
+ * 基于 Figma 设计规范，与 SingleLineText / PisellEmail 设计体系一致，覆盖时使用 pisell-lowcode-xxx
  */
 
 .pisell-url {
   &-edit {
+    position: relative;
     width: 100%;
 
-    // 错误提示样式
-    &-error {
-      margin-top: 4px;
-      font-size: 12px;
-      color: #ff4d4f;
-      line-height: 1.5;
+    // Input 组件内置样式（Figma 设计规范）
+    .pisell-lowcode-input,
+    .pisell-lowcode-input-affix-wrapper {
+      font-size: 16px !important;
+      line-height: 24px !important;
+      border-radius: 8px !important;
+      border: 1px solid #d0d5dd !important; // Gray/300
+      padding: 12px 16px !important;
+      height: 48px !important;
+      color: #101828 !important; // Gray/900
+      background-color: #ffffff !important;
+
+      &::placeholder {
+        color: #667085 !important; // Gray/500
+      }
+
+      &:focus,
+      &:focus-within {
+        border-color: #d6bbfb !important; // Primary/300
+        box-shadow: 0 0 0 4px #f4ebff !important; // Primary/100
+        outline: none !important;
+      }
+
+      &:hover:not(:focus):not(:focus-within):not([disabled]) {
+        border-color: #b692f6 !important; // Primary/400
+      }
+
+      &[disabled],
+      &.pisell-lowcode-input-disabled {
+        background-color: #f9fafb !important; // Gray/50
+        color: #98a2b3 !important; // Gray/400
+        border-color: #d0d5dd !important;
+        cursor: not-allowed !important;
+      }
+    }
+
+    // 带前缀（链接图标）的 Input 容器
+    .pisell-lowcode-input-affix-wrapper {
+      padding: 0 !important;
+
+      .pisell-lowcode-input-prefix {
+        margin-right: 8px;
+        margin-left: 16px;
+        color: #667085; // Gray/500
+        font-size: 16px;
+      }
+
+      .pisell-lowcode-input-suffix {
+        margin-left: 8px;
+        margin-right: 16px;
+        color: #667085;
+        font-size: 16px;
+      }
+
+      .pisell-lowcode-input {
+        padding: 12px 0 !important;
+        border: none !important;
+        box-shadow: none !important;
+
+        &:focus {
+          box-shadow: none !important;
+        }
+      }
+    }
+
+    // 清空按钮
+    .pisell-lowcode-input-clear-icon {
+      color: #667085 !important;
+      font-size: 14px !important;
+
+      &:hover {
+        color: #344054 !important; // Gray/700
+      }
+    }
+
+    // 错误状态
+    .pisell-lowcode-input-status-error,
+    .pisell-lowcode-input-affix-wrapper-status-error {
+      border-color: #fda29b !important; // Error/300
+
+      &:focus,
+      &:focus-within {
+        border-color: #f97066 !important; // Error/400
+        box-shadow: 0 0 0 4px #fee4e2 !important; // Error/100
+      }
+
+      &:hover:not(:focus):not(:focus-within) {
+        border-color: #f97066 !important; // Error/400
+      }
     }
   }
 
+  // 错误提示（与设计体系一致）
+  &-edit-error {
+    margin-top: 4px;
+    font-size: 12px;
+    color: #d92d20; // Error/600
+    line-height: 1.5;
+    animation: pisell-url-fadeIn 0.3s ease-in-out;
+  }
+
   &-read {
     display: inline-flex;
     align-items: center;
 
-    // 链接样式
     .pisell-lowcode-typography-link {
       cursor: pointer;
-      transition: all 0.3s;
+      transition: color 0.2s ease-in-out;
 
       &:hover {
-        opacity: 0.8;
+        color: #6d48c4 !important;
+      }
+
+      &:active {
+        color: #5f3da8 !important;
       }
     }
 
-    // 链接图标
-    .anticon-link {
+    // 链接图标（只读态 Space 内第一项）
+    .pisell-lowcode-space-item:first-child {
       font-size: 14px;
+      line-height: 1;
     }
   }
 
@@ -44,3 +142,14 @@
     }
   }
 }
+
+@keyframes pisell-url-fadeIn {
+  from {
+    opacity: 0;
+    transform: translateY(-4px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}

package/lib/components/pisellUrl/PisellUrl.stories.js

@@ -58,7 +58,7 @@ module.exports = __toCommonJS(PisellUrl_stories_exports);
 var import_PisellUrl = require("./PisellUrl");
 var import_react = __toESM(require("react"));
 var meta = {
-  title: "表单/PisellUrl",
+  title: "表单/表单组件/PisellUrl",
   component: import_PisellUrl.PisellUrl,
   parameters: {
     layout: "centered",

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

@@ -1,5 +1,7 @@
 /**
  * PisellUrl 组件导出文件
  */
-export { PisellUrl, default } from './PisellUrl';
+import PisellUrl from './PisellUrl';
+export { PisellUrl };
+export default PisellUrl;
 export type { PisellUrlProps } from './types';

package/lib/components/pisellUrl/index.js

@@ -29,11 +29,19 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/components/pisellUrl/index.tsx
 var pisellUrl_exports = {};
 __export(pisellUrl_exports, {
-  PisellUrl: () => import_PisellUrl.PisellUrl,
-  default: () => import_PisellUrl.default
+  PisellUrl: () => import_PisellUrl.default,
+  default: () => pisellUrl_default
 });
 module.exports = __toCommonJS(pisellUrl_exports);
+var import_locales = require("../../locales");
 var import_PisellUrl = __toESM(require("./PisellUrl"));
+import_PisellUrl.default.SortOptions = {
+  getSortItems: (fieldKey) => [
+    { key: `${fieldKey}:asc`, label: (0, import_locales.getText)("sort-a-z") },
+    { key: `${fieldKey}:desc`, label: (0, import_locales.getText)("sort-z-a") }
+  ]
+};
+var pisellUrl_default = import_PisellUrl.default;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PisellUrl

package/lib/components/pisellUrl/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PisellUrl 工具函数导出
+ */
+export * from './urlValidator';
+export * from './urlHelper';
+export * from './urlFormatter';

package/lib/components/pisellUrl/utils/urlFormatter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * URL 格式化工具函数
+ */
+/**
+ * 格式化 URL 显示
+ * @param url URL 地址
+ * @param options 格式化选项
+ * @returns 格式化后的 URL
+ *
+ * @example
+ * formatUrlDisplay('https://www.example.com/path', { showProtocol: false })
+ * // 'www.example.com/path'
+ */
+export declare function formatUrlDisplay(url: string, options: {
+    showProtocol?: boolean;
+    showWww?: boolean;
+    showPathname?: boolean;
+    displayFormat?: 'full' | 'domain' | 'custom';
+    customFormat?: (url: string) => string;
+}): string;
+/**
+ * 隐藏 URL 协议
+ * @param url URL 地址
+ * @returns 隐藏协议后的 URL
+ *
+ * @example
+ * hideUrlProtocol('https://example.com') // 'example.com'
+ */
+export declare function hideUrlProtocol(url: string): string;
+/**
+ * 隐藏 www 前缀
+ * @param url URL 地址
+ * @returns 隐藏 www 后的 URL
+ *
+ * @example
+ * hideWwwPrefix('https://www.example.com') // 'https://example.com'
+ */
+export declare function hideWwwPrefix(url: string): string;

package/lib/components/pisellUrl/utils/urlHelper.d.ts

@@ -0,0 +1,63 @@
+/**
+ * URL 辅助函数
+ */
+/**
+ * 规范化 URL（补全协议）
+ * @param url URL 地址
+ * @param defaultProtocol 默认协议
+ * @returns 规范化后的 URL
+ *
+ * @example
+ * normalizeUrl('example.com', 'https://') // 'https://example.com'
+ * normalizeUrl('http://example.com', 'https://') // 'http://example.com'
+ */
+export declare function normalizeUrl(url: string, defaultProtocol?: string): string;
+/**
+ * 智能补全协议（识别 localhost）
+ * @param url URL 地址
+ * @returns 规范化后的 URL
+ *
+ * @example
+ * smartNormalizeUrl('localhost:3000') // 'http://localhost:3000'
+ * smartNormalizeUrl('example.com') // 'https://example.com'
+ */
+export declare function smartNormalizeUrl(url: string): string;
+/**
+ * 提取域名
+ * @param url URL 地址
+ * @returns 域名
+ *
+ * @example
+ * extractDomain('https://www.example.com/path') // 'www.example.com'
+ */
+export declare function extractDomain(url: string): string;
+/**
+ * 处理链接跳转（安全性保障）
+ * @param url URL 地址
+ * @param openInNewWindow 是否新窗口打开
+ * @param defaultProtocol 默认协议
+ *
+ * @example
+ * handleUrlClick('example.com', true, 'https://')
+ */
+export declare function handleUrlClick(url: string, openInNewWindow?: boolean, defaultProtocol?: string): void;
+/**
+ * 检测是否为安全链接（HTTPS）
+ * @param url URL 地址
+ * @returns 是否为 HTTPS
+ *
+ * @example
+ * isSecureUrl('https://example.com') // true
+ * isSecureUrl('http://example.com') // false
+ */
+export declare function isSecureUrl(url: string): boolean;
+/**
+ * 提取 URL 参数
+ * @param url URL 地址
+ * @returns 参数对象
+ *
+ * @example
+ * extractUrlParams('https://example.com?foo=bar&baz=qux')
+ * // { foo: 'bar', baz: 'qux' }
+ */
+export declare function extractUrlParams(url: string): Record<string, string>;

package/lib/components/pisellUrl/utils/urlValidator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * URL 校验工具函数
+ */
+/**
+ * URL 格式校验（使用 URL 构造函数）
+ * @param url URL 地址
+ * @returns 是否通过校验
+ *
+ * @example
+ * validateUrl('https://example.com') // true
+ * validateUrl('invalid-url') // false
+ */
+export declare function validateUrl(url: string): boolean;
+/**
+ * URL 正则校验（备选方法）
+ * @param url URL 地址
+ * @returns 是否通过校验
+ */
+export declare function validateUrlByRegex(url: string): boolean;
+/**
+ * 解析 URL 各部分
+ * @param url URL 地址
+ * @returns URL 各部分或 null
+ *
+ * @example
+ * parseUrl('https://example.com:8080/path?key=value#hash')
+ * // { protocol: 'https', host: 'example.com', port: '8080', ... }
+ */
+export declare function parseUrl(url: string): {
+    protocol: string;
+    host: string;
+    port: string;
+    pathname: string;
+    search: string;
+    hash: string;
+} | null;
+/**
+ * 协议白名单校验
+ * @param url URL 地址
+ * @param allowedProtocols 允许的协议列表
+ * @returns 校验结果
+ */
+export declare function validateUrlProtocol(url: string, allowedProtocols: string[]): {
+    isValid: boolean;
+    errors: string[];
+};

package/lib/components/productCard/components/Packages/utils.d.ts

@@ -6,7 +6,7 @@
  * @Author: WangHan
  * @Date: 2024-11-22 10:01
  */
-export declare const minusSign: (item: any, type?: string) => "" | "-";
+export declare const minusSign: (item: any, type?: string) => "-" | "";
 /**
  * @title: 金额格式化
  * @description:

package/lib/components/select/index.less

@@ -5,16 +5,32 @@
   &-select-dropdown-render-divider {
     margin: 8px 0;
   }
+
   &-select-dropdown-render-options-wrap {
     padding: 0 5px 5px;
   }
+
+  &-select-clear {
+    color: #667085;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-width: 36px;
+    min-height: 36px;
+    margin: -18px -6px;
+    padding: 8px 6px;
+
+    &:hover {
+      color: #344054;
+    }
+  }
 }
 
 // 添加选项间距
 .pisell-base-select-dropdown {
   .pisell-lowcode-select-item {
     margin-bottom: 4px;
-    
+
     &:last-child {
       margin-bottom: 0;
     }
@@ -27,4 +43,4 @@
 
   box-shadow: none !important;
   border-color: transparent !important;
-}
+}

package/lib/components/sort/index.js

@@ -85,6 +85,16 @@ var sortChildrenMap = {
       key: `${key}:desc${isLocal ? ":number" : ""}`,
       label: /* @__PURE__ */ import_react.default.createElement(Label, { content: (0, import_locales.getText)("sort-9-0") })
     }
+  ],
+  option: (key, isLocal) => [
+    {
+      key: `${key}:asc${isLocal ? ":option" : ""}`,
+      label: /* @__PURE__ */ import_react.default.createElement(Label, { content: (0, import_locales.getText)("sort-first-last") })
+    },
+    {
+      key: `${key}:desc${isLocal ? ":option" : ""}`,
+      label: /* @__PURE__ */ import_react.default.createElement(Label, { content: (0, import_locales.getText)("sort-last-first") })
+    }
   ]
 };
 var Sort = ({
@@ -98,12 +108,12 @@ var Sort = ({
 }) => {
   const sortItems = (0, import_react.useMemo)(() => {
     return list.map((d) => {
+      const children = d.getSortItems ? d.getSortItems(d.name).map(({ key, label }) => ({ key, label: /* @__PURE__ */ import_react.default.createElement(Label, { content: label }) })) : sortChildrenMap[d.type](d.name, !!(d == null ? void 0 : d.localFilter));
       return {
         key: d.name,
         label: d.label,
-        children: sortChildrenMap[d.type](d.name, !!(d == null ? void 0 : d.localFilter)),
+        children,
         popupClassName: `${prefix}sort-sub-menu-popup-wrap ${prefix}dropdown-css-var`,
-        // 增加显示隐藏配置
         className: `${d.isHidden ? `${prefix}sort-menu-wrap-hide` : ""}`
       };
     });
@@ -156,7 +166,7 @@ var Sort = ({
         items: sortItems,
         onClick,
         selectable: true,
-        selectedKeys: value
+        selectedKeys: value != null && value !== "" ? [value] : []
       }
     },
     btnContent

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

@@ -1,13 +1,32 @@
 import { MenuProps } from "antd";
 import React from "react";
+/** 单个排序子项（如 A→Z、0→9），由组件的 getSortItems 返回 */
+export declare type SortOptionItem = {
+    key: string;
+    label: string;
+};
 export declare type SortItemProps = {
-    type: "date" | "string" | "number";
+    /** 排序类型，与 sortChildrenMap 对应；当 getSortItems 存在时可省略 */
+    type?: "date" | "string" | "number" | "option";
     label?: string;
     name?: string | string[];
     isCustom: boolean;
     columnKey?: string;
     localFilter?: boolean;
     isHidden?: boolean;
+    /** 由组件内置导出：直接返回该列的排序子项，优先于 type */
+    getSortItems?: (fieldKey: string) => SortOptionItem[];
+};
+/**
+ * 组件侧导出的排序支持契约（如 PisellSingleLineText.SortOptions）。
+ * 支持两种形态：
+ * - getSortItems：组件内置完整排序项（key + label），优先使用；
+ * - type：仅类型，由 Sort 的 sortChildrenMap 生成子项（兼容旧用法）。
+ */
+export declare type SortOptionType = (Pick<SortItemProps, "type"> & Partial<Pick<SortItemProps, "label" | "localFilter" | "isHidden">>) | {
+    getSortItems: (fieldKey: string) => SortOptionItem[];
+    label?: string;
+    isHidden?: boolean;
 };
 export declare type SortListProps = {
     list: SortItemProps[];

package/lib/components/table/Table/fields/types/index.d.ts

@@ -0,0 +1,33 @@
+/// <reference types="react" />
+export declare type FieldPropsType = {
+    title: React.ReactNode;
+    editable: boolean;
+    dataIndex: string;
+    field_type: FieldType;
+    record: Record<string, any>;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    handleSave: () => void;
+    onChange: (value: any, record: any) => void;
+    action?: string;
+    contentClassName?: string;
+};
+export declare type FieldType = "text" | "image";
+export declare type EditPropsType = {
+    value: any;
+    onChange: (v: any) => void;
+    onPressEnter: () => void;
+    onBlur: () => void;
+    style: React.CSSProperties;
+    bordered: boolean;
+    options?: {
+        value: string;
+        label: string;
+    }[] | ((value?: string) => Promise<{
+        value: string;
+        label: string;
+    }[]>);
+    [key: string]: any;
+};

package/lib/components/table/Table/utils.d.ts

@@ -155,7 +155,7 @@ export declare const getSettingKeyArrByMode: ({ filter, columnSetting, dataSourc
     sort?: SortType | undefined;
     mode: "" | "localStorage" | "remote";
     currentViewMode: ModeType;
-}) => ("column_setting" | "gallery_setting" | "order_by" | "group_by" | "filters" | "view_mode" | "filter_setting")[];
+}) => ("filters" | "column_setting" | "gallery_setting" | "order_by" | "group_by" | "view_mode" | "filter_setting")[];
 export declare const omit: (obj: Record<string, any>, keys: string[]) => Record<string, any>;
 export declare const stringify: (obj: Record<string, any>) => string;
 export {};

package/lib/components/virtualInput/BaseVirtualInput/index.d.ts

@@ -0,0 +1,44 @@
+import React from 'react';
+import './index.less';
+export interface BaseVirtualInputProps {
+    /** 输入值 */
+    value?: string | React.ReactNode;
+    /** 占位符 */
+    placeholder?: string;
+    /** 是否自动聚焦 */
+    autoFocus?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 组件高度，默认60px */
+    height?: number | string;
+    /** 字体大小，默认48px，如果不设置会根据高度自动计算 */
+    fontSize?: number | string;
+    /** 聚焦回调 */
+    onFocus?: () => void;
+    /** 失焦回调 */
+    onBlur?: () => void;
+    /** 文字位置 */
+    textAlign?: 'start' | 'center' | 'end';
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 自定义类名 */
+    className?: string;
+    /** showCursor  */
+    showCursor?: boolean;
+    /** 防止失焦的元素选择器或ref */
+    preventBlurElements?: Array<string | React.RefObject<HTMLElement>>;
+    /** 是否聚焦（受控模式） */
+    focused?: boolean;
+    /** 是否选中全部文本（类似浏览器选中效果） */
+    selected?: boolean;
+    /** 选中状态的背景色，默认为主题色 */
+    selectedColor?: string;
+}
+export interface BaseVirtualInputRef {
+    /** 手动聚焦 */
+    focus: () => void;
+    /** 手动失焦 */
+    blur: () => void;
+}
+declare const BaseVirtualInput: React.ForwardRefExoticComponent<BaseVirtualInputProps & React.RefAttributes<BaseVirtualInputRef>>;
+export default BaseVirtualInput;

package/lib/hooks/useMobile.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 响应式监听 Hook
+ * 监听窗口大小变化，返回当前是否为移动端
+ *
+ * @param breakpoint - 断点宽度（默认 768px）
+ * @returns 是否为移动端
+ */
+export declare function useMobile(breakpoint?: number): boolean;

package/lib/index.d.ts

@@ -14,7 +14,7 @@ export type { PisellSingleLineTextProps, PisellLongTextProps, PisellNumberProps,
  * <PisellMetrics.MetricCard title="Total Sales" value={1580} />
  */
 export { default as PisellMetrics } from './components/PisellMetrics';
-export type { PisellMetricCardProps, PisellStatisticProps } from './components/PisellMetrics';
+export type { PisellMetricCardProps, PisellStatisticProps, } from './components/PisellMetrics';
 /**
  * PisellLayouts - 布局组件命名空间
  * @example
@@ -134,7 +134,7 @@ export { default as CropPhoto } from './components/cropPhoto';
 export { default as PisellUpload } from './components/pisellUpload';
 export { default as Translation } from './components/translation';
 export { PisellLookup } from './components/pisellLookup';
-export type { PisellLookupProps, PisellLookupRef } from './components/pisellLookup';
+export type { PisellLookupProps, PisellLookupRef, } from './components/pisellLookup';
 export { PisellFind } from './components/pisellFind';
 export type { PisellFindProps, PisellFindRef } from './components/pisellFind';
 export { default as DataSourceForm } from './components/dataSourceComponents/dataSourceForm';
@@ -148,6 +148,10 @@ export { default as DataSourceTypography } from './components/dataSourceComponen
 export { default as DataSourceTable } from './components/dataSourceComponents/dataSourceTable';
 export { default as DataSourceWrapper } from './components/dataSourceComponents/dataSourceWrapper';
 export { default as PisellDataSourceContainer } from './components/pisellDataSourceContainer';
+export { default as PisellRecordBoard } from './components/pisellRecordBoard';
+export type { RecordBoardContextValue, RecordBoardChildComponentProps, RecordBoardColumnType, } from './components/pisellRecordBoard';
+export { PisellShellFrame } from './components/pisellShellFrame';
+export type { PisellShellFrameProps, PisellShellFrameConfig, PisellShellFrameScrollConfig, } from './components/pisellShellFrame';
 export type { DataSourceContainerProps } from './components/pisellDataSourceContainer';
 export { default as FormItemCheckbox } from './components/dataSourceComponents/fields/Checkbox';
 export { default as FormItemSwitch } from './components/dataSourceComponents/fields/Switch';
@@ -162,6 +166,10 @@ export { default as FormItemTranslation } from './components/dataSourceComponent
 export { default as FormItemUpload } from './components/dataSourceComponents/fields/Upload';
 export { default as FormItemIconSelect } from './components/dataSourceComponents/fields/IconSelect';
 export { default as BaseTranslation } from './components/dataSourceComponents/fields/Translation/BaseTranslation';
+export { default as DataSourceSubForm } from './components/dataSourceComponents/dataSourceSubForm';
+export type { DataSourceSubFormProps } from './components/dataSourceComponents/dataSourceSubForm/types';
+export { default as FormItemRecordListWrapper } from './components/dataSourceComponents/fields/RecordListWrapper';
+export { default as FormItemTabs } from './components/dataSourceComponents/fields/Tabs';
 export { default as PisellMenu } from './components/pisellMenu';
 export type { PisellMenuProps } from './components/pisellMenu/types';
 export { default as PisellNavigationMenu } from './components/pisellNavigationMenu';