@pisell/materials 6.9.4 → 6.9.5

package/es/index.js

@@ -1,22 +1,159 @@
+// ==================== 命名空间导出（推荐使用）====================
+// 新的命名空间组织方式，提供更好的组件分组和查找体验
+// 同时保留所有原有单独导出，确保向后兼容
+
+/**
+ * PisellFields - 字段组件命名空间
+ * @example
+ * import { PisellFields } from '@pisell/materials';
+ * <PisellFields.SingleLineText value="hello" />
+ * <PisellFields.Currency value={1000} currencySymbol="$" />
+ */
+export { default as PisellFields } from "./components/PisellFields";
+/**
+ * PisellMetrics - 指标展示组件命名空间
+ * @example
+ * import { PisellMetrics } from '@pisell/materials';
+ * <PisellMetrics.MetricCard title="Total Sales" value={1580} />
+ */
+export { default as PisellMetrics } from "./components/PisellMetrics";
+/**
+ * PisellLayouts - 布局组件命名空间
+ * @example
+ * import { PisellLayouts } from '@pisell/materials';
+ * <PisellLayouts.BasicGrid columns={3}>{children}</PisellLayouts.BasicGrid>
+ */
+export { default as PisellLayouts } from "./components/PisellLayouts";
+// ==================== Ant Design 组件重导出 ====================
+// 直接从 antd 导出的基础组件，用于兼容性
 export { Affix, Alert, Anchor, Avatar, Breadcrumb, Card, Carousel, Col,
 // Collapse,
 ColorPicker, Descriptions, Divider, Empty, Grid, InputNumber, Mentions, Menu, Pagination, Popconfirm, Popover, Progress, Rate, Result, Row, Space, Spin, Statistic, Steps, Switch, Tag, Timeline, Tooltip, Transfer, Tree, message, notification, version } from 'antd';
+
+// ==================== 基础 UI 组件 ====================
+// 基础交互组件，对 Ant Design 组件的增强封装
 export { default as AutoComplete } from "./components/auto-complete";
 export { default as AutoCompleteNumber } from "./components/auto-complete-number";
 export { default as Badge } from "./components/badge";
-export { default as BatchEditor } from "./components/batch-editor";
 export { default as Button } from "./components/button";
-export { default as ButtonGroupEdit } from "./components/buttonGroupEdit";
-export { default as ButtonGroupPreview } from "./components/buttonGroupPreview";
 export { default as Calendar } from "./components/calendar";
-export { default as CardMetricItem } from "./components/cardMetricItem";
-export { default as CardPro } from "./components/cardPro";
 export { default as Cascader } from "./components/cascader";
 export { default as Checkbox } from "./components/checkbox";
-export { default as ClassicLayout } from "./components/classicLayout";
-export { default as Component } from "./components/component";
+export { default as Collapse } from "./components/collapse";
 export { default as ConfigProvider } from "./components/config-provider";
