zkit-ui 1.0.5 → 2.0.0

package/dist/index.js

@@ -1,62 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActionDialogProvider = exports.actionDialog = exports.ActionDialog = exports.ToastProvider = exports.toast = exports.PickerServiceProvider = exports.pickerService = exports.ComponentLibProvider = exports.useI18n = exports.I18nProvider = exports.resolveSystemBuiltinLocale = exports.resolveBuiltinLocale = exports.DEFAULT_I18N_LOCALE = exports.BUILTIN_I18N_LOCALES = exports.configureComponentLib = exports.useTheme = exports.ThemeProvider = exports.LinkedScroll = exports.RadioIndicator = exports.RadioGroup = exports.Radio = exports.SliderCaptcha = exports.Switch = exports.DatePicker = exports.AddressCascader = exports.WHEEL_VISIBLE_ITEMS = exports.WHEEL_VIEWPORT_HEIGHT = exports.WHEEL_ITEM_HEIGHT = exports.WHEEL_AREA_VERTICAL_INSET = exports.WHEEL_AREA_HEIGHT = exports.WheelColumn = exports.Picker = exports.BetweenTime = exports.AccordionTrigger = exports.AccordionItem = exports.AccordionIndicator = exports.AccordionContent = exports.Accordion = exports.SheetHeader = exports.SheetFooter = exports.SheetContent = exports.Sheet = exports.TextInputPrimitive = exports.TextInput = exports.Text = exports.CheckboxIndicator = exports.CheckboxGroup = exports.Checkbox = exports.LoadingSpinner = exports.Button = void 0;
-exports.ImagePreviewProvider = exports.ImagePreview = exports.imagePreview = exports.PermissionPurposeDialogProvider = exports.permissionPurposeDialog = exports.LoadingProvider = exports.loading = void 0;
-var index_1 = require("./ui/Button/index");
-Object.defineProperty(exports, "Button", { enumerable: true, get: function () { return index_1.Button; } });
-var index_2 = require("./ui/LoadingSpinner/index");
-Object.defineProperty(exports, "LoadingSpinner", { enumerable: true, get: function () { return index_2.LoadingSpinner; } });
-var index_3 = require("./ui/Checkbox/index");
-Object.defineProperty(exports, "Checkbox", { enumerable: true, get: function () { return index_3.Checkbox; } });
-Object.defineProperty(exports, "CheckboxGroup", { enumerable: true, get: function () { return index_3.CheckboxGroup; } });
-Object.defineProperty(exports, "CheckboxIndicator", { enumerable: true, get: function () { return index_3.CheckboxIndicator; } });
-var index_4 = require("./ui/Text/index");
-Object.defineProperty(exports, "Text", { enumerable: true, get: function () { return index_4.Text; } });
-var index_5 = require("./ui/TextInput/index");
-Object.defineProperty(exports, "TextInput", { enumerable: true, get: function () { return index_5.TextInput; } });
-Object.defineProperty(exports, "TextInputPrimitive", { enumerable: true, get: function () { return index_5.TextInputPrimitive; } });
-var index_6 = require("./ui/Sheet/index");
-Object.defineProperty(exports, "Sheet", { enumerable: true, get: function () { return index_6.Sheet; } });
-Object.defineProperty(exports, "SheetContent", { enumerable: true, get: function () { return index_6.SheetContent; } });
-Object.defineProperty(exports, "SheetFooter", { enumerable: true, get: function () { return index_6.SheetFooter; } });
-Object.defineProperty(exports, "SheetHeader", { enumerable: true, get: function () { return index_6.SheetHeader; } });
-var index_7 = require("./ui/Accordion/index");
-Object.defineProperty(exports, "Accordion", { enumerable: true, get: function () { return index_7.Accordion; } });
-Object.defineProperty(exports, "AccordionContent", { enumerable: true, get: function () { return index_7.AccordionContent; } });
-Object.defineProperty(exports, "AccordionIndicator", { enumerable: true, get: function () { return index_7.AccordionIndicator; } });
-Object.defineProperty(exports, "AccordionItem", { enumerable: true, get: function () { return index_7.AccordionItem; } });
-Object.defineProperty(exports, "AccordionTrigger", { enumerable: true, get: function () { return index_7.AccordionTrigger; } });
-var index_8 = require("./ui/BetweenTime/index");
-Object.defineProperty(exports, "BetweenTime", { enumerable: true, get: function () { return index_8.BetweenTime; } });
-var index_9 = require("./ui/Picker/index");
-Object.defineProperty(exports, "Picker", { enumerable: true, get: function () { return index_9.Picker; } });
-var index_10 = require("./ui/WheelColumn/index");
-Object.defineProperty(exports, "WheelColumn", { enumerable: true, get: function () { return index_10.WheelColumn; } });
-Object.defineProperty(exports, "WHEEL_AREA_HEIGHT", { enumerable: true, get: function () { return index_10.WHEEL_AREA_HEIGHT; } });
-Object.defineProperty(exports, "WHEEL_AREA_VERTICAL_INSET", { enumerable: true, get: function () { return index_10.WHEEL_AREA_VERTICAL_INSET; } });
-Object.defineProperty(exports, "WHEEL_ITEM_HEIGHT", { enumerable: true, get: function () { return index_10.WHEEL_ITEM_HEIGHT; } });
-Object.defineProperty(exports, "WHEEL_VIEWPORT_HEIGHT", { enumerable: true, get: function () { return index_10.WHEEL_VIEWPORT_HEIGHT; } });
-Object.defineProperty(exports, "WHEEL_VISIBLE_ITEMS", { enumerable: true, get: function () { return index_10.WHEEL_VISIBLE_ITEMS; } });
-var index_11 = require("./ui/AddressCascader/index");
-Object.defineProperty(exports, "AddressCascader", { enumerable: true, get: function () { return index_11.AddressCascader; } });
-var index_12 = require("./ui/DatePicker/index");
-Object.defineProperty(exports, "DatePicker", { enumerable: true, get: function () { return index_12.DatePicker; } });
-var index_13 = require("./ui/Switch/index");
-Object.defineProperty(exports, "Switch", { enumerable: true, get: function () { return index_13.Switch; } });
-var index_14 = require("./ui/SliderCaptcha/index");
-Object.defineProperty(exports, "SliderCaptcha", { enumerable: true, get: function () { return index_14.SliderCaptcha; } });
-var index_15 = require("./ui/Radio/index");
-Object.defineProperty(exports, "Radio", { enumerable: true, get: function () { return index_15.Radio; } });
-Object.defineProperty(exports, "RadioGroup", { enumerable: true, get: function () { return index_15.RadioGroup; } });
-Object.defineProperty(exports, "RadioIndicator", { enumerable: true, get: function () { return index_15.RadioIndicator; } });
-var index_16 = require("./ui/LinkedScroll/index");
-Object.defineProperty(exports, "LinkedScroll", { enumerable: true, get: function () { return index_16.LinkedScroll; } });
+exports.ZKitCoreProvider = exports.useI18n = exports.I18nProvider = exports.resolveSystemBuiltinLocale = exports.resolveBuiltinLocale = exports.DEFAULT_I18N_LOCALE = exports.BUILTIN_I18N_LOCALES = exports.configureZKit = exports.useTheme = exports.ThemeProvider = void 0;
 var ThemeProvider_1 = require("./theme/ThemeProvider");
 Object.defineProperty(exports, "ThemeProvider", { enumerable: true, get: function () { return ThemeProvider_1.ThemeProvider; } });
 var useTheme_1 = require("./theme/useTheme");
 Object.defineProperty(exports, "useTheme", { enumerable: true, get: function () { return useTheme_1.useTheme; } });
 var config_1 = require("./config");
