@weapp-tailwindcss/env 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 ice breaker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,35 @@
-# Temporary Holding Version
+# @weapp-tailwindcss/env
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> English | [简体中文](./README.zh-CN.md)
+
+Node.js build-time helpers for detecting mini-app frameworks, platforms and HBuilderX. The package has no runtime dependencies and supports ESM and CommonJS.
+
+## Install
+
+```sh
+pnpm add @weapp-tailwindcss/env
+```
+
+## Usage
+
+```ts
+import { detectAppType, normalizeFrameworkStylePlatform, resolveUniPlatformsFromEnv } from '@weapp-tailwindcss/env'
+
+const appType = detectAppType({ root: process.cwd(), detectEnv: true })
+const platform = normalizeFrameworkStylePlatform('wx', 'mpx') // mp-weixin
+const { uniPlatform } = resolveUniPlatformsFromEnv({ UNI_PLATFORM: 'h5' })
+```
+
+Framework detection supports weapp-vite, MPX, Taro, uni-app, uni-app Vite and uni-app x. `detectAppType` checks an explicit manifest, explicit package metadata, project files, then environment hints. Parent directory search defaults to enabled; use `searchUp: false` to inspect only the supplied root. Unknown frameworks return `undefined`.
+
+An explicit `env` object is an isolated snapshot: missing fields never inherit process variables. Without a snapshot, environment helpers read the current process on each call. `detectAppType` only reads process variables when `detectEnv: true`; individual platform resolvers retain their default environment value when called without a value or with `undefined`.
+
+## API
+
+- Framework detection: `detectAppType`, `detectAppTypeFromEnv`, `detectAppTypeFromPackageJson`.
+- Metadata predicates: `isMpxPackage`, `isTaroPackage`, `isUniAppPackage`, `isUniAppVitePackage`, `isUniAppXPackage`, `isWeappVitePackage`, `isUniAppXManifest`.
+- Environment hints: `isRunningInHBuilderX`.
+- Platforms: `resolvePlatform`, `resolveMpxPlatform`, `resolveTaroPlatform`, `resolveUniPlatform`, `resolveUniUtsPlatform`, `resolveUniAppXPlatform`, `resolveUniPlatformsFromEnv`, `normalizeFrameworkStylePlatform`.
+- Types: `DetectableAppType`, `DetectAppTypeOptions`, `FrameworkEnv`, `HBuilderXRuntimeHints`, `PackageJsonLike`, `UniAppManifestLike`, `UniPlatformInfo`.
+
+These helpers report facts. Bundler selection, generator targets and CSS policy belong to the caller. Existing imports from `weapp-tailwindcss` and `weapp-tailwindcss/framework` remain supported. The Vite-specific `resolveImplicitAppTypeFromViteRoot` stays in the main package.

package/README.zh-CN.md

@@ -0,0 +1,35 @@
+# @weapp-tailwindcss/env
+
+> [English](./README.md) | 简体中文
+
+用于 Node.js 构建期的环境、框架、平台与 HBuilderX 识别工具。没有运行时依赖，提供 ESM 和 CommonJS 入口。
+
+## 安装
+
+```sh
+pnpm add @weapp-tailwindcss/env
+```
+
+## 使用
+
+```ts
+import { detectAppType, normalizeFrameworkStylePlatform, resolveUniPlatformsFromEnv } from '@weapp-tailwindcss/env'
+
+const appType = detectAppType({ root: process.cwd(), detectEnv: true })
+const platform = normalizeFrameworkStylePlatform('wx', 'mpx') // mp-weixin
+const { uniPlatform } = resolveUniPlatformsFromEnv({ UNI_PLATFORM: 'h5' })
+```
+
+支持 weapp-vite、MPX、Taro、uni-app、uni-app Vite 和 uni-app x。`detectAppType` 按显式 manifest、显式 package 信息、项目文件、环境提示的顺序判断。默认向父目录查找，`searchUp: false` 仅检查传入根目录；无法识别时返回 `undefined`。
+
+显式 `env` 是隔离快照：缺失字段不会继承进程环境。省略快照时，环境函数在每次调用时读取当前进程。`detectAppType` 仅在 `detectEnv: true` 时读取进程环境；单值平台函数省略参数或传入 `undefined` 时仍使用对应环境变量。
+
+## API
+
+- 框架检测：`detectAppType`、`detectAppTypeFromEnv`、`detectAppTypeFromPackageJson`。
+- 配置判断：`isMpxPackage`、`isTaroPackage`、`isUniAppPackage`、`isUniAppVitePackage`、`isUniAppXPackage`、`isWeappVitePackage`、`isUniAppXManifest`。
+- 环境提示：`isRunningInHBuilderX`。
+- 平台：`resolvePlatform`、`resolveMpxPlatform`、`resolveTaroPlatform`、`resolveUniPlatform`、`resolveUniUtsPlatform`、`resolveUniAppXPlatform`、`resolveUniPlatformsFromEnv`、`normalizeFrameworkStylePlatform`。
+- 类型：`DetectableAppType`、`DetectAppTypeOptions`、`FrameworkEnv`、`HBuilderXRuntimeHints`、`PackageJsonLike`、`UniAppManifestLike`、`UniPlatformInfo`。
+
+本包提供事实识别，由调用方决定构建器分支、生成器 target 和样式策略。`weapp-tailwindcss` 与 `weapp-tailwindcss/framework` 的既有导入继续可用；Vite 专用的 `resolveImplicitAppTypeFromViteRoot` 保留在主包。

