zkit-ui 1.0.0

package/ios/ZKitWheelPicker.mm

@@ -0,0 +1,230 @@
+#import "ZKitWheelPicker.h"
+
+#import <React/RCTConvert.h>
+#import <React/RCTUtils.h>
+
+#import "ZKitWheelPickerLabel.h"
+
+@interface ZKitWheelPicker() <UIPickerViewDataSource, UIPickerViewDelegate, UIPickerViewAccessibilityDelegate>
+@end
+
+@implementation ZKitWheelPicker
+
+static void ZKitStopDeceleratingScrollViews(UIView *view)
+{
+  for (UIView *subview in view.subviews) {
+    if ([subview isKindOfClass:[UIScrollView class]]) {
+      UIScrollView *scrollView = (UIScrollView *)subview;
+      [scrollView setContentOffset:scrollView.contentOffset animated:NO];
+      [scrollView.layer removeAllAnimations];
+    }
+
+    ZKitStopDeceleratingScrollViews(subview);
+  }
+}
+
+- (instancetype)initWithFrame:(CGRect)frame
+{
+  self = [super initWithFrame:frame];
+  if (!self) {
+    return nil;
+  }
+
+  _items = @[];
+  _selectedIndex = NSNotFound;
+  _color = [UIColor blackColor];
+  _font = [UIFont systemFontOfSize:21 weight:UIFontWeightRegular];
+  _rowHeight = 0;
+  _numberOfLines = 1;
+
+  self.delegate = self;
+  self.dataSource = self;
+
+  // 保持系统中间选中指示线稳定显示。
+  [self selectRow:0 inComponent:0 animated:YES];
+
+  return self;
+}
+
+RCT_NOT_IMPLEMENTED(- (instancetype)initWithCoder:(NSCoder *)coder)
+
+- (void)setItems:(NSArray<NSDictionary *> *)items
+{
+  _items = [items copy] ?: @[];
+  [self reloadAllComponents];
+  [self setNeedsLayout];
+
+  if (_items.count == 0) {
+    return;
+  }
+
+  NSInteger targetIndex = _selectedIndex == NSNotFound ? 0 : _selectedIndex;
+  targetIndex = MAX(0, MIN(targetIndex, (NSInteger)_items.count - 1));
+  _selectedIndex = targetIndex;
+
+  dispatch_async(dispatch_get_main_queue(), ^{
+    [self selectRow:targetIndex inComponent:0 animated:NO];
+  });
+}
+
+- (void)setSelectedIndex:(NSInteger)selectedIndex
+{
+  if (_selectedIndex == selectedIndex) {
+    return;
+  }
+
+  NSInteger previousIndex = _selectedIndex;
+  _selectedIndex = selectedIndex;
+
+  if (_items.count == 0) {
+    return;
+  }
+
+  NSInteger targetIndex = MAX(0, MIN(selectedIndex, (NSInteger)_items.count - 1));
+  BOOL animated = previousIndex != NSNotFound;
+
+  dispatch_async(dispatch_get_main_queue(), ^{
+    [self selectRow:targetIndex inComponent:0 animated:animated];
+  });
+}
+
+- (void)setColor:(UIColor *)color
+{
+  _color = color ?: [UIColor blackColor];
+  [self reloadAllComponents];
+  [self setNeedsLayout];
+}
+
+- (void)setFont:(UIFont *)font
+{
+  _font = font ?: [UIFont systemFontOfSize:21 weight:UIFontWeightRegular];
+  [self reloadAllComponents];
+  [self setNeedsLayout];
+}
+
+- (void)setRowHeight:(CGFloat)rowHeight
+{
+  if (_rowHeight == rowHeight) {
+    return;
+  }
+
+  _rowHeight = rowHeight;
+  [self reloadAllComponents];
+  [self setNeedsLayout];
+}
+
+- (void)setNumberOfLines:(NSInteger)numberOfLines
+{
+  _numberOfLines = MAX(1, numberOfLines);
+  [self reloadAllComponents];
+  [self setNeedsLayout];
+}
+
+- (void)syncCurrentSelection
+{
+  if (_items.count == 0) {
+    return;
+  }
+
+  ZKitStopDeceleratingScrollViews(self);
+  [self layoutIfNeeded];
+
+  dispatch_async(dispatch_get_main_queue(), ^{
+    NSInteger row = [self selectedRowInComponent:0];
+    if (row < 0) {
+      row = self->_selectedIndex != NSNotFound ? self->_selectedIndex : 0;
+    }
+
+    row = MAX(0, MIN(row, (NSInteger)self->_items.count - 1));
+    [self selectRow:row inComponent:0 animated:NO];
+    [self pickerView:self didSelectRow:row inComponent:0];
+  });
+}
+
+- (NSInteger)numberOfComponentsInPickerView:(__unused UIPickerView *)pickerView
+{
+  return 1;
+}
+
+- (NSInteger)pickerView:(__unused UIPickerView *)pickerView numberOfRowsInComponent:(__unused NSInteger)component
+{
+  return _items.count;
+}
+
+- (NSString *)pickerView:(__unused UIPickerView *)pickerView
+             titleForRow:(NSInteger)row
+            forComponent:(__unused NSInteger)component
+{
+  if (row < 0 || row >= (NSInteger)_items.count) {
+    return @"";
+  }
+
+  return [RCTConvert NSString:_items[row][@"label"]] ?: @"";
+}
+
+- (CGFloat)pickerView:(__unused UIPickerView *)pickerView rowHeightForComponent:(__unused NSInteger)component
+{
+  if (_rowHeight > 0) {
+    return _rowHeight;
+  }
+
+  return (_font.lineHeight * MAX(1, _numberOfLines)) + 20.0;
+}
+
+- (UIView *)pickerView:(UIPickerView *)pickerView
+            viewForRow:(NSInteger)row
+          forComponent:(NSInteger)component
+           reusingView:(UIView *)view
+{
+  CGFloat rowHeight = [pickerView rowSizeForComponent:component].height;
+  CGFloat rowWidth = [pickerView rowSizeForComponent:component].width;
+
+  if (!view) {
+    view = [[UIView alloc] initWithFrame:CGRectZero];
+    ZKitWheelPickerLabel *label = [[ZKitWheelPickerLabel alloc] initWithFrame:CGRectZero];
+    [view insertSubview:label atIndex:0];
+  }
+
+  view.frame = CGRectMake(0, 0, rowWidth, rowHeight);
+
+  ZKitWheelPickerLabel *label = (ZKitWheelPickerLabel *)view.subviews.firstObject;
+  label.frame = CGRectMake(0, 0, rowWidth, rowHeight);
+  label.font = _font;
+  label.textColor = [RCTConvert UIColor:_items[row][@"textColor"]] ?: _color;
+  label.textAlignment = NSTextAlignmentCenter;
+  label.text = [self pickerView:pickerView titleForRow:row forComponent:component];
+  label.accessibilityIdentifier = _items[row][@"testID"];
+  label.numberOfLines = MAX(1, _numberOfLines);
+  label.lineBreakMode = NSLineBreakByTruncatingTail;
+  label.adjustsFontSizeToFitWidth = NO;
+  label.leftInset = 20.0;
+  label.rightInset = 20.0;
+
+  return view;
+}
+
+- (void)pickerView:(__unused UIPickerView *)pickerView
+      didSelectRow:(NSInteger)row
+       inComponent:(__unused NSInteger)component
+{
+  _selectedIndex = row;
+
+  if (_onChange && row >= 0 && row < (NSInteger)_items.count) {
+    _onChange(@{
+      @"newIndex": @(row),
+      @"newValue": RCTNullIfNil(_items[row][@"value"]),
+    });
+  }
+}
+
+- (NSString *)pickerView:(UIPickerView *)pickerView accessibilityLabelForComponent:(NSInteger)component
+{
+  return self.accessibilityLabel;
+}
+
+- (NSString *)pickerView:(UIPickerView *)pickerView accessibilityHintForComponent:(NSInteger)component
+{
+  return self.accessibilityHint;
+}
+
+@end

