@unif/react-native-ui 0.1.0 → 0.2.0

package/lib/commonjs/README.md

@@ -0,0 +1,99 @@
+# @unif/react-native-ui 基础组件
+
+借鉴 antd v6 语义化设计 + ant-design-mobile-rn 实践，提供基础 UI 组件。
+
+## 组件总览
+
+### 布局
+
+| 组件 | 说明 | 文档 |
+|------|------|------|
+| Row | 水平布局 | [row/index.md](./row/index.md) |
+| Column | 垂直布局 | [column/index.md](./column/index.md) |
+| Center | 居中布局 | [center/index.md](./center/index.md) |
+| Space | 间距占位 | [space/index.md](./space/index.md) |
+
+### 通用
+
+| 组件 | 说明 | 文档 |
+|------|------|------|
+| Text | 语义化文字 | [text/index.md](./text/index.md) |
+| Button | 语义化按钮 | [button/index.md](./button/index.md) |
+| Touchable | 统一触摸反馈 | [touchable/index.md](./touchable/index.md) |
+| Divider | 分割线 | [divider/index.md](./divider/index.md) |
+| ListItem | 列表行 | [list-item/index.md](./list-item/index.md) |
+| mergeStyles | 样式合并工具 | [hooks/index.md](./hooks/index.md) |
+
+## 引入方式
+
+```tsx
+import { Row, Column, Center, Space, Text, Button, Touchable, Divider, ListItem } from '@unif/react-native-ui';
+```
+
+## 目录结构
+
+```
+src/
+├── index.tsx                 # 统一导出
+├── README.md                 # 总览（本文件）
+├── theme/
+│   ├── config.ts             # 主题配置（configure API）
+│   └── tokens.ts             # Design Tokens
+├── hooks/
+│   ├── index.ts
+│   ├── index.md              # mergeStyles 文档
+│   └── useMergeStyles.ts
+├── row/
+│   ├── index.tsx             # Row 组件
+│   ├── index.md
+│   └── style/
+│       └── index.tsx
+├── column/
+│   ├── index.tsx             # Column 组件
+│   ├── index.md
+│   └── style/
+│       └── index.tsx
+├── center/
+│   ├── index.tsx             # Center 组件
+│   ├── index.md
+│   └── style/
+│       └── index.tsx
+├── space/
+│   ├── index.tsx             # Space 组件
+│   ├── index.md
+│   └── style/
+│       └── index.tsx
+├── text/
+│   ├── index.tsx             # Text 组件
+│   ├── index.md
+│   └── style/
+│       └── index.tsx
+├── button/
+│   ├── index.tsx             # Button 组件
+│   ├── index.md
+│   └── style/
+│       └── index.tsx
+├── touchable/
+│   ├── index.tsx             # Touchable 组件
+│   ├── index.md
+│   └── style/
+│       └── index.tsx
+├── divider/
+│   ├── index.tsx             # Divider 组件
+│   ├── index.md
+│   └── style/
+│       └── index.tsx
+└── list-item/
+    ├── index.tsx             # ListItem 组件
+    ├── index.md
+    └── style/
+        └── index.tsx
+```
+
+## 设计原则
+
+1. **语义化** — `variant="caption"` 而非 `fontSize={13}`，意图清晰
+2. **Semantic Styles** — 消费方通过 `styles={{content: {...}}}` 精确覆盖内部 slot，不侵入组件结构
+3. **Token 驱动** — 所有颜色、间距来自 `tokens`，主题可控
+4. **样式数组组合** — `[baseStyle, variantStyle, stateStyle, userStyle]` 优先级叠加
+5. **性能安全** — 样式常量预定义在模块顶层，`mergeStyles` 配合 `useMemo` 使用

package/lib/commonjs/action-sheet/index.js