package/dist/index.cjs

@@ -0,0 +1,274 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let node_process = require("node:process");
+node_process = __toESM(node_process, 1);
+let node_path = require("node:path");
+node_path = __toESM(node_path, 1);
+let node_fs = require("node:fs");
+//#region src/environment.ts
+function getProcessEnv() {
+	return {
+		MPX_CLI_MODE: node_process.default.env["MPX_CLI_MODE"],
+		MPX_CURRENT_TARGET_MODE: node_process.default.env["MPX_CURRENT_TARGET_MODE"],
+		NODE_PATH: node_process.default.env["NODE_PATH"],
+		TARO_ENV: node_process.default.env["TARO_ENV"],
+		UNI_PLATFORM: node_process.default.env["UNI_PLATFORM"],
+		UNI_UTS_PLATFORM: node_process.default.env["UNI_UTS_PLATFORM"],
+		WEAPP_TAILWINDCSS_TARGET: node_process.default.env["WEAPP_TAILWINDCSS_TARGET"],
+		WEAPP_TW_TARGET: node_process.default.env["WEAPP_TW_TARGET"]
+	};
+}
+//#endregion
+//#region src/hbuilderx.ts
+const KNOWN_MAC_HBUILDERX_PLUGIN_DIRS = ["/Applications/HBuilderX.app/Contents/HBuilderX/plugins/uniapp-cli-vite", "/Applications/HBuilderX.app/Contents/HBuilderX/plugins/uniapp-cli"];
+const HBUILDERX_PLUGIN_CWD_RE = /[\\/]HBuilderX(?:\.[^\\/]*)?(?:[\\/]Contents[\\/]HBuilderX)?[\\/]plugins[\\/]uniapp-cli(?:-vite)?(?:[\\/]|$)/i;
+function hasKnownHBuilderXPluginPrefix(normalizedCwd) {
+	for (const dir of KNOWN_MAC_HBUILDERX_PLUGIN_DIRS) {
+		const normalizedDir = node_path.default.normalize(dir);
+		if (normalizedCwd === normalizedDir || normalizedCwd.startsWith(`${normalizedDir}${node_path.default.sep}`)) return true;
+	}
+	return false;
+}
+function matchesHBuilderXPluginCwd(cwd) {
+	const normalized = node_path.default.normalize(cwd);
+	if (hasKnownHBuilderXPluginPrefix(normalized)) return true;
+	return HBUILDERX_PLUGIN_CWD_RE.test(normalized);
+}
+function isRunningInHBuilderX(options = {}) {
+	const env = options.env ?? getProcessEnv();
+	const nodePath = "nodePath" in options ? options.nodePath : env.NODE_PATH;
+	if (!(nodePath == null || nodePath.trim().length === 0)) return false;
+	return matchesHBuilderXPluginCwd(options.cwd ?? node_process.default.cwd());
+}
+//#endregion
+//#region src/platform.ts
+const MINI_PROGRAM_PLATFORMS = /* @__PURE__ */ new Set([
+	"alipay",
+	"baidu",
+	"jd",
+	"qq",
+	"swan",
+	"tt",
+	"weapp",
+	"wechat",
+	"wx"
+]);
+function normalizePlatform(value) {
+	return value?.trim().toLowerCase() || void 0;
+}
+function resolvePlatformInfo(value) {
+	const normalized = normalizePlatform(value);
+	const isAppAndroid = normalized === "app-android";
+	const isAppIos = normalized === "app-ios";
+	const isAppHarmony = normalized === "app-harmony";
+	return {
+		raw: value,
+		normalized,
+		isApp: normalized?.startsWith("app-") === true || normalized === "app" || normalized === "app-plus",
+		isAppAndroid,
+		isAppHarmony,
+		isAppIos,
+		isMp: normalized?.startsWith("mp-") === true || (normalized ? MINI_PROGRAM_PLATFORMS.has(normalized) : false),
+		isWeb: normalized?.startsWith("web") === true || normalized === "h5"
+	};
+}
+function resolvePlatform(value) {
+	return resolvePlatformInfo(value);
+}
+function resolveTaroPlatform(value = getProcessEnv().TARO_ENV) {
+	return resolvePlatform(value);
+}
+function resolveMpxPlatformValue(env = getProcessEnv()) {
+	return env.MPX_CURRENT_TARGET_MODE ?? env.MPX_CLI_MODE;
+}
+function resolveMpxPlatform(value = resolveMpxPlatformValue()) {
+	return resolvePlatform(value);
+}
+function resolveUniPlatform(value = getProcessEnv().UNI_PLATFORM) {
+	return resolvePlatform(value);
+}
+function resolveUniUtsPlatform(value = getProcessEnv().UNI_UTS_PLATFORM) {
+	return resolvePlatform(value);
+}
+function resolveUniAppXPlatform(value = getProcessEnv().UNI_UTS_PLATFORM) {
+	return resolvePlatform(value);
+}
+function resolveUniPlatformsFromEnv(env = getProcessEnv()) {
+	return {
+		uniPlatform: resolvePlatform(env.UNI_PLATFORM),
+		uniAppXPlatform: resolvePlatform(env.UNI_UTS_PLATFORM),
+		uniUtsPlatform: resolvePlatform(env.UNI_UTS_PLATFORM)
+	};
+}
+const MPX_TO_UNI_PLATFORM = {
+	ali: "mp-alipay",
+	dd: "mp-dingtalk",
+	jd: "mp-jd",
+	qq: "mp-qq",
+	swan: "mp-baidu",
+	tt: "mp-toutiao",
+	wx: "mp-weixin"
+};
+function normalizeFrameworkStylePlatform(platform, appType) {
+	const normalized = platform?.trim().toLowerCase();
+	if (!normalized) return;
+	if (appType === "mpx") return MPX_TO_UNI_PLATFORM[normalized] ?? normalized;
+	return normalized;
+}
+//#endregion
+//#region src/detect-env.ts
+function detectAppTypeFromEnv(env = getProcessEnv(), options = {}) {
+	if (env.WEAPP_TW_TARGET === "weapp-vite" || env.WEAPP_TAILWINDCSS_TARGET === "weapp-vite") return "weapp-vite";
+	if (env.TARO_ENV) return "taro";
+	if (env.MPX_CLI_MODE || env.MPX_CURRENT_TARGET_MODE) return "mpx";
+	const { uniPlatform, uniUtsPlatform } = resolveUniPlatformsFromEnv(env);
+	if (uniUtsPlatform.normalized) return "uni-app-x";
+	if (uniPlatform.normalized) return "uni-app-vite";
+	if (isRunningInHBuilderX({
+		cwd: options.cwd,
+		env
+	})) return options.hbuilderxVite === false ? "uni-app" : "uni-app-vite";
+}
+//#endregion
+//#region src/package.ts
+const MPX_SCRIPT_RE = /\bmpx(?:-cli-service)?\b/u;
+const TARO_SCRIPT_RE = /\btaro\b/u;
+const WEAPP_VITE_SCRIPT_RE = /\bweapp-vite\b/u;
+const UNI_APP_SCRIPT_RE = /\buni(?:\s|$)/u;
+const UNI_APP_VITE_SCRIPT_RE = /\buni(?:\s|$)/u;
+function resolveDependencyNames(pkg) {
+	return /* @__PURE__ */ new Set([
+		...Object.keys(pkg.dependencies ?? {}),
+		...Object.keys(pkg.devDependencies ?? {}),
+		...Object.keys(pkg.peerDependencies ?? {}),
+		...Object.keys(pkg.optionalDependencies ?? {})
+	]);
+}
+function hasDependencyPrefix(dependencyNames, prefix) {
+	return [...dependencyNames].some((name) => name.startsWith(prefix));
+}
+function hasScriptMatch(pkg, pattern) {
+	return Object.values(pkg.scripts ?? {}).some((script) => pattern.test(script));
+}
+function isWeappVitePackage(pkg) {
+	const dependencyNames = resolveDependencyNames(pkg);
+	return dependencyNames.has("weapp-vite") || hasDependencyPrefix(dependencyNames, "@weapp-vite/") || hasScriptMatch(pkg, WEAPP_VITE_SCRIPT_RE);
+}
+function isMpxPackage(pkg) {
+	return hasDependencyPrefix(resolveDependencyNames(pkg), "@mpxjs/") || hasScriptMatch(pkg, MPX_SCRIPT_RE);
+}
+function isTaroPackage(pkg) {
+	return hasDependencyPrefix(resolveDependencyNames(pkg), "@tarojs/") || hasScriptMatch(pkg, TARO_SCRIPT_RE);
+}
+function isUniAppVitePackage(pkg) {
+	return resolveDependencyNames(pkg).has("@dcloudio/vite-plugin-uni") || hasScriptMatch(pkg, UNI_APP_VITE_SCRIPT_RE);
+}
+function isUniAppXPackage(pkg) {
+	const dependencyNames = resolveDependencyNames(pkg);
+	return dependencyNames.has("@dcloudio/uni-uts-v1") || dependencyNames.has("@weapp-tailwindcss/debug-uni-app-x");
+}
+function isUniAppPackage(pkg) {
+	const dependencyNames = resolveDependencyNames(pkg);
+	return dependencyNames.has("@dcloudio/vue-cli-plugin-uni") || dependencyNames.has("@dcloudio/uni-app") || Object.hasOwn(pkg, "uni-app") || hasScriptMatch(pkg, UNI_APP_SCRIPT_RE);
+}
+function isUniAppXManifest(manifest) {
+	return Boolean(manifest && Object.hasOwn(manifest, "uni-app-x"));
+}
+function detectAppTypeFromPackageJson(pkg) {
+	if (isWeappVitePackage(pkg)) return "weapp-vite";
+	if (isMpxPackage(pkg)) return "mpx";
+	if (isTaroPackage(pkg)) return "taro";
+	if (isUniAppXPackage(pkg)) return "uni-app-x";
+	if (isUniAppVitePackage(pkg)) return "uni-app-vite";
+	if (isUniAppPackage(pkg)) return "uni-app";
+}
+//#endregion
+//#region src/project.ts
+const PACKAGE_JSON_FILE = "package.json";
+const MANIFEST_JSON_FILE = "manifest.json";
+const MPX_MARKERS = [["src", "app.mpx"], ["app.mpx"]];
+function tryReadJson(file) {
+	if (!(0, node_fs.existsSync)(file)) return;
+	try {
+		return JSON.parse((0, node_fs.readFileSync)(file, "utf8"));
+	} catch {}
+}
+function detectAppTypeFromMarkers(root) {
+	for (const segments of MPX_MARKERS) if ((0, node_fs.existsSync)(node_path.default.join(root, ...segments))) return "mpx";
+}
+function detectAppTypeFromRoot(root, searchUp = true) {
+	const resolvedRoot = node_path.default.resolve(root);
+	if (!(0, node_fs.existsSync)(resolvedRoot)) return;
+	const markerDetected = detectAppTypeFromMarkers(resolvedRoot);
+	if (markerDetected) return markerDetected;
+	let current = resolvedRoot;
+	while (true) {
+		if (isUniAppXManifest(tryReadJson(node_path.default.join(current, MANIFEST_JSON_FILE)))) return "uni-app-x";
+		const pkg = tryReadJson(node_path.default.join(current, PACKAGE_JSON_FILE));
+		if (pkg) {
+			const detected = detectAppTypeFromPackageJson(pkg);
+			if (detected) return detected;
+		}
+		if (!searchUp) break;
+		const parent = node_path.default.dirname(current);
+		if (parent === current) break;
+		current = parent;
+	}
+}
+function detectAppType(options = {}) {
+	if (isUniAppXManifest(options.manifest)) return "uni-app-x";
+	if (options.packageJson) {
+		const detected = detectAppTypeFromPackageJson(options.packageJson);
+		if (detected) return detected;
+	}
+	if (options.root) {
+		const detected = detectAppTypeFromRoot(options.root, options.searchUp ?? true);
+		if (detected) return detected;
+	}
+	const env = options.env ?? (options.detectEnv ? getProcessEnv() : void 0);
+	if (env) return detectAppTypeFromEnv(env, {
+		cwd: options.cwd ?? options.root ?? (options.detectEnv ? node_process.default.cwd() : void 0),
+		hbuilderxVite: options.hbuilderxVite
+	});
+}
+//#endregion
+exports.detectAppType = detectAppType;
+exports.detectAppTypeFromEnv = detectAppTypeFromEnv;
+exports.detectAppTypeFromPackageJson = detectAppTypeFromPackageJson;
+exports.isMpxPackage = isMpxPackage;
+exports.isRunningInHBuilderX = isRunningInHBuilderX;
+exports.isTaroPackage = isTaroPackage;
+exports.isUniAppPackage = isUniAppPackage;
+exports.isUniAppVitePackage = isUniAppVitePackage;
+exports.isUniAppXManifest = isUniAppXManifest;
+exports.isUniAppXPackage = isUniAppXPackage;
+exports.isWeappVitePackage = isWeappVitePackage;
+exports.normalizeFrameworkStylePlatform = normalizeFrameworkStylePlatform;
+exports.resolveMpxPlatform = resolveMpxPlatform;
+exports.resolvePlatform = resolvePlatform;
+exports.resolveTaroPlatform = resolveTaroPlatform;
+exports.resolveUniAppXPlatform = resolveUniAppXPlatform;
+exports.resolveUniPlatform = resolveUniPlatform;
+exports.resolveUniPlatformsFromEnv = resolveUniPlatformsFromEnv;
+exports.resolveUniUtsPlatform = resolveUniUtsPlatform;