+export { default as DatePicker } from "./components/date-picker";
+export { default as Drawer } from "./components/drawer";
+export { default as Dropdown } from "./components/dropdown";
+export { default as Icon } from "./components/icon";
+export { default as Iconfont } from "./components/iconfont";
+export { default as Input } from "./components/input";
+export { default as InputNumberRange } from "./components/input-number-range";
+export { default as List } from "./components/list";
+export { default as Modal } from "./components/modal";
+export { default as Radio } from "./components/radio";
+export { default as Select } from "./components/select";
+export { default as Segmented } from "./components/segmented";
+export { default as Skeleton } from "./components/skeleton";
+export { default as Slider } from "./components/slider";
+export { default as Tabs } from "./components/tabs";
+export { default as TimePicker } from "./components/time-picker";
+export { default as TreeSelect } from "./components/tree-select";
+export { default as Typography } from "./components/typography";
+export { default as Upload } from "./components/upload";
+
+// ==================== 字段组件 (Fields) ====================
+// 表单字段组件，支持编辑态、只读态、禁用态三种视图模式
+// 用于 Airtable 风格的数据表格和表单场景
+// 注意：类型已在 PisellFields 命名空间中导出
+export { PisellSingleLineText } from "./components/pisellSingleLineText";
+export { PisellLongText } from "./components/pisellLongText";
+export { PisellNumber } from "./components/pisellNumber";
+export { PisellCurrency } from "./components/pisellCurrency";
+export { PisellPercent } from "./components/pisellPercent";
+export { PisellPhone } from "./components/pisellPhone";
+export { PisellEmail } from "./components/pisellEmail";
+export { PisellUrl } from "./components/pisellUrl";
+export { PisellRating } from "./components/pisellRating";
+export { PisellSingleSelect } from "./components/pisellSingleSelect";
+export { PisellMultipleSelect } from "./components/pisellMultipleSelect";
+
+// ==================== 卡片组件 (Cards) ====================
+// 卡片系列组件，用于列表、网格等场景的内容展示
+export { default as PisellCard } from "./components/pisellCard";
+export { default as PisellCards } from "./components/PisellCards";
+export { default as TabCard } from "./components/PisellCards/components/TabCard";
+export { default as TextCard } from "./components/PisellCards/components/TextCard";
+export { default as GraphicTextCard } from "./components/PisellCards/components/GraphicTextCard";
+export { default as MultilevelCard } from "./components/PisellCards/components/MultilevelCard";
+export { default as PisellImageCard } from "./components/PisellCards/components/PisellImageCard";
+export { default as CardPro } from "./components/cardPro";
+export { default as CardMetricItem } from "./components/cardMetricItem";
+export { default as PisellCardList } from "./components/pisellCardList";
+export { default as ProductCard } from "./components/productCard";
+export { default as WalletCard } from "./components/walletCard";
+export { default as PisellWalletPassCard } from "./components/pisellWalletPassCard";
+export { default as PisellGoodPassCard } from "./components/pisellGoodPassCard";
+export { default as PisellAppCard } from "./components/pisellAppCard";
+// ==================== 数据展示组件 (Data Display) ====================
+// 用于展示各类数据指标、统计信息
+export { default as PisellMetricCard } from "./components/pisellMetricCard";
+// 类型已在 PisellMetrics 命名空间中导出
+export { PisellDateTimeDisplay } from "./components/pisellDateTimeDisplay";
+export { default as PisellStatisticList } from "./components/pisellStatisticList";
+export { default as PisellEmpty } from "./components/pisellEmpty";
+export { default as PisellText } from "./components/pisellText";
+export { default as PisellTags } from "./components/pisellTags";
+export { default as PisellAvatar } from "./components/pisellAvatar";
+export { default as PisellCountdown } from "./components/pisellCountdown";
+export { default as Image } from "./components/image";
+export { default as AutoResizeText } from "./components/auto-resize-text";
+
+// ==================== 布局组件 (Layout) ====================
+// 页面布局和容器组件
+export { default as Page } from "./components/page";
+export { default as PisellLayout } from "./components/pisellLayout";
+export { default as PisellContent } from "./components/pisellLayout/content";
+export { default as PisellFooter } from "./components/pisellLayout/footer";
+export { default as PisellHeader } from "./components/pisellLayout/header";
+export { default as PisellSider } from "./components/pisellLayout/sider";
+export { default as ClassicLayout } from "./components/classicLayout";
+export { default as PisellContainer } from "./components/pisellContainer";
+export { default as PisellRow } from "./components/pisellRow";
+export { default as Div } from "./components/div";
+export { default as PisellBasicGrid } from "./components/PisellBasicGrid";
+// 类型已在 PisellLayouts 命名空间中导出
+export { default as PisellScrollView } from "./components/PisellScrollView";
+// 类型已在 PisellLayouts 命名空间中导出
+export { default as PisellViewGrid } from "./components/pisellViewGrid";
+
+// ==================== 表格组件 (Table) ====================
+// 表格及相关数据处理组件
+export { default as Table } from "./components/table";
+export { default as PisellGridView } from "./components/pisellGridPro/GridView";
+export { default as PisellToolBar } from "./components/pisellGridPro/ToolBar";
+export { default as PisellGridPro } from "./components/pisellGridPro";
+export { default as RecordView } from "./components/record-view";
+
+// ==================== 表单组件 (Form) ====================
+// 表单及表单项组件
+export { default as Form } from "./components/form";
+export { default as PisellInput } from "./components/pisellInput";
+export { getBankCardTypeImg } from "./components/pisellInput/components/BankCard/utils";
+export { default as PisellDatePicker } from "./components/pisellDatePicker";
+export { default as PisellCheckboxGroup } from "./components/pisellCheckboxGroup";
+export { default as PisellCustomCheckboxGroup } from "./components/pisellCustomCheckboxGroup";
+export { default as PisellInformationEntry } from "./components/pisellInformationEntry";
+export { default as PisellAdjustPrice } from "./components/pisellAdjustPrice";
+export { default as PisellAdjustPriceInputNumber } from "./components/pisellAdjustPrice/PisellAdjustPriceInputNumber";
+export { default as CustomSelect } from "./components/customSelect";
+export { default as IconSelect } from "./components/iconSelect";
+export { default as SelectTime } from "./components/select-time";
 export { default as CropPhoto } from "./components/cropPhoto";
