zkit-ui 1.0.5 → 2.0.0

package/src/index.ts

@@ -1,248 +1,10 @@
-export { Button } from './ui/Button/index';
-export type {
-  ButtonBorder,
-  ButtonBorderStyle,
-  ButtonColors,
-  ButtonGradient,
-  ButtonGradientDirection,
-  ButtonGradientPoint,
-  ButtonIconPlacement,
-  ButtonLayout,
-  ButtonLoadingMode,
-  ButtonPressEffect,
-  ButtonProps,
-  ButtonRef,
-  ButtonShape,
-  ButtonShadow,
-  ButtonShadowConfig,
-  ButtonShadowSize,
-  ButtonSize,
-  ButtonTone,
-  ButtonVariant,
-} from './ui/Button/index';
-export { LoadingSpinner } from './ui/LoadingSpinner/index';
-export type { LoadingSpinnerProps } from './ui/LoadingSpinner/index';
-export { Checkbox, CheckboxGroup, CheckboxIndicator } from './ui/Checkbox/index';
-export type {
-  CheckboxCheckedState,
-  CheckboxColors,
-  CheckboxGroupAlign,
-  CheckboxGroupOrientation,
-  CheckboxGroupProps,
-  CheckboxIndicatorProps,
-  CheckboxLabelPlacement,
-  CheckboxLayout,
-  CheckboxProps,
-  CheckboxRef,
-  CheckboxShape,
-  CheckboxSize,
-  CheckboxSlotProps,
-  CheckboxTone,
-  CheckboxValue,
-  CheckboxVariant,
-} from './ui/Checkbox/index';
-export { Text } from './ui/Text/index';
-export type {
-  TextProps,
-  TextRef,
-  TextSize,
-  TextSizeValue,
-  TextTone,
-  TextTruncate,
-  TextVariant,
-  TextWeight,
-} from './ui/Text/index';
-export { TextInput, TextInputPrimitive } from './ui/TextInput/index';
-export type {
-  TextInputColors,
-  TextInputLayout,
-  TextInputPrimitiveProps,
-  TextInputPrimitiveRef,
-  TextInputProps,
-  TextInputRef,
-  TextInputSize,
-  TextInputStatus,
-  TextInputTone,
-  TextInputVariant,
-} from './ui/TextInput/index';
-export {
-  Sheet,
-  SheetContent,
-  SheetFooter,
-  SheetHeader,
-} from './ui/Sheet/index';
-export type {
-  SheetAnimationConfig,
-  SheetBackdropConfig,
-  SheetCloseCompleteDetails,
-  SheetCloseOptions,
-  SheetCloseReason,
-  SheetContentProps,
-  SheetDetent,
-  SheetDetentChangePayload,
-  SheetFooterProps,
-  SheetHandleConfig,
-  SheetHeaderProps,
-  SheetNativeProps,
-  SheetOpenChangeDetails,
-  SheetOpenChangeReason,
-  SheetOpenCompleteDetails,
-  SheetOpenOptions,
-  SheetOpenReason,
-  SheetPlacement,
-  SheetProps,
-  SheetRef,
-  SheetRenderContext,
-  SheetSafeAreaEdges,
-  SheetSize,
-  SheetState,
-} from './ui/Sheet/index';
-export {
-  Accordion,
-  AccordionContent,
-  AccordionIndicator,
-  AccordionItem,
-  AccordionTrigger,
-} from './ui/Accordion/index';
-export type {
-  AccordionAnimationConfig,
-  AccordionContentProps,
-  AccordionIndicatorProps,
-  AccordionItemState,
-  AccordionItemProps,
-  AccordionMountStrategy,
-  AccordionMultipleProps,
-  AccordionPressEffect,
-  AccordionProps,
-  AccordionSingleProps,
-  AccordionSize,
-  AccordionSlot,
-  AccordionTone,
-  AccordionTriggerProps,
-  AccordionTriggerRenderState,
-  AccordionType,
-  AccordionValue,
-  AccordionVariant,
-} from './ui/Accordion/index';
-export { BetweenTime } from './ui/BetweenTime/index';
-export type { BetweenTimeProps } from './ui/BetweenTime/index';
-export { Picker } from './ui/Picker/index';
-export type {
-  PickerChangePayload,
-  PickerColumnHeaderContext,
-  PickerConfirmPayload,
-  PickerDraftChangePayload,
-  PickerHandle,
-  PickerOption,
-  PickerPrimitiveValue,
-  PickerProps,
-  PickerSelection,
-  PickerTriggerContext,
-  PickerValue,
-  PickerValueMode,
-} from './ui/Picker/index';
-export {
-  WheelColumn,
-  WHEEL_AREA_HEIGHT,
-  WHEEL_AREA_VERTICAL_INSET,
-  WHEEL_ITEM_HEIGHT,
-  WHEEL_VIEWPORT_HEIGHT,
-  WHEEL_VISIBLE_ITEMS,
-} from './ui/WheelColumn/index';
-export type {
-  WheelColumnChangePayload,
-  WheelColumnChangeSource,
-  WheelColumnHandle,
-  WheelColumnOption,
-  WheelColumnProps,
-  WheelColumnValue,
-  WheelOption,
-} from './ui/WheelColumn/index';
-export { AddressCascader } from './ui/AddressCascader/index';
-export type {
-  AddressCascaderChangePayload,
-  AddressCascaderConfirmPayload,
-  AddressCascaderHandle,
-  AddressCascaderOption,
-  AddressCascaderProps,
-  AddressCascaderRenderContext,
-  AddressCascaderValue,
-} from './ui/AddressCascader/index';
-export { DatePicker } from './ui/DatePicker/index';
-export type {
-  DatePickerChangePayload,
-  DatePickerColumn,
-  DatePickerColumnHeaderContext,
-  DatePickerConfirmPayload,
-  DatePickerDisableContext,
-  DatePickerDraftChangePayload,
-  DatePickerHandle,
-  DatePickerInput,
-  DatePickerLabelFormat,
-  DatePickerOption,
-  DatePickerParts,
-  DatePickerPrecision,
-  DatePickerProps,
-  DatePickerRenderContext,
-  DatePickerSelection,
-  DatePickerValue,
-} from './ui/DatePicker/index';
-export { Switch } from './ui/Switch/index';
-export type {
-  SwitchColors,
-  SwitchLabelPlacement,
-  SwitchLayout,
-  SwitchProps,
-  SwitchRef,
-  SwitchSize,
-  SwitchSlotProps,
-  SwitchStateText,
-  SwitchTone,
-} from './ui/Switch/index';
-export { SliderCaptcha } from './ui/SliderCaptcha/index';
-export type {
-  SliderCaptchaChallenge,
-  SliderCaptchaErrorInfo,
-  SliderCaptchaErrorStage,
-  SliderCaptchaLoadReason,
-  SliderCaptchaProps,
-  SliderCaptchaStatus,
-  SliderCaptchaTexts,
-  SliderCaptchaVerifyPayload,
-  SliderCaptchaVerifyResult,
-} from './ui/SliderCaptcha/index';
-export { Radio, RadioGroup, RadioIndicator } from './ui/Radio/index';
-export type {
-  RadioColors,
-  RadioGroupAlign,
-  RadioGroupOrientation,
-  RadioGroupProps,
-  RadioIndicatorProps,
-  RadioLabelPlacement,
-  RadioLayout,
-  RadioProps,
-  RadioRef,
-  RadioSize,
-  RadioSlotProps,
-  RadioTone,
-  RadioValue,
-  RadioVariant,
-} from './ui/Radio/index';
-export { LinkedScroll } from './ui/LinkedScroll/index';
-export type {
-  LinkedScrollChangeMeta,
-  LinkedScrollChangeSource,
-  LinkedScrollItem,
-  LinkedScrollMenuItemRenderContext,
-  LinkedScrollProps,
-  LinkedScrollSectionRenderContext,
-  LinkedScrollValue,
-} from './ui/LinkedScroll/index';
 export { ThemeProvider } from './theme/ThemeProvider';
 export { useTheme } from './theme/useTheme';
 export type { Theme, ThemeOverride } from './theme/types';