package/dist/index.d.cts

@@ -0,0 +1,108 @@
+//#region src/types.d.ts
+type DetectableAppType = 'mpx' | 'taro' | 'uni-app' | 'uni-app-vite' | 'uni-app-x' | 'weapp-vite';
+type FrameworkEnv = Record<string, string | undefined> & Partial<Record<'MPX_CLI_MODE' | 'MPX_CURRENT_TARGET_MODE' | 'NODE_PATH' | 'TARO_ENV' | 'UNI_PLATFORM' | 'UNI_UTS_PLATFORM' | 'WEAPP_TAILWINDCSS_TARGET' | 'WEAPP_TW_TARGET', string | undefined>>;
+interface UniPlatformInfo {
+  raw: string | undefined;
+  normalized: string | undefined;
+  isApp: boolean;
+  isAppAndroid: boolean;
+  isAppHarmony: boolean;
+  isAppIos: boolean;
+  isMp: boolean;
+  isWeb: boolean;
+}
+interface HBuilderXRuntimeHints {
+  cwd?: string | undefined;
+  env?: FrameworkEnv | undefined;
+  nodePath?: string | null | undefined;
+}
+interface PackageJsonLike {
+  'dependencies'?: Record<string, string> | undefined;
+  'devDependencies'?: Record<string, string> | undefined;
+  'peerDependencies'?: Record<string, string> | undefined;
+  'optionalDependencies'?: Record<string, string> | undefined;
+  'scripts'?: Record<string, string> | undefined;
+  'uni-app'?: unknown;
+}
+interface UniAppManifestLike {
+  'uni-app-x'?: unknown;
+}
+interface DetectAppTypeOptions {
+  /**
+   * 项目根目录。传入后会读取 marker、manifest.json 与 package.json。
+   */
+  root?: string | undefined;
+  /**
+   * 已解析的 package.json 内容。适合在调用方已经读取配置时复用。
+   */
+  packageJson?: PackageJsonLike | undefined;
+  /**
+   * 已解析的 uni-app manifest.json 内容，用于识别 uni-app x。
+   */
+  manifest?: UniAppManifestLike | undefined;
+  /**
+   * 是否从 root 向上查找 package.json 与 manifest.json。
+   *
+   * @default `true`
+   */
+  searchUp?: boolean | undefined;
+  /**
+   * 环境变量快照。传入后可用于识别 HBuilderX、Taro、MPX 与 uni-app 运行环境。
+   * 缺失字段不会回退到进程环境。
+   */
+  env?: FrameworkEnv | undefined;
+  /**
+   * 是否读取当前进程环境变量参与推断。
+   *
+   * @default `false`
+   */
+  detectEnv?: boolean | undefined;
+  /**
+   * HBuilderX 插件运行时的工作目录。默认使用 `root`，启用 `detectEnv` 时会回退到 `process.cwd()`。
+   */
+  cwd?: string | undefined;
+  /**
+   * 是否在 HBuilderX 插件运行时把 uni-app 识别为 uni-app Vite。
+   *
+   * @default `true`
+   */
+  hbuilderxVite?: boolean | undefined;
+}
+//#endregion
+//#region src/detect-env.d.ts
+export declare function detectAppTypeFromEnv(env?: FrameworkEnv, options?: {
+  cwd?: string | undefined;
+  hbuilderxVite?: boolean | undefined;
+}): DetectableAppType | undefined;
+//#endregion
+//#region src/hbuilderx.d.ts
+export declare function isRunningInHBuilderX(options?: HBuilderXRuntimeHints): boolean;
+//#endregion
+//#region src/package.d.ts
+export declare function isWeappVitePackage(pkg: PackageJsonLike): boolean;
+export declare function isMpxPackage(pkg: PackageJsonLike): boolean;
+export declare function isTaroPackage(pkg: PackageJsonLike): boolean;
+export declare function isUniAppVitePackage(pkg: PackageJsonLike): boolean;
+export declare function isUniAppXPackage(pkg: PackageJsonLike): boolean;
+export declare function isUniAppPackage(pkg: PackageJsonLike): boolean;
+export declare function isUniAppXManifest(manifest: UniAppManifestLike | undefined): boolean;
+export declare function detectAppTypeFromPackageJson(pkg: PackageJsonLike): DetectableAppType | undefined;
+//#endregion
+//#region src/platform.d.ts
+export declare function resolvePlatform(value: string | undefined): UniPlatformInfo;
+export declare function resolveTaroPlatform(value?: string | undefined): UniPlatformInfo;
+export declare function resolveMpxPlatform(value?: string | undefined): UniPlatformInfo;
+export declare function resolveUniPlatform(value?: string | undefined): UniPlatformInfo;
+export declare function resolveUniUtsPlatform(value?: string | undefined): UniPlatformInfo;
+export declare function resolveUniAppXPlatform(value?: string | undefined): UniPlatformInfo;
+export declare function resolveUniPlatformsFromEnv(env?: FrameworkEnv): {
+  uniPlatform: UniPlatformInfo;
+  uniAppXPlatform: UniPlatformInfo;
+  uniUtsPlatform: UniPlatformInfo;
+};
+export declare function normalizeFrameworkStylePlatform(platform: string | undefined, appType: string | undefined): string | undefined;
+//#endregion
+//#region src/project.d.ts
+export declare function detectAppType(options?: DetectAppTypeOptions): DetectableAppType | undefined;
+//#endregion
+export type { DetectAppTypeOptions, DetectableAppType, FrameworkEnv, HBuilderXRuntimeHints, PackageJsonLike, UniAppManifestLike, UniPlatformInfo };

