docs: update

Author: sonofmagic

website/docs/community/merge/cva-and-variants.mdx

@@ -59,7 +59,9 @@ button({ tone: 'outline', size: 'sm' })
   ```ts
   import { create } from '@weapp-tailwindcss/cva'
 
-  const { cva: cvaForWeb } = create({ escape: false, unescape: false })
+  // 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+  const isH5 = true
+  const { cva: cvaForWeb } = create({ escape: !isH5, unescape: !isH5 })
   ```
 
 ### Live Demo
@@ -139,9 +141,11 @@ mergeLater({ twMerge: false })
 ```ts
 import { create } from '@weapp-tailwindcss/variants'
 
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+const isH5 = true
 const { tv: tvForWeb, cn: cnForWeb } = create({
-  escape: false,
-  unescape: false,
+  escape: !isH5,
+  unescape: !isH5,
 })
 ```
 

website/docs/community/merge/overview.mdx

@@ -117,16 +117,17 @@ badge({ tone: 'success' })
 ```ts
 import { create } from '@weapp-tailwindcss/merge'
 
-const { twMerge: mergeForMiniProgram } = create()
-const { twMerge: mergeForWeb } = create({
-  escape: false,
-  unescape: false,
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+const isH5 = false
+const { twMerge } = create({
+  escape: !isH5,
+  unescape: !isH5,
 })
 
-mergeForMiniProgram('text-[#ececec]', 'text-[#ECECEC]') // → 'text-_b_hECECEC_B'
-mergeForWeb('text-[#ececec]', 'text-[#ECECEC]')         // → 'text-[#ECECEC]'
+twMerge('text-[#ececec]', 'text-[#ECECEC]') // → 小程序时得到转义结果
 ```
 
+- H5 环境只需将 `isH5` 设为 `true`，即可关闭 escape/unescape。
 - `escape: false` 表示结果保持原样（适合 Web 或同构渲染）。
 - `unescape: false` 可跳过运行前的「反转义」，用于确保输入不会被改写。
 - 如果只想自定义映射表，传入 `escape: { map: { '#': '__hash__' } }` 即可；运行时会把自定义映射与默认映射合并，保证编译期和运行时的行为一致。

website/docs/community/merge/runtime-api.mdx

@@ -152,8 +152,9 @@ const raw = weappTwIgnore`
 `create` 会根据传入的 `options` 返回一组隔离的运行时函数（`twMerge`、`twJoin`、`createTailwindMerge`、`extendTailwindMerge`），用于控制转义行为：
 
 ```ts
-const { twMerge: mergeForWeb } = create({ escape: false, unescape: false })
-const { twMerge: mergeForMiniProgram } = create()
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+const isH5 = false
+const { twMerge } = create({ escape: !isH5, unescape: !isH5 })
 ```
 
 ### CreateOptions

website/docs/community/packages-runtime/cva.mdx

@@ -51,12 +51,14 @@ const className = button({ tone: 'outline', size: 'sm' })
 ```ts
 import { create } from '@weapp-tailwindcss/cva'
 