package/ios/ZKitWheelPickerLabel.h

@@ -0,0 +1,10 @@
+#import <UIKit/UIKit.h>
+
+@interface ZKitWheelPickerLabel : UILabel
+
+@property (nonatomic, assign) CGFloat topInset;
+@property (nonatomic, assign) CGFloat bottomInset;
+@property (nonatomic, assign) CGFloat leftInset;
+@property (nonatomic, assign) CGFloat rightInset;
+
+@end

package/ios/ZKitWheelPickerLabel.mm

@@ -0,0 +1,31 @@
+#import "ZKitWheelPickerLabel.h"
+
+@implementation ZKitWheelPickerLabel
+
+- (instancetype)initWithFrame:(CGRect)frame
+{
+  self = [super initWithFrame:frame];
+  if (self) {
+    self.topInset = 0.0;
+    self.bottomInset = 0.0;
+    self.leftInset = 0.0;
+    self.rightInset = 0.0;
+  }
+  return self;
+}
+
+- (void)drawTextInRect:(CGRect)rect
+{
+  UIEdgeInsets insets = UIEdgeInsetsMake(self.topInset, self.leftInset, self.bottomInset, self.rightInset);
+  [super drawTextInRect:UIEdgeInsetsInsetRect(rect, insets)];
+}
+
+- (CGSize)intrinsicContentSize
+{
+  CGSize intrinsicSize = [super intrinsicContentSize];
+  intrinsicSize.height += self.topInset + self.bottomInset;
+  intrinsicSize.width += self.leftInset + self.rightInset;
+  return intrinsicSize;
+}
+
+@end