package/dist/index.d.ts

@@ -0,0 +1,108 @@
+//#region src/types.d.ts
+type DetectableAppType = 'mpx' | 'taro' | 'uni-app' | 'uni-app-vite' | 'uni-app-x' | 'weapp-vite';
+type FrameworkEnv = Record<string, string | undefined> & Partial<Record<'MPX_CLI_MODE' | 'MPX_CURRENT_TARGET_MODE' | 'NODE_PATH' | 'TARO_ENV' | 'UNI_PLATFORM' | 'UNI_UTS_PLATFORM' | 'WEAPP_TAILWINDCSS_TARGET' | 'WEAPP_TW_TARGET', string | undefined>>;
+interface UniPlatformInfo {
+  raw: string | undefined;
+  normalized: string | undefined;
+  isApp: boolean;
+  isAppAndroid: boolean;
+  isAppHarmony: boolean;
+  isAppIos: boolean;
+  isMp: boolean;
+  isWeb: boolean;
+}
+interface HBuilderXRuntimeHints {
+  cwd?: string | undefined;
+  env?: FrameworkEnv | undefined;
+  nodePath?: string | null | undefined;
+}
+interface PackageJsonLike {
+  'dependencies'?: Record<string, string> | undefined;
+  'devDependencies'?: Record<string, string> | undefined;
+  'peerDependencies'?: Record<string, string> | undefined;
+  'optionalDependencies'?: Record<string, string> | undefined;
+  'scripts'?: Record<string, string> | undefined;
+  'uni-app'?: unknown;
+}
+interface UniAppManifestLike {
+  'uni-app-x'?: unknown;
+}
+interface DetectAppTypeOptions {
+  /**
+   * 项目根目录。传入后会读取 marker、manifest.json 与 package.json。
+   */
+  root?: string | undefined;
+  /**
+   * 已解析的 package.json 内容。适合在调用方已经读取配置时复用。
+   */
+  packageJson?: PackageJsonLike | undefined;
+  /**
+   * 已解析的 uni-app manifest.json 内容，用于识别 uni-app x。
+   */
+  manifest?: UniAppManifestLike | undefined;
+  /**
+   * 是否从 root 向上查找 package.json 与 manifest.json。
+   *
+   * @default `true`
+   */
+  searchUp?: boolean | undefined;
+  /**
+   * 环境变量快照。传入后可用于识别 HBuilderX、Taro、MPX 与 uni-app 运行环境。
+   * 缺失字段不会回退到进程环境。
+   */
+  env?: FrameworkEnv | undefined;
+  /**
+   * 是否读取当前进程环境变量参与推断。
+   *
+   * @default `false`
+   */
+  detectEnv?: boolean | undefined;
+  /**
+   * HBuilderX 插件运行时的工作目录。默认使用 `root`，启用 `detectEnv` 时会回退到 `process.cwd()`。
+   */
+  cwd?: string | undefined;
+  /**
+   * 是否在 HBuilderX 插件运行时把 uni-app 识别为 uni-app Vite。
+   *
+   * @default `true`
+   */
+  hbuilderxVite?: boolean | undefined;
+}
+//#endregion
+//#region src/detect-env.d.ts
+export declare function detectAppTypeFromEnv(env?: FrameworkEnv, options?: {
+  cwd?: string | undefined;
+  hbuilderxVite?: boolean | undefined;
+}): DetectableAppType | undefined;
+//#endregion
+//#region src/hbuilderx.d.ts
+export declare function isRunningInHBuilderX(options?: HBuilderXRuntimeHints): boolean;
+//#endregion
+//#region src/package.d.ts
+export declare function isWeappVitePackage(pkg: PackageJsonLike): boolean;
+export declare function isMpxPackage(pkg: PackageJsonLike): boolean;
+export declare function isTaroPackage(pkg: PackageJsonLike): boolean;
+export declare function isUniAppVitePackage(pkg: PackageJsonLike): boolean;
+export declare function isUniAppXPackage(pkg: PackageJsonLike): boolean;
+export declare function isUniAppPackage(pkg: PackageJsonLike): boolean;
+export declare function isUniAppXManifest(manifest: UniAppManifestLike | undefined): boolean;
+export declare function detectAppTypeFromPackageJson(pkg: PackageJsonLike): DetectableAppType | undefined;
+//#endregion
+//#region src/platform.d.ts
+export declare function resolvePlatform(value: string | undefined): UniPlatformInfo;
+export declare function resolveTaroPlatform(value?: string | undefined): UniPlatformInfo;
+export declare function resolveMpxPlatform(value?: string | undefined): UniPlatformInfo;
+export declare function resolveUniPlatform(value?: string | undefined): UniPlatformInfo;
+export declare function resolveUniUtsPlatform(value?: string | undefined): UniPlatformInfo;
+export declare function resolveUniAppXPlatform(value?: string | undefined): UniPlatformInfo;
+export declare function resolveUniPlatformsFromEnv(env?: FrameworkEnv): {
+  uniPlatform: UniPlatformInfo;
+  uniAppXPlatform: UniPlatformInfo;
+  uniUtsPlatform: UniPlatformInfo;
+};
+export declare function normalizeFrameworkStylePlatform(platform: string | undefined, appType: string | undefined): string | undefined;
+//#endregion
+//#region src/project.d.ts
+export declare function detectAppType(options?: DetectAppTypeOptions): DetectableAppType | undefined;
+//#endregion
+export type { DetectAppTypeOptions, DetectableAppType, FrameworkEnv, HBuilderXRuntimeHints, PackageJsonLike, UniAppManifestLike, UniPlatformInfo };

