feat .calude

.claude/skills/uni-helper/references/util-unocss-preset.md

@@ -0,0 +1,175 @@
+---
+name: unocss-preset-uni
+description: UnoCSS preset for uni-app with platform-specific utilities and rpx support
+---
+
+# unocss-preset-uni
+
+UnoCSS preset designed for uni-app development. Provides utilities for rpx units and platform-specific styling.
+
+## Installation
+
+```bash
+npm i -D @uni-helper/unocss-preset-uni
+```
+
+## Setup
+
+```ts
+// uno.config.ts
+import { defineConfig } from 'unocss'
+import { presetUni } from '@uni-helper/unocss-preset-uni'
+
+export default defineConfig({
+  presets: [
+    presetUni(),
+  ],
+})
+```
+
+## Features
+
+- **rpx support**: Automatic conversion to rpx units
+- **Platform variants**: Style targeting specific platforms
+- **Safe area utilities**: Handle notches and safe areas
+- **Compatible with**: Mini programs, H5, and App
+
+## RPX Utilities
+
+The preset automatically converts pixel values to rpx:
+
+```html
+<!-- These generate rpx units -->
+<view class="w-100"></view>    <!-- width: 100rpx -->
+<view class="h-50"></view>     <!-- height: 50rpx -->
+<view class="m-20"></view>     <!-- margin: 20rpx -->
+<view class="p-16"></view>     <!-- padding: 16rpx -->
+<view class="text-32"></view>  <!-- font-size: 32rpx -->
+```
+
+## Platform Variants
+
+Apply styles to specific platforms:
+
+```html
+<!-- Only apply on H5 -->
+<view class="h5:bg-red"></view>
+
+<!-- Only apply on WeChat -->
+<view class="mp-weixin:bg-blue"></view>
+
+<!-- Only apply on App -->
+<view class="app:bg-green"></view>
+
+<!-- Combine with responsive -->
+<view class="h5:p-20 mp-weixin:p-10"></view>
+```
+
+## Safe Area Utilities
+
+```html
+<!-- Safe area padding -->
+<view class="pt-safe"></view>      <!-- padding-top: env(safe-area-inset-top) -->
+<view class="pb-safe"></view>      <!-- padding-bottom: env(safe-area-inset-bottom) -->
+<view class="px-safe"></view>      <!-- padding-x with safe area -->
+
+<!-- Safe area margin -->
+<view class="mt-safe"></view>
+<view class="mb-safe"></view>
+
+<!-- Full safe area -->
+<view class="safe-area"></view>
+```
+
+## Tab Bar Utilities
+
+```html
+<!-- Padding for tab bar -->
+<view class="pb-tabbar"></view>
+
+<!-- Margin for tab bar -->
+<view class="mb-tabbar"></view>
+```
+
+## Status Bar Utilities
+
+```html
+<!-- Status bar height -->
+<view class="h-statusbar"></view>
+<view class="pt-statusbar"></view>
+```
+
+## Configuration
+
+```ts
+// uno.config.ts
+import { defineConfig } from 'unocss'
+import { presetUni } from '@uni-helper/unocss-preset-uni'
+
+export default defineConfig({
+  presets: [
+    presetUni({
+      // rpx base width (default: 750)
+      baseWidth: 750,
+
+      // Enable platform variants
+      platform: true,
+
+      // Enable safe area utilities
+      safeArea: true,
+
+      // Custom platforms
+      platforms: ['mp-weixin', 'mp-alipay', 'h5', 'app'],
+    }),
+  ],
+})
+```
+
+## With Vite
+
+```ts
+// vite.config.ts
+import Uni from '@dcloudio/vite-plugin-uni'
+import UnoCSS from 'unocss/vite'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [
+    UnoCSS(),
+    Uni(),
+  ],
+})
+```
+
+## Example
+
+```vue
+<template>
+  <view class="page bg-gray-100">
+    <!-- Status bar spacing -->
+    <view class="h-statusbar"></view>
+
+    <!-- Header with safe area -->
+    <view class="px-32 pt-safe flex items-center justify-between">
+      <text class="text-36 font-bold">Title</text>
+    </view>
+
+    <!-- Content -->
+    <view class="p-32 flex flex-col gap-20">
+      <!-- Platform-specific styling -->
+      <view class="card h5:shadow-lg mp-weixin:border">
+        <text class="text-28 text-gray-800">Content</text>
+      </view>
+    </view>
+
+    <!-- Bottom safe area for devices with notches -->
+    <view class="pb-safe"></view>
+  </view>
+</template>
+```
+
+<!--
+Source references:
+- https://github.com/uni-helper/unocss-preset-uni
+- https://uni-helper.js.org/unocss-preset-uni
+-->