@pisell/materials 3.3.87 → 3.3.89

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

@@ -17,4 +17,4 @@ export declare const minusSign: (item: any, type?: string) => "-" | "";
  * @Author: WangHan
  * @Date: 2024-11-22 10:58
  */
-export declare const _formatAmount: (price?: number, amountSymbol?: string, digit?: number) => string | number;
+export declare const _formatAmount: (price?: number, amountSymbol?: string, digit?: number) => any;

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

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const Radio: (props: any) => import("react").JSX.Element;
 export default Radio;

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

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const Skeleton: (props: any) => import("react").JSX.Element;
 export default Skeleton;

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

@@ -0,0 +1,39 @@
+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 = {
+    /** 排序类型，与 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[];
+    onChange?: (val: string, detail: Parameters<Required<MenuProps>["onClick"]>[0]) => void;
+    button?: React.ReactNode;
+    style?: React.CSSProperties;
+    value?: any;
+    placement?: "bottom" | "bottomLeft" | "bottomRight" | "top" | "topLeft" | "topRight";
+    localPagination?: boolean;
+};

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

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;
-}) => ("view_mode" | "filter_setting" | "group_by" | "order_by" | "column_setting" | "gallery_setting" | "filters")[];
+}) => ("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/time-picker/index.d.ts

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const TimePicker: (props: any) => import("react").JSX.Element;
 export default TimePicker;

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

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const Upload: (props: any) => import("react").JSX.Element;
 export default Upload;

package/lib/components/virtual-keyboard/Time/utils.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 export declare const formatStringToTime: (value: string) => {
     valueArray: string[];
     valueString: string;

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/components/virtualInput/index.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import { BaseVirtualInputProps, BaseVirtualInputRef } from './BaseVirtualInput';
+import './index.less';
+export type { BaseVirtualInputProps, BaseVirtualInputRef } from './BaseVirtualInput';
+export interface VirtualInputProps extends BaseVirtualInputProps {
+    /** 在VirtualInput上方显示的额外内容 */
+    topContent?: React.ReactNode;
+    /** 在VirtualInput下方显示的额外内容 */
+    bottomContent?: React.ReactNode;
+    /** wrapper class */
+    wrapperClassName?: string;
+    /** 虚拟输入框包装器的样式 */
+    wrapperStyle?: React.CSSProperties;
+    /** 是否允许清除输入框中的内容 */
+    allowClear?: boolean;
+    /** 清除输入框内容的回调函数 */
+    onClear?: () => void;
+    /** 自定义清除按钮的样式 */
+    clearButtonStyle?: React.CSSProperties;
+    theme?: {
+        token?: {
+            colorPrimary?: string;
+        };
+    };
+}
+export interface VirtualInputRef extends BaseVirtualInputRef {
+}
+declare const VirtualInput: React.ForwardRefExoticComponent<VirtualInputProps & React.RefAttributes<VirtualInputRef>>;
+export default VirtualInput;

package/lib/hooks/useMobile.d.ts

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

package/lib/hooks/useThemeTokens.d.ts

@@ -0,0 +1,7 @@
+declare type ThemeInput = {
+    token?: {
+        colorPrimary?: string;
+    };
+};
+declare const useThemeTokens: (themeInput?: ThemeInput) => any;
+export default useThemeTokens;

package/lib/index.d.ts

@@ -166,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';

package/lib/index.js

