zs_library 0.8.2 → 0.9.1

package/dist/components/desktop-next/hooks/use-grid-layout.d.ts

@@ -0,0 +1,11 @@
+export declare const useGridLayout: (iconSize: number, measureRef: React.RefObject<HTMLDivElement | null>) => {
+    getGridPosition: (index: number) => {
+        col: number;
+        row: number;
+    };
+    getIndexFromPosition: (x: number, y: number, containerRect: DOMRect) => number;
+    cols: number;
+    cellSize: number;
+    containerWidth: number;
+    gap: number;
+};

package/dist/components/desktop-next/index.d.ts

@@ -0,0 +1,39 @@
+import { default as React, JSX } from 'react';
+import { DesktopDndProps, DndSortItem, DndPageItem, ComponentRegistry } from './types';
+import { DockProps } from './dock';
+import { Theme } from './themes';
+export interface DesktopHandle {
+    pages: DndPageItem[];
+    currentPage: number;
+    setCurrentPage: (page: number) => void;
+}
+export interface DesktopDndExtendedProps<D = unknown> extends DesktopDndProps<D> {
+    dockProps?: DockProps;
+    theme?: Theme | "light" | "dark";
+    noLetters?: boolean;
+    storageKey?: string;
+    pageTransition?: import('./types').PageTransition;
+    itemBuilder?: (item: DndSortItem, index: number) => React.ReactNode | null;
+    itemBuilderAllowNull?: boolean;
+    itemIconBuilderAllowNull?: boolean;
+    pagingDotBuilder?: (index: number, isActive: boolean) => React.ReactNode;
+    pagingDotsBuilder?: (dots: React.ReactNode[]) => React.ReactNode;
+    extraItems?: DndSortItem[];
+    componentRegistry?: ComponentRegistry;
+}
+declare const DesktopDnd: <D = unknown>(props: DesktopDndExtendedProps<D> & {
+    ref?: React.ForwardedRef<DesktopHandle>;
+}) => JSX.Element;
+export default DesktopDnd;
+export type { DesktopDndProps, DndSortItem, DndPageItem, DndItemBaseData, SizeConfig, SortItemUserConfig, MenuItemConfig, DataTypeMenuConfigMap, SortItemDefaultConfig, TypeConfigMap, ContextMenuData, DesktopDndContextMenuProps, ContextMenuActionPayload, ContextMenuActionType, ListItem, SortItemBaseData, SortItemBaseConfig, ComponentRegistryEntry, ComponentRegistry, PageTransition, } from './types';
+export { loadRemoteComponent, RemoteComponentErrorBoundary } from './component-registry/remote-loader';
+export { appDefaultConfig, groupDefaultConfig, builtinConfigMap, getDefaultConfig, commonSizeConfigs, commonSizeConfigsArray, getSizeConfig, getItemSize, getDataTypeMenuConfig, } from './config';
+export type { Theme, ThemeType } from './themes';
+export { themeLight, themeDark, defaultTheme, themes, } from './themes';
+export { mergeTheme } from './themes/utils';
+export { Dock, LaunchpadModal, LaunchpadButton, StackedIcon, SearchBox } from './dock';
+export type { DockProps, LaunchpadModalProps, LaunchpadButtonProps, StackedIconProps } from './dock';
+export { BaseModal } from './modal';
+export type { BaseModalProps } from './modal';
+export { BaseDrawer } from './drawer';
+export type { BaseDrawerProps } from './drawer';

package/dist/components/desktop-next/items/folder-item.d.ts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+import { DndSortItem } from '../types';
+interface FolderItemProps {
+    item: DndSortItem;
+    onDragStart: (item: DndSortItem, clientX: number, clientY: number, pointerId: number, el: HTMLElement) => void;
+    onItemClick?: (item: DndSortItem) => void;
+    iconBuilder?: (item: DndSortItem) => React.ReactNode;
+    size?: {
+        col: number;
+        row: number;
+    };
+}
+declare const FolderItem: ({ item, onDragStart, iconBuilder, size, }: FolderItemProps) => import("react/jsx-runtime").JSX.Element;
+export default FolderItem;

package/dist/components/desktop-next/items/grid-item.d.ts

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+import { DndSortItem } from '../types';
+interface GridItemProps {
+    item: DndSortItem;
+    onDragStart: (item: DndSortItem, clientX: number, clientY: number, pointerId: number, el: HTMLElement) => void;
+    onItemClick?: (item: DndSortItem) => void;
+    iconBuilder?: (item: DndSortItem) => React.ReactNode;
+    size?: {
+        col: number;
+        row: number;
+    };
+    children?: React.ReactNode;
+    noLabel?: boolean;
+    iconSize?: number;
+}
+declare const _default: React.MemoExoticComponent<({ item, onDragStart, onItemClick, iconBuilder, size, children, noLabel, iconSize: iconSizeProp, }: GridItemProps) => import("react/jsx-runtime").JSX.Element>;
+export default _default;