@@ -0,0 +1,71 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _hooks = require("../hooks");
+var _context = require("../theme/context");
+var _style = require("./style");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * ActionSheet 基础组件
+ *
+ * 轻量底部选项面板，Modal + 网格布局。
+ */
+
+const ActionSheet = ({
+  visible,
+  onClose,
+  options,
+  onSelect,
+  columns = 3,
+  style,
+  styles: semanticStyles,
+  testID
+}) => {
+  const tokens = (0, _context.useTokens)();
+  const defaultStyles = (0, _react.useMemo)(() => (0, _style.createDefaultStyles)(tokens), [tokens]);
+  const s = (0, _react.useMemo)(() => (0, _hooks.mergeStyles)(defaultStyles, semanticStyles), [defaultStyles, semanticStyles]);
+  if (!visible) {
+    return null;
+  }
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.Modal, {
+    visible: visible,
+    transparent: true,
+    animationType: "slide",
+    onRequestClose: onClose,
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableWithoutFeedback, {
+      onPress: onClose,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+        style: s.overlay
+      })
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: [s.panel, style],
+      testID: testID,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+        style: s.grid,
+        children: options.map(item => /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.TouchableOpacity, {
+          style: [s.option, {
+            width: `${Math.floor(100 / columns)}%`
+          }],
+          onPress: () => onSelect(item.key),
+          activeOpacity: 0.7,
+          testID: testID ? `${testID}-${item.key}` : undefined,
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+            style: s.optionIcon,
+            children: item.icon
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+            style: s.optionLabel,
+            children: item.label
+          })]
+        }, item.key))
+      })
+    })]
+  });
+};
+var _default = exports.default = ActionSheet;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/action-sheet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_hooks","_context","_style","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","ActionSheet","visible","onClose","options","onSelect","columns","style","styles","semanticStyles","testID","tokens","useTokens","defaultStyles","useMemo","createDefaultStyles","s","mergeStyles","jsxs","Modal","transparent","animationType","onRequestClose","children","jsx","TouchableWithoutFeedback","onPress","View","overlay","panel","grid","map","item","TouchableOpacity","option","width","Math","floor","key","activeOpacity","undefined","optionIcon","icon","Text","optionLabel","label","_default","exports"],"sourceRoot":"../../../src","sources":["action-sheet/index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/action-sheet/index.md

@@ -0,0 +1,69 @@
+---
+title: ActionSheet
+nav:
+  title: 组件
+  order: 1
+group:
+  title: 基础
+  order: 2
+---
+
+# ActionSheet 底部操作面板
+
+从底部弹出的选项网格面板。
+
+## 何时使用
+
+- 需要展示操作选项时（如拍照、选照片等）
+- 底部弹出式面板
+
+## 代码演示
+
+```tsx
+import { ActionSheet, Icon } from '@unif/react-native-ui';
+
+const options = [
+  { key: 'camera', label: '拍照', icon: <Icon name="camera-outline" size={28} /> },
+  { key: 'photo', label: '照片', icon: <Icon name="image-outline" size={28} /> },
+];
+
+<ActionSheet
+  visible={visible}
+  onClose={() => setVisible(false)}
+  options={options}
+  onSelect={(key) => console.log(key)}
+/>
+```
+
+## API
+
+| 属性     | 说明           | 类型                                | 默认值 |
+| -------- | -------------- | ----------------------------------- | ------ |
+| visible  | 是否可见       | `boolean`                           | -      |
+| onClose  | 关闭回调       | `() => void`                        | -      |
+| title    | 标题           | `string`                            | -      |
+| options  | 选项列表       | `ActionSheetOption[]`               | -      |
+| onSelect | 选择回调       | `(key: string) => void`             | -      |
+| columns  | 每行列数       | `number`                            | `3`    |
+| style    | 面板样式       | `ViewStyle`                         | -      |
+| styles   | 语义样式       | `ActionSheetSemanticStyles`         | -      |
+| testID   | 测试标识       | `string`                            | -      |
+
+## ActionSheetOption
+
+| 属性  | 说明   | 类型        |
+| ----- | ------ | ----------- |
+| key   | 唯一标识 | `string`  |
+| label | 显示文本 | `string`  |
+| icon  | 图标     | `ReactNode` |
+
+## Semantic Styles
+
+| Slot        | 说明           |
+| ----------- | -------------- |
+| overlay     | 遮罩层         |
+| panel       | 底部面板       |
+| grid        | 网格容器       |
+| option      | 单个选项       |
+| optionIcon  | 选项图标容器   |
+| optionLabel | 选项标签文本   |

package/lib/commonjs/action-sheet/style/index.js