@@ -63,6 +63,7 @@ __export(src_exports, {
   DataSourceImage: () => import_dataSourceImage.default,
   DataSourceMenu: () => import_dataSourceMenu.default,
   DataSourceQRCode: () => import_dataSourceQRCode.default,
+  DataSourceSubForm: () => import_dataSourceSubForm.default,
   DataSourceTable: () => import_dataSourceTable.default,
   DataSourceTypography: () => import_dataSourceTypography.default,
   DataSourceWrapper: () => import_dataSourceWrapper.default,
@@ -84,8 +85,10 @@ __export(src_exports, {
   FormItemInput: () => import_Input.default,
   FormItemInputNumber: () => import_InputNumber.default,
   FormItemRadio: () => import_Radio.default,
+  FormItemRecordListWrapper: () => import_RecordListWrapper.default,
   FormItemSelect: () => import_Select.default,
   FormItemSwitch: () => import_Switch.default,
+  FormItemTabs: () => import_Tabs.default,
   FormItemTimePicker: () => import_TimePicker.default,
   FormItemTranslation: () => import_Translation.default,
   FormItemUpload: () => import_Upload.default,
@@ -382,6 +385,9 @@ var import_Translation = __toESM(require("./components/dataSourceComponents/fiel
 var import_Upload = __toESM(require("./components/dataSourceComponents/fields/Upload"));
 var import_IconSelect = __toESM(require("./components/dataSourceComponents/fields/IconSelect"));
 var import_BaseTranslation = __toESM(require("./components/dataSourceComponents/fields/Translation/BaseTranslation"));
+var import_dataSourceSubForm = __toESM(require("./components/dataSourceComponents/dataSourceSubForm"));
+var import_RecordListWrapper = __toESM(require("./components/dataSourceComponents/fields/RecordListWrapper"));
+var import_Tabs = __toESM(require("./components/dataSourceComponents/fields/Tabs"));
 var import_pisellMenu = __toESM(require("./components/pisellMenu"));
 var import_pisellNavigationMenu = __toESM(require("./components/pisellNavigationMenu"));
 var import_page_header = __toESM(require("./components/page-header"));
@@ -473,6 +479,7 @@ var import_usePisellConfig = __toESM(require("./components/pisell-config-provide
   DataSourceImage,
   DataSourceMenu,
   DataSourceQRCode,
+  DataSourceSubForm,
   DataSourceTable,
   DataSourceTypography,
   DataSourceWrapper,
@@ -494,8 +501,10 @@ var import_usePisellConfig = __toESM(require("./components/pisell-config-provide
   FormItemInput,
   FormItemInputNumber,
   FormItemRadio,
+  FormItemRecordListWrapper,
   FormItemSelect,
   FormItemSwitch,
+  FormItemTabs,
   FormItemTimePicker,
   FormItemTranslation,
   FormItemUpload,

package/lib/theme/tokens.d.ts

@@ -0,0 +1,22 @@
+import { ThemeConfig } from 'antd';
+/**
+ * Pisell 项目统一的 Ant Design Token 配置
+ * 基于 Figma 设计规范
+ *
+ * 使用场景：
+ * - 低代码平台（page/index.tsx）
+ * - Storybook 预览
+ * - 其他需要主题配置的场景
+ */
+/**
+ * 获取组件级别的 token 配置
+ */
+export declare function getComponentsToken(): ThemeConfig['components'];
+/**
+ * 获取全局 token 配置
+ */
+export declare function getGlobalToken(themeColor?: string): ThemeConfig['token'];
+/**
+ * 获取完整的主题配置
+ */
+export declare function getThemeConfig(themeColor?: string): ThemeConfig;

package/lib/utils/tagColor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 只读态 Tag 未传 color 时使用的预设色板（按索引稳定分配）
+ */
+/**
+ * 根据 value 或索引从预设色板取一个稳定颜色（未传 option.color 时使用）
+ */
+export declare function getDefaultTagColor(value: unknown, index: number): string;

package/lowcode/auto-resize-text/meta.ts

@@ -9,7 +9,7 @@ const AutoResizeTextMeta: ComponentMetadata = {
   "devMode": "proCode",
   "npm": {
     "package": "@pisell/materials",
-    "version": "3.3.86",
+    "version": "3.3.88",
     "exportName": "AutoResizeText",
     "main": "src/index.tsx",
     "destructuring": true,
@@ -277,6 +277,10 @@ const AutoResizeTextMeta: ComponentMetadata = {
                       "label": "progress",
                       "value": "progress"
                     },
+                    {
+                      "label": "label",
+                      "value": "label"
+                    },
                     {
                       "label": "title",
                       "value": "title"
@@ -549,10 +553,6 @@ const AutoResizeTextMeta: ComponentMetadata = {
                       "label": "kbd",
                       "value": "kbd"
                     },
-                    {
-                      "label": "label",
-                      "value": "label"
-                    },
                     {
                       "label": "legend",
                       "value": "legend"
@@ -751,6 +751,10 @@ const AutoResizeTextMeta: ComponentMetadata = {
                       "label": "progress",
                       "value": "progress"
                     },
+                    {
+                      "label": "label",
+                      "value": "label"
+                    },
                     {
                       "label": "title",
                       "value": "title"
@@ -1023,10 +1027,6 @@ const AutoResizeTextMeta: ComponentMetadata = {
                       "label": "kbd",
                       "value": "kbd"
                     },
-                    {
-                      "label": "label",
-                      "value": "label"
-                    },
                     {
                       "label": "legend",
                       "value": "legend"

package/lowcode/data-source-form/constants.ts

@@ -17,6 +17,7 @@ import formItemRadioGroupMeta from '../form-item-radio.group/meta';
 import formItemSelectMeta from '../form-item-select/meta';
 import formItemTimePickerMeta from '../form-item-time-picker/meta';
 import formItemUploadMeta from '../form-item-upload/meta';
+import formItemRecordListWrapperMeta from '../form-item-record-list-wrapper/meta';
 
 export const metaAll = [
   formItemCheckboxMeta,
@@ -38,6 +39,7 @@ export const metaAll = [
   formItemSelectMeta,
   formItemTimePickerMeta,
   formItemUploadMeta,
+  formItemRecordListWrapperMeta,
 ]
 
 export const formItemMetaMap: Record<string, any> = metaAll.reduce((p, c) => {
@@ -75,6 +77,7 @@ export const nocobaseCpt2PisellCptMap: Record<string, any> = {
   Upload: 'FormItemUpload',
   Translation: "FormItemTranslation",
   IconPicker: "FormItemIconSelect",
+  RecordListWrapper: 'FormItemRecordListWrapper',
 };
 
 

package/lowcode/data-source-form/utils.ts

@@ -5,6 +5,7 @@ import {
   systemFields,
   formItemMetaMap,
 } from './constants';
+import { parseXRecordSchemaToChildSchemas } from '../data-source-sub-form/meta';
 
 type UiSchema = {
   title: string;
@@ -30,7 +31,8 @@ type UiSchema = {
     dataSource?: any;
     extraParams?: Record<string, any>;
   };
-  type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+  'x-record-schema'?: Record<string, any> | Record<string, any>[] | string;
+  type: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
 };
 
 // 创建表单组
@@ -131,6 +133,7 @@ export const createFormItemSchema = (
   item: {
     name: string;
     uiSchema: UiSchema;
+    schema?: Record<string, any>;
     children?: any[];
     _children?: any[];
     interface?: string;
@@ -303,12 +306,33 @@ export const createFormItemSchema = (
     componentName = 'Translation';
   }
 
+  // 注入默认值
+  props.defaultValue = defaultValue;
+
   // 获取选项配置
-  const dataSourceConfig = (uiSchema as any)?.['x-data-source'];
+  const dataSourceConfig = (uiSchema as any)?.['x-data-source'] || item?.schema?.['x-data-source'];
+  const recordSchemaConfig = (uiSchema as any)?.['x-record-schema'] || item?.schema?.['x-record-schema'];
+  const isRecordListWrapper =
+    item?.interface === 'RecordListWrapper' || xComponent === 'RecordListWrapper';
+
+  if (isRecordListWrapper) {
+    cptTitle = '记录列表包装器';
+    componentName = 'RecordListWrapper';
+    props.xRecordSchema = recordSchemaConfig;
+
+    // 自动将 recordSchemaConfig 解析为子节点 Schema，与 JsonSetter 的 setValue 保持一致，
+    // 避免用户必须在低代码面板手动触发 JsonSetter 才能渲染子表单字段。
+    if (recordSchemaConfig) {
+      childrenSchema = parseXRecordSchemaToChildSchemas(recordSchemaConfig);
+    } else {
+      childrenSchema = [];
+    }
+  }
   
   if (
-    ['Select', 'Radio.Group', 'Checkbox.Group'].includes(xComponent) &&
-    (uiSchema?.enum?.length > 0 || dataSourceConfig)
+    (['Select', 'Radio.Group', 'Checkbox.Group'].includes(xComponent) ||
+      isRecordListWrapper) &&
+    (uiSchema?.enum?.length > 0 || dataSourceConfig || isRecordListWrapper)
   ) {
     if (['Radio.Group', 'Checkbox.Group'].includes(xComponent)) {
       props.direction = 'horizontal';
@@ -343,7 +367,7 @@ export const createFormItemSchema = (
     const optionConfig = dataSourceConfig || {};
     
     // 设置 optionSourceType
-    props.optionSourceType = optionConfig?.type || 'default';
+    props.optionSourceType = optionConfig?.type || '';
     
     // 根据 sourceType 设置不同的配置
     if (props.optionSourceType === 'default') {
@@ -427,6 +451,8 @@ export const createFormItemSchema = (
     schemaType = type as any;
   } else if (xComponent === 'InputNumber' || xComponent === 'Percent') {
     schemaType = 'number';
+  } else if (componentName === 'RecordListWrapper') {
+    schemaType = 'array';
   } else if (xComponent === 'Input.JSON' || item?.interface === 'i18nInput') {
     schemaType = 'object';
   } else if (['Checkbox.Group', 'Select'].includes(xComponent) && props.mode === 'multiple') {