@weapp-tailwindcss/init 1.0.16 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -1
- package/README.zh-CN.md +11 -1
- package/dist/index.cjs +39 -13
- package/dist/index.d.ts +17 -3
- package/dist/index.js +39 -14
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,7 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
> English | [简体中文](./README.zh-CN.md)
|
|
4
4
|
|
|
5
|
-
This package initializes weapp-tailwindcss
|
|
5
|
+
This package initializes `weapp-tailwindcss` project configuration.
|
|
6
|
+
|
|
7
|
+
The default mode targets Tailwind CSS 4 and `weapp-tailwindcss` 5: it updates `package.json` and creates the CSS-first `src/app.css` entry without writing `postcss.config.*`, `tailwind.config.*`, `@tailwindcss/postcss`, or `autoprefixer`.
|
|
8
|
+
|
|
9
|
+
Use `mode: 'legacy'` explicitly when maintaining a Tailwind 3 project that still needs the old PostCSS and Tailwind configuration files.
|
|
6
10
|
|
|
7
11
|
## Website
|
|
8
12
|
|
package/README.zh-CN.md
CHANGED
|
@@ -2,7 +2,17 @@
|
|
|
2
2
|
|
|
3
3
|
> [English](./README.md) | 简体中文
|
|
4
4
|
|
|
5
|
-
这个包负责初始化 weapp-tailwindcss
|
|
5
|
+
这个包负责初始化 `weapp-tailwindcss` 相关配置。
|
|
6
|
+
|
|
7
|
+
默认模式面向 Tailwind CSS 4 / `weapp-tailwindcss` 5:只更新 `package.json` 并创建 CSS-first 入口 `src/app.css`,不会写入 `postcss.config.*`、`tailwind.config.*`,也不会添加 `@tailwindcss/postcss` 或 `autoprefixer`。
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
import { init } from '@weapp-tailwindcss/init'
|
|
11
|
+
|
|
12
|
+
await init({ cwd: process.cwd() })
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
需要维护旧版 Tailwind 3 项目时,显式传入 `mode: 'legacy'`,初始化器才会生成旧式 PostCSS 与 Tailwind 配置。
|
|
6
16
|
|
|
7
17
|
## 官网
|
|
8
18
|
|
package/dist/index.cjs
CHANGED
|
@@ -46,19 +46,24 @@ async function getLatestVersionInRange(packageName, versionRange, options) {
|
|
|
46
46
|
}
|
|
47
47
|
const defaultDevDeps = {
|
|
48
48
|
"tailwindcss": "4",
|
|
49
|
+
"weapp-tailwindcss": "5"
|
|
50
|
+
};
|
|
51
|
+
const legacyDevDeps = {
|
|
52
|
+
"tailwindcss": "3",
|
|
49
53
|
"postcss": "8",
|
|
50
54
|
"autoprefixer": "10",
|
|
51
55
|
"weapp-tailwindcss": "4"
|
|
52
56
|
};
|
|
53
|
-
async function getDevDepsVersions(options) {
|
|
54
|
-
|
|
57
|
+
async function getDevDepsVersions(options, mode = "v4") {
|
|
58
|
+
const deps = mode === "legacy" ? legacyDevDeps : defaultDevDeps;
|
|
59
|
+
return Object.fromEntries(await Promise.all(Object.entries(deps).map(async (x) => {
|
|
55
60
|
return [x[0], `^${await getLatestVersionInRange(...x, options)}`];
|
|
56
61
|
})));
|
|
57
62
|
}
|
|
58
63
|
//#endregion
|
|
59
64
|
//#region src/index.ts
|
|
60
65
|
async function createContext(options) {
|
|
61
|
-
const { cwd, pkgJsonBasename, postcssConfigBasename, tailwindConfigBasename, fetchOptions } = options;
|
|
66
|
+
const { cwd, pkgJsonBasename, postcssConfigBasename, tailwindConfigBasename, cssEntryBasename, sourceGlob, mode, fetchOptions } = options;
|
|
62
67
|
const pkgJsonPath = pathe.default.resolve(cwd, pkgJsonBasename);
|
|
63
68
|
if (await fs_extra.default.exists(pkgJsonPath)) {
|
|
64
69
|
const pkgJson = await fs_extra.default.readJson(pkgJsonPath);
|
|
@@ -66,19 +71,27 @@ async function createContext(options) {
|
|
|
66
71
|
pkgJson,
|
|
67
72
|
pkgJsonPath,
|
|
68
73
|
cwd,
|
|
69
|
-
versions: await getDevDepsVersions(fetchOptions),
|
|
74
|
+
versions: await getDevDepsVersions(fetchOptions, mode),
|
|
70
75
|
postcssConfigBasename,
|
|
71
76
|
tailwindConfigBasename,
|
|
77
|
+
cssEntryBasename,
|
|
78
|
+
sourceGlob,
|
|
79
|
+
mode,
|
|
72
80
|
get type() {
|
|
73
81
|
return pkgJson.type;
|
|
74
82
|
}
|
|
75
83
|
};
|
|
76
|
-
} else _weapp_tailwindcss_logger.logger.warn("当前目录下不存在 `package.json` 文件,初始化脚本将被跳过,请执行 `
|
|
84
|
+
} else _weapp_tailwindcss_logger.logger.warn("当前目录下不存在 `package.json` 文件,初始化脚本将被跳过,请执行 `pnpm init` 或手动创建 `package.json` 后重试 ");
|
|
77
85
|
}
|
|
78
86
|
async function updatePackageJson(ctx) {
|
|
79
87
|
for (const [key, value] of Object.entries(ctx.versions)) (0, _weapp_tailwindcss_shared.setValue)(ctx.pkgJson, `devDependencies.${key}`, value);
|
|
80
88
|
await fs_extra.default.writeJSON(ctx.pkgJsonPath, ctx.pkgJson, { spaces: 2 });
|
|
81
89
|
}
|
|
90
|
+
async function writeIfMissing(file, data) {
|
|
91
|
+
if (await fs_extra.default.exists(file)) return false;
|
|
92
|
+
await fs_extra.default.outputFile(file, data);
|
|
93
|
+
return true;
|
|
94
|
+
}
|
|
82
95
|
async function touchPostcssConfig(ctx) {
|
|
83
96
|
const data = `${ctx.type === "module" ? "export default " : "module.exports = "}{
|
|
84
97
|
plugins: {
|
|
@@ -88,7 +101,7 @@ async function touchPostcssConfig(ctx) {
|
|
|
88
101
|
},
|
|
89
102
|
}
|
|
90
103
|
`;
|
|
91
|
-
await
|
|
104
|
+
return await writeIfMissing(pathe.default.resolve(ctx.cwd, ctx.postcssConfigBasename), data);
|
|
92
105
|
}
|
|
93
106
|
async function touchTailwindConfig(ctx) {
|
|
94
107
|
const data = `/** @type {import('tailwindcss').Config} */
|
|
@@ -105,14 +118,23 @@ ${ctx.type === "module" ? "export default " : "module.exports = "}{
|
|
|
105
118
|
},
|
|
106
119
|
}
|
|
107
120
|
`;
|
|
108
|
-
await
|
|
121
|
+
return await writeIfMissing(pathe.default.resolve(ctx.cwd, ctx.tailwindConfigBasename), data);
|
|
122
|
+
}
|
|
123
|
+
async function touchCssEntry(ctx) {
|
|
124
|
+
const data = `@import "tailwindcss";
|
|
125
|
+
@source "${ctx.sourceGlob}";
|
|
126
|
+
`;
|
|
127
|
+
return await writeIfMissing(pathe.default.resolve(ctx.cwd, ctx.cssEntryBasename), data);
|
|
109
128
|
}
|
|
110
129
|
function getInitDefaults() {
|
|
111
130
|
return {
|
|
112
131
|
cwd: node_process.default.cwd(),
|
|
113
132
|
postcssConfigBasename: "postcss.config.js",
|
|
114
133
|
tailwindConfigBasename: "tailwind.config.js",
|
|
115
|
-
|
|
134
|
+
cssEntryBasename: "src/app.css",
|
|
135
|
+
sourceGlob: "./**/*.{html,js,ts,jsx,tsx,vue,wxml}",
|
|
136
|
+
pkgJsonBasename: "package.json",
|
|
137
|
+
mode: "v4"
|
|
116
138
|
};
|
|
117
139
|
}
|
|
118
140
|
async function init(options) {
|
|
@@ -120,17 +142,21 @@ async function init(options) {
|
|
|
120
142
|
if (ctx) {
|
|
121
143
|
await updatePackageJson(ctx);
|
|
122
144
|
_weapp_tailwindcss_logger.logger.success("`package.json` 文件修改完成!");
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
145
|
+
if (ctx.mode === "legacy") {
|
|
146
|
+
if (await touchPostcssConfig(ctx)) _weapp_tailwindcss_logger.logger.success("`postcss.config.js` 文件创建完成!");
|
|
147
|
+
if (await touchTailwindConfig(ctx)) _weapp_tailwindcss_logger.logger.success("`tailwind.config.js` 文件创建完成!");
|
|
148
|
+
_weapp_tailwindcss_logger.logger.success("`weapp-tailwindcss` 旧版初始化完成!");
|
|
149
|
+
return;
|
|
150
|
+
}
|
|
151
|
+
if (await touchCssEntry(ctx)) _weapp_tailwindcss_logger.logger.success(`\`${ctx.cssEntryBasename}\` 文件创建完成!`);
|
|
152
|
+
_weapp_tailwindcss_logger.logger.success("`weapp-tailwindcss` v5 初始化完成!请将 WeappTailwindcss() 注册到项目构建器,并确认入口 CSS 被实际引入。");
|
|
128
153
|
}
|
|
129
154
|
}
|
|
130
155
|
//#endregion
|
|
131
156
|
exports.createContext = createContext;
|
|
132
157
|
exports.getInitDefaults = getInitDefaults;
|
|
133
158
|
exports.init = init;
|
|
159
|
+
exports.touchCssEntry = touchCssEntry;
|
|
134
160
|
exports.touchPostcssConfig = touchPostcssConfig;
|
|
135
161
|
exports.touchTailwindConfig = touchTailwindConfig;
|
|
136
162
|
exports.updatePackageJson = updatePackageJson;
|
package/dist/index.d.ts
CHANGED
|
@@ -299,6 +299,7 @@ type PackageJsonExports = string | PackageJsonExportsObject | Array<string | Pac
|
|
|
299
299
|
//#endregion
|
|
300
300
|
//#region src/npm.d.ts
|
|
301
301
|
type FetchOptions = Options;
|
|
302
|
+
type InitMode = 'v4' | 'legacy';
|
|
302
303
|
//#endregion
|
|
303
304
|
//#region src/index.d.ts
|
|
304
305
|
interface CreateContextOptions {
|
|
@@ -306,6 +307,9 @@ interface CreateContextOptions {
|
|
|
306
307
|
pkgJsonBasename?: string;
|
|
307
308
|
postcssConfigBasename?: string;
|
|
308
309
|
tailwindConfigBasename?: string;
|
|
310
|
+
cssEntryBasename?: string;
|
|
311
|
+
sourceGlob?: string;
|
|
312
|
+
mode?: InitMode;
|
|
309
313
|
fetchOptions?: FetchOptions;
|
|
310
314
|
}
|
|
311
315
|
declare function createContext(options: Required<CreateContextOptions>): Promise<{
|
|
@@ -313,6 +317,9 @@ declare function createContext(options: Required<CreateContextOptions>): Promise
|
|
|
313
317
|
pkgJsonPath: string;
|
|
314
318
|
cwd: string;
|
|
315
319
|
versions: {
|
|
320
|
+
tailwindcss: string;
|
|
321
|
+
'weapp-tailwindcss': string;
|
|
322
|
+
} | {
|
|
316
323
|
tailwindcss: string;
|
|
317
324
|
postcss: string;
|
|
318
325
|
autoprefixer: string;
|
|
@@ -320,18 +327,25 @@ declare function createContext(options: Required<CreateContextOptions>): Promise
|
|
|
320
327
|
};
|
|
321
328
|
postcssConfigBasename: string;
|
|
322
329
|
tailwindConfigBasename: string;
|
|
330
|
+
cssEntryBasename: string;
|
|
331
|
+
sourceGlob: string;
|
|
332
|
+
mode: InitMode;
|
|
323
333
|
readonly type: "module" | "commonjs" | undefined;
|
|
324
334
|
} | undefined>;
|
|
325
335
|
type Context = Exclude<Awaited<ReturnType<typeof createContext>>, undefined>;
|
|
326
336
|
declare function updatePackageJson(ctx: Context): Promise<void>;
|
|
327
|
-
declare function touchPostcssConfig(ctx: Context): Promise<
|
|
328
|
-
declare function touchTailwindConfig(ctx: Context): Promise<
|
|
337
|
+
declare function touchPostcssConfig(ctx: Context): Promise<boolean>;
|
|
338
|
+
declare function touchTailwindConfig(ctx: Context): Promise<boolean>;
|
|
339
|
+
declare function touchCssEntry(ctx: Context): Promise<boolean>;
|
|
329
340
|
declare function getInitDefaults(): {
|
|
330
341
|
cwd: string;
|
|
331
342
|
postcssConfigBasename: string;
|
|
332
343
|
tailwindConfigBasename: string;
|
|
344
|
+
cssEntryBasename: string;
|
|
345
|
+
sourceGlob: string;
|
|
333
346
|
pkgJsonBasename: string;
|
|
347
|
+
mode: InitMode;
|
|
334
348
|
};
|
|
335
349
|
declare function init(options?: CreateContextOptions): Promise<void>;
|
|
336
350
|
//#endregion
|
|
337
|
-
export { Context, CreateContextOptions, createContext, getInitDefaults, init, touchPostcssConfig, touchTailwindConfig, updatePackageJson };
|
|
351
|
+
export { Context, CreateContextOptions, createContext, getInitDefaults, init, touchCssEntry, touchPostcssConfig, touchTailwindConfig, updatePackageJson };
|
package/dist/index.js
CHANGED
|
@@ -20,19 +20,24 @@ async function getLatestVersionInRange(packageName, versionRange, options) {
|
|
|
20
20
|
}
|
|
21
21
|
const defaultDevDeps = {
|
|
22
22
|
"tailwindcss": "4",
|
|
23
|
+
"weapp-tailwindcss": "5"
|
|
24
|
+
};
|
|
25
|
+
const legacyDevDeps = {
|
|
26
|
+
"tailwindcss": "3",
|
|
23
27
|
"postcss": "8",
|
|
24
28
|
"autoprefixer": "10",
|
|
25
29
|
"weapp-tailwindcss": "4"
|
|
26
30
|
};
|
|
27
|
-
async function getDevDepsVersions(options) {
|
|
28
|
-
|
|
31
|
+
async function getDevDepsVersions(options, mode = "v4") {
|
|
32
|
+
const deps = mode === "legacy" ? legacyDevDeps : defaultDevDeps;
|
|
33
|
+
return Object.fromEntries(await Promise.all(Object.entries(deps).map(async (x) => {
|
|
29
34
|
return [x[0], `^${await getLatestVersionInRange(...x, options)}`];
|
|
30
35
|
})));
|
|
31
36
|
}
|
|
32
37
|
//#endregion
|
|
33
38
|
//#region src/index.ts
|
|
34
39
|
async function createContext(options) {
|
|
35
|
-
const { cwd, pkgJsonBasename, postcssConfigBasename, tailwindConfigBasename, fetchOptions } = options;
|
|
40
|
+
const { cwd, pkgJsonBasename, postcssConfigBasename, tailwindConfigBasename, cssEntryBasename, sourceGlob, mode, fetchOptions } = options;
|
|
36
41
|
const pkgJsonPath = path.resolve(cwd, pkgJsonBasename);
|
|
37
42
|
if (await fs.exists(pkgJsonPath)) {
|
|
38
43
|
const pkgJson = await fs.readJson(pkgJsonPath);
|
|
@@ -40,19 +45,27 @@ async function createContext(options) {
|
|
|
40
45
|
pkgJson,
|
|
41
46
|
pkgJsonPath,
|
|
42
47
|
cwd,
|
|
43
|
-
versions: await getDevDepsVersions(fetchOptions),
|
|
48
|
+
versions: await getDevDepsVersions(fetchOptions, mode),
|
|
44
49
|
postcssConfigBasename,
|
|
45
50
|
tailwindConfigBasename,
|
|
51
|
+
cssEntryBasename,
|
|
52
|
+
sourceGlob,
|
|
53
|
+
mode,
|
|
46
54
|
get type() {
|
|
47
55
|
return pkgJson.type;
|
|
48
56
|
}
|
|
49
57
|
};
|
|
50
|
-
} else logger.warn("当前目录下不存在 `package.json` 文件,初始化脚本将被跳过,请执行 `
|
|
58
|
+
} else logger.warn("当前目录下不存在 `package.json` 文件,初始化脚本将被跳过,请执行 `pnpm init` 或手动创建 `package.json` 后重试 ");
|
|
51
59
|
}
|
|
52
60
|
async function updatePackageJson(ctx) {
|
|
53
61
|
for (const [key, value] of Object.entries(ctx.versions)) setValue(ctx.pkgJson, `devDependencies.${key}`, value);
|
|
54
62
|
await fs.writeJSON(ctx.pkgJsonPath, ctx.pkgJson, { spaces: 2 });
|
|
55
63
|
}
|
|
64
|
+
async function writeIfMissing(file, data) {
|
|
65
|
+
if (await fs.exists(file)) return false;
|
|
66
|
+
await fs.outputFile(file, data);
|
|
67
|
+
return true;
|
|
68
|
+
}
|
|
56
69
|
async function touchPostcssConfig(ctx) {
|
|
57
70
|
const data = `${ctx.type === "module" ? "export default " : "module.exports = "}{
|
|
58
71
|
plugins: {
|
|
@@ -62,7 +75,7 @@ async function touchPostcssConfig(ctx) {
|
|
|
62
75
|
},
|
|
63
76
|
}
|
|
64
77
|
`;
|
|
65
|
-
await
|
|
78
|
+
return await writeIfMissing(path.resolve(ctx.cwd, ctx.postcssConfigBasename), data);
|
|
66
79
|
}
|
|
67
80
|
async function touchTailwindConfig(ctx) {
|
|
68
81
|
const data = `/** @type {import('tailwindcss').Config} */
|
|
@@ -79,14 +92,23 @@ ${ctx.type === "module" ? "export default " : "module.exports = "}{
|
|
|
79
92
|
},
|
|
80
93
|
}
|
|
81
94
|
`;
|
|
82
|
-
await
|
|
95
|
+
return await writeIfMissing(path.resolve(ctx.cwd, ctx.tailwindConfigBasename), data);
|
|
96
|
+
}
|
|
97
|
+
async function touchCssEntry(ctx) {
|
|
98
|
+
const data = `@import "tailwindcss";
|
|
99
|
+
@source "${ctx.sourceGlob}";
|
|
100
|
+
`;
|
|
101
|
+
return await writeIfMissing(path.resolve(ctx.cwd, ctx.cssEntryBasename), data);
|
|
83
102
|
}
|
|
84
103
|
function getInitDefaults() {
|
|
85
104
|
return {
|
|
86
105
|
cwd: process.cwd(),
|
|
87
106
|
postcssConfigBasename: "postcss.config.js",
|
|
88
107
|
tailwindConfigBasename: "tailwind.config.js",
|
|
89
|
-
|
|
108
|
+
cssEntryBasename: "src/app.css",
|
|
109
|
+
sourceGlob: "./**/*.{html,js,ts,jsx,tsx,vue,wxml}",
|
|
110
|
+
pkgJsonBasename: "package.json",
|
|
111
|
+
mode: "v4"
|
|
90
112
|
};
|
|
91
113
|
}
|
|
92
114
|
async function init(options) {
|
|
@@ -94,12 +116,15 @@ async function init(options) {
|
|
|
94
116
|
if (ctx) {
|
|
95
117
|
await updatePackageJson(ctx);
|
|
96
118
|
logger.success("`package.json` 文件修改完成!");
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
119
|
+
if (ctx.mode === "legacy") {
|
|
120
|
+
if (await touchPostcssConfig(ctx)) logger.success("`postcss.config.js` 文件创建完成!");
|
|
121
|
+
if (await touchTailwindConfig(ctx)) logger.success("`tailwind.config.js` 文件创建完成!");
|
|
122
|
+
logger.success("`weapp-tailwindcss` 旧版初始化完成!");
|
|
123
|
+
return;
|
|
124
|
+
}
|
|
125
|
+
if (await touchCssEntry(ctx)) logger.success(`\`${ctx.cssEntryBasename}\` 文件创建完成!`);
|
|
126
|
+
logger.success("`weapp-tailwindcss` v5 初始化完成!请将 WeappTailwindcss() 注册到项目构建器,并确认入口 CSS 被实际引入。");
|
|
102
127
|
}
|
|
103
128
|
}
|
|
104
129
|
//#endregion
|
|
105
|
-
export { createContext, getInitDefaults, init, touchPostcssConfig, touchTailwindConfig, updatePackageJson };
|
|
130
|
+
export { createContext, getInitDefaults, init, touchCssEntry, touchPostcssConfig, touchTailwindConfig, updatePackageJson };
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@weapp-tailwindcss/init",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "
|
|
4
|
+
"version": "2.0.0",
|
|
5
5
|
"description": "Project initializer for cross-platform Tailwind CSS with weapp-tailwindcss. 用于初始化跨端 Tailwind CSS 项目的 weapp-tailwindcss 工具。",
|
|
6
6
|
"author": "ice breaker <1324318532@qq.com>",
|
|
7
7
|
"license": "MIT",
|