+export { default as PisellUpload } from "./components/pisellUpload";
+export { default as Translation } from "./components/translation";
+
+// ==================== 数据源组件 (DataSource) ====================
+// 数据源绑定相关组件，用于低代码场景
 export { default as DataSourceForm } from "./components/dataSourceComponents/dataSourceForm";
 export { default as FormGroup } from "./components/dataSourceComponents/dataSourceForm/group";
 export { default as JsonWrapper } from "./components/dataSourceComponents/dataSourceForm/provider/jsonWrapper/JsonWrapperProvider";
@@ -27,6 +164,7 @@ export { default as DataSourceQRCode } from "./components/dataSourceComponents/d
 export { default as DataSourceTypography } from "./components/dataSourceComponents/dataSourceShow/dataSourceTypography";
 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 FormItemCheckbox } from "./components/dataSourceComponents/fields/Checkbox";
 export { default as FormItemSwitch } from "./components/dataSourceComponents/fields/Switch";
 export { default as FormItemColorPicker } from "./components/dataSourceComponents/fields/ColorPicker";
@@ -39,131 +177,89 @@ export { default as FormItemTimePicker } from "./components/dataSourceComponents
 export { default as FormItemTranslation } from "./components/dataSourceComponents/fields/Translation";
 export { default as FormItemUpload } from "./components/dataSourceComponents/fields/Upload";
 export { default as FormItemIconSelect } from "./components/dataSourceComponents/fields/IconSelect";
-export { default as DatePicker } from "./components/date-picker";
-export { default as Div } from "./components/div";
-export { default as DragSortTree } from "./components/drag-sort-tree";
-export { default as Drawer } from "./components/drawer";
-export { default as Dropdown } from "./components/dropdown";
-export { default as Filter } from "./components/filter";
-export { default as Form } from "./components/form";
-export { default as Icon } from "./components/icon";
-export { default as Iconfont } from "./components/iconfont";
-export { default as Input } from "./components/input";
-export { default as InputNumberRange } from "./components/input-number-range";
-export { default as List } from "./components/list";
-export { default as loginAndRegister } from "./components/login-and-register";
-export { default as LowCodePage } from "./components/lowCodePage";
-export { default as Modal } from "./components/modal";
-export { default as OrganizationTenantSwitcher } from "./components/organizationTenantSwitcher";
-export { default as Page } from "./components/page";
+export { default as BaseTranslation } from "./components/dataSourceComponents/fields/Translation/BaseTranslation";
+
+// ==================== 导航组件 (Navigation) ====================
+// 导航、菜单、标签页等组件
+export { default as PisellMenu } from "./components/pisellMenu";
+export { default as PisellNavigationMenu } from "./components/pisellNavigationMenu";
 export { default as PageHeader } from "./components/page-header";
-export { default as PisellConfigProvider } from "./components/pisell-config-provider";
-export { default as PisellContext, globalConfig } from "./components/pisell-config-provider/context";
-export { default as usePisellConfig } from "./components/pisell-config-provider/hooks/usePisellConfig";
-export { default as PisellAdjustPrice } from "./components/pisellAdjustPrice";
-export { default as PisellAdjustPriceInputNumber } from "./components/pisellAdjustPrice/PisellAdjustPriceInputNumber";
-export { default as PisellAlert } from "./components/pisellAlert";
 export { default as PisellAnchor } from "./components/pisellAnchor";
-export { default as PisellAvatar } from "./components/pisellAvatar";
-export { default as PisellBatchActionBar } from "./components/pisellBatchActionBar";
-export { default as PisellCard } from "./components/pisellCard";
-export { default as PisellCardList } from "./components/pisellCardList";
-export { default as PisellCards } from "./components/PisellCards";
-export { default as TabCard } from "./components/PisellCards/components/TabCard";
-export { default as PisellCheckboxGroup } from "./components/pisellCheckboxGroup";
-export { default as PisellContainer } from "./components/pisellContainer";
-export { default as PisellCountdown } from "./components/pisellCountdown";
-export { default as PisellDatePicker } from "./components/pisellDatePicker";
-export { default as PisellDraggable } from "./components/pisellDraggable";
-export { default as PisellEmpty } from "./components/pisellEmpty";
-export { default as PisellFloatingPanel } from "./components/pisellFloatingPanel";
-export { default as PisellInformationEntry } from "./components/pisellInformationEntry";
-export { default as PisellInput } from "./components/pisellInput";
-export { getBankCardTypeImg } from "./components/pisellInput/components/BankCard/utils";
-export { default as PisellQrcode } from "./components/pisellQrcode";
-export { default as PisellLayout } from "./components/pisellLayout";
-export { default as PisellContent } from "./components/pisellLayout/content";
-export { default as PisellFooter } from "./components/pisellLayout/footer";
-export { default as PisellHeader } from "./components/pisellLayout/header";
-export { default as PisellSider } from "./components/pisellLayout/sider";
-export { default as PisellLoading } from "./components/pisellLoading";
-export { default as PisellMenu } from "./components/pisellMenu";
-export { default as PisellModal } from "./components/pisellModal";
-export { default as PisellQRScanner } from "./components/pisellQRScanner";
-export { default as PisellRow } from "./components/pisellRow";
-export { default as PisellScan } from "./components/pisellScan";
-export { default as PisellStatisticList } from "./components/pisellStatisticList";
 export { default as PisellSteps } from "./components/PisellSteps";
 export { default as PisellProcedure } from "./components/PisellProcedure";