package/dist/components/desktop-next/modal/base-modal.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode } from 'react';
+import { Theme } from '../themes';
+export interface BaseModalProps {
+    visible: boolean;
+    onClose: () => void;
+    title?: ReactNode;
+    children?: ReactNode;
+    width?: number;
+    mousePosition?: {
+        x: number;
+        y: number;
+    } | null;
+    destroyOnClose?: boolean;
+    closable?: boolean;
+    footer?: ReactNode;
+    className?: string;
+    rootClassName?: string;
+    contentClassName?: string;
+    disableMaxHeight?: boolean;
+    theme?: Theme;
+}
+declare const BaseModal: (props: BaseModalProps) => import("react/jsx-runtime").JSX.Element;
+export default BaseModal;

package/dist/components/desktop-next/modal/folder-modal.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+import { DndSortItem } from '../types';
+interface FolderModalProps {
+    iconBuilder?: (item: DndSortItem) => React.ReactNode;
+}
+declare const FolderModal: ({ iconBuilder }: FolderModalProps) => import("react/jsx-runtime").JSX.Element | null;
+export default FolderModal;

package/dist/components/desktop-next/modal/index.d.ts

@@ -0,0 +1,2 @@
+export { default as BaseModal } from './base-modal';
+export type { BaseModalProps } from './base-modal';

package/dist/components/desktop-next/themes/dark.d.ts

@@ -0,0 +1,2 @@
+import { Theme } from '.';
+export declare const themeDark: Theme;

package/dist/components/desktop-next/themes/index.d.ts

@@ -0,0 +1,125 @@
+import { themeDark } from './dark';
+import { themeLight } from './light';
+export interface BaseModalTheme {
+    mask?: {
+        backgroundColor?: string;
+        backdropFilter?: string;
+    };
+    content?: {
+        backgroundColor?: string;
+        backdropFilter?: string;
+        boxShadowColor?: string;
+        boxShadowBorderColor?: string;
+        borderColor?: string;
+        borderRadius?: string;
+    };
+    header?: {
+        textColor?: string;
+    };
+    scrollbar?: {
+        width?: string;
+        trackColor?: string;
+        thumbColor?: string;
+        thumbHoverColor?: string;
+        borderRadius?: string;
+    };
+}
+export interface DockTheme {
+    backgroundColor?: string;
+    borderColor?: string;
+    boxShadowColor?: string;
+    divider?: {
+        color?: string;
+    };
+    launchpad?: {
+        modal?: {
+            searchBox?: {
+                iconColor?: string;
+                iconFocusColor?: string;
+                backgroundColor?: string;
+                focusBackgroundColor?: string;
+                textColor?: string;
+                placeholderColor?: string;
+                shadowColor?: string;
+                clearButton?: {
+                    backgroundColor?: string;
+                    hoverBackgroundColor?: string;
+                    textColor?: string;
+                };
+            };
+        };
+        icon?: {
+            textColor?: string;
+            backgroundColor?: string;
+            borderColor?: string;
+            shadowColor?: string;
+            hoverGlowColor?: string;
+        };
+    };
+}
+export interface LaunchpadTheme {
+    button?: {
+        backgroundColor?: string;
+        subBackgroundColor?: string;
+        thirdBackgroundColor?: string;
+        borderColor?: string;
+        hoverBackgroundColor?: string;
+    };
+    modal?: BaseModalTheme;
+}
+export interface ContextMenuTheme {
+    textColor?: string;
+    activeColor?: string;
+    dangerColor?: string;
+    backgroundColor?: string;
+    shadowColor?: string;
+    boxShadowBorderColor?: string;
+    borderColor?: string;
+    backdropFilter?: string;
+}
+export interface ItemsTheme {
+    textColor?: string;
+    iconBackgroundColor?: string;
+    iconShadowColor?: string;
+    groupIconBackgroundColor?: string;
+    groupIconShadowColor?: string;
+    infoModalBackgroundColor?: string;
+    groupModal?: {
+        backgroundColor?: string;
+        title?: {
+            textColor?: string;
+            backgroundColor?: string;
+            hoverBackgroundColor?: string;
+            focusBackgroundColor?: string;
+            shadowColor?: string;
+            placeholderColor?: string;
+            selectionBackgroundColor?: string;
+        };
+    };
+}
+export interface BaseTheme {
+    hoverColor?: string;
+    dangerColor?: string;
+    backgroundColor?: string;
+    textColor?: string;
+    shadowColor?: string;
+    boxShadowBorderColor?: string;
+    borderColor?: string;
+    backdropFilter?: string;
+}
+export interface Theme {
+    token: {
+        base?: BaseTheme;
+        dock?: DockTheme;
+        modal?: BaseModalTheme;
+        contextMenu?: ContextMenuTheme;
+        items?: ItemsTheme;
+    };
+}
+export declare const defaultTheme: Theme;
+export declare const themes: {
+    light: Theme;
+    dark: Theme;
+};
+export type ThemeType = keyof typeof themes;
+export { themeLight, themeDark };

