@dcloudio/uni-cli-shared 3.0.0-5020420260813002 → 3.0.0-5020620260917001

package/dist/dom2/fontFamily.js

@@ -15,7 +15,7 @@ function createJsStylePlaceholder(id) {
 exports.createJsStylePlaceholder = createJsStylePlaceholder;
 function createJsStylePlaceholderRegExp(id) {
     const hashId = (0, hash_sum_1.default)(id);
-    return new RegExp(`\\{\\s*"${exports.JS_STYLE_PLACEHOLDER_MARKER}"\\s*:\\s*"${hashId}"\\s*\\}`, 'g');
+    return new RegExp(`\\{\\s*(?:"${exports.JS_STYLE_PLACEHOLDER_MARKER}"|'${exports.JS_STYLE_PLACEHOLDER_MARKER}'|${exports.JS_STYLE_PLACEHOLDER_MARKER})\\s*:\\s*(?:"${hashId}"|'${hashId}')\\s*\\}`, 'g');
 }
 exports.createJsStylePlaceholderRegExp = createJsStylePlaceholderRegExp;
-exports.ANY_JS_STYLE_PLACEHOLDER_RE = new RegExp(`\\{\\s*"${exports.JS_STYLE_PLACEHOLDER_MARKER}"\\s*:\\s*".+?"\\s*\\}`, 'g');
+exports.ANY_JS_STYLE_PLACEHOLDER_RE = new RegExp(`\\{\\s*(?:"${exports.JS_STYLE_PLACEHOLDER_MARKER}"|'${exports.JS_STYLE_PLACEHOLDER_MARKER}'|${exports.JS_STYLE_PLACEHOLDER_MARKER})\\s*:\\s*(?:"[^"]+?"|'[^']+?')\\s*\\}`, 'g');

package/dist/dom2/index.d.ts

@@ -1,4 +1,5 @@
 export * from './sharedData';
+export * from './script';
 export * from './vue';
 export * from './fontFamily';
 export * from './rootScrollView';

package/dist/dom2/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./sharedData"), exports);
+__exportStar(require("./script"), exports);
 __exportStar(require("./vue"), exports);
 __exportStar(require("./fontFamily"), exports);
 __exportStar(require("./rootScrollView"), exports);

package/dist/dom2/script.d.ts

@@ -0,0 +1,8 @@
+import type { UasmTransformOptions } from '../uasm';
+import type { UniVitePlugin } from '../vite';
+export interface UniVaporScriptPluginOptions {
+    sharedDataLibName?: string;
+    sharedDataLibAsGlobal?: boolean;
+    uasm?: UasmTransformOptions;
+}
+export declare function uniVaporScriptPlugin(options?: UniVaporScriptPluginOptions): UniVitePlugin;

package/dist/dom2/script.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uniVaporScriptPlugin = void 0;
+const uts_1 = require("../uts");
+const extApi_1 = require("../uts/extApi");
+const utils_1 = require("../utils");
+const sharedData_1 = require("./sharedData");
+function uniVaporScriptPlugin(options = {}) {
+    const { uasm, ...sharedData } = options;
+    const { D2SP } = (0, utils_1.requireUniHelpers)();
+    const nodeEnv = process.env.UNI_NODE_ENV || process.env.NODE_ENV;
+    const extApi = (0, utils_1.isNormalCompileTarget)() && nodeEnv !== 'development'
+        ? (0, extApi_1.initUts2jsExtApiOptions)()
+        : undefined;
+    return D2SP({
+        typescript: (0, uts_1.resolveUTSCompiler)().getTypeScript(),
+        extApi,
+        uasm,
+        sharedData: {
+            ...(0, sharedData_1.initUts2jsSharedDataOptions)(),
+            ...sharedData,
+        },
+    });
+}
+exports.uniVaporScriptPlugin = uniVaporScriptPlugin;

package/dist/hbx/env.d.ts

@@ -1,7 +1,4 @@
 export { isInHBuilderX } from './utils';
 export declare const runByHBuilderX: () => boolean;
-/**
- * 增加 node_modules
- */
 export declare function initModulePaths(): void;
 export declare function fixBinaryPath(): void;

package/dist/hbx/env.js

@@ -4,8 +4,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fixBinaryPath = exports.initModulePaths = exports.runByHBuilderX = exports.isInHBuilderX = void 0;
+const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const module_1 = __importDefault(require("module"));
+const url_1 = require("url");
 const uni_shared_1 = require("@dcloudio/uni-shared");
 const resolve_1 = require("../resolve");
 const utils_1 = require("../utils");
@@ -19,12 +21,47 @@ exports.runByHBuilderX = (0, uni_shared_1.once)(() => {
 /**
  * 增加 node_modules
  */
+const initializedModulePaths = new Set();
+function getPackageName(specifier) {
+    if (!specifier ||
+        specifier.startsWith('.') ||
+        specifier.startsWith('/') ||
+        specifier.startsWith('\\') ||
+        specifier.startsWith('#') ||
+        specifier.includes(':') ||
+        /[\\%?#]/.test(specifier)) {
+        return;
+    }
+    const segments = specifier.split('/');
+    if (segments.some((segment) => !segment || segment === '.' || segment === '..') ||
+        (specifier.startsWith('@') &&
+            (segments.length < 2 || segments[0].length === 1))) {
+        return;
+    }
+    const packageName = specifier.startsWith('@')
+        ? segments.slice(0, 2).join('/')
+        : segments[0];
+    return packageName;
+}
+function canFallbackToNodeModules(specifier, error, nodeModulesPath) {
+    const code = error?.code;
+    if (code !== 'ERR_MODULE_NOT_FOUND') {
+        return false;
+    }
+    const packageName = getPackageName(specifier);
+    return (!!packageName && fs_1.default.existsSync(path_1.default.resolve(nodeModulesPath, packageName)));
+}
 function initModulePaths() {
     if (!(0, utils_2.isInHBuilderX)()) {
         return;
     }
-    const Module = module.constructor.length > 1 ? module.constructor : module_1.default;
     const nodeModulesPath = path_1.default.resolve(process.env.UNI_CLI_CONTEXT, 'node_modules');
+    if (initializedModulePaths.has(nodeModulesPath)) {
+        return;
+    }
+    const parentURL = (0, url_1.pathToFileURL)(path_1.default.resolve(process.env.UNI_CLI_CONTEXT, 'package.json')).href;
+    const moduleApi = module_1.default;
+    const Module = module.constructor.length > 1 ? module.constructor : module_1.default;
     const oldNodeModulePaths = Module._nodeModulePaths;
     Module._nodeModulePaths = function (from) {
         const paths = oldNodeModulePaths.call(this, from);
@@ -33,6 +70,72 @@ function initModulePaths() {
         }
         return paths;
     };
+    if (moduleApi.registerHooks) {
+        moduleApi.registerHooks({
+            resolve(specifier, context, nextResolve) {
+                try {
+                    return nextResolve(specifier, context);
+                }
+                catch (error) {
+                    if (!canFallbackToNodeModules(specifier, error, nodeModulesPath)) {
+                        throw error;
+                    }
+                    return nextResolve(specifier, { ...context, parentURL });
+                }
+            },
+        });
+        initializedModulePaths.add(nodeModulesPath);
+        return;
+    }
+    // Node 的 ESM 解析不会使用 _nodeModulePaths，需要单独回退到 HBuilderX 内置依赖。
+    const register = moduleApi.register;
+    if (register) {
+        const nodeModulesURL = (0, url_1.pathToFileURL)(nodeModulesPath + path_1.default.sep).href;
+        const loader = `
+import { existsSync } from 'node:fs'
+
+const parentURL = ${JSON.stringify(parentURL)}
+const nodeModulesURL = ${JSON.stringify(nodeModulesURL)}
+
+export async function resolve(specifier, context, nextResolve) {
+  try {
+    return await nextResolve(specifier, context)
+  } catch (error) {
+    if (
+      error?.code !== 'ERR_MODULE_NOT_FOUND' ||
+      !specifier ||
+      specifier.startsWith('.') ||
+      specifier.startsWith('/') ||
+      specifier.startsWith('\\\\') ||
+      specifier.startsWith('#') ||
+      specifier.includes(':') ||
+      /[\\\\%?#]/.test(specifier)
+    ) {
+      throw error
+    }
+    const segments = specifier.split('/')
+    if (
+      segments.some(
+        (segment) => !segment || segment === '.' || segment === '..'
+      ) ||
+      (specifier.startsWith('@') &&
+        (segments.length < 2 || segments[0].length === 1))
+    ) {
+      throw error
+    }
+    const packageName = specifier.startsWith('@')
+      ? segments.slice(0, 2).join('/')
+      : segments[0]
+    if (!existsSync(new URL(packageName + '/', nodeModulesURL))) {
+      throw error
+    }
+    return nextResolve(specifier, { ...context, parentURL })
+  }
+}
+`;
+        register(`data:text/javascript,${encodeURIComponent(loader)}`, (0, url_1.pathToFileURL)(process.env.UNI_CLI_CONTEXT + path_1.default.sep));
+    }
+    initializedModulePaths.add(nodeModulesPath);
 }
 exports.initModulePaths = initModulePaths;
 function resolveEsbuildModule(name) {

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './hbx';
 export * from './ssr';
 export * from './vue';
 export * from './uts';
+export * from './uts/extApi';
 export * from './x';
 export * from './logs';
 export * from './dom2';
@@ -25,6 +26,7 @@ export * from './scripts';
 export * from './platform';
 export * from './utsUtils';
 export * from './workers';
+export * from './uasm';
 export { parseUniExtApi, parseUniExtApis, parseInjects, Define, DefineOptions, Defines, getUniExtApiProviderRegisters, formatExtApiProviderName, } from './uni_modules';
 export { copyEncryptUniModulesDom2Bytes, getUniModulesEncryptType, parseUniModulesArtifacts, resolveEncryptUniModule, } from './uni_modules.cloud';
 import type { EncryptPackageJson } from './uni_modules.cloud';

package/dist/index.js

@@ -23,6 +23,7 @@ __exportStar(require("./hbx"), exports);
 __exportStar(require("./ssr"), exports);
 __exportStar(require("./vue"), exports);
 __exportStar(require("./uts"), exports);
+__exportStar(require("./uts/extApi"), exports);
 __exportStar(require("./x"), exports);
 __exportStar(require("./logs"), exports);
 __exportStar(require("./dom2"), exports);
@@ -42,6 +43,7 @@ __exportStar(require("./scripts"), exports);
 __exportStar(require("./platform"), exports);
 __exportStar(require("./utsUtils"), exports);
 __exportStar(require("./workers"), exports);
+__exportStar(require("./uasm"), exports);
 var uni_modules_1 = require("./uni_modules");
 Object.defineProperty(exports, "parseUniExtApi", { enumerable: true, get: function () { return uni_modules_1.parseUniExtApi; } });
 Object.defineProperty(exports, "parseUniExtApis", { enumerable: true, get: function () { return uni_modules_1.parseUniExtApis; } });

package/dist/json/mp/pages.d.ts

@@ -4,7 +4,7 @@ interface ParsePagesJsonOptions {
     darkmode?: boolean;
     subpackages: boolean;
     independentSubpackages?: boolean;
-    windowOptionsMap?: Record<string, string>;
+    windowOptionsMap?: Record<string, string | string[]>;
     tabBarOptionsMap?: Record<string, string>;
     tabBarItemOptionsMap?: Record<string, string>;
     networkTimeout?: NetworkTimeout;

package/dist/json/mp/types.d.ts

@@ -28,6 +28,7 @@ export interface PageWindowOptions extends ShareWindowOptions {
     style?: Style;
     singlePage?: SinglePage;
     restartStrategy?: RestartStrategy;
+    styleIsolation?: 'shared' | 'isolated';
 }
 export interface AppWindowOptions extends ShareWindowOptions {
     visualEffectInBackground?: 'none' | 'hidden';

package/dist/json/mp/utils.d.ts

@@ -1,3 +1,3 @@
 import type { AppWindowOptions, PageWindowOptions, TabBar } from './types';
-export declare function parseWindowOptions(style: UniApp.PagesJsonPageStyle, platform: UniApp.PLATFORM, windowOptionsMap?: Record<string, string>): PageWindowOptions | AppWindowOptions;
+export declare function parseWindowOptions(style: UniApp.PagesJsonPageStyle, platform: UniApp.PLATFORM, windowOptionsMap?: Record<string, string | string[]>): PageWindowOptions | AppWindowOptions;
 export declare function parseTabBar(tabBar: UniApp.TabBarOptions, platform: UniApp.PLATFORM, tabBarOptionsMap?: Record<string, string>, tabBarItemOptionsMap?: Record<string, string>): TabBar;

package/dist/json/mp/utils.js

@@ -21,6 +21,18 @@ function convert(to, from, map) {
     });
     return to;
 }
+function convertWindowOptions(to, from, map) {
+    Object.entries(map).forEach(([key, value]) => {
+        const names = (0, shared_1.isArray)(value) ? value : [value];
+        for (const name of names) {
+            if ((0, shared_1.hasOwn)(from, name)) {
+                to[key] = from[name];
+                break;
+            }
+        }
+    });
+    return to;
+}
 function parseWindowOptions(style, platform, windowOptionsMap) {
     if (!style) {
         return {};
@@ -29,7 +41,7 @@ function parseWindowOptions(style, platform, windowOptionsMap) {
     (0, pages_1.removePlatformStyle)(trimJson(style));
     const res = {};
     if (windowOptionsMap) {
-        return (0, shared_1.extend)(convert(res, style, windowOptionsMap), platformStyle);
+        return (0, shared_1.extend)(convertWindowOptions(res, style, windowOptionsMap), platformStyle);
     }
     return (0, shared_1.extend)(res, style, platformStyle);
 }

package/dist/json/uni-x/index.d.ts

@@ -3,6 +3,11 @@ export interface UniXPageOptions {
     disableScroll?: boolean;
     enablePullDownRefresh?: boolean;
     scrollIndicator?: 'none';
+    enableBackToTop?: boolean;
+    bounces?: boolean;
+    androidOverscroll?: boolean;
+    androidRefresherColor?: string;
+    backgroundColor?: string;
 }
 export declare function normalizeUniAppXAppPagesJson(jsonStr: string): UniApp.PagesJson;
 export declare function parseUniXPageOptions(filename: string): UniXPageOptions | undefined;

package/dist/json/uni-x/index.js

@@ -90,18 +90,27 @@ function updateUniXPageOptions(pagesJson) {
     }
     const pageOptions = new Map();
     pagesJson.pages.forEach((page) => {
-        pageOptions.set(page.path, normalizeRootPageOptions(page.style));
+        pageOptions.set(page.path, normalizeRootPageOptions(page.style, pagesJson.globalStyle));
     });
     uniXPageOptionsCache.set(inputDir, pageOptions);
 }
-function normalizeRootPageOptions(pageStyle) {
-    if (!pageStyle) {
-        return {};
-    }
+function normalizeRootPageOptions(pageStyle, globalStyle) {
+    const androidRefresherColor = pageStyle?.androidRefresherColor ?? globalStyle.androidRefresherColor;
+    const backgroundColor = pageStyle?.backgroundColor ?? globalStyle.backgroundColor;
     return {
-        disableScroll: pageStyle.disableScroll === true || undefined,
-        enablePullDownRefresh: isEnablePullDownRefresh(pageStyle) || undefined,
-        scrollIndicator: pageStyle.scrollIndicator,
+        disableScroll: pageStyle?.disableScroll === true || undefined,
+        enablePullDownRefresh: (pageStyle && isEnablePullDownRefresh(pageStyle)) || undefined,
+        scrollIndicator: pageStyle?.scrollIndicator,
+        // 新增的根滚动配置遵循 pages.json 页面样式覆盖全局样式的规则。
+        enableBackToTop: pageStyle?.enableBackToTop ?? globalStyle.enableBackToTop,
+        bounces: pageStyle?.bounces ?? globalStyle.bounces,
+        androidOverscroll: pageStyle?.androidOverscroll ?? globalStyle.androidOverscroll,
+        androidRefresherColor: androidRefresherColor?.startsWith('@')
+            ? undefined
+            : androidRefresherColor,
+        backgroundColor: backgroundColor?.startsWith('@')
+            ? undefined
+            : backgroundColor,
     };
 }
 function initUniXPageOptions() {

package/dist/mp/externalClasses.d.ts

@@ -1,5 +1,9 @@
 import { type Program } from '@babel/types';
 import type { SFCStyleBlock } from '@vue/compiler-sfc';
+export declare const ALIPAY_CLASS_MASK_APP = 1;
+export declare const ALIPAY_CLASS_MASK_PAGE: number;
+export declare const ALIPAY_CLASS_MASK_COMPONENT: number;
+export declare const ALIPAY_STYLE_CLASS_PREFIXES: readonly ["-a-", "-p-", "-c-"];
 /**
  * 页面使用的 externalClasses 信息
  * - staticClasses: 静态绑定的 class 值集合，如 my-class="foo" 中的 "foo"
@@ -38,4 +42,17 @@ export declare function findMiniProgramComponentStyleIsolation(pagePahth: string
     styleIsolation: StyleIsolation;
     isPage: boolean;
 } | undefined;
+export declare function clearMiniProgramComponentStyleIsolation(pagePahth: string): void;
+export declare function isAlipayXStyleIsolation(): boolean;
+/**
+ * 将 styleIsolation 转换为模板节点需要携带的来源 mask。
+ * mask 在编译期确定，SJS 运行时只做字符串展开，避免在视图层重复判断组件配置。
+ */
+export declare function getAlipayStyleIsolationClassMask(filename: string): number;
+export declare function isAlipayStyleIsolationClass(value: string): boolean;
+/**
+ * 静态 class 在编译期直接展开，避免把可提前完成的字符串处理留到 SJS 运行时。
+ * 保留前缀属于支付宝隔离实现的内部协议，静态可识别的用户 class 必须及时报错。
+ */
+export declare function formatAlipayStyleIsolationClasses(value: string, mask: number, keepRaw?: boolean): string;
 export declare function createDefaultSFCStyleBlock(source: string): SFCStyleBlock;

package/dist/mp/externalClasses.js

@@ -1,10 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDefaultSFCStyleBlock = exports.findMiniProgramComponentStyleIsolation = exports.updateMiniProgramComponentStyleIsolation = exports.parseStyleIsolation = exports.parseExternalClasses = exports.updateMiniProgramComponentExternalClasses = exports.findMiniProgramComponentExternalClasses = exports.hasExternalClasses = exports.clearPageExternalClasses = exports.addPageExternalClasses = exports.updatePageExternalClasses = exports.findPageExternalClasses = void 0;
+exports.createDefaultSFCStyleBlock = exports.formatAlipayStyleIsolationClasses = exports.isAlipayStyleIsolationClass = exports.getAlipayStyleIsolationClassMask = exports.isAlipayXStyleIsolation = exports.clearMiniProgramComponentStyleIsolation = exports.findMiniProgramComponentStyleIsolation = exports.updateMiniProgramComponentStyleIsolation = exports.parseStyleIsolation = exports.parseExternalClasses = exports.updateMiniProgramComponentExternalClasses = exports.findMiniProgramComponentExternalClasses = exports.hasExternalClasses = exports.clearPageExternalClasses = exports.addPageExternalClasses = exports.updatePageExternalClasses = exports.findPageExternalClasses = exports.ALIPAY_STYLE_CLASS_PREFIXES = exports.ALIPAY_CLASS_MASK_COMPONENT = exports.ALIPAY_CLASS_MASK_PAGE = exports.ALIPAY_CLASS_MASK_APP = void 0;
 const types_1 = require("@babel/types");
 const estree_walker_1 = require("estree-walker");
 const utils_1 = require("../utils");
+const utils_2 = require("../utils");
+const pages_1 = require("../json/pages");
 const externalClassesCache = new Map();
+// 支付宝 ACSS 不支持微信小程序使用的 [class] 隔离方案，因此使用来源前缀作为隔离键。
+exports.ALIPAY_CLASS_MASK_APP = 1;
+exports.ALIPAY_CLASS_MASK_PAGE = 1 << 1;
+exports.ALIPAY_CLASS_MASK_COMPONENT = 1 << 2;
+exports.ALIPAY_STYLE_CLASS_PREFIXES = ['-a-', '-p-', '-c-'];
 const pageStyleIsolationCache = new Map();
 const pageExternalClassesCache = new Map();
 function findPageExternalClasses(filename) {
@@ -112,6 +119,75 @@ function findMiniProgramComponentStyleIsolation(pagePahth) {
     return pageStyleIsolationCache.get((0, utils_1.normalizePath)(pagePahth));
 }
 exports.findMiniProgramComponentStyleIsolation = findMiniProgramComponentStyleIsolation;
+function clearMiniProgramComponentStyleIsolation(pagePahth) {
+    pageStyleIsolationCache.delete((0, utils_1.normalizePath)(pagePahth));
+}
+exports.clearMiniProgramComponentStyleIsolation = clearMiniProgramComponentStyleIsolation;
+function isAlipayXStyleIsolation() {
+    return (process.env.UNI_PLATFORM === 'mp-alipay' &&
+        process.env.UNI_APP_X === 'true' &&
+        process.env.UNI_APP_STYLE_ISOLATION_VERSION === '2');
+}
+exports.isAlipayXStyleIsolation = isAlipayXStyleIsolation;
+/**
+ * 将 styleIsolation 转换为模板节点需要携带的来源 mask。
+ * mask 在编译期确定，SJS 运行时只做字符串展开，避免在视图层重复判断组件配置。
+ */
+function getAlipayStyleIsolationClassMask(filename) {
+    if ((0, utils_2.isAppVue)(filename)) {
+        return exports.ALIPAY_CLASS_MASK_APP;
+    }
+    const isolation = findMiniProgramComponentStyleIsolation(filename);
+    const isPage = isolation?.isPage || (0, pages_1.isUniPageFile)(filename);
+    const styleIsolation = isolation?.styleIsolation;
+    if (isPage) {
+        return styleIsolation === 'isolated'
+            ? exports.ALIPAY_CLASS_MASK_PAGE
+            : exports.ALIPAY_CLASS_MASK_APP | exports.ALIPAY_CLASS_MASK_PAGE;
+    }
+    if (styleIsolation === 'app') {
+        return exports.ALIPAY_CLASS_MASK_APP | exports.ALIPAY_CLASS_MASK_COMPONENT;
+    }
+    if (styleIsolation === 'app-and-page') {
+        return (exports.ALIPAY_CLASS_MASK_APP |
+            exports.ALIPAY_CLASS_MASK_PAGE |
+            exports.ALIPAY_CLASS_MASK_COMPONENT);
+    }
+    return exports.ALIPAY_CLASS_MASK_COMPONENT;
+}
+exports.getAlipayStyleIsolationClassMask = getAlipayStyleIsolationClassMask;
+function isAlipayStyleIsolationClass(value) {
+    return exports.ALIPAY_STYLE_CLASS_PREFIXES.some((prefix) => value.startsWith(prefix));
+}
+exports.isAlipayStyleIsolationClass = isAlipayStyleIsolationClass;
+/**
+ * 静态 class 在编译期直接展开，避免把可提前完成的字符串处理留到 SJS 运行时。
+ * 保留前缀属于支付宝隔离实现的内部协议，静态可识别的用户 class 必须及时报错。
+ */
+function formatAlipayStyleIsolationClasses(value, mask, keepRaw = true) {
+    const result = [];
+    const classes = value.split(/\s+/).filter(Boolean);
+    for (const clazz of classes) {
+        if (isAlipayStyleIsolationClass(clazz)) {
+            throw new Error(`支付宝小程序样式隔离不允许 class 使用保留前缀：${clazz}`);
+        }
+        // externalClass 跨组件传递时不能保留原名，否则子组件会将其误认为本地 class 再补组件前缀。
+        if (keepRaw) {
+            result.push(clazz);
+        }
+        if (mask & exports.ALIPAY_CLASS_MASK_APP) {
+            result.push('-a-' + clazz);
+        }
+        if (mask & exports.ALIPAY_CLASS_MASK_PAGE) {
+            result.push('-p-' + clazz);
+        }
+        if (mask & exports.ALIPAY_CLASS_MASK_COMPONENT) {
+            result.push('-c-' + clazz);
+        }
+    }
+    return result.join(' ');
+}
+exports.formatAlipayStyleIsolationClasses = formatAlipayStyleIsolationClasses;
 function createDefaultSFCStyleBlock(source) {
     const offset = source.length;
     return {

package/dist/mp/index.d.ts

@@ -9,5 +9,5 @@ export * from './constants';
 export { HTML_TO_MINI_PROGRAM_TAGS } from './tags';
 export { copyMiniProgramPluginJson, copyMiniProgramThemeJson, createCopyPluginTarget, } from './plugin';
 export { parseMainDescriptor, parseScriptDescriptor, parseTemplateDescriptor, transformDynamicImports, updateMiniProgramGlobalComponents, updateMiniProgramComponentsByMainFilename, updateMiniProgramComponentsByScriptFilename, updateMiniProgramComponentsByTemplateFilename, getGlobalComponentSource, } from './usingComponents';
-export { hasExternalClasses, parseExternalClasses, parseStyleIsolation, findMiniProgramComponentExternalClasses, updateMiniProgramComponentExternalClasses, updateMiniProgramComponentStyleIsolation, findMiniProgramComponentStyleIsolation, findPageExternalClasses, updatePageExternalClasses, addPageExternalClasses, clearPageExternalClasses, createDefaultSFCStyleBlock, } from './externalClasses';
+export { hasExternalClasses, parseExternalClasses, parseStyleIsolation, findMiniProgramComponentExternalClasses, updateMiniProgramComponentExternalClasses, updateMiniProgramComponentStyleIsolation, clearMiniProgramComponentStyleIsolation, findMiniProgramComponentStyleIsolation, findPageExternalClasses, updatePageExternalClasses, addPageExternalClasses, clearPageExternalClasses, createDefaultSFCStyleBlock, isAlipayXStyleIsolation, getAlipayStyleIsolationClassMask, isAlipayStyleIsolationClass, formatAlipayStyleIsolationClasses, ALIPAY_CLASS_MASK_APP, ALIPAY_CLASS_MASK_PAGE, ALIPAY_CLASS_MASK_COMPONENT, ALIPAY_STYLE_CLASS_PREFIXES, } from './externalClasses';
 export type { PageExternalClassesInfo } from './externalClasses';

package/dist/mp/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDefaultSFCStyleBlock = exports.clearPageExternalClasses = exports.addPageExternalClasses = exports.updatePageExternalClasses = exports.findPageExternalClasses = exports.findMiniProgramComponentStyleIsolation = exports.updateMiniProgramComponentStyleIsolation = exports.updateMiniProgramComponentExternalClasses = exports.findMiniProgramComponentExternalClasses = exports.parseStyleIsolation = exports.parseExternalClasses = exports.hasExternalClasses = exports.getGlobalComponentSource = exports.updateMiniProgramComponentsByTemplateFilename = exports.updateMiniProgramComponentsByScriptFilename = exports.updateMiniProgramComponentsByMainFilename = exports.updateMiniProgramGlobalComponents = exports.transformDynamicImports = exports.parseTemplateDescriptor = exports.parseScriptDescriptor = exports.parseMainDescriptor = exports.createCopyPluginTarget = exports.copyMiniProgramThemeJson = exports.copyMiniProgramPluginJson = exports.HTML_TO_MINI_PROGRAM_TAGS = void 0;
+exports.ALIPAY_STYLE_CLASS_PREFIXES = exports.ALIPAY_CLASS_MASK_COMPONENT = exports.ALIPAY_CLASS_MASK_PAGE = exports.ALIPAY_CLASS_MASK_APP = exports.formatAlipayStyleIsolationClasses = exports.isAlipayStyleIsolationClass = exports.getAlipayStyleIsolationClassMask = exports.isAlipayXStyleIsolation = exports.createDefaultSFCStyleBlock = exports.clearPageExternalClasses = exports.addPageExternalClasses = exports.updatePageExternalClasses = exports.findPageExternalClasses = exports.findMiniProgramComponentStyleIsolation = exports.clearMiniProgramComponentStyleIsolation = exports.updateMiniProgramComponentStyleIsolation = exports.updateMiniProgramComponentExternalClasses = exports.findMiniProgramComponentExternalClasses = exports.parseStyleIsolation = exports.parseExternalClasses = exports.hasExternalClasses = exports.getGlobalComponentSource = exports.updateMiniProgramComponentsByTemplateFilename = exports.updateMiniProgramComponentsByScriptFilename = exports.updateMiniProgramComponentsByMainFilename = exports.updateMiniProgramGlobalComponents = exports.transformDynamicImports = exports.parseTemplateDescriptor = exports.parseScriptDescriptor = exports.parseMainDescriptor = exports.createCopyPluginTarget = exports.copyMiniProgramThemeJson = exports.copyMiniProgramPluginJson = exports.HTML_TO_MINI_PROGRAM_TAGS = void 0;
 __exportStar(require("./ast"), exports);
 __exportStar(require("./wxs"), exports);
 __exportStar(require("./nvue"), exports);
@@ -46,9 +46,18 @@ Object.defineProperty(exports, "parseStyleIsolation", { enumerable: true, get: f
 Object.defineProperty(exports, "findMiniProgramComponentExternalClasses", { enumerable: true, get: function () { return externalClasses_1.findMiniProgramComponentExternalClasses; } });
 Object.defineProperty(exports, "updateMiniProgramComponentExternalClasses", { enumerable: true, get: function () { return externalClasses_1.updateMiniProgramComponentExternalClasses; } });
 Object.defineProperty(exports, "updateMiniProgramComponentStyleIsolation", { enumerable: true, get: function () { return externalClasses_1.updateMiniProgramComponentStyleIsolation; } });
+Object.defineProperty(exports, "clearMiniProgramComponentStyleIsolation", { enumerable: true, get: function () { return externalClasses_1.clearMiniProgramComponentStyleIsolation; } });
 Object.defineProperty(exports, "findMiniProgramComponentStyleIsolation", { enumerable: true, get: function () { return externalClasses_1.findMiniProgramComponentStyleIsolation; } });
 Object.defineProperty(exports, "findPageExternalClasses", { enumerable: true, get: function () { return externalClasses_1.findPageExternalClasses; } });
 Object.defineProperty(exports, "updatePageExternalClasses", { enumerable: true, get: function () { return externalClasses_1.updatePageExternalClasses; } });
 Object.defineProperty(exports, "addPageExternalClasses", { enumerable: true, get: function () { return externalClasses_1.addPageExternalClasses; } });
 Object.defineProperty(exports, "clearPageExternalClasses", { enumerable: true, get: function () { return externalClasses_1.clearPageExternalClasses; } });
 Object.defineProperty(exports, "createDefaultSFCStyleBlock", { enumerable: true, get: function () { return externalClasses_1.createDefaultSFCStyleBlock; } });
+Object.defineProperty(exports, "isAlipayXStyleIsolation", { enumerable: true, get: function () { return externalClasses_1.isAlipayXStyleIsolation; } });
+Object.defineProperty(exports, "getAlipayStyleIsolationClassMask", { enumerable: true, get: function () { return externalClasses_1.getAlipayStyleIsolationClassMask; } });
+Object.defineProperty(exports, "isAlipayStyleIsolationClass", { enumerable: true, get: function () { return externalClasses_1.isAlipayStyleIsolationClass; } });
+Object.defineProperty(exports, "formatAlipayStyleIsolationClasses", { enumerable: true, get: function () { return externalClasses_1.formatAlipayStyleIsolationClasses; } });
+Object.defineProperty(exports, "ALIPAY_CLASS_MASK_APP", { enumerable: true, get: function () { return externalClasses_1.ALIPAY_CLASS_MASK_APP; } });
+Object.defineProperty(exports, "ALIPAY_CLASS_MASK_PAGE", { enumerable: true, get: function () { return externalClasses_1.ALIPAY_CLASS_MASK_PAGE; } });
+Object.defineProperty(exports, "ALIPAY_CLASS_MASK_COMPONENT", { enumerable: true, get: function () { return externalClasses_1.ALIPAY_CLASS_MASK_COMPONENT; } });
+Object.defineProperty(exports, "ALIPAY_STYLE_CLASS_PREFIXES", { enumerable: true, get: function () { return externalClasses_1.ALIPAY_STYLE_CLASS_PREFIXES; } });

package/dist/postcss/plugins/stylePluginExternal.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const postcss_selector_parser_1 = __importDefault(require("postcss-selector-parser"));
 const pages_1 = require("../../json/pages");
 const externalClasses_1 = require("../../mp/externalClasses");
+const utils_1 = require("../../utils");
 /**
  * 基于页面 externalClasses 使用情况提升页面样式优先级
  *
@@ -31,6 +32,11 @@ const externalPlugin = () => {
                     if (!platform.startsWith('mp-')) {
                         return;
                     }
+                    // 支付宝 ACSS 不支持 [class]，隔离 2.0 使用来源前缀完成样式命中控制。
+                    if ((0, externalClasses_1.isAlipayXStyleIsolation)()) {
+                        processAlipayStyleIsolation(root);
+                        return;
+                    }
                     // 从 postcss source 中获取当前样式所属文件
                     const filePath = root.source?.input?.file;
                     if (!filePath) {
@@ -66,6 +72,46 @@ const externalPlugin = () => {
         },
     };
 };
+/**
+ * 单 class 选择器按 App、页面、组件来源改写为不同前缀；页面额外补 page 提权，
+ * 从而在同名 class 下保持“页面 > 组件 > App”。复杂选择器继续遵循支付宝原生行为。
+ */
+function processAlipayStyleIsolation(root) {
+    const filePath = root.source?.input?.file;
+    if (!filePath) {
+        return;
+    }
+    const prefix = (0, utils_1.isAppVue)(filePath)
+        ? '-a-'
+        : (0, pages_1.isUniPageFile)(filePath)
+            ? '-p-'
+            : '-c-';
+    const isPage = prefix === '-p-';
+    root.walkRules((rule) => {
+        if (rule.parent?.type === 'atrule' &&
+            /-?keyframes$/.test(rule.parent.name)) {
+            return;
+        }
+        rule.selector = (0, postcss_selector_parser_1.default)((selectorRoot) => {
+            selectorRoot.each((selector) => {
+                // 所有静态 CSS class 都要校验，防止用户 class 与内部隔离键冲突。
+                selector.walkClasses((classNode) => {
+                    if ((0, externalClasses_1.isAlipayStyleIsolationClass)(classNode.value)) {
+                        throw rule.error(`支付宝小程序样式隔离不允许 class 使用保留前缀：${classNode.value}`);
+                    }
+                });
+                if (selector.nodes.length !== 1 || selector.nodes[0].type !== 'class') {
+                    return;
+                }
+                selector.nodes[0].value = prefix + selector.nodes[0].value;
+                if (isPage) {
+                    selector.prepend(postcss_selector_parser_1.default.combinator({ value: ' ' }));
+                    selector.prepend(postcss_selector_parser_1.default.tag({ value: 'page' }));
+                }
+            });
+        }).processSync(rule.selector);
+    });
+}
 function processRule(rule, processedRules, staticClasses, hasDynamic) {
     // 同一个 Rule 只处理一次，避免被重复追加 [class]
     if (processedRules.has(rule)) {

package/dist/resolve.d.ts

@@ -12,6 +12,6 @@ export declare function resolvePinia(): string;
 export declare function resolveProjectPinia(): string | undefined;
 export declare function resolvePiniaDependencies(): Record<string, string>;
 export declare function resolvePiniaAlias(): Record<string, string>;
-export declare function resolveVueI18nRuntimeAlias(): Record<string, string>;
+export declare function resolveVueI18nAlias(): Record<string, string>;
 export declare function resolveComponentsLibPath(): string;
 export declare function resolveComponentsLibDirs(): string[];