-export { default as PisellTags } from "./components/pisellTags";
-export { default as PisellText } from "./components/pisellText";
-export { default as PisellToast, useToast } from "./components/pisellToast";
-// export { default as InformationModal } from './components/pisellModal/components/Information';
-export { default as PisellTooltip } from "./components/pisellTooltip";
-export { default as PisellUpload } from "./components/pisellUpload";
-export { default as PisellViewGrid } from "./components/pisellViewGrid";
-export { default as PisellWalletPassCard } from "./components/pisellWalletPassCard";
+export { default as PisellSuperTabs } from "./components/PisellSuperTabs";
 export { default as ProfileMenu } from "./components/profileMenu";
-export { default as QRCode } from "./components/qrcode";
-export { default as Radio } from "./components/radio";
-export { default as RecordView } from "./components/record-view";
-export { default as Segmented } from "./components/segmented";
-export { default as Select } from "./components/select";
-export { default as SelectTime } from "./components/select-time";
-export { default as Skeleton } from "./components/skeleton";
-export { default as Slider } from "./components/slider";
+
+// ==================== Tabbar 组件 (底部导航栏) ====================
+// 移动端底部导航栏组件
+export { default as PisellTabbar } from "./components/PisellTabbar";
+export { default as PisellTabbarTemplate1 } from "./components/PisellTabbar/template/Template1";
+export { default as PisellTabbar2 } from "./components/PisellTabbar2";
+
+//新增组件
+// ==================== 反馈组件 (Feedback) ====================
+// 用户反馈和提示类组件
+export { default as PisellModal } from "./components/pisellModal";
+export { default as PisellToast } from "./components/pisellToast";
+export { default as PisellAlert } from "./components/pisellAlert";
+export { default as PisellTooltip } from "./components/pisellTooltip";
+export { default as PisellLoading } from "./components/pisellLoading";
+
+// ==================== 筛选与排序组件 ====================
+// 数据筛选、排序相关组件
+export { default as Filter } from "./components/filter";
+export { default as PisellFilter } from "./components/pisellFilter";
+export { default as PisellQuickFilter } from "./components/pisellQuickFilter";
 export { default as Sort } from "./components/sort";
+export { default as PisellSort } from "./components/pisellSort";
+// ==================== 拖拽与排序组件 ====================
+// 拖拽交互相关组件
+export { default as DragSortTree } from "./components/drag-sort-tree";
 export { default as SortableList } from "./components/sortableList";
-export { default as Table } from "./components/table";
-export { default as Tabs } from "./components/tabs";
-export { default as TimePicker } from "./components/time-picker";
-export { default as Translation } from "./components/translation";
-export { default as TreeSelect } from "./components/tree-select";
-export { default as Typography } from "./components/typography";
-export { default as Upload } from "./components/upload";
+export { default as PisellDraggable } from "./components/pisellDraggable";
+export { default as PisellDropSort } from "./components/pisellDropSort";
+
+// ==================== 批量操作组件 ====================
+// 批量操作相关组件
+export { default as PisellBatchActionBar } from "./components/pisellBatchActionBar";
+export { default as BatchEditor } from "./components/batch-editor";
+
+// ==================== 工具组件 (Utilities) ====================
+// 二维码、扫码、虚拟键盘等工具类组件
+export { default as QRCode } from "./components/qrcode";
+export { default as PisellQrcode } from "./components/pisellQrcode";
+export { default as PisellQRScanner } from "./components/pisellQRScanner";
+export { default as PisellScan } from "./components/pisellScan";
 export { default as VirtualKeyboard } from "./components/virtual-keyboard";
 export { default as PisellPriceKeyboard } from "./components/virtual-keyboard/Amount";
 export { default as PisellNumberKeyboard } from "./components/virtual-keyboard/Number";
 export { default as VirtualKeyboardTime } from "./components/virtual-keyboard/Time";