package/ios/ZKitWheelPickerManager.h

@@ -0,0 +1,5 @@
+#import <React/RCTViewManager.h>
+
+@interface ZKitWheelPickerManager : RCTViewManager
+
+@end

package/ios/ZKitWheelPickerManager.mm

@@ -0,0 +1,53 @@
+#import "ZKitWheelPickerManager.h"
+
+#import <React/RCTBridge.h>
+#import <React/RCTFont.h>
+#import <React/RCTUIManager.h>
+
+#import "ZKitWheelPicker.h"
+
+@implementation ZKitWheelPickerManager
+
+RCT_EXPORT_MODULE(ZKitWheelPicker)
+
+- (UIView *)view
+{
+  return [ZKitWheelPicker new];
+}
+
+RCT_EXPORT_VIEW_PROPERTY(items, NSArray<NSDictionary *>)
+RCT_EXPORT_VIEW_PROPERTY(selectedIndex, NSInteger)
+RCT_EXPORT_VIEW_PROPERTY(onChange, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(color, UIColor)
+RCT_EXPORT_VIEW_PROPERTY(numberOfLines, NSInteger)
+RCT_EXPORT_VIEW_PROPERTY(rowHeight, CGFloat)
+RCT_CUSTOM_VIEW_PROPERTY(fontSize, NSNumber, ZKitWheelPicker)
+{
+  view.font = [RCTFont updateFont:view.font withSize:json ?: @(defaultView.font.pointSize)];
+}
+RCT_CUSTOM_VIEW_PROPERTY(fontWeight, NSString, ZKitWheelPicker)
+{
+  view.font = [RCTFont updateFont:view.font withWeight:json];
+}
+RCT_CUSTOM_VIEW_PROPERTY(fontStyle, NSString, ZKitWheelPicker)
+{
+  view.font = [RCTFont updateFont:view.font withStyle:json];
+}
+RCT_CUSTOM_VIEW_PROPERTY(fontFamily, NSString, ZKitWheelPicker)
+{
+  view.font = [RCTFont updateFont:view.font withFamily:json ?: defaultView.font.familyName];
+}
+
+RCT_EXPORT_METHOD(syncCurrentSelection:(nonnull NSNumber *)reactTag)
+{
+  [self.bridge.uiManager addUIBlock:^(__unused RCTUIManager *uiManager, NSDictionary<NSNumber *, UIView *> *viewRegistry) {
+    UIView *view = viewRegistry[reactTag];
+    if (![view isKindOfClass:[ZKitWheelPicker class]]) {
+      return;
+    }
+
+    [(ZKitWheelPicker *)view syncCurrentSelection];
+  }];
+}
+
+@end

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "zkit-ui",
+  "version": "1.0.0",
+  "private": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "source": "src/index.ts",
+  "react-native": "dist/index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Concur-max/zkit.git",
+    "directory": "packages/ui"
+  },
+  "homepage": "https://github.com/Concur-max/zkit/tree/main/packages/ui",
+  "bugs": {
+    "url": "https://github.com/Concur-max/zkit/issues"
+  },
+  "files": [
+    "dist",
+    "src",
+    "ios",
+    "react-native.config.js",
+    "zkit-ui.podspec",
+    "README.md"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@vant/area-data": "^2.1.0",
+    "dayjs": "^1.11.13",
+    "react-native-toast-message": "^2.3.3",
+    "zkit-tools": "1.0.0"
+  },
+  "peerDependencies": {
+    "@expo/vector-icons": "*",
+    "@lodev09/react-native-true-sheet": "*",
+    "@shopify/flash-list": "*",
+    "expo-image": "*",
+    "expo-linear-gradient": "*",
+    "lottie-react-native": "*",
+    "react": "*",
+    "react-native": "*",
+    "react-native-gesture-handler": "*",
+    "react-native-reanimated": "*",
+    "react-native-safe-area-context": "*",
+    "react-native-svg": "*",
+    "react-native-worklets": "*",
+    "sonner-native": "*"
+  },
+  "devDependencies": {
+    "@expo/vector-icons": "^15.1.1",
+    "@shopify/flash-list": "^2.3.1",
+    "@types/react": "~19.1.17",
+    "dayjs": "^1.11.13",
+    "expo-image": "~3.0.11",
+    "expo-linear-gradient": "~15.0.8",
+    "lottie-react-native": "7.3.2",
+    "react": "19.1.0",
+    "react-native": "0.81.5",
+    "react-native-gesture-handler": "~2.28.0",
+    "react-native-reanimated": "~4.1.6",
+    "react-native-safe-area-context": "5.6.2",
+    "react-native-screens": "~4.16.0",
+    "react-native-svg": "^15.12.1",
+    "react-native-worklets": "0.5.1",
+    "sonner-native": "^0.22.2",
+    "typescript": "~5.9.3",
+    "@lodev09/react-native-true-sheet": "3.10.0"
+  },
+  "scripts": {
+    "build": "node scripts/build.cjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/react-native.config.js

@@ -0,0 +1,10 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: null,
+      ios: {
+        podspecPath: 'zkit-ui.podspec',
+      },
+    },
+  },
+};