-const { cva: cvaWeb } = create({
-  escape: false,
-  unescape: false,
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+const isH5 = true
+const { cva: cvaRuntime } = create({
+  escape: !isH5,
+  unescape: !isH5,
 })
 
-const badge = cvaWeb('text-[#0F172A] bg-[#E2E8F0]')
+const badge = cvaRuntime('text-[#0F172A] bg-[#E2E8F0]')
 ```
 
 ## Demo：跨端变体工厂
@@ -77,8 +79,10 @@ const config = {
 }
 
 const pill = cva('inline-flex items-center rounded-full px-2 text-xs font-medium', config)
-const { cva: cvaWeb } = create({ escape: false, unescape: false })
-const pillWeb = cvaWeb('inline-flex items-center rounded-full px-2 text-xs font-medium', config)
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+const isH5 = true
+const { cva: cvaRuntime } = create({ escape: !isH5, unescape: !isH5 })
+const pillWeb = cvaRuntime('inline-flex items-center rounded-full px-2 text-xs font-medium', config)
 ```
 
 ## 常见注意事项

website/docs/community/packages-runtime/index.mdx

@@ -32,10 +32,11 @@ description: 'runtime 系列包的版本选择、能力矩阵与多端使用心
 ```ts
 import { create } from '@weapp-tailwindcss/merge'
 
-const { twMerge: mergeForMiniProgram } = create()
-const { twMerge: mergeForWeb } = create({
-  escape: false,
-  unescape: false,
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+const isH5 = false
+const { twMerge } = create({
+  escape: !isH5,
+  unescape: !isH5,
 })
 ```
 

website/docs/community/packages-runtime/merge-v3.mdx

@@ -26,12 +26,14 @@ const className = twMerge('p-2 p-4', 'bg-[#0F172A]')
 ```ts
 import { create } from '@weapp-tailwindcss/merge-v3'
 
-const { twMerge: twMergeWeb } = create({
-  escape: false,
-  unescape: false,
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+const isH5 = true
+const { twMerge } = create({
+  escape: !isH5,
+  unescape: !isH5,
 })
 
-twMergeWeb('text-[#2563EB]', 'text-[#1D4ED8]')
+twMerge('text-[#2563EB]', 'text-[#1D4ED8]')
 // => 'text-[#1D4ED8]'
 ```
 

website/docs/community/packages-runtime/merge.mdx

@@ -67,12 +67,14 @@ const buttonClass = twMerge(
 ```ts
 import { create } from '@weapp-tailwindcss/merge'
 
-const { twMerge: twMergeWeb } = create({
-  escape: false,
-  unescape: false,
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+const isH5 = true
+const { twMerge } = create({
+  escape: !isH5,
+  unescape: !isH5,
 })
 
-const className = twMergeWeb('text-[#2563EB]', 'text-[#1D4ED8]')
+const className = twMerge('text-[#2563EB]', 'text-[#1D4ED8]')
 // => 'text-[#1D4ED8]'
 ```
 

website/docs/community/packages-runtime/multi-platform-demos.mdx

@@ -8,12 +8,14 @@ description: '基于 packages-runtime 的跨端示例：uni-app + Web、Taro + W
 
 ## Demo 1：uni-app + Web（Vue + TS）
 
+同一份 `tv` 实例即可覆盖小程序与 H5，通过环境变量决定是否关闭 escape/unescape。
+
 ### 共享变体（`src/ui/button.variants.ts`）
 
 ```ts
-import { tv, create } from '@weapp-tailwindcss/variants'
+import { create } from '@weapp-tailwindcss/variants'
 
-type ButtonConfig = Parameters<typeof tv>[0]
+type ButtonConfig = Parameters<ReturnType<typeof create>['tv']>[0]
 
 const config: ButtonConfig = {
   base: 'inline-flex items-center justify-center rounded-md px-3 py-2 text-sm font-medium',
@@ -33,14 +35,18 @@ const config: ButtonConfig = {
   },
 }
 
-let tvRuntime = tv
-
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+let isH5 = false
 // #ifdef H5
-const { tv: tvWeb } = create({ escape: false, unescape: false })
-tvRuntime = tvWeb
+isH5 = true
 // #endif
 
-export const button = tvRuntime(config)
+const { tv } = create({
+  escape: !isH5,
+  unescape: !isH5,
+})
+
+export const button = tv(config)
 ```
 
 ### 小程序 / H5 共用页面（`src/pages/index/index.vue`）
@@ -65,12 +71,14 @@ import { button } from '@/ui/button.variants'
 
 ## Demo 2：Taro + Web（React + TSX）
 
+同一份 `tv` 实例即可覆盖小程序与 H5，通过环境变量决定是否关闭 escape/unescape。
+
 ### 共享变体（`src/ui/card.variants.ts`）
 
 ```ts
-import { tv, create } from '@weapp-tailwindcss/variants'
+import { create } from '@weapp-tailwindcss/variants'
 
-type CardConfig = Parameters<typeof tv>[0]
+type CardConfig = Parameters<ReturnType<typeof create>['tv']>[0]
 
 const config: CardConfig = {
   base: 'rounded-xl border border-[#E2E8F0] bg-white p-4 shadow-sm',
@@ -85,11 +93,14 @@ const config: CardConfig = {
   },
 }
 
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
 const isH5 = process.env.TARO_ENV === 'h5'
-const { tv: tvWeb } = create({ escape: false, unescape: false })
-const tvRuntime = isH5 ? tvWeb : tv
+const { tv } = create({
+  escape: !isH5,
+  unescape: !isH5,
+})
 
-export const card = tvRuntime(config)
+export const card = tv(config)
 ```
 
 ### 小程序页面（`src/pages/index/index.tsx`）

website/docs/community/packages-runtime/variants-v3.mdx

@@ -49,12 +49,14 @@ const tvBase = createTV({ twMerge: false })
 ```ts
 import { create } from '@weapp-tailwindcss/variants-v3'
 
-const { tv: tvWeb } = create({
-  escape: false,
-  unescape: false,
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+const isH5 = true
+const { tv } = create({
+  escape: !isH5,
+  unescape: !isH5,
 })
 
-const card = tvWeb({
+const card = tv({
   base: 'rounded-xl border border-[#E2E8F0] bg-white',
 })
 ```
@@ -78,8 +80,10 @@ const config = {
 }
 
 const button = tv(config)
-const { tv: tvWeb } = create({ escape: false, unescape: false })
-const buttonWeb = tvWeb(config)
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+const isH5 = true
+const { tv: tvRuntime } = create({ escape: !isH5, unescape: !isH5 })
+const buttonWeb = tvRuntime(config)
 ```
 
 ## 常见注意事项

website/docs/community/packages-runtime/variants.mdx

@@ -60,16 +60,18 @@ mergeLater({ twMerge: false }) // => 仅 escape，不合并
 ```ts
 import { create } from '@weapp-tailwindcss/variants'
 
-const { tv: tvWeb, cn: cnWeb } = create({
-  escape: false,
-  unescape: false,
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+const isH5 = true
+const { tv, cn } = create({
+  escape: !isH5,
+  unescape: !isH5,
 })
 
-const card = tvWeb({
+const card = tv({
   base: 'rounded-xl border border-[#E2E8F0] bg-white',
 })
 
-const className = cnWeb('text-[#0F172A]', 'text-[#1E293B]')()
+const className = cn('text-[#0F172A]', 'text-[#1E293B]')()
 ```
 
 ## Demo：复用同一配置
@@ -91,8 +93,10 @@ const buttonConfig = {
 }
 
 const button = tv(buttonConfig)
-const { tv: tvWeb } = create({ escape: false, unescape: false })
-const buttonWeb = tvWeb(buttonConfig)
+// 跨平台框架请自行判断是否为 H5 构建，通常可从环境变量读取。
+const isH5 = true
+const { tv: tvRuntime } = create({ escape: !isH5, unescape: !isH5 })
+const buttonWeb = tvRuntime(buttonConfig)
 ```
 
 ## 常见注意事项