-export { configureComponentLib } from './config';
-export type { ComponentLibConfig, ComponentLibI18nConfig } from './config';
+
+export { configureZKit } from './config';
+export type { ZKitConfig, ZKitI18nConfig } from './config';
+
 export {
   BUILTIN_I18N_LOCALES,
   DEFAULT_I18N_LOCALE,
@@ -259,137 +21,6 @@ export type {
   I18nTranslate,
   I18nTranslateParams,
 } from './i18n/types';
-export { ComponentLibProvider } from './ComponentLibProvider';
-export type { ComponentLibProviderProps } from './ComponentLibProvider';
-export { pickerService, PickerServiceProvider } from './services/PickerService/index';
-export type {
-  AddressPickerResult,
-  BetweenTimePickerResult,
-  DatePickerResult,
-  PickOptions,
-  PickDateOptions,
-  PickAddressOptions,
-  PickBetweenTimeOptions,
-  PickerResult,
-} from './services/PickerService/index';
-export { toast, ToastProvider } from './services/CardToastService/index';
-export type {
-  ToastAction,
-  ToastActionContext,
-  ToastCustomOptions,
-  ToastDefaults,
-  ToastDismissReason,
-  ToastHandle,
-  ToastIconRenderContext,
-  ToastItem,
-  ToastOpenChangeMeta,
-  ToastOpenChangeReason,
-  ToastOptions,
-  ToastPlacement,
-  ToastProviderProps,
-  ToastRenderContext,
-  ToastService,
-  ToastShortcutOptions,
-  ToastStrategy,
-  ToastTone,
-  ToastUpdateOptions,
-} from './services/CardToastService/index';
-export { ActionDialog, actionDialog, ActionDialogProvider } from './services/ActionDialogService/index';
-export type {
-  ActionDialogAction,
-  ActionDialogActionContext,
-  ActionDialogActionPressResult,
-  ActionDialogActionResult,
-  ActionDialogActionRole,
-  ActionDialogActionTone,
-  ActionDialogActionVariant,
-  ActionDialogAlertOptions,
-  ActionDialogCollisionStrategy,
-  ActionDialogColors,
-  ActionDialogConfirmOptions,
-  ActionDialogDismissOptions,
-  ActionDialogDismissReason,
-  ActionDialogDismissResult,
-  ActionDialogFooterLayout,
-  ActionDialogFooterOptions,
-  ActionDialogFooterRenderContext,
-  ActionDialogHandle,
-  ActionDialogHostMode,
-  ActionDialogKeyboardOptions,
-  ActionDialogLabels,
-  ActionDialogLayerOptions,
-  ActionDialogLayoutOptions,
-  ActionDialogMotion,
-  ActionDialogOpenChangeMeta,
-  ActionDialogOpenChangeReason,
-  ActionDialogOpenOptions,
-  ActionDialogProps,
-  ActionDialogRef,
-  ActionDialogResolvedAction,
-  ActionDialogResolvedFooterLayout,
-  ActionDialogResult,
-  ActionDialogSemanticActionOptions,
-  ActionDialogService,
-  ActionDialogSnapshot,
-} from './services/ActionDialogService/index';
-export { loading, LoadingProvider } from './services/LoadingService/index';
-export type {
-  LoadingColors,
-  LoadingDefaults,
-  LoadingDismissReason,
-  LoadingHandle,
-  LoadingIconRenderContext,
-  LoadingInput,
-  LoadingItem,
-  LoadingLabels,
-  LoadingLiveRegion,
-  LoadingOpenChangeMeta,
-  LoadingOpenChangeReason,
-  LoadingPromiseErrorInput,
-  LoadingPromiseOptions,
-  LoadingPromiseResultInput,
-  LoadingProviderProps,
-  LoadingRenderContext,
-  LoadingResolvedDefaults,
-  LoadingResultInput,
-  LoadingResultOptions,
-  LoadingService,
-  LoadingShowOptions,
-  LoadingSnapshot,
-  LoadingStatus,
-  LoadingUpdateOptions,
-} from './services/LoadingService/index';
-export {
-  permissionPurposeDialog,
-  PermissionPurposeDialogProvider,
-} from './services/PermissionPurposeDialogService/index';
-export type {
-  PermissionPurpose,
-  PermissionPurposeDialogHandle,
-  PermissionPurposeDialogOptions,
-} from './services/PermissionPurposeDialogService/index';
-export { imagePreview, ImagePreview, ImagePreviewProvider } from './services/ImagePreviewService/index';
-export type {
-  ImagePreviewChangeMeta,
-  ImagePreviewChangeReason,
-  ImagePreviewCloseReason,
-  ImagePreviewColors,
-  ImagePreviewImage,
-  ImagePreviewImageDescriptor,
-  ImagePreviewImageProps,
-  ImagePreviewInteractions,
-  ImagePreviewLabels,
-  ImagePreviewOpenChangeMeta,
-  ImagePreviewOpenChangeReason,
-  ImagePreviewOpenOptions,
-  ImagePreviewPrefetchCachePolicy,
-  ImagePreviewProps,
-  ImagePreviewRef,
-  ImagePreviewRenderContext,
-  ImagePreviewResolvedImage,
-  ImagePreviewResult,
-  ImagePreviewServiceHandle,
-  ImagePreviewServiceSnapshot,
-  ImagePreviewSource,
-  ImagePreviewTapBehavior,
-} from './services/ImagePreviewService/index';
+
+export { ZKitCoreProvider } from './ZKitCoreProvider';
+export type { ZKitCoreProviderProps } from './ZKitCoreProvider';

package/src/services/ActionDialogService/README.md

@@ -5,7 +5,7 @@
 - `ActionDialog`：声明式组件，支持 `open/defaultOpen/onOpenChange`
 - `actionDialog`：全局命令式服务，适合路由守卫、请求确认、跨组件业务流程
 
-`ComponentLibProvider` 已内置 `ActionDialogProvider`；只有单独使用 `actionDialog` 服务时才需要确认 Provider 已挂载。
+`ZKitProvider` 已内置 `ActionDialogProvider`；只有单独使用 `actionDialog` 服务时才需要确认 Provider 已挂载。
 
 ## 设计取舍
 
@@ -22,7 +22,7 @@
 ## 声明式使用
 
 ```tsx
-import { ActionDialog } from 'zkit-ui';
+import { ActionDialog } from 'zkit-ui/action-dialog';
 
 <ActionDialog
   open={open}
@@ -39,7 +39,8 @@ import { ActionDialog } from 'zkit-ui';
 ## 命令式确认
 
 ```tsx
-import { actionDialog, loading } from 'zkit-ui';
+import { actionDialog } from 'zkit-ui/action-dialog';
+import { loading } from 'zkit-ui/loading';
 
 const confirmed = await actionDialog.confirm({
   title: '删除确认',

package/src/services/CardToastService/README.md

@@ -2,10 +2,10 @@
 
 全局卡片 Toast 服务，适合保存成功、网络失败、轻量操作反馈这类不应打断用户流程的提示。
 
-`ComponentLibProvider` 已内置 `ToastProvider`。如果单独接入，需要把 `ToastProvider` 放在应用根部。
+`ZKitProvider` 已内置 `ToastProvider`。如果单独接入，需要把 `ToastProvider` 放在应用根部。
 
 ```tsx
-import { ToastProvider } from 'zkit-ui';
+import { ToastProvider } from 'zkit-ui/toast';
 
 export function App() {
   return <ToastProvider>{/* app */}</ToastProvider>;
@@ -24,7 +24,7 @@ export function App() {
 ## 使用方式
 
 ```ts
-import { toast } from 'zkit-ui';
+import { toast } from 'zkit-ui/toast';
 
 toast.success('保存成功');
 toast.error('网络错误', {

package/src/services/ImagePreviewService/README.md

@@ -17,7 +17,7 @@
 ## 声明式用法
 
 ```tsx
-import { ImagePreview } from 'zkit-ui';
+import { ImagePreview } from 'zkit-ui/image-preview';
 
 <ImagePreview
   images={[
@@ -33,10 +33,10 @@ import { ImagePreview } from 'zkit-ui';
 
 ## 命令式用法
 
-`ComponentLibProvider` 已内置 `ImagePreviewProvider`。如果没有使用统一 Provider，需要在应用根部单独挂载。
+`ZKitProvider` 已内置 `ImagePreviewProvider`。如果没有使用统一 Provider，需要在应用根部单独挂载。
 
 ```tsx
-import { imagePreview } from 'zkit-ui';
+import { imagePreview } from 'zkit-ui/image-preview';
 
 const handle = imagePreview.open({
   images,

package/src/services/LoadingService/README.md

@@ -1,6 +1,6 @@
 # LoadingService
 
-全局加载 HUD 服务，用于短时阻塞、Promise 生命周期反馈和轻量结果态。`ComponentLibProvider` 已内置 `LoadingProvider`，普通业务入口只需要导入 `loading`。
+全局加载 HUD 服务，用于短时阻塞、Promise 生命周期反馈和轻量结果态。`ZKitProvider` 已内置 `LoadingProvider`，普通业务入口只需要导入 `loading`。
 
 ## 设计要点
 
@@ -9,12 +9,12 @@
 - `loading.promise()` 绑定异步任务，成功/失败结果只会更新当前仍活跃的 handle
 - `loading` 默认 15s 超时自动关闭，`success/error` 默认短暂停留后关闭
 - Android 不使用 `elevation` 或额外阴影层；iOS/Web 阴影跟随同一动画层，退出完成后卸载，避免残影
-- 默认文案来自 i18n，可通过 `ComponentLibProvider loading` 或 `LoadingProvider defaults` 覆盖
+- 默认文案来自 i18n，可通过 `ZKitProvider loading` 或 `LoadingProvider defaults` 覆盖
 
 ## 基础用法
 
 ```tsx
-import { loading } from 'zkit-ui';
+import { loading } from 'zkit-ui/loading';
 
 const handle = loading.show('正在保存');
 
@@ -88,7 +88,7 @@ loading.hide(); // 隐藏当前 HUD
 ## Provider 配置
 
 ```tsx
-<ComponentLibProvider
+<ZKitProvider
   loading={{
     loadingTimeout: 20000,
     successDuration: 1000,
@@ -104,7 +104,7 @@ loading.hide(); // 隐藏当前 HUD
   }}
 >
   <App />
-</ComponentLibProvider>
+</ZKitProvider>
 ```
 
 ## 关键类型

package/src/services/PermissionPurposeDialogService/README.md

@@ -4,16 +4,16 @@
 
 ## 前置条件
 
-确保应用根组件已包裹 `ComponentLibProvider`（已内置 `PermissionPurposeDialogProvider`）：
+确保应用根组件已包裹 `ZKitProvider`（已内置 `PermissionPurposeDialogProvider`）：
 
 ```tsx
-import { ComponentLibProvider } from 'zkit-ui';
+import { ZKitProvider } from 'zkit-ui/provider';
 
 export default function App() {
   return (
-    <ComponentLibProvider>
+    <ZKitProvider>
       {/* 你的应用内容 */}
-    </ComponentLibProvider>
+    </ZKitProvider>
   );
 }
 ```
@@ -21,7 +21,7 @@ export default function App() {
 ## 使用方式
 
 ```tsx
-import { permissionPurposeDialog } from 'zkit-ui';
+import { permissionPurposeDialog } from 'zkit-ui/permission-purpose-dialog';
 
 // 展示说明（与系统权限框同时出现）
 const purpose = permissionPurposeDialog.show({

package/src/services/PermissionPurposeDialogService/index.tsx

@@ -5,7 +5,7 @@
  *   支持按权限自动填充默认文案，也支持完全自定义。
  * @example
  * ```tsx
- * import { permissionPurposeDialog } from 'zkit-ui';
+ * import { permissionPurposeDialog } from 'zkit-ui/permission-purpose-dialog';
  *
  * // 展示说明
  * const purpose = permissionPurposeDialog.show({ permission: 'location' });
@@ -387,7 +387,7 @@ function PermissionPurposeCard({
 
 /**
  * 权限用途说明 Provider
- * @description 需要在应用根组件中包裹，已内置于 ComponentLibProvider
+ * @description 需要在应用根组件中包裹，已内置于 ZKitProvider
  */
 export function PermissionPurposeDialogProvider({ children }: { children: React.ReactNode }) {
   const [state, setState] = React.useState<PermissionPurposeDialogState>(initialState);

package/src/services/PickerService/README.md

@@ -4,16 +4,16 @@
 
 ## 前置条件
 
-确保应用根组件已包裹 `ComponentLibProvider`（已内置 `PickerServiceProvider`）：
+确保应用根组件已包裹 `ZKitProvider`（已内置 `PickerServiceProvider`）：
 
 ```tsx
-import { ComponentLibProvider } from 'zkit-ui';
+import { ZKitProvider } from 'zkit-ui/provider';
 
 export default function App() {
   return (
-    <ComponentLibProvider>
+    <ZKitProvider>
       {/* 你的应用内容 */}
-    </ComponentLibProvider>
+    </ZKitProvider>
   );
 }
 ```
@@ -21,7 +21,7 @@ export default function App() {
 ## 使用方式
 
 ```tsx
-import { pickerService } from 'zkit-ui';
+import { pickerService } from 'zkit-ui/picker-service';
 ```
 
 ### 通用选择器

package/src/services/PickerService/index.tsx

@@ -3,7 +3,7 @@
  * @description 提供 pick、pickDate、pickAddress、pickBetweenTime 等方法
  * @example
  * ```tsx
- * import { pickerService } from 'zkit-ui';
+ * import { pickerService } from 'zkit-ui/picker-service';
  *
  * const result = await pickerService.pick({ options: [...], value: 'id' });
  * const date = await pickerService.pickDate({ value: '2024-01-01' });
@@ -221,7 +221,7 @@ const initialState: PickerState = {
 
 /**
  * 选择器服务 Provider
- * @description 需要在应用根组件中包裹，已内置于 ComponentLibProvider
+ * @description 需要在应用根组件中包裹，已内置于 ZKitProvider
  */
 export function PickerServiceProvider({ children }: { children: React.ReactNode }) {
   const [state, setState] = React.useState<PickerState>(initialState);

package/src/theme/ThemeProvider.tsx

@@ -30,7 +30,7 @@ export function ThemeProvider({ baseTheme, theme, children }: ThemeProviderProps
   const value = React.useMemo(() => {
     // 优先级（低 -> 高）：
     // 1) defaultTheme
-    // 2) configureComponentLib({ theme })
+    // 2) configureZKit({ theme })
     // 3) ThemeProvider({ baseTheme })
     // 4) ThemeProvider({ theme })
     const finalTheme = mergeTheme(baseTheme ?? getDefaultTheme(), theme);

package/src/ui/Accordion/README.md

@@ -6,13 +6,13 @@
 
 ```tsx
 import * as React from 'react';
+import { Text } from 'zkit-ui/text';
 import {
   Accordion,
   AccordionContent,
   AccordionItem,
   AccordionTrigger,
-  Text,
-} from 'zkit-ui';
+} from 'zkit-ui/accordion';
 
 export function DemoAccordion() {
   const [value, setValue] = React.useState<string | null>('profile');

package/src/ui/AddressCascader/README.md

@@ -9,7 +9,8 @@ AddressCascader 是一个省/市/区（县）三级联动选择组件。
 ## 基础用法
 
 ```tsx
-import { AddressCascader, Button } from 'zkit-ui';
+import { AddressCascader } from 'zkit-ui/address-cascader';
+import { Button } from 'zkit-ui/button';
 
 export function Demo() {
   const [value, setValue] = React.useState(['110000', '110100', '110101']);
@@ -28,7 +29,8 @@ export function Demo() {
 `list` 的数据结构沿用 Picker 的树结构：每个节点包含 `value/text/children`。
 
 ```tsx
-import { AddressCascader, Button } from 'zkit-ui';
+import { AddressCascader } from 'zkit-ui/address-cascader';
+import { Button } from 'zkit-ui/button';
 
 const list = [
   {