zs_library 0.5.3 → 0.6.0

package/dist/components/desktop/types.d.ts

@@ -1,36 +1,82 @@
-export interface SortItemBaseConfig {
-    /** 最大行数 default 2 */
-    maxRow?: number;
-    /** 最大列数 default 2 */
-    maxCol?: number;
-    /** 行数 */
-    row?: number;
+/** 尺寸配置项 */
+export interface SizeConfig {
+    /** 配置ID（可选，通常使用对象key作为ID） */
+    id?: string;
+    /** 显示名称 */
+    name: string;
     /** 列数 */
-    col?: number;
-    /** 允许设置大小 default true */
-    allowResize?: boolean;
-    /** 允许打开右键菜单 default true */
-    allowContextMenu?: boolean;
-    /** 允许显示分享按钮 default true */
-    allowShare?: boolean;
-    /** 允许显示删除按钮 default true */
-    allowDelete?: boolean;
-    /** 允许显示信息按钮 default true */
-    allowInfo?: boolean;
+    col: number;
+    /** 行数 */
+    row: number;
+}
+/** 用户可配置的设置（会存储到用户数据中） */
+export interface SortItemUserConfig {
+    /** 尺寸配置ID */
+    sizeId?: string;
+}
+/** 菜单项配置 */
+export interface MenuItemConfig {
+    /** 菜单项文本 */
+    text: string;
+    /** 菜单项图标 */
+    icon?: React.ReactNode;
+    /** 菜单项颜色 */
+    color?: string;
+    /** 文本颜色 */
+    textColor?: string;
+    /** 点击回调 */
+    onClick?: (item: SortItem, contextActions: any) => void;
 }
+/** dataType菜单配置映射表 */
+export type DataTypeMenuConfigMap = Record<string, MenuItemConfig[]>;
+/** 系统默认配置（不会存储到用户数据中，防止篡改） */
+export interface SortItemDefaultConfig {
+    /** 可用的尺寸配置列表 */
+    sizeConfigs: SizeConfig[];
+    /** 默认尺寸配置ID */
+    defaultSizeId: string;
+    /** 允许设置大小 */
+    allowResize: boolean;
+    /** 允许打开右键菜单 */
+    allowContextMenu: boolean;
+    /** 允许显示分享按钮 */
+    allowShare: boolean;
+    /** 允许显示删除按钮 */
+    allowDelete: boolean;
+    /** 允许显示信息按钮 */
+    allowInfo: boolean;
+}
+/** 完整的配置接口（用户配置 + 系统默认配置） */
+export interface SortItemBaseConfig extends SortItemUserConfig, SortItemDefaultConfig {
+}
+/** 类型配置映射表 */
+export type TypeConfigMap = Record<string, SortItemDefaultConfig>;
 export interface SortItemBaseData {
     name: string;
     icon?: string;
 }
-export interface SortItem<D = any & SortItemBaseData, C = any & SortItemBaseConfig> {
+export interface SortItem<D = any & SortItemBaseData, C = any & SortItemUserConfig> {
     id: string | number;
-    type: "app" | "group";
-    data?: D;
-    config?: C;
-    children?: SortItem<D, C>[];
+    /** 项目类型，支持内置类型（app、group）和自定义类型 */
+    type: "app" | "group" | string;
+    data?: D & SortItemBaseData;
+    config?: C & SortItemUserConfig;
+    children?: SortItem<D & SortItemBaseData, C & SortItemUserConfig>[];
+    /** 区分数据类型：page表示分页数据，dock表示dock数据，string任意类型，关联自定义右键菜单项 */
+    dataType?: "page" | "dock" | string;
     /** 下面的参数为组件内部处理时自动添加，不影响数据 */
     parentIds?: (string | number)[];
     /** groupItem 点击时的坐标，用于打开弹窗时从坐标处打开 */
     pageX?: number;
     pageY?: number;
 }
+/** List项目类型，只包含id、type、children三个属性 */
+export interface ListItem<D = any & SortItemBaseData, C = any & SortItemUserConfig> {
+    id: string | number;
+    /** 区分数据类型：page表示分页数据，dock表示dock数据，string任意类型 */
+    type: "page" | "dock" | string;
+    children: SortItem<D & SortItemBaseData, C & SortItemUserConfig>[];
+}
+export type SortableItemData = SortItem;
+export type DesktopSizeConfig = SizeConfig;
+export type DesktopTypeConfigMap = TypeConfigMap;

package/dist/components/desktop/{utils.d.ts → utils/index.d.ts}

@@ -1,7 +1,8 @@
-import { SortItem } from './types';
 declare class SortableUtils {
     /** 清理重复id */
-    static uniqueArray: (array: SortItem[]) => SortItem<any, any>[];
+    static uniqueArray: <T extends {
+        id: string | number;
+    }>(array: T[]) => T[];
     static quickJSONCheck: (str: any) => boolean;
 }
 export default SortableUtils;

package/dist/components/desktop/utils/render-icon.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+import { SortItem } from '../types';
+/**
+ * 渲染图标的通用函数
+ * @param item 排序项数据
+ * @param icon 外部传入的图标（优先级最高）
+ * @param configItemIconBuilder 配置中的图标构建器
+ * @returns 渲染的图标元素
+ */
+export declare const renderIcon: <D, C>(item: SortItem<D, C>, icon?: React.ReactNode, configItemIconBuilder?: ((item: SortItem<D, C>) => React.ReactNode) | React.ReactNode) => React.ReactNode;

package/dist/components/dock/dock-desktop.d.ts

@@ -1,4 +1,4 @@
-import { HTMLMotionProps, MotionValue } from 'framer-motion';
+import { HTMLMotionProps, MotionValue } from 'motion/react';
 import { ElementType, FC, ReactNode } from 'react';
 import { DockItem } from '.';
 export interface DesktopIconContainerProps extends DockItem, Partial<Omit<HTMLMotionProps<"div">, "title" | "children">> {

package/dist/components/dock/dock-mobile.d.ts

@@ -1,5 +1,5 @@
 import { FC, ReactNode } from 'react';
-import { HTMLMotionProps } from 'framer-motion';
+import { HTMLMotionProps } from 'motion/react';
 import { DockItem } from '.';
 export interface MobileIconContainerProps extends DockItem, Partial<Omit<HTMLMotionProps<"div">, "title" | "children">> {
     index: number;

package/dist/components/dock/index.d.ts

@@ -1,7 +1,7 @@
 import { FC, ReactNode } from 'react';
 import { default as DockDesktop, DesktopIconContainer } from './dock-desktop';
 import { default as DockMobile, DockMobileProps, MobileIconContainer } from './dock-mobile';
-import { MotionValue } from 'framer-motion';
+import { MotionValue } from 'motion/react';
 export interface DockItem {
     icon?: ReactNode;
     title?: string;

package/dist/components/editor/type.d.ts

@@ -20,11 +20,6 @@ export interface EditorUploadImageProps {
      * @default file
      */
     name?: string;
-    /**
-     * 上传请求时是否携带 cookie
-     * @default false
-     */
-    withCredentials?: boolean;
     /**
      * 上传文件之前的钩子，参数为上传的文件，若返回 false 停止上传
      * @param file
@@ -46,7 +41,12 @@ export interface EditorUploadImageProps {
     /**
      * 上传图片失败后的回调
      */
-    onError?: (e: Error) => void;
+    onError?: (e: Error) => void; /**
+     * 完全自定义的上传函数，相当于 fetch 的 Promise
+     * @param file 要上传的文件
+     * @returns Promise，resolve时返回响应数据（可以是Response对象、URL字符串或包含url字段的对象）
+     */
+    customUploadFn?: (file: File) => Promise<any>;
 }
 export interface EditorProps {
     className?: string;

package/dist/components/editor/ui/button.d.ts

@@ -2,7 +2,7 @@ import { VariantProps } from 'class-variance-authority';
 import * as React from "react";
 declare const buttonVariants: (props?: ({
     variant?: "link" | "outline" | "default" | "destructive" | "secondary" | "ghost" | null | undefined;
-    size?: "default" | "icon" | "sm" | "lg" | null | undefined;
+    size?: "icon" | "default" | "sm" | "lg" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
     asChild?: boolean;

package/dist/components/index.d.ts

@@ -10,17 +10,19 @@ export { SortableConfigProvider as DesktopSortableConfigProvider } from './deskt
 export type { SortableConfigProviderProps as DesktopSortableConfigProviderProps } from './desktop/context/config/context';
 export { SortableStateProvider as DesktopSortableStateProvider } from './desktop/context/state/context';
 export type { SortableStateProviderProps as DesktopSortableStateProviderProps } from './desktop/context/state/context';
-export { appConfig as desktopAppConfig, groupConfig as desktopGroupConfig, configMap as desktopConfigMap, } from './desktop/config';
-export type { SortItemBaseConfig as DesktopSortItemBaseConfig, SortItem as DesktopSortItem, SortItemBaseData as DesktopSortItemBaseData, } from './desktop/types';
-export { themeLight as desktopThemeLight, themeDark as desktopThemeDark, } from './desktop/theme';
-export type { Theme as DesktopTheme } from './desktop/theme';
+export { appDefaultConfig as desktopAppDefaultConfig, groupDefaultConfig as desktopGroupDefaultConfig, builtinConfigMap as desktopBuiltinConfigMap, getDefaultConfig as getDesktopDefaultConfig, } from './desktop/config';
+export type { SortItemBaseConfig as DesktopSortItemBaseConfig, SortItemUserConfig as DesktopSortItemUserConfig, SortItemDefaultConfig as DesktopSortItemDefaultConfig, SortItem as DesktopSortItem, SortItemBaseData as DesktopSortItemBaseData, TypeConfigMap as DesktopTypeConfigMap, } from './desktop/types';
+export { themeLight as desktopThemeLight, themeDark as desktopThemeDark, defaultTheme as desktopDefaultTheme, themes as desktopThemes, } from './desktop/themes';
+export type { Theme as DesktopTheme, ThemeType as DesktopThemeType } from './desktop/themes';
 export { default as SortableUtils } from './desktop/utils';
+export { Dock as DesktopDock, LaunchpadModal as DesktopLaunchpadModal, LaunchpadButton as DesktopLaunchpadButton, } from './desktop/dock';
+export type { DockProps as DesktopDockProps, LaunchpadModalProps as DesktopLaunchpadModalProps, LaunchpadButtonProps as DesktopLaunchpadButtonProps, } from './desktop/dock';
 export { default as MdEditor } from './md-editor';
 export { default as Markdown } from './md-editor/preview';
 export { default as Dock } from './dock';
-export { default as DockDesktop, DesktopIconContainer as DockDesktopItem, } from './dock/dock-desktop';
-export { default as DockMobile, MobileIconContainer as DockMobileItem, } from './dock/dock-mobile';
-export { useMotionValue as useDockDesktopMouseX } from 'framer-motion';
+export { default as DockDesktop, DesktopIconContainer as DockDesktopItem } from './dock/dock-desktop';
+export { default as DockMobile, MobileIconContainer as DockMobileItem } from './dock/dock-mobile';
+export { useMotionValue as useDockDesktopMouseX } from 'motion/react';
 export type { DesktopIconContainerProps as DockDesktopItemProps } from './dock/dock-desktop';
 export type { MobileIconContainerProps as DockMobileItemProps } from './dock/dock-mobile';
 export { default as Editor } from './editor';