package/dist/components/desktop-next/themes/light.d.ts

@@ -0,0 +1,2 @@
+import { Theme } from '.';
+export declare const themeLight: Theme;

package/dist/components/desktop-next/themes/utils.d.ts

@@ -0,0 +1,2 @@
+import { Theme } from './index';
+export declare function mergeTheme(theme: Theme | "light" | "dark"): Theme;

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

@@ -0,0 +1,151 @@
+import { ReactNode } from 'react';
+/** 基础数据接口 */
+export interface DndItemBaseData {
+    name: string;
+    icon?: string;
+    iconColor?: string;
+}
+/** 桌面项 */
+export interface DndSortItem<D = any> {
+    id: string | number;
+    /** 项目类型: app 或 group(文件夹) */
+    type: "app" | "group" | string;
+    dataType?: string;
+    config?: SortItemUserConfig;
+    data?: D & DndItemBaseData;
+    children?: DndSortItem<D>[];
+}
+/** 分页数据 */
+export interface DndPageItem<D = any> {
+    id: string | number;
+    children: DndSortItem<D>[];
+}
+/** 拖拽状态 */
+export interface DragState {
+    activeId: string | number | null;
+    isDragging: boolean;
+    pointerPosition: {
+        x: number;
+        y: number;
+    } | null;
+    pointerOffset: {
+        x: number;
+        y: number;
+    } | null;
+    mergeTargetId: string | number | null;
+    dragSource: "main" | "folder" | null;
+    draggedItem: DndSortItem | null;
+    gapIndex: number;
+    sourcePageIndex: number;
+}
+/** 文件夹弹窗状态 */
+export interface FolderModalState {
+    openFolder: DndSortItem | null;
+    openPosition: {
+        x: number;
+        y: number;
+    } | null;
+}
+export type PageTransition = "slide" | "cube" | "fade" | "zoom";
+/** 组件 Props */
+export interface DesktopDndProps<D = any> {
+    pages: DndPageItem<D>[];
+    onChange: (pages: DndPageItem<D>[]) => void;
+    iconSize?: number;
+    onItemClick?: (item: DndSortItem<D>) => void;
+    itemIconBuilder?: (item: DndSortItem<D>) => React.ReactNode;
+    className?: string;
+    maxPages?: number;
+    mergeDwellTime?: number;
+    typeConfigMap?: TypeConfigMap;
+    dataTypeMenuConfigMap?: DataTypeMenuConfigMap;
+    onRemoveClick?: (item: DndSortItem<D>) => void;
+    onContextMenuItemClick?: (item: DndSortItem<D>, payload: ContextMenuActionPayload) => void;
+    contextMenuProps?: DesktopDndContextMenuProps;
+}
+export interface SizeConfig {
+    id?: string;
+    name: string;
+    col: number;
+    row: number;
+}
+export interface SortItemUserConfig {
+    sizeId?: string;
+    sourceId?: string;
+}
+export interface MenuItemConfig {
+    text: string;
+    icon?: ReactNode;
+    color?: string;
+    textColor?: string;
+    onClick?: (item: DndSortItem, contextActions: DesktopDndContextActions) => void;
+}
+export type DataTypeMenuConfigMap = Record<string, MenuItemConfig[]>;
+export interface SortItemDefaultConfig {
+    sizeConfigs?: SizeConfig[];
+    defaultSizeId?: string;
+    allowResize?: boolean;
+    allowContextMenu?: boolean;
+    allowShare?: boolean;
+    allowDelete?: boolean;
+    allowInfo?: boolean;
+}
+/** 完整的配置接口（用户配置 + 系统默认配置） */
+export interface SortItemBaseConfig extends SortItemUserConfig, SortItemDefaultConfig {
+}
+export interface SortItemBaseData {
+    name: string;
+    icon?: string;
+    iconColor?: string;
+}
+/** List项目类型，只包含id、type、children三个属性 */
+export interface ListItem<D = any> {
+    id: string | number;
+    /** 区分数据类型：page表示分页数据，dock表示dock数据，string任意类型 */
+    type: "page" | "dock" | string;
+    children: DndSortItem<D>[];
+}
+export interface ComponentRegistryEntry {
+    name: string;
+    sizeConfigs?: SizeConfig[];
+    defaultSizeId?: string;
+    allowResize?: boolean;
+    allowContextMenu?: boolean;
+    allowShare?: boolean;
+    allowDelete?: boolean;
+    allowInfo?: boolean;
+    component?: React.ComponentType<{
+        item: DndSortItem;
+    }>;
+    iconUrl?: string;
+    remoteUrl?: string;
+    meta?: Record<string, unknown>;
+}
+export type ComponentRegistry = Record<string, ComponentRegistryEntry>;
+export type SortableItemData = DndSortItem;
+export type DesktopSizeConfig = SizeConfig;
+export type DesktopTypeConfigMap = TypeConfigMap;
+export type TypeConfigMap = Record<string, SortItemDefaultConfig>;
+export interface ContextMenuData {
+    rect: DOMRect;
+    data: DndSortItem;
+    pageX?: number;
+    pageY?: number;
+    element?: Element | null;
+}
+export interface DesktopDndContextActions {
+    setContextMenu: (data: ContextMenuData | null) => void;
+    hideContextMenu: () => void;
+    removeItem: (itemId: string | number) => void;
+    updateItemConfig: (itemId: string | number, config: SortItemUserConfig) => void;
+}
+export interface DesktopDndContextMenuProps {
+    showRemoveButton?: boolean;
+    showSizeButton?: boolean;
+}
+export type ContextMenuActionType = "remove" | "resize" | "custom";
+export interface ContextMenuActionPayload {
+    actionType: ContextMenuActionType;
+    menuItem?: MenuItemConfig;
+    sizeConfig?: SizeConfig;
+}

