@hagoss/postcss-legacy-ios-compat

English | 中文

面向旧版 iOS / Safari 的 PostCSS CSS 兼容补丁插件。

功能

1. 将独立的 translate / rotate / scale 降级为 transform（iOS 14 / Safari <= 14.6）
2. 为 UnoCSS / Tailwind 风格的 transform CSS 变量（var(--un-*) / var(--tw-*)）补上 fallback，避免未定义自定义属性导致整条 transform 在 iOS 14 上失效

安装

pnpm add -D @hagoss/postcss-legacy-ios-compat
# 或: npm i -D @hagoss/postcss-legacy-ios-compat

需要 postcss ^8 作为 peer dependency。

使用

postcss.config.js：

export default {
  plugins: {
    '@hagoss/postcss-legacy-ios-compat': {}
  }
}

或编程式调用：

import postcss from 'postcss'
import legacyIosCompat from '@hagoss/postcss-legacy-ios-compat'

const result = await postcss([legacyIosCompat()]).process(css, {
  from: undefined
})

开发

pnpm install
pnpm test
pnpm build

发版

版本号 / changelog / git tag 由 release-it 处理。推送到 npm 由 GitHub Actions 在 v* tag 上通过 Trusted Publishing（OIDC） 完成（publish.yml）。

首次发布（一次性）

1. 使用有 @hagoss 发布权限的账号执行 npm login
2. 在本仓库执行：

pnpm build
npm publish --access public

3. 到 npm 包设置 → Trusted Publisher → GitHub Actions：
   • Organization or user: hagofe
   • Repository: postcss-legacy-ios-compat
   • Workflow filename: publish.yml
   • Allowed action: npm publish

后续发版

pnpm release

会升版本、更新 CHANGELOG.md、创建 v* tag 并推送。Publish workflow 随后用 OIDC 执行 npm publish（无需长期 NPM_TOKEN）。

许可证

MIT