zkit-ui 1.0.5 → 2.0.0

package/src/all.ts

@@ -0,0 +1,397 @@
+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 { configureZKit } from './config';
+export type { ZKitConfig, ZKitI18nConfig } from './config';
+export {
+  BUILTIN_I18N_LOCALES,
+  DEFAULT_I18N_LOCALE,
+  resolveBuiltinLocale,
+  resolveSystemBuiltinLocale,
+} from './i18n/locale';
+export type { BuiltinI18nLocale } from './i18n/locale';
+export { I18nProvider } from './i18n/I18nProvider';
+export { useI18n } from './i18n/useI18n';
+export type {
+  I18nContextValue,
+  I18nMessages,
+  I18nMissingKeyPolicy,
+  I18nTranslate,
+  I18nTranslateParams,
+} from './i18n/types';
+export { ZKitProvider } from './ZKitProvider';
+export type { ZKitProviderProps } from './ZKitProvider';
+export { ZKitCoreProvider } from './ZKitCoreProvider';
+export type { ZKitCoreProviderProps } from './ZKitCoreProvider';
+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';

package/src/config.ts

@@ -8,9 +8,9 @@ import type { I18nMessages, I18nMissingKeyPolicy } from './i18n/types';
 // 1) Theme：用于给所有组件提供默认 tokens（颜色等）
 // 2) i18n：用于给所有组件提供默认文案字典/缺失策略
 //
-// 推荐在应用启动时调用一次 configureComponentLib()（例如在 app entry），
+// 推荐在应用启动时调用一次 configureZKit()（例如在 app entry），
 // 这样即便业务侧没有包 Provider，组件库也能拿到一致的默认值。
-export type ComponentLibI18nConfig = {
+export type ZKitI18nConfig = {
   // locale 目前仅用于透传；组件内部可据此选择 key 前缀或做格式化扩展
   locale?: string;
   // messages 是 key -> 文案 的扁平字典，组件内部用 t(key) 获取
@@ -21,45 +21,45 @@ export type ComponentLibI18nConfig = {
   missingKeyPolicy?: I18nMissingKeyPolicy;
 };
 
-export type ComponentLibConfig = {
+export type ZKitConfig = {
   // theme 是“覆盖对象”，只需要传你要改的字段即可（未传字段回落到 defaultTheme）
   theme?: ThemeOverride;
-  i18n?: ComponentLibI18nConfig;
+  i18n?: ZKitI18nConfig;
 };
 
-let componentLibConfig: ComponentLibConfig = {};
+let zKitConfig: ZKitConfig = {};
 
 // 合并式更新：多次调用会按层级合并（不会把之前的 i18n 整块覆盖掉）
-export function configureComponentLib(next: ComponentLibConfig) {
-  componentLibConfig = {
-    ...componentLibConfig,
+export function configureZKit(next: ZKitConfig) {
+  zKitConfig = {
+    ...zKitConfig,
     ...next,
     i18n: {
-      ...componentLibConfig.i18n,
+      ...zKitConfig.i18n,
       ...next.i18n,
     },
   };
 }
 
-export function getComponentLibConfig(): ComponentLibConfig {
-  return componentLibConfig;
+export function getZKitConfig(): ZKitConfig {
+  return zKitConfig;
 }
 
 // getDefaultTheme 用于生成“当前有效的默认主题”：
 // - defaultTheme 作为组件库内置基线
-// - configureComponentLib({ theme }) 提供全局覆盖
+// - configureZKit({ theme }) 提供全局覆盖
 // - ThemeProvider({ theme }) 再做实例级覆盖（优先级更高）
 export function getDefaultTheme(): Theme {
-  return mergeTheme(defaultTheme, componentLibConfig.theme);
+  return mergeTheme(defaultTheme, zKitConfig.theme);
 }
 
 // getDefaultI18nConfig 用于生成“当前有效的默认 i18n 配置”：
-// - configureComponentLib({ i18n }) 可在应用启动时设定默认 locale/messages
+// - configureZKit({ i18n }) 可在应用启动时设定默认 locale/messages
 // - I18nProvider({ ... }) 可在局部覆盖（例如某个子树临时切换语言）
-export function getDefaultI18nConfig(): Required<ComponentLibI18nConfig> {
+export function getDefaultI18nConfig(): Required<ZKitI18nConfig> {
   return {
-    locale: componentLibConfig.i18n?.locale ?? resolveSystemBuiltinLocale(),
-    messages: componentLibConfig.i18n?.messages ?? {},
-    missingKeyPolicy: componentLibConfig.i18n?.missingKeyPolicy ?? 'key',
+    locale: zKitConfig.i18n?.locale ?? resolveSystemBuiltinLocale(),
+    messages: zKitConfig.i18n?.messages ?? {},
+    missingKeyPolicy: zKitConfig.i18n?.missingKeyPolicy ?? 'key',
   };
 }