package/dist/components/desktop-next/utils/pinyin.d.ts

@@ -0,0 +1 @@
+export declare function getGroupLetter(name: string): string;

package/dist/components/desktop-next/utils/shatter-effect.d.ts

@@ -0,0 +1 @@
+export declare function playShatterEffect(element: Element): Promise<void>;

package/dist/components/index.d.ts

@@ -33,5 +33,14 @@ export { default as GeoMap } from './map-view';
 export type { GeoMapProps } from './map-view';
 export { default as SimpleEditor, SimpleEditorViewer, useSimpleEditor, jsonToHtml, htmlToJson, EditorFormatConverter, } from './tiptap-editor/simple';
 export type { SimpleEditorProps, SimpleEditorViewerProps, SimpleEditorFeatures, EditorOutputFormat, UseSimpleEditorProps, JSONContent, } from './tiptap-editor/simple';
+export { default as DesktopNext } from './desktop-next';
+export { commonSizeConfigs as desktopNextCommonSizeConfigs, appDefaultConfig as desktopNextAppDefaultConfig, groupDefaultConfig as desktopNextGroupDefaultConfig, builtinConfigMap as desktopNextBuiltinConfigMap, getDefaultConfig as getDesktopNextDefaultConfig, getSizeConfig as getDesktopNextSizeConfig, getItemSize as getDesktopNextItemSize, } from './desktop-next/config';
+export { themeLight as desktopNextThemeLight, themeDark as desktopNextThemeDark, defaultTheme as desktopNextDefaultTheme, themes as desktopNextThemes, } from './desktop-next/themes';
+export type { Theme as DesktopNextTheme, ThemeType as DesktopNextThemeType, } from './desktop-next/themes';
+export type { DesktopDndProps as DesktopNextProps, DndSortItem, DndPageItem, DndItemBaseData, SizeConfig, SortItemUserConfig, MenuItemConfig, DataTypeMenuConfigMap, SortItemDefaultConfig, TypeConfigMap, ContextMenuData, DesktopDndContextMenuProps as DesktopNextContextMenuProps, ContextMenuActionPayload, ContextMenuActionType, } from './desktop-next/types';
+export { default as DesktopDnd } from './desktop-next';
+/** @deprecated Use desktopNextCommonSizeConfigs instead */
+export { commonSizeConfigs as desktopDndCommonSizeConfigs, appDefaultConfig as desktopDndAppDefaultConfig, groupDefaultConfig as desktopDndGroupDefaultConfig, builtinConfigMap as desktopDndBuiltinConfigMap, getDefaultConfig as getDesktopDndDefaultConfig, getSizeConfig as getDesktopDndSizeConfig, getItemSize as getDesktopDndItemSize, } from './desktop-next/config';
+export type { DesktopDndProps, DesktopDndContextMenuProps, } from './desktop-next/types';
 export { PhotoWatermark, availableTemplates, extractExifData, parseExifData, formatXiaomiLeicaExifData, HtmlRenderer, } from './photo-watermark';
 export type { ExifData, ExifExtractResult, WatermarkComponentProps as PhotoWatermarkProps, TemplateConfig, ExifParamsForm } from './photo-watermark';