package/src/ComponentLibProvider.tsx

@@ -0,0 +1,56 @@
+import type * as React from 'react';
+import { I18nProvider } from './i18n/I18nProvider';
+import type { I18nMessages, I18nMissingKeyPolicy } from './i18n/types';
+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 { ThemeProvider } from './theme/ThemeProvider';
+import type { Theme, ThemeOverride } from './theme/types';
+
+export type ComponentLibProviderProps = {
+  // baseTheme 用于传入完整主题作为基线（例如品牌主题）
+  baseTheme?: Theme;
+  // theme 用于对 baseTheme 做局部覆盖（例如只改 primary）
+  theme?: ThemeOverride;
+  locale?: string;
+  messages?: I18nMessages;
+  missingKeyPolicy?: I18nMissingKeyPolicy;
+  loading?: LoadingDefaults;
+  children: React.ReactNode;
+};
+
+// ComponentLibProvider 是组件库推荐的顶层 Provider：
+// - 同时提供 Theme 与 i18n
+// - 避免业务方在 App 里层层包裹多个 Provider
+export function ComponentLibProvider({
+  baseTheme,
+  theme,
+  locale,
+  messages,
+  missingKeyPolicy,
+  loading,
+  children,
+}: ComponentLibProviderProps) {
+  return (
+    <ThemeProvider baseTheme={baseTheme} theme={theme}>
+      <I18nProvider locale={locale} messages={messages} missingKeyPolicy={missingKeyPolicy}>
+        <PickerServiceProvider>
+          <ToastProvider>
+            <ActionDialogProvider>
+              <LoadingProvider defaults={loading}>
+                <PermissionPurposeDialogProvider>
+                  <ImagePreviewProvider>
+                    {children}
+                  </ImagePreviewProvider>
+                </PermissionPurposeDialogProvider>
+              </LoadingProvider>
+            </ActionDialogProvider>
+          </ToastProvider>
+        </PickerServiceProvider>
+      </I18nProvider>
+    </ThemeProvider>
+  );
+}