@@ -0,0 +1,42 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createDefaultStyles = void 0;
+const createDefaultStyles = t => ({
+  overlay: {
+    flex: 1,
+    backgroundColor: 'rgba(0,0,0,0.3)'
+  },
+  panel: {
+    backgroundColor: t.colorBgElevated,
+    borderTopLeftRadius: 12,
+    borderTopRightRadius: 12,
+    paddingTop: 20,
+    paddingBottom: 24,
+    paddingHorizontal: t.spaceMd
+  },
+  grid: {
+    flexDirection: 'row',
+    justifyContent: 'space-around'
+  },
+  option: {
+    alignItems: 'center'
+  },
+  optionIcon: {
+    width: 56,
+    height: 56,
+    borderRadius: 12,
+    backgroundColor: t.colorBgPage,
+    justifyContent: 'center',
+    alignItems: 'center',
+    marginBottom: t.spaceSm
+  },
+  optionLabel: {
+    fontSize: 12,
+    color: t.colorTextSecondary
+  }
+});
+exports.createDefaultStyles = createDefaultStyles;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/action-sheet/style/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createDefaultStyles","t","overlay","flex","backgroundColor","panel","colorBgElevated","borderTopLeftRadius","borderTopRightRadius","paddingTop","paddingBottom","paddingHorizontal","spaceMd","grid","flexDirection","justifyContent","option","alignItems","optionIcon","width","height","borderRadius","colorBgPage","marginBottom","spaceSm","optionLabel","fontSize","color","colorTextSecondary","exports"],"sourceRoot":"../../../../src","sources":["action-sheet/style/index.tsx"],"mappings":";;;;;;AAkBO,MAAMA,mBAAmB,GAC9BC,CAAS,KACsB;EAC/BC,OAAO,EAAE;IACPC,IAAI,EAAE,CAAC;IACPC,eAAe,EAAE;EACnB,CAAC;EACDC,KAAK,EAAE;IACLD,eAAe,EAAEH,CAAC,CAACK,eAAe;IAClCC,mBAAmB,EAAE,EAAE;IACvBC,oBAAoB,EAAE,EAAE;IACxBC,UAAU,EAAE,EAAE;IACdC,aAAa,EAAE,EAAE;IACjBC,iBAAiB,EAAEV,CAAC,CAACW;EACvB,CAAC;EACDC,IAAI,EAAE;IACJC,aAAa,EAAE,KAAK;IACpBC,cAAc,EAAE;EAClB,CAAC;EACDC,MAAM,EAAE;IACNC,UAAU,EAAE;EACd,CAAC;EACDC,UAAU,EAAE;IACVC,KAAK,EAAE,EAAE;IACTC,MAAM,EAAE,EAAE;IACVC,YAAY,EAAE,EAAE;IAChBjB,eAAe,EAAEH,CAAC,CAACqB,WAAW;IAC9BP,cAAc,EAAE,QAAQ;IACxBE,UAAU,EAAE,QAAQ;IACpBM,YAAY,EAAEtB,CAAC,CAACuB;EAClB,CAAC;EACDC,WAAW,EAAE;IACXC,QAAQ,EAAE,EAAE;IACZC,KAAK,EAAE1B,CAAC,CAAC2B;EACX;AACF,CAAC,CAAC;AAACC,OAAA,CAAA7B,mBAAA,GAAAA,mBAAA","ignoreList":[]}