-export { default as WalletCard } from "./components/walletCard";
-export { default as PublishVersionModal } from "./components/versionModal";
-export { default as IconSelect } from "./components/iconSelect";
-export { default as CustomSelect } from "./components/customSelect";
-export { default as AppVersionControl } from "./components/appVersionControl";
-export { default as Image } from "./components/image";
-export { default as PisellDropSort } from "./components/pisellDropSort";
-export { default as PisellNavigationMenu } from "./components/pisellNavigationMenu";
-export { default as PisellAppCard } from "./components/pisellAppCard";
-export { default as BaseTranslation } from "./components/dataSourceComponents/fields/Translation/BaseTranslation";
-export { default as PisellCustomCheckboxGroup } from "./components/pisellCustomCheckboxGroup";
+export { default as Keyboard } from "./components/keyboard";
+export { default as VirtualInput } from "./components/virtualInput";
+
+// ==================== 其他组件 ====================
+// 其他特殊用途组件
+export { default as Component } from "./components/component";
 export { default as PisellDropdown } from "./components/pisellDropdown";
-export { default as PisellSectionHeaders } from "./components/pisellSectionHeaders";
+export { default as PisellFloatingPanel } from "./components/pisellFloatingPanel";
 export { default as PisellImageCarousels } from "./components/pisellImageCarousels";
 export { default as PisellHeaderProgressBar } from "./components/pisellHeaderProgressBar";
 export { default as PisellList01 } from "./components/pisellList01";
+export { default as PisellSectionHeaders } from "./components/pisellSectionHeaders";
 export { default as SectionFooters } from "./components/section-footers";
-export { default as ProductCard } from "./components/productCard";
-export { default as Collapse } from "./components/collapse";
-export { default as PisellGoodPassCard } from "./components/pisellGoodPassCard";
-export { default as Keyboard } from "./components/keyboard";
-export { default as VirtualInput } from "./components/virtualInput";
-export { default as AutoResizeText } from "./components/auto-resize-text";
-export { default as PisellBasicGrid } from "./components/PisellBasicGrid";
-export { default as PisellScrollView } from "./components/PisellScrollView";
-export { default as PisellSuperTabs } from "./components/PisellSuperTabs";
-export { default as TextCard } from "./components/PisellCards/components/TextCard";
-export { default as GraphicTextCard } from "./components/PisellCards/components/GraphicTextCard";
-export { default as MultilevelCard } from "./components/PisellCards/components/MultilevelCard";
-export { default as PisellImageCard } from "./components/PisellCards/components/PisellImageCard";
-export { default as PisellTabbar } from "./components/PisellTabbar";
-export { default as PisellTabbarTemplate1 } from "./components/PisellTabbar/template/Template1";
-export { default as PisellTabbar2 } from "./components/PisellTabbar2";
+export { default as ButtonGroupEdit } from "./components/buttonGroupEdit";
+export { default as ButtonGroupPreview } from "./components/buttonGroupPreview";
 
-//新增组件
-export { default as PisellDataSourceContainer } from "./components/pisellDataSourceContainer";
-export { default as PisellGridView } from "./components/pisellGridPro/GridView";
-export { default as PisellToolBar } from "./components/pisellGridPro/ToolBar";
-export { default as PisellGridPro } from "./components/pisellGridPro";
-export { default as PisellSort } from "./components/pisellSort";
-export { default as PisellFilter } from "./components/pisellFilter";
-export { default as PisellQuickFilter } from "./components/pisellQuickFilter";
+// ==================== 业务组件 ====================
+// 特定业务场景的组件
+export { default as LowCodePage } from "./components/lowCodePage";
+export { default as loginAndRegister } from "./components/login-and-register";
+export { default as OrganizationTenantSwitcher } from "./components/organizationTenantSwitcher";
+export { default as PublishVersionModal } from "./components/versionModal";
+export { default as AppVersionControl } from "./components/appVersionControl";
+
+// ==================== 配置与上下文 ====================
+// 全局配置和上下文相关
+export { default as PisellConfigProvider } from "./components/pisell-config-provider";
+export { default as PisellContext, globalConfig } from "./components/pisell-config-provider/context";
+export { default as usePisellConfig } from "./components/pisell-config-provider/hooks/usePisellConfig";

package/es/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;