@weapp-core/shared 3.0.5 → 3.1.0

package/dist/platforms-CoAy6Y88.js

@@ -0,0 +1,500 @@
+//#region src/platforms/descriptors.ts
+const DEFAULT_PROJECT_CONFIG_ROOT_KEYS = ["miniprogramRoot", "srcMiniprogramRoot"];
+const DEFAULT_RUNTIME_CAPABILITIES = Object.freeze({
+	globalPageStack: true,
+	globalCreateSelectorQuery: true,
+	selectorQueryScopeByIn: true,
+	globalCreateIntersectionObserver: true,
+	intersectionObserverScopeByParameter: true,
+	pageShareMenu: true,
+	shareTimelineRequiresShareAppMessage: true,
+	pageScrollApi: true,
+	pullDownRefreshApi: true,
+	globalRouterApi: true,
+	appErrorListener: true,
+	appPageNotFoundListener: true,
+	appUnhandledRejectionListener: true,
+	appThemeChangeListener: true,
+	appMemoryWarningListener: true
+});
+const DEFAULT_PAGE_IDENTITY_RULES = [{
+	prefix: "route",
+	source: "route"
+}];
+/**
+* @description 全仓库统一的小程序平台描述表。
+*/
+const MINI_PROGRAM_PLATFORM_DESCRIPTORS = [
+	{
+		id: "weapp",
+		displayName: "WeChat Mini Program",
+		family: "wechat",
+		aliases: [
+			"weapp",
+			"wechat",
+			"weixin",
+			"wx"
+		],
+		outputExtensions: {
+			js: "js",
+			json: "json",
+			wxml: "wxml",
+			wxss: "wxss",
+			wxs: "wxs"
+		},
+		projectConfigFileName: "project.config.json",
+		projectConfigRootKeys: DEFAULT_PROJECT_CONFIG_ROOT_KEYS,
+		ide: {},
+		build: {
+			autoTouchAppStyle: true,
+			defaultBuildTarget: "es2020"
+		},
+		resolvePreservedNpmDirNames: () => ["miniprogram_npm"],
+		json: {},
+		npm: { distDirName: () => "miniprogram_npm" },
+		wxml: {
+			eventBindingStyle: "default",
+			directivePrefix: "wx"
+		},
+		compiler: { templatePreset: "wechat" },
+		typescript: { appTypesPackage: "miniprogram-api-typings" },
+		runtime: {
+			globalObjectKey: "wx",
+			hostConfigKey: "__wxConfig",
+			globalResolvePriority: 1,
+			routeGlobalResolvePriority: 0,
+			capabilities: DEFAULT_RUNTIME_CAPABILITIES,
+			pageIdentityRules: [
+				{
+					prefix: "webview",
+					source: "field",
+					field: "__wxWebviewId__"
+				},
+				{
+					prefix: "exparser",
+					source: "field",
+					field: "__wxExparserNodeId__"
+				},
+				...DEFAULT_PAGE_IDENTITY_RULES
+			]
+		}
+	},
+	{
+		id: "alipay",
+		displayName: "Alipay Mini Program",
+		family: "alipay",
+		aliases: [
+			"alipay",
+			"ali",
+			"my"
+		],
+		outputExtensions: {
+			js: "js",
+			json: "json",
+			wxml: "axml",
+			wxss: "acss",
+			wxs: "sjs"
+		},
+		projectConfigFileName: "mini.project.json",
+		projectConfigRootKeys: DEFAULT_PROJECT_CONFIG_ROOT_KEYS,
+		scriptModuleTagByExtension: { sjs: "import-sjs" },
+		usesProjectRootNpmDir: true,
+		ide: {
+			requiresOpenPlatformArg: true,
+			defaultProjectRoot: "dist/alipay/dist"
+		},
+		build: {
+			autoTouchAppStyle: false,
+			defaultBuildTarget: "es2015"
+		},
+		resolvePreservedNpmDirNames: (options) => [options?.alipayNpmMode === "miniprogram_npm" ? "miniprogram_npm" : "node_modules"],
+		json: {
+			normalizeUsingComponents: true,
+			fillComponentGenericsDefault: true,
+			rewriteBundleNpmImports: true
+		},
+		npm: {
+			distDirName: (options) => options?.alipayNpmMode === "miniprogram_npm" ? "miniprogram_npm" : "node_modules",
+			normalizeImportPath: true,
+			normalizeMiniprogramPackage: true,
+			copyEsModuleDirectory: true,
+			hoistNestedDependencies: true,
+			shouldRebuildCachedPackage: true
+		},
+		wxml: {
+			eventBindingStyle: "alipay",
+			directivePrefix: "a",
+			normalizeComponentTagName: true,
+			normalizeVueTemplate: true,
+			emitGenericPlaceholder: true
+		},
+		compiler: { templatePreset: "alipay" },
+		typescript: { appTypesPackage: "@mini-types/alipay" },
+		runtime: {
+			globalObjectKey: "my",
+			hostConfigKey: "__wxConfig",
+			globalResolvePriority: 0,
+			routeGlobalResolvePriority: 2,
+			capabilities: {
+				...DEFAULT_RUNTIME_CAPABILITIES,
+				pageShareMenu: false,
+				appThemeChangeListener: false
+			},
+			pageIdentityRules: DEFAULT_PAGE_IDENTITY_RULES
+		}
+	},
+	{
+		id: "swan",
+		displayName: "Baidu Smart Program",
+		family: "swan",
+		aliases: [
+			"swan",
+			"baidu",
+			"bd"
+		],
+		outputExtensions: {
+			js: "js",
+			json: "json",
+			wxml: "swan",
+			wxss: "css",
+			wxs: "sjs"
+		},
+		projectConfigFileName: "project.swan.json",
+		projectConfigRootKeys: ["smartProgramRoot", ...DEFAULT_PROJECT_CONFIG_ROOT_KEYS],
+		ide: {},
+		build: { autoTouchAppStyle: false },
+		resolvePreservedNpmDirNames: () => ["miniprogram_npm"],
+		json: {},
+		npm: { distDirName: () => "miniprogram_npm" },
+		wxml: {
+			eventBindingStyle: "default",
+			directivePrefix: "s"
+		},
+		compiler: { templatePreset: "swan" },
+		typescript: { appTypesPackage: "miniprogram-api-typings" },
+		runtime: {
+			globalObjectKey: "swan",
+			hostConfigKey: "__wxConfig",
+			capabilities: DEFAULT_RUNTIME_CAPABILITIES,
+			pageIdentityRules: DEFAULT_PAGE_IDENTITY_RULES
+		}
+	},
+	{
+		id: "tt",
+		displayName: "ByteDance / Douyin Mini Program",
+		family: "tt",
+		aliases: [
+			"tt",
+			"toutiao",
+			"bytedance",
+			"douyin"
+		],
+		outputExtensions: {
+			js: "js",
+			json: "json",
+			wxml: "ttml",
+			wxss: "ttss"
+		},
+		projectConfigFileName: "project.config.json",
+		projectConfigRootKeys: DEFAULT_PROJECT_CONFIG_ROOT_KEYS,
+		ide: {},
+		build: { autoTouchAppStyle: false },
+		resolvePreservedNpmDirNames: () => ["miniprogram_npm"],
+		json: {},
+		npm: { distDirName: () => "miniprogram_npm" },
+		wxml: {
+			eventBindingStyle: "default",
+			directivePrefix: "tt"
+		},
+		compiler: { templatePreset: "tt" },
+		typescript: { appTypesPackage: "@douyin-microapp/typings" },
+		runtime: {
+			globalObjectKey: "tt",
+			hostConfigKey: "__wxConfig",
+			globalResolvePriority: 2,
+			routeGlobalResolvePriority: 1,
+			capabilities: {
+				...DEFAULT_RUNTIME_CAPABILITIES,
+				appThemeChangeListener: false
+			},
+			pageIdentityRules: DEFAULT_PAGE_IDENTITY_RULES
+		}
+	},
+	{
+		id: "jd",
+		displayName: "JD Mini Program",
+		family: "wechat",
+		aliases: ["jd", "jingdong"],
+		outputExtensions: {
+			js: "js",
+			json: "json",
+			wxml: "jxml",
+			wxss: "jxss",
+			wxs: "wxs"
+		},
+		projectConfigFileName: "project.config.json",
+		projectConfigRootKeys: DEFAULT_PROJECT_CONFIG_ROOT_KEYS,
+		ide: {},
+		build: { autoTouchAppStyle: false },
+		resolvePreservedNpmDirNames: () => ["miniprogram_npm"],
+		json: {},
+		npm: { distDirName: () => "miniprogram_npm" },
+		wxml: {
+			eventBindingStyle: "default",
+			directivePrefix: "wx"
+		},
+		compiler: { templatePreset: "wechat" },
+		typescript: { appTypesPackage: "miniprogram-api-typings" },
+		runtime: {
+			globalObjectKey: "jd",
+			hostConfigKey: "__wxConfig",
+			capabilities: DEFAULT_RUNTIME_CAPABILITIES,
+			pageIdentityRules: DEFAULT_PAGE_IDENTITY_RULES
+		}
+	},
+	{
+		id: "xhs",
+		displayName: "Xiaohongshu Mini Program",
+		family: "wechat",
+		aliases: [
+			"xhs",
+			"xiaohongshu",
+			"little-red-book",
+			"red"
+		],
+		outputExtensions: {
+			js: "js",
+			json: "json",
+			wxml: "xhsml",
+			wxss: "css",
+			wxs: "wxs"
+		},
+		projectConfigFileName: "project.config.json",
+		projectConfigRootKeys: DEFAULT_PROJECT_CONFIG_ROOT_KEYS,
+		ide: {},
+		build: { autoTouchAppStyle: false },
+		resolvePreservedNpmDirNames: () => ["miniprogram_npm"],
+		json: {},
+		npm: { distDirName: () => "miniprogram_npm" },
+		wxml: {
+			eventBindingStyle: "default",
+			directivePrefix: "wx"
+		},
+		compiler: { templatePreset: "wechat" },
+		typescript: { appTypesPackage: "miniprogram-api-typings" },
+		runtime: {
+			globalObjectKey: "xhs",
+			hostConfigKey: "__wxConfig",
+			capabilities: DEFAULT_RUNTIME_CAPABILITIES,
+			pageIdentityRules: DEFAULT_PAGE_IDENTITY_RULES
+		}
+	}
+];
+//#endregion
+//#region src/platforms/helpers.ts
+const LEADING_SLASH_RE = /^\/+/;
+function createMiniProgramPlatformRegistry(descriptors) {
+	const descriptorById = /* @__PURE__ */ new Map();
+	const aliasToId = /* @__PURE__ */ new Map();
+	const runtimeGlobalKeyToId = /* @__PURE__ */ new Map();
+	for (const descriptor of descriptors) {
+		descriptorById.set(descriptor.id, descriptor);
+		runtimeGlobalKeyToId.set(descriptor.runtime.globalObjectKey, descriptor.id);
+		aliasToId.set(descriptor.id, descriptor.id);
+		for (const alias of descriptor.aliases) {
+			const normalized = alias.trim().toLowerCase();
+			if (!normalized) continue;
+			aliasToId.set(normalized, descriptor.id);
+		}
+	}
+	return {
+		aliasToId,
+		descriptorById,
+		runtimeGlobalKeyToId
+	};
+}
+const { aliasToId: MINI_PROGRAM_PLATFORM_ALIAS_TO_ID, descriptorById: MINI_PROGRAM_PLATFORM_DESCRIPTOR_BY_ID, runtimeGlobalKeyToId: MINI_PROGRAM_RUNTIME_GLOBAL_KEY_TO_ID } = createMiniProgramPlatformRegistry(MINI_PROGRAM_PLATFORM_DESCRIPTORS);
+const SUPPORTED_MINI_PROGRAM_PLATFORMS = Object.freeze(MINI_PROGRAM_PLATFORM_DESCRIPTORS.map((descriptor) => descriptor.id));
+const SUPPORTED_MINI_PROGRAM_DIRECTIVE_PREFIXES = Object.freeze(Array.from(new Set(MINI_PROGRAM_PLATFORM_DESCRIPTORS.map((descriptor) => descriptor.wxml?.directivePrefix).filter((prefix) => Boolean(prefix)))));
+const ORDERED_RUNTIME_GLOBAL_KEYS = Object.freeze(Array.from(new Set(MINI_PROGRAM_PLATFORM_DESCRIPTORS.map((descriptor) => descriptor.runtime.globalObjectKey))));
+const MAX_RUNTIME_RESOLVE_PRIORITY = Number.MAX_SAFE_INTEGER;
+function getOrderedRuntimeGlobalKeysByPriority(priorityKey) {
+	const ordered = [...MINI_PROGRAM_PLATFORM_DESCRIPTORS].sort((left, right) => {
+		const leftPriority = left.runtime[priorityKey] ?? MAX_RUNTIME_RESOLVE_PRIORITY;
+		const rightPriority = right.runtime[priorityKey] ?? MAX_RUNTIME_RESOLVE_PRIORITY;
+		if (leftPriority !== rightPriority) return leftPriority - rightPriority;
+		return MINI_PROGRAM_PLATFORM_DESCRIPTORS.indexOf(left) - MINI_PROGRAM_PLATFORM_DESCRIPTORS.indexOf(right);
+	});
+	return Object.freeze(Array.from(new Set(ordered.map((descriptor) => descriptor.runtime.globalObjectKey))));
+}
+const ORDERED_RUNTIME_GLOBAL_KEYS_BY_RESOLVE_PRIORITY = getOrderedRuntimeGlobalKeysByPriority("globalResolvePriority");
+const ORDERED_RUNTIME_GLOBAL_KEYS_BY_ROUTE_PRIORITY = getOrderedRuntimeGlobalKeysByPriority("routeGlobalResolvePriority");
+/**
+* @description 小程序平台别名映射表。
+*/
+const MINI_PROGRAM_PLATFORM_ALIASES = Object.freeze(Object.fromEntries(MINI_PROGRAM_PLATFORM_ALIAS_TO_ID.entries()));
+/**
+* @description 标准化平台输入。
+*/
+function normalizeMiniProgramPlatform(input) {
+	return input?.trim().toLowerCase() || void 0;
+}
+/**
+* @description 解析平台输入到标准平台标识。
+*/
+function resolveMiniProgramPlatform(input) {
+	const normalized = normalizeMiniProgramPlatform(input);
+	if (!normalized) return;
+	return MINI_PROGRAM_PLATFORM_ALIAS_TO_ID.get(normalized);
+}
+/**
+* @description 返回所有受支持的小程序平台。
+*/
+function getSupportedMiniProgramPlatforms() {
+	return SUPPORTED_MINI_PROGRAM_PLATFORMS;
+}
+/**
+* @description 返回所有受支持的小程序模板指令前缀。
+*/
+function getSupportedMiniProgramDirectivePrefixes() {
+	return SUPPORTED_MINI_PROGRAM_DIRECTIVE_PREFIXES;
+}
+/**
+* @description 返回默认小程序平台。
+*/
+function getDefaultMiniProgramPlatform() {
+	return SUPPORTED_MINI_PROGRAM_PLATFORMS[0] ?? "weapp";
+}
+/**
+* @description 获取平台描述。
+*/
+function getMiniProgramPlatformDescriptor(platform) {
+	const descriptor = MINI_PROGRAM_PLATFORM_DESCRIPTOR_BY_ID.get(platform);
+	if (!descriptor) throw new Error(`不支持的小程序平台 "${platform}"。`);
+	return descriptor;
+}
+/**
+* @description 获取模板编译预设。
+*/
+function getMiniProgramTemplatePreset(platform) {
+	if (!platform) return "wechat";
+	return getMiniProgramPlatformDescriptor(platform).compiler?.templatePreset ?? "wechat";
+}
+/**
+* @description 判断平台是否允许自动补齐 app 样式入口。
+*/
+function supportsMiniProgramAutoTouchAppStyle(platform) {
+	if (!platform) return false;
+	return getMiniProgramPlatformDescriptor(platform).build?.autoTouchAppStyle === true;
+}
+/**
+* @description 获取平台默认构建目标。
+*/
+function getMiniProgramDefaultBuildTarget(platform) {
+	if (!platform) return;
+	return getMiniProgramPlatformDescriptor(platform).build?.defaultBuildTarget;
+}
+/**
+* @description 获取平台默认使用的类型包。
+*/
+function getMiniProgramAppTypesPackage(platform) {
+	return getMiniProgramPlatformDescriptor(platform ?? getDefaultMiniProgramPlatform()).typescript?.appTypesPackage ?? "miniprogram-api-typings";
+}
+/**
+* @description 获取平台模板指令前缀。
+*/
+function getMiniProgramDirectivePrefix(platform) {
+	if (!platform) return "wx";
+	return getMiniProgramPlatformDescriptor(platform).wxml?.directivePrefix ?? "wx";
+}
+/**
+* @description 获取宿主全局对象 key。
+*/
+function getMiniProgramRuntimeGlobalKey(platform) {
+	return getMiniProgramPlatformDescriptor(platform).runtime.globalObjectKey;
+}
+/**
+* @description 获取默认宿主全局对象 key。
+*/
+function getDefaultMiniProgramRuntimeGlobalKey() {
+	return ORDERED_RUNTIME_GLOBAL_KEYS[0] ?? "wx";
+}
+/**
+* @description 解析宿主全局对象 key 对应的平台。
+*/
+function getMiniProgramPlatformByRuntimeGlobalKey(globalObjectKey) {
+	const normalized = globalObjectKey?.trim();
+	if (!normalized) return;
+	return MINI_PROGRAM_RUNTIME_GLOBAL_KEY_TO_ID.get(normalized);
+}
+/**
+* @description 返回 runtime 全局对象 key 的扫描优先级。
+*/
+function getMiniProgramRuntimeGlobalKeys(platform) {
+	if (platform) return [getMiniProgramRuntimeGlobalKey(platform)];
+	return ORDERED_RUNTIME_GLOBAL_KEYS;
+}
+/**
+* @description 返回按通用解析优先级排序的 runtime 全局对象 key。
+*/
+function getMiniProgramRuntimeGlobalKeysByResolvePriority(platform) {
+	if (platform) return [getMiniProgramRuntimeGlobalKey(platform)];
+	return ORDERED_RUNTIME_GLOBAL_KEYS_BY_RESOLVE_PRIORITY;
+}
+/**
+* @description 返回按路由解析优先级排序的 runtime 全局对象 key。
+*/
+function getMiniProgramRouteRuntimeGlobalKeys(platform) {
+	if (platform) return [getMiniProgramRuntimeGlobalKey(platform)];
+	return ORDERED_RUNTIME_GLOBAL_KEYS_BY_ROUTE_PRIORITY;
+}
+/**
+* @description 获取平台 runtime 宿主配置 key。
+*/
+function getMiniProgramRuntimeHostConfigKey(platform) {
+	if (!platform) return "__wxConfig";
+	return getMiniProgramPlatformDescriptor(platform).runtime.hostConfigKey;
+}
+/**
+* @description 获取平台 runtime 能力描述。
+*/
+function getMiniProgramRuntimeCapabilities(platform) {
+	if (!platform) return DEFAULT_RUNTIME_CAPABILITIES;
+	return getMiniProgramPlatformDescriptor(platform).runtime.capabilities;
+}
+/**
+* @description 判断平台是否支持指定 runtime 能力。
+*/
+function supportsMiniProgramRuntimeCapability(platform, capabilityName) {
+	return getMiniProgramRuntimeCapabilities(platform)[capabilityName] === true;
+}
+function serializeMiniProgramPageIdentityRule(rule) {
+	return rule.source === "field" ? `${rule.prefix}:${rule.field ?? ""}` : `${rule.prefix}:route`;
+}
+function getMiniProgramPageIdentityRules(platform) {
+	if (platform) return getMiniProgramPlatformDescriptor(platform).runtime.pageIdentityRules;
+	const merged = /* @__PURE__ */ new Map();
+	for (const descriptor of MINI_PROGRAM_PLATFORM_DESCRIPTORS) for (const rule of descriptor.runtime.pageIdentityRules) merged.set(serializeMiniProgramPageIdentityRule(rule), rule);
+	return [...merged.values()];
+}
+/**
+* @description 根据平台描述解析页面身份 key。
+*/
+function resolveMiniProgramPageKeys(page, platform) {
+	if (!page || typeof page !== "object") return [];
+	const keys = [];
+	for (const rule of getMiniProgramPageIdentityRules(platform)) {
+		if (rule.source === "route") {
+			const route = typeof page.route === "string" ? page.route.replace(LEADING_SLASH_RE, "") : "";
+			if (route) keys.push(`${rule.prefix}:${route}`);
+			continue;
+		}
+		const field = rule.field;
+		if (!field) continue;
+		const value = page[field];
+		if (typeof value === "number" || typeof value === "string") keys.push(`${rule.prefix}:${String(value)}`);
+	}
+	return Array.from(new Set(keys));
+}
+//#endregion
+export { MINI_PROGRAM_PLATFORM_DESCRIPTORS as C, supportsMiniProgramRuntimeCapability as S, getSupportedMiniProgramPlatforms as _, getMiniProgramDefaultBuildTarget as a, resolveMiniProgramPlatform as b, getMiniProgramPlatformDescriptor as c, getMiniProgramRuntimeGlobalKey as d, getMiniProgramRuntimeGlobalKeys as f, getSupportedMiniProgramDirectivePrefixes as g, getMiniProgramTemplatePreset as h, getMiniProgramAppTypesPackage as i, getMiniProgramRouteRuntimeGlobalKeys as l, getMiniProgramRuntimeHostConfigKey as m, getDefaultMiniProgramPlatform as n, getMiniProgramDirectivePrefix as o, getMiniProgramRuntimeGlobalKeysByResolvePriority as p, getDefaultMiniProgramRuntimeGlobalKey as r, getMiniProgramPlatformByRuntimeGlobalKey as s, MINI_PROGRAM_PLATFORM_ALIASES as t, getMiniProgramRuntimeCapabilities as u, normalizeMiniProgramPlatform as v, supportsMiniProgramAutoTouchAppStyle as x, resolveMiniProgramPageKeys as y };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weapp-core/shared",
   "type": "module",
-  "version": "3.0.5",
+  "version": "3.1.0",
   "description": "@weapp-core/shared",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -28,6 +28,10 @@
       "./fs": {
         "types": "./src/fs/index.ts",
         "default": "./src/fs/index.ts"
+      },
+      "./platforms": {
+        "types": "./src/platforms/index.ts",
+        "default": "./src/platforms/index.ts"
       }
     },
     "main": "./src/index.ts",
@@ -46,6 +50,10 @@
     "./fs": {
       "types": "./dist/fs/index.d.ts",
       "import": "./dist/fs/index.js"
+    },
+    "./platforms": {
+      "types": "./dist/platforms/index.d.ts",
+      "import": "./dist/platforms/index.js"
     }
   },
   "main": "./dist/index.js",