weapp-tailwindcss-custom-build

v2026.09.25

将 weapp-tailwindcss 集成到自研构建器或高级流水线,覆盖 `weapp-tailwindcss/core`、generator、Vite/Webpack/Rspack/Rollup/Rolldown/Gulp 生命周期、ModuleGraph、Tailwind Scanner/source candidates、watch/HMR、source map、weapp-style-injector 和分包样式隔离。Use for custom bundlers, Node API, build adapters, asset graphs, loaders, plugins, or subpackage style injection;普通框架与 CLI 配置使用 setup skill。

GitHub
安装命令
npx skhub add sonofmagic/weapp-tailwindcss-custom-build
Markdown
SKILL.md

weapp-tailwindcss custom build

围绕构建图和内存产物接入核心转换,避免用输出目录扫描补偿生命周期设计缺失。

工作流

  1. 先判断官方 Vite/Webpack/Rspack/Gulp 入口是否已满足需求;普通项目转到 $weapp-tailwindcss-setup。
  2. 确认调用方拥有的生命周期、模块图、CSS 生成结果、asset API、watch 事件和 source map 能力。
  3. 读取 references/core-api.md 设计 createCompiler() 的 root、snapshot、失效和转换时序;仅在兼容旧自动 runtime 流程时使用 createContext()。
  4. 涉及全局/分包样式注入时再读取 references/style-injection.md。
  5. 在 load、transform、loader result、compilation、bundle asset 或 stream/Vinyl 对象中维护源码和产物关系。
  6. watch 中把精确 dependency/module ID 交给 invalidate(),只重新生成返回的 root,再用新 snapshot 转换实际可达的模板和 JavaScript。
  7. 让初始扫描、transform 与 HMR 共用 Scanner 的文件范围和显式外部 source,不另建宽泛 glob。
  8. 通过 bundler API 写回产物和 source map,不直接修改输出目录。

官方 Vite、Webpack、Rspack 与 Gulp 适配器的 graph 路径已经共享 compiler session:每个插件 owner 只创建一个 compiler,按 scope 投影可达 root 的 snapshot。第三方框架可以复用同样的时序,但必须继续拥有自己的模块图、watch 调度和 asset/Vinyl 写回;不要把 bundler 对象传入 core,也不要把 module ID 当作文件系统路径。

不可破坏的边界

  • createCompiler() 管理 Tailwind root 会话、revision 和不可变 snapshot;它不接管模块图可达性、watch 调度或产物写回。
  • 同一构建周期复用 compiler,并让 CSS、模板和 JS 显式消费同一 snapshot。
  • createContext() 继续兼容自动 runtime 收集模式,不要把两种状态模型混在同一事务中。
  • transformWxss()、transformWxml()、transformJs() 返回类型不同,必须分别处理错误和 map。
  • snapshot classSet 来自 Tailwind 生成/验证结果,不把扫描到的所有字符串直接塞入集合。
  • module ID 是 opaque 值;invalidate() 不会替调用方规范化 POSIX、Windows、virtual ID 或 query。
  • 入口发现若确需文件系统扫描,集中在明确扫描层并测试;不要在 generateBundle 等后置阶段临时读源码。
  • Rspack rule condition 解析必须覆盖函数与组合条件,补丁保持幂等并仅作用于目标 CSS rule。

输出要求

输出生命周期图、数据所有权、API 调用时序、错误/缓存策略、产物写回方式和 watch 回归场景。

发现
标签

此技能尚未发布标签。

版本
最新版本元数据

版本

v2026.09.25

发布时间

Sep 25, 2026

分类

未分类

许可证

MIT

源路径

skills/weapp-tailwindcss/weapp-tailwindcss-custom-build

默认分支

main

最新提交

347f785

Tree SHA

c193afd