package/lib/commonjs/avatar/index.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _hooks = require("../hooks");
+var _context = require("../theme/context");
+var _style = require("./style");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * Avatar 原子组件
+ *
+ * 圆形图像/图标容器，支持图片、图标、占位三种模式。
+ */
+
+const Avatar = ({
+  size = 40,
+  source,
+  icon,
+  style,
+  styles: semanticStyles,
+  testID
+}) => {
+  const tokens = (0, _context.useTokens)();
+  const defaultStyles = (0, _react.useMemo)(() => (0, _style.createDefaultStyles)(tokens), [tokens]);
+  const s = (0, _react.useMemo)(() => (0, _hooks.mergeStyles)(defaultStyles, semanticStyles), [defaultStyles, semanticStyles]);
+  const sizeStyle = {
+    width: size,
+    height: size,
+    borderRadius: size / 2
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+    style: [s.root, sizeStyle, style],
+    testID: testID,
+    children: source ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Image, {
+      source: source,
+      style: [s.image, {
+        width: size,
+        height: size,
+        borderRadius: size / 2
+      }]
+    }) : icon ? icon : null
+  });
+};
+var _default = exports.default = Avatar;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/avatar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_hooks","_context","_style","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","Avatar","size","source","icon","style","styles","semanticStyles","testID","tokens","useTokens","defaultStyles","useMemo","createDefaultStyles","s","mergeStyles","sizeStyle","width","height","borderRadius","jsx","View","root","children","Image","image","_default","exports"],"sourceRoot":"../../../src","sources":["avatar/index.tsx"],"mappings":";;;;;;AAMA,IAAAA,MAAA,GAAAC,uBAAA,CAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAEA,IAAAE,MAAA,GAAAF,OAAA;AACA,IAAAG,QAAA,GAAAH,OAAA;AAEA,IAAAI,MAAA,GAAAJ,OAAA;AAA8C,IAAAK,WAAA,GAAAL,OAAA;AAAA,SAAAD,wBAAAO,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAT,uBAAA,YAAAA,CAAAO,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAZ9C;AACA;AACA;AACA;AACA;;AAmBA,MAAMkB,MAA6B,GAAGA,CAAC;EACrCC,IAAI,GAAG,EAAE;EACTC,MAAM;EACNC,IAAI;EACJC,KAAK;EACLC,MAAM,EAAEC,cAAc;EACtBC;AACF,CAAC,KAAK;EACJ,MAAMC,MAAM,GAAG,IAAAC,kBAAS,EAAC,CAAC;EAC1B,MAAMC,aAAa,GAAG,IAAAC,cAAO,EAAC,MAAM,IAAAC,0BAAmB,EAACJ,MAAM,CAAC,EAAE,CAACA,MAAM,CAAC,CAAC;EAE1E,MAAMK,CAAC,GAAG,IAAAF,cAAO,EACf,MAAM,IAAAG,kBAAW,EAAuBJ,aAAa,EAAEJ,cAAc,CAAC,EACtE,CAACI,aAAa,EAAEJ,cAAc,CAChC,CAAC;EAED,MAAMS,SAAoB,GAAG;IAC3BC,KAAK,EAAEf,IAAI;IACXgB,MAAM,EAAEhB,IAAI;IACZiB,YAAY,EAAEjB,IAAI,GAAG;EACvB,CAAC;EAED,oBACE,IAAArB,WAAA,CAAAuC,GAAA,EAAC3C,YAAA,CAAA4C,IAAI;IAAChB,KAAK,EAAE,CAACS,CAAC,CAACQ,IAAI,EAAEN,SAAS,EAAEX,KAAK,CAAE;IAACG,MAAM,EAAEA,MAAO;IAAAe,QAAA,EACrDpB,MAAM,gBACL,IAAAtB,WAAA,CAAAuC,GAAA,EAAC3C,YAAA,CAAA+C,KAAK;MACJrB,MAAM,EAAEA,MAAO;MACfE,KAAK,EAAE,CAACS,CAAC,CAACW,KAAK,EAAE;QAAER,KAAK,EAAEf,IAAI;QAAEgB,MAAM,EAAEhB,IAAI;QAAEiB,YAAY,EAAEjB,IAAI,GAAG;MAAE,CAAC;IAAE,CACzE,CAAC,GACAE,IAAI,GACNA,IAAI,GACF;EAAI,CACJ,CAAC;AAEX,CAAC;AAAC,IAAAsB,QAAA,GAAAC,OAAA,CAAAnC,OAAA,GAEaS,MAAM","ignoreList":[]}

package/lib/commonjs/avatar/index.md

