@lzk-lib/react

0.7.0 的 React 动画与材质组件。四种上游光学模式通过 opticalMode 切换：standard（默认）、polar、prominent、shader（实验性）。六种扩展透镜通过 lens 切换；显式 opticalMode 优先。默认白色透明、静止，悬停不位移缩放；需要持续流动时显式设置 flow / flowSpeed。导出 GlassButton、GlassCard、GlassDialog、GlassDropdown、GlassInput、GlassSwitch、GlassTabs、GlassToolbar，以及 LiquidGlass、Motion、MotionScene、AnimatedDialog、AnimatedDropdown、AnimatedInput、GradientBorder、PageTransition，以及 TiltCard、Magnetic、Reveal、Spotlight。

import { LiquidGlass } from '@lzk-lib/react';
import '@lzk-lib/core/style.css';

<LiquidGlass radius={28} refraction={60} style={{ padding: 24 }}>
  <h2>你自己的内容</h2>
  <button>继续</button>
</LiquidGlass>

八种 Glass 组件通过 glass 接收材质参数，支持 unstyled 与部位样式。GlassSwitch 提供真实布尔值切换，GlassTabs 提供键盘选择和业务内容面板。

弹窗、下拉、输入、渐变边框、页面过渡支持 unstyled、classNames / styles 部位映射。弹窗支持 renderHeader / renderContent，下拉支持 renderTrigger / renderOption，输入支持 renderLabel / renderPrefix / renderSuffix。自定义外观保留真实控件、动画与键盘行为。

当前未发布到 npm。安装仓库生成的 lzk-lib-core-0.7.0.tgz 和 lzk-lib-react-0.7.0.tgz，或使用同一 workspace 的本地包；React 18/19 由业务项目提供。不需要运行预览站或独立服务。浏览器逻辑在挂载后初始化，可服务端渲染。

液态玻璃预览：/glass/。完整部位表、回调字段与示例见仓库 docs/advanced.md。

常规组件预览 /components/ 已有 58 项，整个包共有 79 个组件导出。0.7.0 新增 16 个表单控件、14 个数据/布局组件、12 个复杂交互组件和 6 个内容动画组件；原有十种基础组件继续保留。

表单包括 Input、Select、Checkbox、RadioGroup、Switch、Slider、NumberInput、PinInput、FileUpload 等；数据包括可排序/勾选的 Table、Avatar、Steps、Timeline；复杂交互包括 Combobox、MultiSelect、Calendar、DatePicker、Drawer、AlertDialog、CommandMenu、TreeView 等。TextReveal、AnimatedNumber、Typewriter、Stagger、Marquee、Shimmer 可以直接接业务内容。

支持 unstyled、classNames 和 styles。API 与边界见仓库 docs/components.md、docs/components-forms.md、docs/components-data.md、docs/components-advanced.md、docs/content-motion.md。FileUpload 负责选择和校验文件，上传请求由业务项目处理；Table 不内置服务端数据或虚拟滚动。

Icon 渲染单独导入的 SVG 数据。额外安装 lzk-lib-icons-0.7.0.tgz 后，可从 @lzk-lib/icons/outline/search 等路径导入单个图标，传给 <Icon icon={search} title="搜索" />。图标目录共 6,220 项，预览在 /icons/。