-Object.defineProperty(exports, "configureComponentLib", { enumerable: true, get: function () { return config_1.configureComponentLib; } });
+Object.defineProperty(exports, "configureZKit", { enumerable: true, get: function () { return config_1.configureZKit; } });
 var locale_1 = require("./i18n/locale");
 Object.defineProperty(exports, "BUILTIN_I18N_LOCALES", { enumerable: true, get: function () { return locale_1.BUILTIN_I18N_LOCALES; } });
 Object.defineProperty(exports, "DEFAULT_I18N_LOCALE", { enumerable: true, get: function () { return locale_1.DEFAULT_I18N_LOCALE; } });
@@ -66,25 +16,5 @@ var I18nProvider_1 = require("./i18n/I18nProvider");
 Object.defineProperty(exports, "I18nProvider", { enumerable: true, get: function () { return I18nProvider_1.I18nProvider; } });
 var useI18n_1 = require("./i18n/useI18n");
 Object.defineProperty(exports, "useI18n", { enumerable: true, get: function () { return useI18n_1.useI18n; } });
-var ComponentLibProvider_1 = require("./ComponentLibProvider");
-Object.defineProperty(exports, "ComponentLibProvider", { enumerable: true, get: function () { return ComponentLibProvider_1.ComponentLibProvider; } });
-var index_17 = require("./services/PickerService/index");
-Object.defineProperty(exports, "pickerService", { enumerable: true, get: function () { return index_17.pickerService; } });
-Object.defineProperty(exports, "PickerServiceProvider", { enumerable: true, get: function () { return index_17.PickerServiceProvider; } });
-var index_18 = require("./services/CardToastService/index");
-Object.defineProperty(exports, "toast", { enumerable: true, get: function () { return index_18.toast; } });
-Object.defineProperty(exports, "ToastProvider", { enumerable: true, get: function () { return index_18.ToastProvider; } });
-var index_19 = require("./services/ActionDialogService/index");
-Object.defineProperty(exports, "ActionDialog", { enumerable: true, get: function () { return index_19.ActionDialog; } });
-Object.defineProperty(exports, "actionDialog", { enumerable: true, get: function () { return index_19.actionDialog; } });
-Object.defineProperty(exports, "ActionDialogProvider", { enumerable: true, get: function () { return index_19.ActionDialogProvider; } });
-var index_20 = require("./services/LoadingService/index");
-Object.defineProperty(exports, "loading", { enumerable: true, get: function () { return index_20.loading; } });
-Object.defineProperty(exports, "LoadingProvider", { enumerable: true, get: function () { return index_20.LoadingProvider; } });
-var index_21 = require("./services/PermissionPurposeDialogService/index");
-Object.defineProperty(exports, "permissionPurposeDialog", { enumerable: true, get: function () { return index_21.permissionPurposeDialog; } });
-Object.defineProperty(exports, "PermissionPurposeDialogProvider", { enumerable: true, get: function () { return index_21.PermissionPurposeDialogProvider; } });
-var index_22 = require("./services/ImagePreviewService/index");
-Object.defineProperty(exports, "imagePreview", { enumerable: true, get: function () { return index_22.imagePreview; } });
-Object.defineProperty(exports, "ImagePreview", { enumerable: true, get: function () { return index_22.ImagePreview; } });
-Object.defineProperty(exports, "ImagePreviewProvider", { enumerable: true, get: function () { return index_22.ImagePreviewProvider; } });
+var ZKitCoreProvider_1 = require("./ZKitCoreProvider");
+Object.defineProperty(exports, "ZKitCoreProvider", { enumerable: true, get: function () { return ZKitCoreProvider_1.ZKitCoreProvider; } });