@@ -0,0 +1,51 @@
+---
+title: Avatar
+nav:
+  title: 组件
+  order: 1
+group:
+  title: 原子
+  order: 1
+---
+
+# Avatar 头像
+
+圆形图像/图标容器，支持图片、图标、占位三种模式。
+
+## 何时使用
+
+- 展示用户头像
+- 展示 AI 助手图标头像
+
+## 代码演示
+
+```tsx
+import { Avatar, Icon } from '@unif/react-native-ui';
+
+// 图片头像
+<Avatar size={40} source={{ uri: 'https://example.com/avatar.png' }} />
+
+// 图标头像
+<Avatar size={28} icon={<Icon name="sparkles" size={18} color="#EB6E00" />} />
+
+// 默认占位
+<Avatar size={40} />
+```
+
+## API
+
+| 属性    | 说明             | 类型                   | 默认值 |
+| ------- | ---------------- | ---------------------- | ------ |
+| size    | 头像尺寸         | `number`               | `40`   |
+| source  | 图片来源         | `ImageSourcePropType`  | -      |
+| icon    | 替代图片的图标   | `ReactNode`            | -      |
+| style   | 容器样式         | `ViewStyle`            | -      |
+| styles  | 语义样式         | `AvatarSemanticStyles` | -      |
+| testID  | 测试标识         | `string`               | -      |
+
+## Semantic Styles
+
+| Slot  | 说明       |
+| ----- | ---------- |
+| root  | 外层容器   |
+| image | 图片元素   |

package/lib/commonjs/avatar/style/index.js

@@ -0,0 +1,21 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createDefaultStyles = void 0;
+const createDefaultStyles = t => ({
+  root: {
+    justifyContent: 'center',
+    alignItems: 'center',
+    backgroundColor: t.colorBgElevated,
+    overflow: 'hidden',
+    ...t.shadowSm
+  },
+  image: {
+    width: '100%',
+    height: '100%'
+  }
+});
+exports.createDefaultStyles = createDefaultStyles;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/avatar/style/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createDefaultStyles","t","root","justifyContent","alignItems","backgroundColor","colorBgElevated","overflow","shadowSm","image","width","height","exports"],"sourceRoot":"../../../../src","sources":["avatar/style/index.tsx"],"mappings":";;;;;;AAQO,MAAMA,mBAAmB,GAAIC,CAAS,KAA4B;EACvEC,IAAI,EAAE;IACJC,cAAc,EAAE,QAAQ;IACxBC,UAAU,EAAE,QAAQ;IACpBC,eAAe,EAAEJ,CAAC,CAACK,eAAe;IAClCC,QAAQ,EAAE,QAAQ;IAClB,GAAGN,CAAC,CAACO;EACP,CAAC;EACDC,KAAK,EAAE;IACLC,KAAK,EAAE,MAAa;IACpBC,MAAM,EAAE;EACV;AACF,CAAC,CAAC;AAACC,OAAA,CAAAZ,mBAAA,GAAAA,mBAAA","ignoreList":[]}

package/lib/commonjs/button/index.js

@@ -0,0 +1,60 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _hooks = require("../hooks");
+var _context = require("../theme/context");
+var _style = require("./style");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * 按钮组件
+ *
+ * type + size + semantic styles。
+ */
+
+const Button = ({
+  type = 'primary',
+  size = 'default',
+  icon,
+  disabled,
+  block,
+  loading,
+  onPress,
+  style,
+  styles: semanticStyles,
+  testID,
+  children
+}) => {
+  const tokens = (0, _context.useTokens)();
+  const typeStyles = (0, _react.useMemo)(() => (0, _style.createTypeStyles)(tokens), [tokens]);
+  const s = (0, _react.useMemo)(() => (0, _hooks.mergeStyles)(_style.DEFAULT_STYLES, _style.SIZE_STYLES[size], typeStyles[type], disabled ? _style.DISABLED_STYLES : undefined, block ? _style.BLOCK_STYLES : undefined, semanticStyles), [type, size, disabled, block, semanticStyles, typeStyles]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.Pressable, {
+    style: ({
+      pressed
+    }) => [s.root, pressed && _style.PRESSED_STYLE, style],
+    onPress: onPress,
+    disabled: disabled || loading,
+    testID: testID,
+    children: [icon && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: s.icon,
+      children: icon
+    }), loading && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.ActivityIndicator, {
+      color: s.content?.color,
+      size: "small",
+      style: _style.loadingStyle
+    }), typeof children === 'string' ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      style: s.content,
+      children: children
+    }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: s.content,
+      children: children
+    })]
+  });
+};
+var _default = exports.default = Button;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/button/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_hooks","_context","_style","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","Button","type","size","icon","disabled","block","loading","onPress","style","styles","semanticStyles","testID","children","tokens","useTokens","typeStyles","useMemo","createTypeStyles","s","mergeStyles","DEFAULT_STYLES","SIZE_STYLES","DISABLED_STYLES","undefined","BLOCK_STYLES","jsxs","Pressable","pressed","root","PRESSED_STYLE","jsx","View","ActivityIndicator","color","content","loadingStyle","Text","_default","exports"],"sourceRoot":"../../../src","sources":["button/index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/button/index.md

