zs_library 0.9.7 → 0.9.9

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

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
-import { ComponentRegistry, ContextMenuActionPayload, DesktopDndContextMenuProps, DndSortItem, DndPageItem, TypeConfigMap, DataTypeMenuConfigMap, PageTransition } from './types';
+import { BeforeRemoveHandler, ComponentRegistry, ContextMenuActionPayload, DesktopDndContextMenuProps, DndSortItem, DndPageItem, TypeConfigMap, DataTypeMenuConfigMap, PageTransition } from './types';
 import { Theme } from './themes';
 import { DesktopDndContextValue } from './contexts';
 /**
@@ -27,6 +27,8 @@ export interface DesktopDndProviderProps {
     typeConfigMap?: TypeConfigMap;
     /** 按 item dataType 配置自定义右键菜单项。 */
     dataTypeMenuConfigMap?: DataTypeMenuConfigMap;
+    /** 默认移除动作提交前的同步或异步拦截器。 */
+    onBeforeRemove?: BeforeRemoveHandler;
     /** 点击默认移除菜单项时的自定义回调。 */
     onRemoveClick?: (item: DndSortItem) => void;
     /** 右键菜单项被触发后的统一回调。 */
@@ -65,4 +67,4 @@ export interface DesktopDndProviderProps {
  *
  * 负责组装状态、配置和数据操作三个细粒度 context，并保持 useDesktopDnd 的兼容返回值。
  */
-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 declare const DesktopDndProvider: ({ pages: externalPages, onChange, iconSize, maxPages, mergeDwellTime, containerRef, typeConfigMap, dataTypeMenuConfigMap, onBeforeRemove, onRemoveClick, onContextMenuItemClick, contextMenuProps, theme: themeProp, noLetters, itemBuilder, itemBuilderAllowNull, itemIconBuilder, itemIconBuilderAllowNull, pagingDotBuilder, pagingDotsBuilder, pageTransition, extraItems, storageKey, componentRegistry, children, }: DesktopDndProviderProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
-import { ComponentRegistry, ContextMenuActionPayload, ContextMenuData, DesktopDndContextMenuProps, DndPageItem, DndSortItem, DragState, FolderModalState, PageTransition, SortItemUserConfig, TypeConfigMap, DataTypeMenuConfigMap } from '../types';
+import { BeforeRemoveHandler, ComponentRegistry, ContextMenuActionPayload, ContextMenuData, DesktopDndContextMenuProps, DndPageItem, DndSortItem, DragState, FolderModalState, PageTransition, SortItemUserConfig, TypeConfigMap, DataTypeMenuConfigMap } from '../types';
 import { Theme } from '../themes';
 import { DesktopNextI18nT, DesktopNextLanguage } from '../i18n';
 /** 桌面运行时状态，描述当前页面、拖拽、弹窗和右键菜单的即时状态。 */
@@ -46,6 +46,8 @@ export interface DesktopDndConfigContextValue {
     typeConfigMap?: TypeConfigMap;
     /** 按 item dataType 配置自定义右键菜单项。 */
     dataTypeMenuConfigMap?: DataTypeMenuConfigMap;
+    /** 默认移除动作提交前的同步或异步拦截器。 */
+    onBeforeRemove?: BeforeRemoveHandler;
     /** 点击默认移除菜单项时的自定义回调；未提供时直接移除 item。 */
     onRemoveClick?: (item: DndSortItem) => void;
     /** 右键菜单项被触发后的统一回调，包括移除、改尺寸和自定义菜单项。 */

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

@@ -47,7 +47,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, PageTransition, } from './types';
+export type { BeforeRemoveHandler, BeforeRemoveResult, 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

@@ -49,6 +49,8 @@ export interface FolderModalState {
     } | null;
 }
 export type PageTransition = "slide" | "cube" | "fade" | "zoom";
+export type BeforeRemoveResult = boolean | void;
+export type BeforeRemoveHandler<D = unknown> = (item: DndSortItem<D>) => BeforeRemoveResult | Promise<BeforeRemoveResult>;
 /** 组件 Props */
 export interface DesktopDndProps<D = any> {
     pages: DndPageItem<D>[];
@@ -64,6 +66,8 @@ export interface DesktopDndProps<D = any> {
     mergeDwellTime?: number;
     typeConfigMap?: TypeConfigMap;
     dataTypeMenuConfigMap?: DataTypeMenuConfigMap;
+    /** 在移除动画和数据提交前拦截；返回 false 或拒绝 Promise 时取消。 */
+    onBeforeRemove?: BeforeRemoveHandler<D>;
     onRemoveClick?: (item: DndSortItem<D>) => void;
     onContextMenuItemClick?: (item: DndSortItem<D>, payload: ContextMenuActionPayload) => void;
     contextMenuProps?: DesktopDndContextMenuProps;

package/dist/components/index.d.ts

@@ -38,7 +38,7 @@ export { DesktopDndProvider as DesktopNextProvider, useDesktopDnd as useDesktopN
 export { commonSizeConfigs as desktopNextCommonSizeConfigs, commonSizeConfigsArray as desktopNextCommonSizeConfigsArray, appDefaultConfig as desktopNextAppDefaultConfig, groupDefaultConfig as desktopNextGroupDefaultConfig, builtinConfigMap as desktopNextBuiltinConfigMap, getDefaultConfig as getDesktopNextDefaultConfig, getSizeConfig as getDesktopNextSizeConfig, getItemSize as getDesktopNextItemSize, getDataTypeMenuConfig as getDesktopNextDataTypeMenuConfig, } 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 { DesktopDndExtendedProps as DesktopNextProps, DesktopHandle as DesktopNextHandle, DesktopDndProviderProps as DesktopNextProviderProps, DesktopDndActionsContextValue as DesktopNextActionsContextValue, DesktopDndConfigContextValue as DesktopNextConfigContextValue, DesktopDndContextValue as DesktopNextContextValue, DesktopDndStateContextValue as DesktopNextStateContextValue, ContextMenuProps as DesktopNextContextMenuComponentProps, ContextMenuItemProps as DesktopNextContextMenuItemProps, ContextMenuSubMenuItemProps as DesktopNextContextMenuSubMenuItemProps, ContextMenuSizeMenuItemProps as DesktopNextContextMenuSizeMenuItemProps, ContextMenuHoverContextType as DesktopNextContextMenuHoverContextType, DockProps as DesktopNextDockProps, LaunchpadModalProps as DesktopNextLaunchpadModalProps, LaunchpadButtonProps as DesktopNextLaunchpadButtonProps, StackedIconProps as DesktopNextStackedIconProps, SearchBoxProps as DesktopNextSearchBoxProps, BaseModalFloatingControlsConfig as DesktopNextBaseModalFloatingControlsConfig, BaseModalProps as DesktopNextBaseModalProps, BaseDrawerProps as DesktopNextBaseDrawerProps, DndSortItem, DndPageItem, DndItemBaseData, SizeConfig, SortItemUserConfig, MenuItemConfig, DataTypeMenuConfigMap, SortItemDefaultConfig, TypeConfigMap, ContextMenuData, DesktopDndContextMenuProps as DesktopNextContextMenuProps, ContextMenuActionPayload, ContextMenuActionType, ListItem as DesktopNextListItem, SortItemBaseData as DesktopNextSortItemBaseData, SortItemBaseConfig as DesktopNextSortItemBaseConfig, ComponentRegistryEntry as DesktopNextComponentRegistryEntry, ComponentRegistry as DesktopNextComponentRegistry, PageTransition as DesktopNextPageTransition, DesktopNextLanguage, DesktopNextI18n, DesktopNextI18nResource, DesktopNextI18nT, } from './desktop-next';
+export type { DesktopDndExtendedProps as DesktopNextProps, DesktopHandle as DesktopNextHandle, DesktopDndProviderProps as DesktopNextProviderProps, DesktopDndActionsContextValue as DesktopNextActionsContextValue, DesktopDndConfigContextValue as DesktopNextConfigContextValue, DesktopDndContextValue as DesktopNextContextValue, DesktopDndStateContextValue as DesktopNextStateContextValue, ContextMenuProps as DesktopNextContextMenuComponentProps, ContextMenuItemProps as DesktopNextContextMenuItemProps, ContextMenuSubMenuItemProps as DesktopNextContextMenuSubMenuItemProps, ContextMenuSizeMenuItemProps as DesktopNextContextMenuSizeMenuItemProps, ContextMenuHoverContextType as DesktopNextContextMenuHoverContextType, DockProps as DesktopNextDockProps, LaunchpadModalProps as DesktopNextLaunchpadModalProps, LaunchpadButtonProps as DesktopNextLaunchpadButtonProps, StackedIconProps as DesktopNextStackedIconProps, SearchBoxProps as DesktopNextSearchBoxProps, BaseModalFloatingControlsConfig as DesktopNextBaseModalFloatingControlsConfig, BaseModalProps as DesktopNextBaseModalProps, BaseDrawerProps as DesktopNextBaseDrawerProps, DndSortItem, DndPageItem, DndItemBaseData, BeforeRemoveHandler, BeforeRemoveResult, SizeConfig, SortItemUserConfig, MenuItemConfig, DataTypeMenuConfigMap, SortItemDefaultConfig, TypeConfigMap, ContextMenuData, DesktopDndContextMenuProps as DesktopNextContextMenuProps, ContextMenuActionPayload, ContextMenuActionType, ListItem as DesktopNextListItem, SortItemBaseData as DesktopNextSortItemBaseData, SortItemBaseConfig as DesktopNextSortItemBaseConfig, ComponentRegistryEntry as DesktopNextComponentRegistryEntry, ComponentRegistry as DesktopNextComponentRegistry, PageTransition as DesktopNextPageTransition, DesktopNextLanguage, DesktopNextI18n, DesktopNextI18nResource, DesktopNextI18nT, } from './desktop-next';
 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';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { Desktop, DesktopSortable, DesktopAppItem, DesktopGroupItem, DesktopBaseModal, DesktopBaseDrawer, DesktopSortableConfigProvider, DesktopSortableStateProvider, getDesktopDefaultConfig, desktopThemeLight, desktopThemeDark, SortableUtils, DesktopNext, DesktopNextProvider, useDesktopNext, DesktopNextActionsProvider, DesktopNextConfigProvider, DesktopNextStateProvider, useDesktopNextActions, useDesktopNextConfig, useDesktopNextState, DesktopNextContextMenu, DesktopNextContextMenuItem, DesktopNextContextMenuSubMenuItem, DesktopNextContextMenuSizeSubMenuContent, DesktopNextContextMenuHoverContext, DesktopNextDock, DesktopNextLaunchpadModal, DesktopNextLaunchpadButton, DesktopNextStackedIcon, DesktopNextSearchBox, DesktopNextBaseModal, DesktopNextBaseDrawer, loadDesktopNextRemoteComponent, DesktopNextRemoteComponentErrorBoundary, mergeDesktopNextTheme, desktopNextCommonSizeConfigs, desktopNextCommonSizeConfigsArray, desktopNextAppDefaultConfig, desktopNextGroupDefaultConfig, desktopNextBuiltinConfigMap, getDesktopNextDefaultConfig, getDesktopNextSizeConfig, getDesktopNextItemSize, getDesktopNextDataTypeMenuConfig, desktopNextThemeLight, desktopNextThemeDark, desktopNextDefaultTheme, desktopNextThemes, DesktopDnd, desktopDndCommonSizeConfigs, desktopDndAppDefaultConfig, desktopDndGroupDefaultConfig, desktopDndBuiltinConfigMap, getDesktopDndDefaultConfig, getDesktopDndSizeConfig, getDesktopDndItemSize, Dock, DockDesktop, DockDesktopItem, DockMobile, DockMobileItem, useDockDesktopMouseX, MdEditor, Markdown, GeoMap, SimpleEditor, SimpleEditorViewer, useSimpleEditor, jsonToHtml, htmlToJson, EditorFormatConverter, PhotoWatermark, HtmlRenderer, availableTemplates, extractExifData, parseExifData, formatXiaomiLeicaExifData, } from './components';
 export { I18nProvider, ZsI18nProvider, } from './i18n/provider';
-export type { DesktopHandle, DesktopProps, DesktopAppItemProps, DesktopGroupItemProps, DesktopSortableProps, DesktopSortableConfigProviderProps, DesktopSortableStateProviderProps, DesktopBaseModalProps, DesktopBaseDrawerProps, DesktopSortItemBaseConfig, DesktopSortItemUserConfig, DesktopSortItemDefaultConfig, DesktopTypeConfigMap, DesktopSortItem, DesktopListItem, DesktopSortItemBaseData, DesktopTheme, DesktopNextProps, DesktopNextHandle, DesktopNextProviderProps, DesktopNextActionsContextValue, DesktopNextConfigContextValue, DesktopNextContextValue, DesktopNextStateContextValue, DesktopNextContextMenuProps, DesktopNextContextMenuComponentProps, DesktopNextContextMenuItemProps, DesktopNextContextMenuSubMenuItemProps, DesktopNextContextMenuSizeMenuItemProps, DesktopNextContextMenuHoverContextType, DesktopNextDockProps, DesktopNextLaunchpadModalProps, DesktopNextLaunchpadButtonProps, DesktopNextStackedIconProps, DesktopNextSearchBoxProps, DesktopNextBaseModalFloatingControlsConfig, DesktopNextBaseModalProps, DesktopNextBaseDrawerProps, DesktopNextTheme, DesktopNextThemeType, DesktopDndProps, DndSortItem, DndPageItem, DndItemBaseData, SizeConfig, SortItemUserConfig, MenuItemConfig, DataTypeMenuConfigMap, SortItemDefaultConfig, TypeConfigMap, ContextMenuData, DesktopDndContextMenuProps, ContextMenuActionPayload, ContextMenuActionType, DesktopNextListItem, DesktopNextSortItemBaseData, DesktopNextSortItemBaseConfig, DesktopNextComponentRegistryEntry, DesktopNextComponentRegistry, DesktopNextPageTransition, DesktopNextLanguage, DesktopNextI18n, DesktopNextI18nResource, DesktopNextI18nT, DockDesktopItemProps, DockMobileItemProps, SimpleEditorProps, SimpleEditorViewerProps, SimpleEditorFeatures, EditorOutputFormat, UseSimpleEditorProps, JSONContent, ExifData, ExifExtractResult, } from './components';
+export type { DesktopHandle, DesktopProps, DesktopAppItemProps, DesktopGroupItemProps, DesktopSortableProps, DesktopSortableConfigProviderProps, DesktopSortableStateProviderProps, DesktopBaseModalProps, DesktopBaseDrawerProps, DesktopSortItemBaseConfig, DesktopSortItemUserConfig, DesktopSortItemDefaultConfig, DesktopTypeConfigMap, DesktopSortItem, DesktopListItem, DesktopSortItemBaseData, DesktopTheme, DesktopNextProps, DesktopNextHandle, DesktopNextProviderProps, DesktopNextActionsContextValue, DesktopNextConfigContextValue, DesktopNextContextValue, DesktopNextStateContextValue, DesktopNextContextMenuProps, DesktopNextContextMenuComponentProps, DesktopNextContextMenuItemProps, DesktopNextContextMenuSubMenuItemProps, DesktopNextContextMenuSizeMenuItemProps, DesktopNextContextMenuHoverContextType, DesktopNextDockProps, DesktopNextLaunchpadModalProps, DesktopNextLaunchpadButtonProps, DesktopNextStackedIconProps, DesktopNextSearchBoxProps, DesktopNextBaseModalFloatingControlsConfig, DesktopNextBaseModalProps, DesktopNextBaseDrawerProps, DesktopNextTheme, DesktopNextThemeType, DesktopDndProps, DndSortItem, DndPageItem, DndItemBaseData, BeforeRemoveHandler, BeforeRemoveResult, SizeConfig, SortItemUserConfig, MenuItemConfig, DataTypeMenuConfigMap, SortItemDefaultConfig, TypeConfigMap, ContextMenuData, DesktopDndContextMenuProps, ContextMenuActionPayload, ContextMenuActionType, DesktopNextListItem, DesktopNextSortItemBaseData, DesktopNextSortItemBaseConfig, DesktopNextComponentRegistryEntry, DesktopNextComponentRegistry, DesktopNextPageTransition, DesktopNextLanguage, DesktopNextI18n, DesktopNextI18nResource, DesktopNextI18nT, DockDesktopItemProps, DockMobileItemProps, SimpleEditorProps, SimpleEditorViewerProps, SimpleEditorFeatures, EditorOutputFormat, UseSimpleEditorProps, JSONContent, ExifData, ExifExtractResult, } from './components';
 export type { ZsI18nProviderProps } from './i18n/provider';
 export type { ZsI18nContextValue, ZsI18nLanguage, ZsI18nResources, } from './i18n/context';
 import * as Components from "./components";