package/dist/services/PermissionPurposeDialogService/index.d.ts

@@ -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' });
@@ -90,7 +90,7 @@ declare class PermissionPurposeDialogServiceClass {
 export declare const permissionPurposeDialog: PermissionPurposeDialogServiceClass;
 /**
  * 权限用途说明 Provider
- * @description 需要在应用根组件中包裹，已内置于 ComponentLibProvider
+ * @description 需要在应用根组件中包裹，已内置于 ZKitProvider
  */
 export declare function PermissionPurposeDialogProvider({ children }: {
     children: React.ReactNode;

package/dist/services/PermissionPurposeDialogService/index.js

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

package/dist/services/PickerService/index.d.ts

@@ -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' });
@@ -119,7 +119,7 @@ declare class PickerServiceClass {
 export declare const pickerService: PickerServiceClass;
 /**
  * 选择器服务 Provider
- * @description 需要在应用根组件中包裹，已内置于 ComponentLibProvider
+ * @description 需要在应用根组件中包裹，已内置于 ZKitProvider
  */
 export declare function PickerServiceProvider({ children }: {
     children: React.ReactNode;

package/dist/services/PickerService/index.js

@@ -41,7 +41,7 @@ const jsx_runtime_1 = require("react/jsx-runtime");
  * @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' });
@@ -129,7 +129,7 @@ const initialState = {
 };
 /**
  * 选择器服务 Provider
- * @description 需要在应用根组件中包裹，已内置于 ComponentLibProvider
+ * @description 需要在应用根组件中包裹，已内置于 ZKitProvider
  */
 function PickerServiceProvider({ children }) {
     const [state, setState] = React.useState(initialState);

package/dist/theme/ThemeProvider.js

@@ -51,7 +51,7 @@ function ThemeProvider({ baseTheme, theme, children }) {
     const value = React.useMemo(() => {
         // 优先级（低 -> 高）：
         // 1) defaultTheme
-        // 2) configureComponentLib({ theme })
+        // 2) configureZKit({ theme })
         // 3) ThemeProvider({ baseTheme })
         // 4) ThemeProvider({ theme })
         const finalTheme = (0, mergeTheme_1.mergeTheme)(baseTheme !== null && baseTheme !== void 0 ? baseTheme : (0, config_1.getDefaultTheme)(), theme);

package/package.json

@@ -1,11 +1,171 @@
 {
   "name": "zkit-ui",
-  "version": "1.0.5",
+  "version": "2.0.0",
   "private": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "source": "src/index.ts",
   "react-native": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "react-native": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./all": {
+      "types": "./dist/all.d.ts",
+      "react-native": "./dist/all.js",
+      "default": "./dist/all.js"
+    },
+    "./provider": {
+      "types": "./dist/ZKitProvider.d.ts",
+      "react-native": "./dist/ZKitProvider.js",
+      "default": "./dist/ZKitProvider.js"
+    },
+    "./core-provider": {
+      "types": "./dist/ZKitCoreProvider.d.ts",
+      "react-native": "./dist/ZKitCoreProvider.js",
+      "default": "./dist/ZKitCoreProvider.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "react-native": "./dist/config.js",
+      "default": "./dist/config.js"
+    },
+    "./theme/*": {
+      "types": "./dist/theme/*.d.ts",
+      "react-native": "./dist/theme/*.js",
+      "default": "./dist/theme/*.js"
+    },
+    "./i18n/locales": {
+      "types": "./dist/i18n/locales/index.d.ts",
+      "react-native": "./dist/i18n/locales/index.js",
+      "default": "./dist/i18n/locales/index.js"
+    },
+    "./i18n/locales/*": {
+      "types": "./dist/i18n/locales/*.d.ts",
+      "react-native": "./dist/i18n/locales/*.js",
+      "default": "./dist/i18n/locales/*.js"
+    },
+    "./i18n/*": {
+      "types": "./dist/i18n/*.d.ts",
+      "react-native": "./dist/i18n/*.js",
+      "default": "./dist/i18n/*.js"
+    },
+    "./accordion": {
+      "types": "./dist/ui/Accordion/index.d.ts",
+      "react-native": "./dist/ui/Accordion/index.js",
+      "default": "./dist/ui/Accordion/index.js"
+    },
+    "./address-cascader": {
+      "types": "./dist/ui/AddressCascader/index.d.ts",
+      "react-native": "./dist/ui/AddressCascader/index.js",
+      "default": "./dist/ui/AddressCascader/index.js"
+    },
+    "./between-time": {
+      "types": "./dist/ui/BetweenTime/index.d.ts",
+      "react-native": "./dist/ui/BetweenTime/index.js",
+      "default": "./dist/ui/BetweenTime/index.js"
+    },
+    "./button": {
+      "types": "./dist/ui/Button/index.d.ts",
+      "react-native": "./dist/ui/Button/index.js",
+      "default": "./dist/ui/Button/index.js"
+    },
+    "./checkbox": {
+      "types": "./dist/ui/Checkbox/index.d.ts",
+      "react-native": "./dist/ui/Checkbox/index.js",
+      "default": "./dist/ui/Checkbox/index.js"
+    },
+    "./date-picker": {
+      "types": "./dist/ui/DatePicker/index.d.ts",
+      "react-native": "./dist/ui/DatePicker/index.js",
+      "default": "./dist/ui/DatePicker/index.js"
+    },
+    "./linked-scroll": {
+      "types": "./dist/ui/LinkedScroll/index.d.ts",
+      "react-native": "./dist/ui/LinkedScroll/index.js",
+      "default": "./dist/ui/LinkedScroll/index.js"
+    },
+    "./loading-spinner": {
+      "types": "./dist/ui/LoadingSpinner/index.d.ts",
+      "react-native": "./dist/ui/LoadingSpinner/index.js",
+      "default": "./dist/ui/LoadingSpinner/index.js"
+    },
+    "./picker": {
+      "types": "./dist/ui/Picker/index.d.ts",
+      "react-native": "./dist/ui/Picker/index.js",
+      "default": "./dist/ui/Picker/index.js"
+    },
+    "./radio": {
+      "types": "./dist/ui/Radio/index.d.ts",
+      "react-native": "./dist/ui/Radio/index.js",
+      "default": "./dist/ui/Radio/index.js"
+    },
+    "./sheet": {
+      "types": "./dist/ui/Sheet/index.d.ts",
+      "react-native": "./dist/ui/Sheet/index.js",
+      "default": "./dist/ui/Sheet/index.js"
+    },
+    "./slider-captcha": {
+      "types": "./dist/ui/SliderCaptcha/index.d.ts",
+      "react-native": "./dist/ui/SliderCaptcha/index.js",
+      "default": "./dist/ui/SliderCaptcha/index.js"
+    },
+    "./switch": {
+      "types": "./dist/ui/Switch/index.d.ts",
+      "react-native": "./dist/ui/Switch/index.js",
+      "default": "./dist/ui/Switch/index.js"
+    },
+    "./text": {
+      "types": "./dist/ui/Text/index.d.ts",
+      "react-native": "./dist/ui/Text/index.js",
+      "default": "./dist/ui/Text/index.js"
+    },
+    "./text-input": {
+      "types": "./dist/ui/TextInput/index.d.ts",
+      "react-native": "./dist/ui/TextInput/index.js",
+      "default": "./dist/ui/TextInput/index.js"
+    },
+    "./wheel-column": {
+      "types": "./dist/ui/WheelColumn/index.d.ts",
+      "react-native": "./dist/ui/WheelColumn/index.js",
+      "default": "./dist/ui/WheelColumn/index.js"
+    },
+    "./action-dialog": {
+      "types": "./dist/services/ActionDialogService/index.d.ts",
+      "react-native": "./dist/services/ActionDialogService/index.js",
+      "default": "./dist/services/ActionDialogService/index.js"
+    },
+    "./image-preview": {
+      "types": "./dist/services/ImagePreviewService/index.d.ts",
+      "react-native": "./dist/services/ImagePreviewService/index.js",
+      "default": "./dist/services/ImagePreviewService/index.js"
+    },
+    "./loading": {
+      "types": "./dist/services/LoadingService/index.d.ts",
+      "react-native": "./dist/services/LoadingService/index.js",
+      "default": "./dist/services/LoadingService/index.js"
+    },
+    "./permission-purpose-dialog": {
+      "types": "./dist/services/PermissionPurposeDialogService/index.d.ts",
+      "react-native": "./dist/services/PermissionPurposeDialogService/index.js",
+      "default": "./dist/services/PermissionPurposeDialogService/index.js"
+    },
+    "./picker-service": {
+      "types": "./dist/services/PickerService/index.d.ts",
+      "react-native": "./dist/services/PickerService/index.js",
+      "default": "./dist/services/PickerService/index.js"
+    },
+    "./toast": {
+      "types": "./dist/services/CardToastService/index.d.ts",
+      "react-native": "./dist/services/CardToastService/index.js",
+      "default": "./dist/services/CardToastService/index.js"
+    },
+    "./assets/*": "./dist/assets/*",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Concur-max/zkit.git",
@@ -30,7 +190,7 @@
     "@vant/area-data": "^2.1.0",
     "dayjs": "^1.11.13",
     "react-native-toast-message": "^2.3.3",
-    "zkit-tools": "1.0.0"
+    "zkit-tools": "1.0.1"
   },
   "peerDependencies": {
     "@expo/vector-icons": "*",
@@ -70,6 +230,8 @@
   },
   "scripts": {
     "build": "node scripts/build.cjs",
+    "verify:entrypoints": "node scripts/verify-entrypoints.cjs",
+    "verify": "pnpm run build && pnpm run verify:entrypoints",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   }
 }

package/src/ZKitCoreProvider.tsx

@@ -0,0 +1,34 @@
+import type * as React from 'react';
+import { I18nProvider } from './i18n/I18nProvider';
+import type { I18nMessages, I18nMissingKeyPolicy } from './i18n/types';
+import { ThemeProvider } from './theme/ThemeProvider';
+import type { Theme, ThemeOverride } from './theme/types';
+
+export type ZKitCoreProviderProps = {
+  // baseTheme 用于传入完整主题作为基线（例如品牌主题）
+  baseTheme?: Theme;
+  // theme 用于对 baseTheme 做局部覆盖（例如只改 primary）
+  theme?: ThemeOverride;
+  locale?: string;
+  messages?: I18nMessages;
+  missingKeyPolicy?: I18nMissingKeyPolicy;
+  children: React.ReactNode;
+};
+
+// ZKitCoreProvider 只提供轻量核心上下文，不挂载任何全局浮层或选择器服务。
+export function ZKitCoreProvider({
+  baseTheme,
+  theme,
+  locale,
+  messages,
+  missingKeyPolicy,
+  children,
+}: ZKitCoreProviderProps) {
+  return (
+    <ThemeProvider baseTheme={baseTheme} theme={theme}>
+      <I18nProvider locale={locale} messages={messages} missingKeyPolicy={missingKeyPolicy}>
+        {children}
+      </I18nProvider>
+    </ThemeProvider>
+  );
+}

package/src/ZKitProvider.tsx

@@ -0,0 +1,48 @@
+import { ActionDialogProvider } from './services/ActionDialogService/index';
+import { ToastProvider } from './services/CardToastService/index';
+import { ImagePreviewProvider } from './services/ImagePreviewService/index';
+import { LoadingProvider, type LoadingDefaults } from './services/LoadingService/index';
+import { PermissionPurposeDialogProvider } from './services/PermissionPurposeDialogService/index';
+import { PickerServiceProvider } from './services/PickerService/index';
+import { ZKitCoreProvider, type ZKitCoreProviderProps } from './ZKitCoreProvider';
+
+export type ZKitProviderProps = ZKitCoreProviderProps & {
+  loading?: LoadingDefaults;
+};
+
+// ZKitProvider 是完整应用 Provider：
+// - 同时提供 Theme 与 i18n
+// - 挂载 Picker / Toast / Dialog / Loading / Permission / ImagePreview 等全局服务
+export function ZKitProvider({
+  baseTheme,
+  theme,
+  locale,
+  messages,
+  missingKeyPolicy,
+  loading,
+  children,
+}: ZKitProviderProps) {
+  return (
+    <ZKitCoreProvider
+      baseTheme={baseTheme}
+      theme={theme}
+      locale={locale}
+      messages={messages}
+      missingKeyPolicy={missingKeyPolicy}
+    >
+      <PickerServiceProvider>
+        <ToastProvider>
+          <ActionDialogProvider>
+            <LoadingProvider defaults={loading}>
+              <PermissionPurposeDialogProvider>
+                <ImagePreviewProvider>
+                  {children}
+                </ImagePreviewProvider>
+              </PermissionPurposeDialogProvider>
+            </LoadingProvider>
+          </ActionDialogProvider>
+        </ToastProvider>
+      </PickerServiceProvider>
+    </ZKitCoreProvider>
+  );
+}