@@ -0,0 +1,90 @@
+# Button 语义化按钮
+
+支持 `type` / `size` 变体和 `styles` 语义插槽覆盖。使用 `Pressable` 实现按下态反馈。
+
+## 何时使用
+
+- 替代 `<TouchableOpacity>` + 手写按钮样式的组合
+- 需要统一按钮风格（主按钮、描边按钮、幽灵按钮）时
+
+## 代码演示
+
+```tsx
+// 主按钮
+<Button onPress={handleConfirm}>确认下单</Button>
+
+// 描边按钮
+<Button type="outline" onPress={handleModify}>修改</Button>
+
+// 幽灵按钮
+<Button type="ghost" onPress={handlePush}>推送经销商</Button>
+
+// 并排等宽
+<View style={{flexDirection: 'row', gap: 10}}>
+  <Button type="outline" block onPress={handleModify}>修改</Button>
+  <Button block onPress={handleConfirm}>确认</Button>
+</View>
+
+// 带图标
+<Button icon={<Icon name="add" size={16} color="#FFF" />} onPress={handleAdd}>
+  添加
+</Button>
+
+// 语义插槽覆盖
+<Button
+  type="outline"
+  onPress={handleAction}
+  styles={{root: {borderColor: 'red'}, content: {color: 'red'}}}>
+  危险操作
+</Button>
+```
+
+## API
+
+| 属性 | 说明 | 类型 | 默认值 |
+|------|------|------|--------|
+| type | 按钮类型 | `'primary'` \| `'outline'` \| `'ghost'` \| `'danger'` | `'primary'` |
+| size | 按钮大小 | `'default'` \| `'small'` | `'default'` |
+| icon | 左侧图标 | `ReactNode` | - |
+| disabled | 禁用状态 | `boolean` | `false` |
+| block | 撑满父容器（flex: 1） | `boolean` | `false` |
+| loading | 加载状态 | `boolean` | `false` |
+| onPress | 点击回调 | `() => void` | **必填** |
+| style | 外层容器样式 | `ViewStyle` | - |
+| styles | 语义插槽样式 | `Partial<ButtonSemanticStyles>` | - |
+| testID | 测试标识 | `string` | - |
+| children | 按钮内容 | `ReactNode` | **必填** |
+
+## Semantic Styles
+
+通过 `styles` prop 精确覆盖组件内部各 slot 的样式，不侵入组件结构。
+
+| 插槽 | 类型 | 说明 |
+|------|------|------|
+| root | `ViewStyle` | 按钮容器（背景、边框、圆角等） |
+| icon | `ViewStyle` | 图标区域（间距等） |
+| content | `TextStyle` | 文字区域（字号、颜色、字重等） |
+
+## Type 规格
+
+| type | 背景 | 文字色 | 边框 |
+|------|------|--------|------|
+| primary | colorPrimary | #FFF | 无 |
+| outline | 透明 | colorTextSecondary | colorBorder |
+| ghost | 透明 | colorPrimary | colorPrimary |
+| danger | colorError | #FFF | 无 |
+
+## Size 规格
+
+| size | paddingVertical | borderRadius | fontSize |
+|------|----------------|--------------|----------|
+| default | 10 | 8 | 14 |
+| small | 6 | 6 | 12 |
+
+## 样式合并顺序
+
+```
+DEFAULT_STYLES → SIZE_STYLES → TYPE_STYLES → DISABLED_STYLES → BLOCK_STYLES → semanticStyles
+```
+
+内部使用 `mergeStyles` + `useMemo` 按 slot 维度合并，仅在 props 变化时重算。