zs_library 0.9.0 → 0.9.2

package/README.md

@@ -5,6 +5,31 @@
 
 个人业务组件库 React
 
+## 组件列表
+
+### 布局
+
+| 组件 | 说明 |
+| --- | --- |
+| `DesktopNext` | 基于 motion 实现的轻量级桌面组件，类似 iPadOS 桌面效果。支持拖拽排序、拖拽合并文件夹、多页分页、右键菜单、组件注册表、主题定制、布局持久化。**推荐使用** |
+| `Desktop` | 基于 react-sortablejs 封装实现的桌面组件，支持排序、文件夹、分页、本地存储、主题定制、右键菜单和 Dock 栏。**已废弃，请使用 DesktopNext** |
+| `Dock` | macOS / iOS 风格的 Dock 栏组件，支持桌面端（放大悬浮动效）和移动端两种模式 |
+
+### 数据录入
+
+| 组件 | 说明 |
+| --- | --- |
+| `SimpleEditor` | 基于 Tiptap 的富文本编辑器，支持常见文本格式、图片上传、AI 辅助写作、多种输出格式（HTML / JSON / Markdown）、受控模式 |
+| `MdEditor` | Markdown 编辑器，支持实时预览、图片上传、主题切换。**已废弃，请使用 SimpleEditor** |
+
+### 数据展示
+
+| 组件 | 说明 |
+| --- | --- |
+| `GeoMap` | 基于 react-map-gl 和 maplibre-gl 的中国地理地图组件，支持按缩放级别自动加载/卸载行政区划数据、自定义数据源 |
+| `Markdown` | Markdown 渲染组件，支持 GFM、代码高亮、图片预览、emoji |
+| `PhotoWatermark` | 基于 Canvas 的照片水印生成组件，支持多品牌相机风格、自动提取 EXIF 信息、Canvas/HTML 双渲染模式 |
+
 ## 编码规范
 
 参考 [Angular coding style guide](https://angular.dev/style-guide#file-structure-conventions)

package/dist/components/desktop/context-menu/index.d.ts

@@ -1,9 +1,10 @@
-import { SortItem } from '../types';
+import { SortItem, MenuItemConfig } from '../types';
 export interface ContextMenuProps<D, C> {
     showShareButton?: boolean;
     showInfoButton?: boolean;
     showRemoveButton?: boolean;
     showSizeButton?: boolean;
+    menuItems?: MenuItemConfig[];
     onShareClick?: (item: SortItem<D, C>) => void;
     onInfoClick?: (item: SortItem<D, C>) => void;
     onRemoveClick?: (item: SortItem<D, C>, remove: (id: string) => void) => void;

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

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
-import { ComponentRegistry, ContextMenuActionPayload, ContextMenuData, DesktopDndContextMenuProps, DndSortItem, DndPageItem, DragState, FolderModalState, SortItemUserConfig, TypeConfigMap, DataTypeMenuConfigMap } from './types';
+import { ComponentRegistry, ContextMenuActionPayload, ContextMenuData, DesktopDndContextMenuProps, DndSortItem, DndPageItem, DragState, FolderModalState, SortItemUserConfig, TypeConfigMap, DataTypeMenuConfigMap, PageTransition } from './types';
 import { Theme } from './themes';
 interface DesktopDndContextValue {
     pages: DndPageItem[];
@@ -34,6 +34,7 @@ interface DesktopDndContextValue {
     itemIconBuilderAllowNull?: boolean;
     pagingDotBuilder?: (index: number, isActive: boolean) => React.ReactNode;
     pagingDotsBuilder?: (dots: React.ReactNode[]) => React.ReactNode;
+    pageTransition?: PageTransition;
     extraItems?: DndSortItem[];
     componentRegistry?: ComponentRegistry;
     removeItem: (itemId: string | number) => void;
@@ -75,10 +76,11 @@ interface DesktopDndProviderProps {
     itemIconBuilderAllowNull?: boolean;
     pagingDotBuilder?: (index: number, isActive: boolean) => React.ReactNode;
     pagingDotsBuilder?: (dots: React.ReactNode[]) => React.ReactNode;
+    pageTransition?: PageTransition;
     extraItems?: DndSortItem[];
     storageKey?: string;
     componentRegistry?: ComponentRegistry;
     children: React.ReactNode;
 }
-export declare const DesktopDndProvider: ({ pages: externalPages, onChange, iconSize, maxPages, mergeDwellTime, containerRef, typeConfigMap, dataTypeMenuConfigMap, onRemoveClick, onContextMenuItemClick, contextMenuProps, theme: themeProp, noLetters, itemBuilder, itemBuilderAllowNull, itemIconBuilder, itemIconBuilderAllowNull, pagingDotBuilder, pagingDotsBuilder, extraItems, storageKey, componentRegistry, children, }: DesktopDndProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DesktopDndProvider: ({ pages: externalPages, onChange, iconSize, maxPages, mergeDwellTime, containerRef, typeConfigMap, dataTypeMenuConfigMap, onRemoveClick, onContextMenuItemClick, contextMenuProps, theme: themeProp, noLetters, itemBuilder, itemBuilderAllowNull, itemIconBuilder, itemIconBuilderAllowNull, pagingDotBuilder, pagingDotsBuilder, pageTransition, extraItems, storageKey, componentRegistry, children, }: DesktopDndProviderProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -12,6 +12,7 @@ export interface DesktopDndExtendedProps<D = unknown> extends DesktopDndProps<D>
     theme?: Theme | "light" | "dark";
     noLetters?: boolean;
     storageKey?: string;
+    pageTransition?: import('./types').PageTransition;
     itemBuilder?: (item: DndSortItem, index: number) => React.ReactNode | null;
     itemBuilderAllowNull?: boolean;
     itemIconBuilderAllowNull?: boolean;
@@ -24,7 +25,7 @@ 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, } from './types';
+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';

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

@@ -9,7 +9,7 @@ export interface DndItemBaseData {
 export interface DndSortItem<D = any> {
     id: string | number;
     /** 项目类型: app 或 group(文件夹) */
-    type: "app" | "group";
+    type: "app" | "group" | string;
     dataType?: string;
     config?: SortItemUserConfig;
     data?: D & DndItemBaseData;
@@ -46,6 +46,7 @@ export interface FolderModalState {
         y: number;
     } | null;
 }
+export type PageTransition = "slide" | "cube" | "fade" | "zoom";
 /** 组件 Props */
 export interface DesktopDndProps<D = any> {
     pages: DndPageItem<D>[];