package/src/assets/animations/spinner.json

@@ -0,0 +1 @@
+{"v":"5.7.5","fr":60,"ip":0,"op":61,"w":600,"h":600,"nm":"ios-spinner","ddd":0,"assets":[],"layers":[{"ddd":0,"ind":1,"ty":4,"nm":"1","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[100]},{"t":60,"s":[0]}],"ix":11},"r":{"a":0,"k":-180,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":2,"ty":4,"nm":"2","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[8]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":4,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":5,"s":[100]},{"t":60,"s":[8]}],"ix":11},"r":{"a":0,"k":-150,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":3,"ty":4,"nm":"3","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[16]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":9,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":10,"s":[100]},{"t":60,"s":[16]}],"ix":11},"r":{"a":0,"k":-120,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":4,"ty":4,"nm":"4","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[24]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":14,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":15,"s":[100]},{"t":60,"s":[24]}],"ix":11},"r":{"a":0,"k":-90,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":5,"ty":4,"nm":"5","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[32]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":19,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":20,"s":[100]},{"t":60,"s":[32]}],"ix":11},"r":{"a":0,"k":-60,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":6,"ty":4,"nm":"6","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[40]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":24,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":25,"s":[100]},{"t":60,"s":[40]}],"ix":11},"r":{"a":0,"k":-30,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":7,"ty":4,"nm":"7","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[48]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":29,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":30,"s":[100]},{"t":60,"s":[48]}],"ix":11},"r":{"a":0,"k":0,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":8,"ty":4,"nm":"8","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[56]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":34,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":35,"s":[100]},{"t":60,"s":[56]}],"ix":11},"r":{"a":0,"k":-330,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":9,"ty":4,"nm":"9","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[64]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":39,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":40,"s":[100]},{"t":60,"s":[64]}],"ix":11},"r":{"a":0,"k":-300,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":10,"ty":4,"nm":"10","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[72]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":44,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":45,"s":[100]},{"t":60,"s":[72]}],"ix":11},"r":{"a":0,"k":-270,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":11,"ty":4,"nm":"11","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[80]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":49,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":50,"s":[100]},{"t":60,"s":[80]}],"ix":11},"r":{"a":0,"k":-240,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":12,"ty":4,"nm":"12","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[88]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":54,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":55,"s":[100]},{"t":60,"s":[88]}],"ix":11},"r":{"a":0,"k":-210,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0}],"markers":[]}

package/src/assets/icons/check.svg

@@ -0,0 +1,4 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M20 6L9 17L4 12" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+

package/src/config.ts

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