package/dist/index.js

@@ -0,0 +1,231 @@
+import process from "node:process";
+import path from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+//#region src/environment.ts
+function getProcessEnv() {
+	return {
+		MPX_CLI_MODE: process.env["MPX_CLI_MODE"],
+		MPX_CURRENT_TARGET_MODE: process.env["MPX_CURRENT_TARGET_MODE"],
+		NODE_PATH: process.env["NODE_PATH"],
+		TARO_ENV: process.env["TARO_ENV"],
+		UNI_PLATFORM: process.env["UNI_PLATFORM"],
+		UNI_UTS_PLATFORM: process.env["UNI_UTS_PLATFORM"],
+		WEAPP_TAILWINDCSS_TARGET: process.env["WEAPP_TAILWINDCSS_TARGET"],
+		WEAPP_TW_TARGET: process.env["WEAPP_TW_TARGET"]
+	};
+}
+//#endregion
+//#region src/hbuilderx.ts
+const KNOWN_MAC_HBUILDERX_PLUGIN_DIRS = ["/Applications/HBuilderX.app/Contents/HBuilderX/plugins/uniapp-cli-vite", "/Applications/HBuilderX.app/Contents/HBuilderX/plugins/uniapp-cli"];
+const HBUILDERX_PLUGIN_CWD_RE = /[\\/]HBuilderX(?:\.[^\\/]*)?(?:[\\/]Contents[\\/]HBuilderX)?[\\/]plugins[\\/]uniapp-cli(?:-vite)?(?:[\\/]|$)/i;
+function hasKnownHBuilderXPluginPrefix(normalizedCwd) {
+	for (const dir of KNOWN_MAC_HBUILDERX_PLUGIN_DIRS) {
+		const normalizedDir = path.normalize(dir);
+		if (normalizedCwd === normalizedDir || normalizedCwd.startsWith(`${normalizedDir}${path.sep}`)) return true;
+	}
+	return false;
+}
+function matchesHBuilderXPluginCwd(cwd) {
+	const normalized = path.normalize(cwd);
+	if (hasKnownHBuilderXPluginPrefix(normalized)) return true;
+	return HBUILDERX_PLUGIN_CWD_RE.test(normalized);
+}
+function isRunningInHBuilderX(options = {}) {
+	const env = options.env ?? getProcessEnv();
+	const nodePath = "nodePath" in options ? options.nodePath : env.NODE_PATH;
+	if (!(nodePath == null || nodePath.trim().length === 0)) return false;
+	return matchesHBuilderXPluginCwd(options.cwd ?? process.cwd());
+}
+//#endregion
+//#region src/platform.ts
+const MINI_PROGRAM_PLATFORMS = /* @__PURE__ */ new Set([
+	"alipay",
+	"baidu",
+	"jd",
+	"qq",
+	"swan",
+	"tt",
+	"weapp",
+	"wechat",
+	"wx"
+]);
+function normalizePlatform(value) {
+	return value?.trim().toLowerCase() || void 0;
+}
+function resolvePlatformInfo(value) {
+	const normalized = normalizePlatform(value);
+	const isAppAndroid = normalized === "app-android";
+	const isAppIos = normalized === "app-ios";
+	const isAppHarmony = normalized === "app-harmony";
+	return {
+		raw: value,
+		normalized,
+		isApp: normalized?.startsWith("app-") === true || normalized === "app" || normalized === "app-plus",
+		isAppAndroid,
+		isAppHarmony,
+		isAppIos,
+		isMp: normalized?.startsWith("mp-") === true || (normalized ? MINI_PROGRAM_PLATFORMS.has(normalized) : false),
+		isWeb: normalized?.startsWith("web") === true || normalized === "h5"
+	};
+}
+function resolvePlatform(value) {
+	return resolvePlatformInfo(value);
+}
+function resolveTaroPlatform(value = getProcessEnv().TARO_ENV) {
+	return resolvePlatform(value);
+}
+function resolveMpxPlatformValue(env = getProcessEnv()) {
+	return env.MPX_CURRENT_TARGET_MODE ?? env.MPX_CLI_MODE;
+}
+function resolveMpxPlatform(value = resolveMpxPlatformValue()) {
+	return resolvePlatform(value);
+}
+function resolveUniPlatform(value = getProcessEnv().UNI_PLATFORM) {
+	return resolvePlatform(value);
+}
+function resolveUniUtsPlatform(value = getProcessEnv().UNI_UTS_PLATFORM) {
+	return resolvePlatform(value);
+}
+function resolveUniAppXPlatform(value = getProcessEnv().UNI_UTS_PLATFORM) {
+	return resolvePlatform(value);
+}
+function resolveUniPlatformsFromEnv(env = getProcessEnv()) {
+	return {
+		uniPlatform: resolvePlatform(env.UNI_PLATFORM),
+		uniAppXPlatform: resolvePlatform(env.UNI_UTS_PLATFORM),
+		uniUtsPlatform: resolvePlatform(env.UNI_UTS_PLATFORM)
+	};
+}
+const MPX_TO_UNI_PLATFORM = {
+	ali: "mp-alipay",
+	dd: "mp-dingtalk",
+	jd: "mp-jd",
+	qq: "mp-qq",
+	swan: "mp-baidu",
+	tt: "mp-toutiao",
+	wx: "mp-weixin"
+};
+function normalizeFrameworkStylePlatform(platform, appType) {
+	const normalized = platform?.trim().toLowerCase();
+	if (!normalized) return;
+	if (appType === "mpx") return MPX_TO_UNI_PLATFORM[normalized] ?? normalized;
+	return normalized;
+}
+//#endregion
+//#region src/detect-env.ts
+function detectAppTypeFromEnv(env = getProcessEnv(), options = {}) {
+	if (env.WEAPP_TW_TARGET === "weapp-vite" || env.WEAPP_TAILWINDCSS_TARGET === "weapp-vite") return "weapp-vite";
+	if (env.TARO_ENV) return "taro";
+	if (env.MPX_CLI_MODE || env.MPX_CURRENT_TARGET_MODE) return "mpx";
+	const { uniPlatform, uniUtsPlatform } = resolveUniPlatformsFromEnv(env);
+	if (uniUtsPlatform.normalized) return "uni-app-x";
+	if (uniPlatform.normalized) return "uni-app-vite";
+	if (isRunningInHBuilderX({
+		cwd: options.cwd,
+		env
+	})) return options.hbuilderxVite === false ? "uni-app" : "uni-app-vite";
+}
+//#endregion
+//#region src/package.ts
+const MPX_SCRIPT_RE = /\bmpx(?:-cli-service)?\b/u;
+const TARO_SCRIPT_RE = /\btaro\b/u;
+const WEAPP_VITE_SCRIPT_RE = /\bweapp-vite\b/u;
+const UNI_APP_SCRIPT_RE = /\buni(?:\s|$)/u;
+const UNI_APP_VITE_SCRIPT_RE = /\buni(?:\s|$)/u;
+function resolveDependencyNames(pkg) {
+	return /* @__PURE__ */ new Set([
+		...Object.keys(pkg.dependencies ?? {}),
+		...Object.keys(pkg.devDependencies ?? {}),
+		...Object.keys(pkg.peerDependencies ?? {}),
+		...Object.keys(pkg.optionalDependencies ?? {})
+	]);
+}
+function hasDependencyPrefix(dependencyNames, prefix) {
+	return [...dependencyNames].some((name) => name.startsWith(prefix));
+}
+function hasScriptMatch(pkg, pattern) {
+	return Object.values(pkg.scripts ?? {}).some((script) => pattern.test(script));
+}
+function isWeappVitePackage(pkg) {
+	const dependencyNames = resolveDependencyNames(pkg);
+	return dependencyNames.has("weapp-vite") || hasDependencyPrefix(dependencyNames, "@weapp-vite/") || hasScriptMatch(pkg, WEAPP_VITE_SCRIPT_RE);
+}
+function isMpxPackage(pkg) {
+	return hasDependencyPrefix(resolveDependencyNames(pkg), "@mpxjs/") || hasScriptMatch(pkg, MPX_SCRIPT_RE);
+}
+function isTaroPackage(pkg) {
+	return hasDependencyPrefix(resolveDependencyNames(pkg), "@tarojs/") || hasScriptMatch(pkg, TARO_SCRIPT_RE);
+}
+function isUniAppVitePackage(pkg) {
+	return resolveDependencyNames(pkg).has("@dcloudio/vite-plugin-uni") || hasScriptMatch(pkg, UNI_APP_VITE_SCRIPT_RE);
+}
+function isUniAppXPackage(pkg) {
+	const dependencyNames = resolveDependencyNames(pkg);
+	return dependencyNames.has("@dcloudio/uni-uts-v1") || dependencyNames.has("@weapp-tailwindcss/debug-uni-app-x");
+}
+function isUniAppPackage(pkg) {
+	const dependencyNames = resolveDependencyNames(pkg);
+	return dependencyNames.has("@dcloudio/vue-cli-plugin-uni") || dependencyNames.has("@dcloudio/uni-app") || Object.hasOwn(pkg, "uni-app") || hasScriptMatch(pkg, UNI_APP_SCRIPT_RE);
+}
+function isUniAppXManifest(manifest) {
+	return Boolean(manifest && Object.hasOwn(manifest, "uni-app-x"));
+}
+function detectAppTypeFromPackageJson(pkg) {
+	if (isWeappVitePackage(pkg)) return "weapp-vite";
+	if (isMpxPackage(pkg)) return "mpx";
+	if (isTaroPackage(pkg)) return "taro";
+	if (isUniAppXPackage(pkg)) return "uni-app-x";
+	if (isUniAppVitePackage(pkg)) return "uni-app-vite";
+	if (isUniAppPackage(pkg)) return "uni-app";
+}
+//#endregion
+//#region src/project.ts
+const PACKAGE_JSON_FILE = "package.json";
+const MANIFEST_JSON_FILE = "manifest.json";
+const MPX_MARKERS = [["src", "app.mpx"], ["app.mpx"]];
+function tryReadJson(file) {
+	if (!existsSync(file)) return;
+	try {
+		return JSON.parse(readFileSync(file, "utf8"));
+	} catch {}
+}
+function detectAppTypeFromMarkers(root) {
+	for (const segments of MPX_MARKERS) if (existsSync(path.join(root, ...segments))) return "mpx";
+}
+function detectAppTypeFromRoot(root, searchUp = true) {
+	const resolvedRoot = path.resolve(root);
+	if (!existsSync(resolvedRoot)) return;
+	const markerDetected = detectAppTypeFromMarkers(resolvedRoot);
+	if (markerDetected) return markerDetected;
+	let current = resolvedRoot;
+	while (true) {
+		if (isUniAppXManifest(tryReadJson(path.join(current, MANIFEST_JSON_FILE)))) return "uni-app-x";
+		const pkg = tryReadJson(path.join(current, PACKAGE_JSON_FILE));
+		if (pkg) {
+			const detected = detectAppTypeFromPackageJson(pkg);
+			if (detected) return detected;
+		}
+		if (!searchUp) break;
+		const parent = path.dirname(current);
+		if (parent === current) break;
+		current = parent;
+	}
+}
+function detectAppType(options = {}) {
+	if (isUniAppXManifest(options.manifest)) return "uni-app-x";
+	if (options.packageJson) {
+		const detected = detectAppTypeFromPackageJson(options.packageJson);
+		if (detected) return detected;
+	}
+	if (options.root) {
+		const detected = detectAppTypeFromRoot(options.root, options.searchUp ?? true);
+		if (detected) return detected;
+	}
+	const env = options.env ?? (options.detectEnv ? getProcessEnv() : void 0);
+	if (env) return detectAppTypeFromEnv(env, {
+		cwd: options.cwd ?? options.root ?? (options.detectEnv ? process.cwd() : void 0),
+		hbuilderxVite: options.hbuilderxVite
+	});
+}
+//#endregion
+export { detectAppType, detectAppTypeFromEnv, detectAppTypeFromPackageJson, isMpxPackage, isRunningInHBuilderX, isTaroPackage, isUniAppPackage, isUniAppVitePackage, isUniAppXManifest, isUniAppXPackage, isWeappVitePackage, normalizeFrameworkStylePlatform, resolveMpxPlatform, resolvePlatform, resolveTaroPlatform, resolveUniAppXPlatform, resolveUniPlatform, resolveUniPlatformsFromEnv, resolveUniUtsPlatform };

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@weapp-tailwindcss/env",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "type": "module",
+  "version": "0.1.0",
+  "description": "构建期的环境、框架与平台识别工具。",
+  "author": "ice breaker <1324318532@qq.com>",
+  "license": "MIT",
+  "homepage": "https://tw.weapp.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/weapp-tailwindcss/weapp-tailwindcss.git",
+    "directory": "packages/env"
+  },
+  "bugs": {
+    "url": "https://github.com/weapp-tailwindcss/weapp-tailwindcss/issues"
+  },
+  "keywords": [
+    "weapp",
+    "framework",
+    "environment",
+    "taro",
+    "uni-app",
+    "mpx"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": "^22.18.0 || >=24.11.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "dev": "tsdown --watch --sourcemap",
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:dev": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test:package": "node scripts/verify-package.mjs"
+  }
 }