@weapp-core/shared 3.2.5 → 3.2.7

package/dist/platforms/runtime/descriptors.js

@@ -0,0 +1,141 @@
+//#region src/platforms/runtime/descriptors.ts
+const DEFAULT_RUNTIME_HOST_CONFIG_KEY = "__wxConfig";
+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"
+}];
+const WEAPP_RUNTIME_DESCRIPTOR = {
+	id: "weapp",
+	aliases: [
+		"weapp",
+		"wechat",
+		"weixin",
+		"wx"
+	],
+	runtime: {
+		globalObjectKey: "wx",
+		hostConfigKey: DEFAULT_RUNTIME_HOST_CONFIG_KEY,
+		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
+		]
+	}
+};
+const ALIPAY_RUNTIME_DESCRIPTOR = {
+	id: "alipay",
+	aliases: [
+		"alipay",
+		"ali",
+		"my"
+	],
+	runtime: {
+		globalObjectKey: "my",
+		hostConfigKey: DEFAULT_RUNTIME_HOST_CONFIG_KEY,
+		globalResolvePriority: 0,
+		routeGlobalResolvePriority: 2,
+		capabilities: {
+			...DEFAULT_RUNTIME_CAPABILITIES,
+			pageShareMenu: false,
+			appThemeChangeListener: false
+		},
+		pageIdentityRules: DEFAULT_PAGE_IDENTITY_RULES
+	}
+};
+const SWAN_RUNTIME_DESCRIPTOR = {
+	id: "swan",
+	aliases: [
+		"swan",
+		"baidu",
+		"bd"
+	],
+	runtime: {
+		globalObjectKey: "swan",
+		hostConfigKey: DEFAULT_RUNTIME_HOST_CONFIG_KEY,
+		capabilities: DEFAULT_RUNTIME_CAPABILITIES,
+		pageIdentityRules: DEFAULT_PAGE_IDENTITY_RULES
+	}
+};
+const TT_RUNTIME_DESCRIPTOR = {
+	id: "tt",
+	aliases: [
+		"tt",
+		"toutiao",
+		"bytedance",
+		"douyin"
+	],
+	runtime: {
+		globalObjectKey: "tt",
+		hostConfigKey: DEFAULT_RUNTIME_HOST_CONFIG_KEY,
+		globalResolvePriority: 2,
+		routeGlobalResolvePriority: 1,
+		capabilities: {
+			...DEFAULT_RUNTIME_CAPABILITIES,
+			appThemeChangeListener: false
+		},
+		pageIdentityRules: DEFAULT_PAGE_IDENTITY_RULES
+	}
+};
+const JD_RUNTIME_DESCRIPTOR = {
+	id: "jd",
+	aliases: ["jd", "jingdong"],
+	runtime: {
+		globalObjectKey: "jd",
+		hostConfigKey: DEFAULT_RUNTIME_HOST_CONFIG_KEY,
+		capabilities: DEFAULT_RUNTIME_CAPABILITIES,
+		pageIdentityRules: DEFAULT_PAGE_IDENTITY_RULES
+	}
+};
+const XHS_RUNTIME_DESCRIPTOR = {
+	id: "xhs",
+	aliases: [
+		"xhs",
+		"xiaohongshu",
+		"little-red-book",
+		"red"
+	],
+	runtime: {
+		globalObjectKey: "xhs",
+		hostConfigKey: DEFAULT_RUNTIME_HOST_CONFIG_KEY,
+		capabilities: DEFAULT_RUNTIME_CAPABILITIES,
+		pageIdentityRules: DEFAULT_PAGE_IDENTITY_RULES
+	}
+};
+const MINI_PROGRAM_RUNTIME_DESCRIPTORS = [
+	WEAPP_RUNTIME_DESCRIPTOR,
+	ALIPAY_RUNTIME_DESCRIPTOR,
+	SWAN_RUNTIME_DESCRIPTOR,
+	TT_RUNTIME_DESCRIPTOR,
+	JD_RUNTIME_DESCRIPTOR,
+	XHS_RUNTIME_DESCRIPTOR
+];
+//#endregion
+export { ALIPAY_RUNTIME_DESCRIPTOR, DEFAULT_RUNTIME_CAPABILITIES, DEFAULT_RUNTIME_HOST_CONFIG_KEY, JD_RUNTIME_DESCRIPTOR, MINI_PROGRAM_RUNTIME_DESCRIPTORS, SWAN_RUNTIME_DESCRIPTOR, TT_RUNTIME_DESCRIPTOR, WEAPP_RUNTIME_DESCRIPTOR, XHS_RUNTIME_DESCRIPTOR };

package/dist/platforms/runtime/helpers.d.ts

@@ -0,0 +1,65 @@
+import { MiniProgramRuntimeCapabilities, MiniProgramRuntimeCapabilityName, MpPlatform } from "../types.js";
+import { MiniProgramRuntimeDescriptor } from "./descriptors.js";
+//#region src/platforms/runtime/helpers.d.ts
+export declare const MINI_PROGRAM_PLATFORM_ALIASES: Readonly<Record<string, MpPlatform>>;
+/**
+ * @description 标准化平台输入。
+ */
+export declare function normalizeMiniProgramPlatform(input?: string | null): string | undefined;
+/**
+ * @description 解析平台输入到标准平台标识。
+ */
+export declare function resolveMiniProgramPlatform(input?: string | null): MpPlatform | undefined;
+/**
+ * @description 返回所有受支持的小程序平台。
+ */
+export declare function getSupportedMiniProgramPlatforms(): readonly MpPlatform[];
+/**
+ * @description 返回默认小程序平台。
+ */
+export declare function getDefaultMiniProgramPlatform(): MpPlatform;
+/**
+ * @description 获取平台描述。
+ */
+export declare function getMiniProgramRuntimeDescriptor(platform: MpPlatform): MiniProgramRuntimeDescriptor;
+/**
+ * @description 获取宿主全局对象 key。
+ */
+export declare function getMiniProgramRuntimeGlobalKey(platform: MpPlatform): string;
+/**
+ * @description 获取默认宿主全局对象 key。
+ */
+export declare function getDefaultMiniProgramRuntimeGlobalKey(): string;
+/**
+ * @description 解析宿主全局对象 key 对应的平台。
+ */
+export declare function getMiniProgramPlatformByRuntimeGlobalKey(globalObjectKey?: string | null): MpPlatform | undefined;
+/**
+ * @description 返回 runtime 全局对象 key 的扫描优先级。
+ */
+export declare function getMiniProgramRuntimeGlobalKeys(platform?: MpPlatform): readonly string[];
+/**
+ * @description 返回按通用解析优先级排序的 runtime 全局对象 key。
+ */
+export declare function getMiniProgramRuntimeGlobalKeysByResolvePriority(platform?: MpPlatform): readonly string[];
+/**
+ * @description 返回按路由解析优先级排序的 runtime 全局对象 key。
+ */
+export declare function getMiniProgramRouteRuntimeGlobalKeys(platform?: MpPlatform): readonly string[];
+/**
+ * @description 获取平台 runtime 宿主配置 key。
+ */
+export declare function getMiniProgramRuntimeHostConfigKey(platform?: MpPlatform): string;
+/**
+ * @description 获取平台 runtime 能力描述。
+ */
+export declare function getMiniProgramRuntimeCapabilities(platform?: MpPlatform): MiniProgramRuntimeCapabilities;
+/**
+ * @description 判断平台是否支持指定 runtime 能力。
+ */
+export declare function supportsMiniProgramRuntimeCapability(platform: MpPlatform | undefined, capabilityName: MiniProgramRuntimeCapabilityName): boolean;
+/**
+ * @description 根据平台描述解析页面身份 key。
+ */
+export declare function resolveMiniProgramPageKeys(page?: Record<string, any>, platform?: MpPlatform): string[];
+//#endregion

package/dist/platforms/runtime/helpers.js

@@ -0,0 +1,169 @@
+import { DEFAULT_RUNTIME_CAPABILITIES, MINI_PROGRAM_RUNTIME_DESCRIPTORS } from "./descriptors.js";
+//#region src/platforms/runtime/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_RUNTIME_DESCRIPTORS);
+const SUPPORTED_MINI_PROGRAM_PLATFORMS = Object.freeze(MINI_PROGRAM_RUNTIME_DESCRIPTORS.map((descriptor) => descriptor.id));
+const ORDERED_RUNTIME_GLOBAL_KEYS = Object.freeze(Array.from(new Set(MINI_PROGRAM_RUNTIME_DESCRIPTORS.map((descriptor) => descriptor.runtime.globalObjectKey))));
+const MAX_RUNTIME_RESOLVE_PRIORITY = Number.MAX_SAFE_INTEGER;
+function getOrderedRuntimeGlobalKeysByPriority(priorityKey) {
+	const ordered = [...MINI_PROGRAM_RUNTIME_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_RUNTIME_DESCRIPTORS.indexOf(left) - MINI_PROGRAM_RUNTIME_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_ALIAS_RECORD = {};
+for (const [alias, platform] of MINI_PROGRAM_PLATFORM_ALIAS_TO_ID) MINI_PROGRAM_PLATFORM_ALIAS_RECORD[alias] = platform;
+const MINI_PROGRAM_PLATFORM_ALIASES = Object.freeze(MINI_PROGRAM_PLATFORM_ALIAS_RECORD);
+/**
+* @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 getDefaultMiniProgramPlatform() {
+	return SUPPORTED_MINI_PROGRAM_PLATFORMS[0] ?? "weapp";
+}
+/**
+* @description 获取平台描述。
+*/
+function getMiniProgramRuntimeDescriptor(platform) {
+	const descriptor = MINI_PROGRAM_PLATFORM_DESCRIPTOR_BY_ID.get(platform);
+	if (!descriptor) throw new Error(`不支持的小程序平台 "${platform}"。`);
+	return descriptor;
+}
+/**
+* @description 获取宿主全局对象 key。
+*/
+function getMiniProgramRuntimeGlobalKey(platform) {
+	return getMiniProgramRuntimeDescriptor(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 getMiniProgramRuntimeDescriptor(platform).runtime.hostConfigKey;
+}
+/**
+* @description 获取平台 runtime 能力描述。
+*/
+function getMiniProgramRuntimeCapabilities(platform) {
+	if (!platform) return DEFAULT_RUNTIME_CAPABILITIES;
+	return getMiniProgramRuntimeDescriptor(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 getMiniProgramRuntimeDescriptor(platform).runtime.pageIdentityRules;
+	const merged = /* @__PURE__ */ new Map();
+	for (const descriptor of MINI_PROGRAM_RUNTIME_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_ALIASES, getDefaultMiniProgramPlatform, getDefaultMiniProgramRuntimeGlobalKey, getMiniProgramPlatformByRuntimeGlobalKey, getMiniProgramRouteRuntimeGlobalKeys, getMiniProgramRuntimeCapabilities, getMiniProgramRuntimeDescriptor, getMiniProgramRuntimeGlobalKey, getMiniProgramRuntimeGlobalKeys, getMiniProgramRuntimeGlobalKeysByResolvePriority, getMiniProgramRuntimeHostConfigKey, getSupportedMiniProgramPlatforms, normalizeMiniProgramPlatform, resolveMiniProgramPageKeys, resolveMiniProgramPlatform, supportsMiniProgramRuntimeCapability };

package/dist/platforms/runtime/index.d.ts

@@ -0,0 +1,5 @@
+import { MiniProgramRuntimeCapabilities, MiniProgramRuntimeCapabilityName, MpPlatform } from "../types.js";
+import { ALIPAY_RUNTIME_DESCRIPTOR, DEFAULT_RUNTIME_CAPABILITIES, DEFAULT_RUNTIME_HOST_CONFIG_KEY, JD_RUNTIME_DESCRIPTOR, MINI_PROGRAM_RUNTIME_DESCRIPTORS, MiniProgramRuntimeDescriptor, SWAN_RUNTIME_DESCRIPTOR, TT_RUNTIME_DESCRIPTOR, WEAPP_RUNTIME_DESCRIPTOR, XHS_RUNTIME_DESCRIPTOR } from "./descriptors.js";
+import { MINI_PROGRAM_PLATFORM_ALIASES, getDefaultMiniProgramPlatform, getDefaultMiniProgramRuntimeGlobalKey, getMiniProgramPlatformByRuntimeGlobalKey, getMiniProgramRouteRuntimeGlobalKeys, getMiniProgramRuntimeCapabilities, getMiniProgramRuntimeDescriptor, getMiniProgramRuntimeGlobalKey, getMiniProgramRuntimeGlobalKeys, getMiniProgramRuntimeGlobalKeysByResolvePriority, getMiniProgramRuntimeHostConfigKey, getSupportedMiniProgramPlatforms, normalizeMiniProgramPlatform, resolveMiniProgramPageKeys, resolveMiniProgramPlatform, supportsMiniProgramRuntimeCapability } from "./helpers.js";
+import { getMiniProgramDirectivePrefix, getSupportedMiniProgramDirectivePrefixes } from "./template.js";
+export { ALIPAY_RUNTIME_DESCRIPTOR, DEFAULT_RUNTIME_CAPABILITIES, DEFAULT_RUNTIME_HOST_CONFIG_KEY, JD_RUNTIME_DESCRIPTOR, MINI_PROGRAM_PLATFORM_ALIASES, MINI_PROGRAM_RUNTIME_DESCRIPTORS, type MiniProgramRuntimeCapabilities, type MiniProgramRuntimeCapabilityName, MiniProgramRuntimeDescriptor, type MpPlatform, SWAN_RUNTIME_DESCRIPTOR, TT_RUNTIME_DESCRIPTOR, WEAPP_RUNTIME_DESCRIPTOR, XHS_RUNTIME_DESCRIPTOR, getDefaultMiniProgramPlatform, getDefaultMiniProgramRuntimeGlobalKey, getMiniProgramDirectivePrefix, getMiniProgramPlatformByRuntimeGlobalKey, getMiniProgramRouteRuntimeGlobalKeys, getMiniProgramRuntimeCapabilities, getMiniProgramRuntimeDescriptor, getMiniProgramRuntimeGlobalKey, getMiniProgramRuntimeGlobalKeys, getMiniProgramRuntimeGlobalKeysByResolvePriority, getMiniProgramRuntimeHostConfigKey, getSupportedMiniProgramDirectivePrefixes, getSupportedMiniProgramPlatforms, normalizeMiniProgramPlatform, resolveMiniProgramPageKeys, resolveMiniProgramPlatform, supportsMiniProgramRuntimeCapability };

package/dist/platforms/runtime/index.js

@@ -0,0 +1,4 @@
+import { ALIPAY_RUNTIME_DESCRIPTOR, DEFAULT_RUNTIME_CAPABILITIES, DEFAULT_RUNTIME_HOST_CONFIG_KEY, JD_RUNTIME_DESCRIPTOR, MINI_PROGRAM_RUNTIME_DESCRIPTORS, SWAN_RUNTIME_DESCRIPTOR, TT_RUNTIME_DESCRIPTOR, WEAPP_RUNTIME_DESCRIPTOR, XHS_RUNTIME_DESCRIPTOR } from "./descriptors.js";
+import { getMiniProgramDirectivePrefix, getSupportedMiniProgramDirectivePrefixes } from "./template.js";
+import { MINI_PROGRAM_PLATFORM_ALIASES, getDefaultMiniProgramPlatform, getDefaultMiniProgramRuntimeGlobalKey, getMiniProgramPlatformByRuntimeGlobalKey, getMiniProgramRouteRuntimeGlobalKeys, getMiniProgramRuntimeCapabilities, getMiniProgramRuntimeDescriptor, getMiniProgramRuntimeGlobalKey, getMiniProgramRuntimeGlobalKeys, getMiniProgramRuntimeGlobalKeysByResolvePriority, getMiniProgramRuntimeHostConfigKey, getSupportedMiniProgramPlatforms, normalizeMiniProgramPlatform, resolveMiniProgramPageKeys, resolveMiniProgramPlatform, supportsMiniProgramRuntimeCapability } from "./helpers.js";
+export { ALIPAY_RUNTIME_DESCRIPTOR, DEFAULT_RUNTIME_CAPABILITIES, DEFAULT_RUNTIME_HOST_CONFIG_KEY, JD_RUNTIME_DESCRIPTOR, MINI_PROGRAM_PLATFORM_ALIASES, MINI_PROGRAM_RUNTIME_DESCRIPTORS, SWAN_RUNTIME_DESCRIPTOR, TT_RUNTIME_DESCRIPTOR, WEAPP_RUNTIME_DESCRIPTOR, XHS_RUNTIME_DESCRIPTOR, getDefaultMiniProgramPlatform, getDefaultMiniProgramRuntimeGlobalKey, getMiniProgramDirectivePrefix, getMiniProgramPlatformByRuntimeGlobalKey, getMiniProgramRouteRuntimeGlobalKeys, getMiniProgramRuntimeCapabilities, getMiniProgramRuntimeDescriptor, getMiniProgramRuntimeGlobalKey, getMiniProgramRuntimeGlobalKeys, getMiniProgramRuntimeGlobalKeysByResolvePriority, getMiniProgramRuntimeHostConfigKey, getSupportedMiniProgramDirectivePrefixes, getSupportedMiniProgramPlatforms, normalizeMiniProgramPlatform, resolveMiniProgramPageKeys, resolveMiniProgramPlatform, supportsMiniProgramRuntimeCapability };

package/dist/platforms/runtime/template.d.ts

@@ -0,0 +1,7 @@
+import { MpPlatform } from "../types.js";
+//#region src/platforms/runtime/template.d.ts
+/** 返回所有受支持的小程序模板指令前缀。 */
+export declare function getSupportedMiniProgramDirectivePrefixes(): readonly string[];
+/** 获取平台模板指令前缀，兼容未指定平台时的微信默认值。 */
+export declare function getMiniProgramDirectivePrefix(platform?: MpPlatform): string;
+//#endregion

package/dist/platforms/runtime/template.js

@@ -0,0 +1,22 @@
+//#region src/platforms/runtime/template.ts
+const MINI_PROGRAM_DIRECTIVE_PREFIXES = Object.freeze({
+	weapp: "wx",
+	alipay: "a",
+	swan: "s",
+	tt: "tt",
+	jd: "wx",
+	xhs: "wx"
+});
+const SUPPORTED_MINI_PROGRAM_DIRECTIVE_PREFIXES = Object.freeze(Array.from(new Set(Object.values(MINI_PROGRAM_DIRECTIVE_PREFIXES))));
+/** 返回所有受支持的小程序模板指令前缀。 */
+function getSupportedMiniProgramDirectivePrefixes() {
+	return SUPPORTED_MINI_PROGRAM_DIRECTIVE_PREFIXES;
+}
+/** 获取平台模板指令前缀，兼容未指定平台时的微信默认值。 */
+function getMiniProgramDirectivePrefix(platform) {
+	const prefix = MINI_PROGRAM_DIRECTIVE_PREFIXES[platform ?? "weapp"];
+	if (!prefix) throw new Error(`不支持的小程序平台 "${platform}"。`);
+	return prefix;
+}
+//#endregion
+export { MINI_PROGRAM_DIRECTIVE_PREFIXES, getMiniProgramDirectivePrefix, getSupportedMiniProgramDirectivePrefixes };

package/dist/{index-BxC5D0Iz.d.ts → platforms/types.d.ts}

@@ -1,15 +1,15 @@
 //#region src/platforms/types.d.ts
-type MpPlatform = 'weapp' | 'alipay' | 'tt' | 'swan' | 'jd' | 'xhs';
-type MiniProgramTemplatePreset = 'wechat' | 'alipay' | 'tt' | 'swan';
-type MiniProgramPlatformFamily = 'wechat' | 'alipay' | 'tt' | 'swan';
-interface OutputExtensions {
+export type MpPlatform = 'weapp' | 'alipay' | 'tt' | 'swan' | 'jd' | 'xhs';
+export type MiniProgramTemplatePreset = 'wechat' | 'alipay' | 'tt' | 'swan';
+export type MiniProgramPlatformFamily = 'wechat' | 'alipay' | 'tt' | 'swan';
+export interface OutputExtensions {
   js: string;
   json: string;
   wxml: string;
   wxss: string;
   wxs?: string;
 }
-interface MiniProgramPageIdentityRule {
+export interface MiniProgramPageIdentityRule {
   /**
    * @description 注册 layout bridge 等页面级能力时使用的 key 前缀。
    */
@@ -23,7 +23,7 @@ interface MiniProgramPageIdentityRule {
    */
   field?: string;
 }
-interface MiniProgramRuntimeCapabilities {
+export interface MiniProgramRuntimeCapabilities {
   /**
    * @description 宿主是否支持全局 `getCurrentPages()` 页面栈读取。
    */
@@ -85,8 +85,8 @@ interface MiniProgramRuntimeCapabilities {
    */
   appMemoryWarningListener: boolean;
 }
-type MiniProgramRuntimeCapabilityName = keyof MiniProgramRuntimeCapabilities;
-interface MiniProgramPlatformDescriptor {
+export type MiniProgramRuntimeCapabilityName = keyof MiniProgramRuntimeCapabilities;
+export interface MiniProgramPlatformDescriptor {
   /**
    * @description 构建流程中使用的标准平台标识。
    */
@@ -210,98 +210,4 @@ interface MiniProgramPlatformDescriptor {
     capabilities: MiniProgramRuntimeCapabilities;
   };
 }
-//#endregion
-//#region src/platforms/descriptors.d.ts
-/**
- * @description 全仓库统一的小程序平台描述表。
- */
-declare const MINI_PROGRAM_PLATFORM_DESCRIPTORS: readonly MiniProgramPlatformDescriptor[];
-//#endregion
-//#region src/platforms/helpers.d.ts
-declare const MINI_PROGRAM_PLATFORM_ALIASES: Readonly<Record<string, MpPlatform>>;
-/**
- * @description 标准化平台输入。
- */
-declare function normalizeMiniProgramPlatform(input?: string | null): string | undefined;
-/**
- * @description 解析平台输入到标准平台标识。
- */
-declare function resolveMiniProgramPlatform(input?: string | null): MpPlatform | undefined;
-/**
- * @description 返回所有受支持的小程序平台。
- */
-declare function getSupportedMiniProgramPlatforms(): readonly MpPlatform[];
-/**
- * @description 返回所有受支持的小程序模板指令前缀。
- */
-declare function getSupportedMiniProgramDirectivePrefixes(): readonly string[];
-/**
- * @description 返回默认小程序平台。
- */
-declare function getDefaultMiniProgramPlatform(): MpPlatform;
-/**
- * @description 获取平台描述。
- */
-declare function getMiniProgramPlatformDescriptor(platform: MpPlatform): MiniProgramPlatformDescriptor;
-/**
- * @description 获取模板编译预设。
- */
-declare function getMiniProgramTemplatePreset(platform?: MpPlatform): MiniProgramTemplatePreset;
-/**
- * @description 判断平台是否允许自动补齐 app 样式入口。
- */
-declare function supportsMiniProgramAutoTouchAppStyle(platform?: MpPlatform): boolean;
-/**
- * @description 获取平台默认构建目标。
- */
-declare function getMiniProgramDefaultBuildTarget(platform?: MpPlatform): string | undefined;
-/**
- * @description 获取平台默认使用的类型包。
- */
-declare function getMiniProgramAppTypesPackage(platform?: MpPlatform): string;
-/**
- * @description 获取平台模板指令前缀。
- */
-declare function getMiniProgramDirectivePrefix(platform?: MpPlatform): string;
-/**
- * @description 获取宿主全局对象 key。
- */
-declare function getMiniProgramRuntimeGlobalKey(platform: MpPlatform): string;
-/**
- * @description 获取默认宿主全局对象 key。
- */
-declare function getDefaultMiniProgramRuntimeGlobalKey(): string;
-/**
- * @description 解析宿主全局对象 key 对应的平台。
- */
-declare function getMiniProgramPlatformByRuntimeGlobalKey(globalObjectKey?: string | null): MpPlatform | undefined;
-/**
- * @description 返回 runtime 全局对象 key 的扫描优先级。
- */
-declare function getMiniProgramRuntimeGlobalKeys(platform?: MpPlatform): readonly string[];
-/**
- * @description 返回按通用解析优先级排序的 runtime 全局对象 key。
- */
-declare function getMiniProgramRuntimeGlobalKeysByResolvePriority(platform?: MpPlatform): readonly string[];
-/**
- * @description 返回按路由解析优先级排序的 runtime 全局对象 key。
- */
-declare function getMiniProgramRouteRuntimeGlobalKeys(platform?: MpPlatform): readonly string[];
-/**
- * @description 获取平台 runtime 宿主配置 key。
- */
-declare function getMiniProgramRuntimeHostConfigKey(platform?: MpPlatform): string;
-/**
- * @description 获取平台 runtime 能力描述。
- */
-declare function getMiniProgramRuntimeCapabilities(platform?: MpPlatform): MiniProgramRuntimeCapabilities;
-/**
- * @description 判断平台是否支持指定 runtime 能力。
- */
-declare function supportsMiniProgramRuntimeCapability(platform: MpPlatform | undefined, capabilityName: MiniProgramRuntimeCapabilityName): boolean;
-/**
- * @description 根据平台描述解析页面身份 key。
- */
-declare function resolveMiniProgramPageKeys(page?: Record<string, any>, platform?: MpPlatform): string[];
-//#endregion
-export { MpPlatform as A, MINI_PROGRAM_PLATFORM_DESCRIPTORS as C, MiniProgramRuntimeCapabilities as D, MiniProgramPlatformFamily as E, MiniProgramRuntimeCapabilityName as O, supportsMiniProgramRuntimeCapability as S, MiniProgramPlatformDescriptor as T, 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, OutputExtensions as j, MiniProgramTemplatePreset as k, 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, MiniProgramPageIdentityRule as w, supportsMiniProgramAutoTouchAppStyle as x, resolveMiniProgramPageKeys as y };
+//#endregion

package/dist/runtimeProviders.d.ts

@@ -0,0 +1,44 @@
+//#region src/runtimeProviders.d.ts
+export type RuntimeProviderBackend = 'miniprogram' | 'web';
+export type RuntimeProviderCompilation = 'native' | 'vue' | 'web';
+export type RuntimeProviderModuleKind = 'runtime' | 'reactivity' | 'template';
+export type RuntimeProviderVariant = 'development' | 'production';
+export type RuntimeProviderInjectionMode = 'none' | 'virtual-module';
+export type RuntimeProviderHmrMode = 'none' | 'host-reload' | 'module-accept';
+/**
+ * 运行时 provider 的开发与生产入口。
+ */
+export interface RuntimeProviderEntry {
+  development: string;
+  production: string;
+}
+/**
+ * 运行时 provider 的声明式能力。
+ */
+export interface RuntimeProviderCapabilities {
+  framework: boolean;
+  hmr: boolean;
+  nativeHost: boolean;
+  webHost: boolean;
+}
+/**
+ * 运行时 provider 的 HMR 契约。
+ */
+export interface RuntimeProviderHmrDescriptor {
+  mode: RuntimeProviderHmrMode;
+  acceptCode?: string;
+}
+/**
+ * 跨包共享的运行时 provider 描述契约。
+ */
+export interface RuntimeProviderDescriptorContract {
+  id: string;
+  backend: RuntimeProviderBackend;
+  compilation: RuntimeProviderCompilation;
+  injection: RuntimeProviderInjectionMode;
+  entries: Readonly<Partial<Record<RuntimeProviderModuleKind, RuntimeProviderEntry>>>;
+  capabilities: Readonly<RuntimeProviderCapabilities>;
+  hmr: Readonly<RuntimeProviderHmrDescriptor>;
+  contractVersion: number;
+}
+//#endregion

package/dist/wxml.d.ts

@@ -0,0 +1,10 @@
+//#region src/wxml.d.ts
+/**
+ * @description 按 exparser 与 glass-easel 的共同规则序列化 WXML 静态文本。
+ */
+export declare function escapeWxmlText(value: string): string;
+/**
+ * @description 按 exparser 与 glass-easel 的共同规则序列化双引号 WXML 属性值。
+ */
+export declare function escapeWxmlAttribute(value: string): string;
+//#endregion

package/dist/wxml.js

@@ -0,0 +1,26 @@
+//#region src/wxml.ts
+const WXML_TEXT_ESCAPE_RE = /[&<>]/g;
+const WXML_ATTRIBUTE_ESCAPE_RE = /[&"<]/g;
+const WXML_TEXT_ESCAPE_MAP = {
+	"&": "&amp;",
+	"<": "&lt;",
+	">": "&gt;"
+};
+const WXML_ATTRIBUTE_ESCAPE_MAP = {
+	...WXML_TEXT_ESCAPE_MAP,
+	"\"": "&quot;"
+};
+/**
+* @description 按 exparser 与 glass-easel 的共同规则序列化 WXML 静态文本。
+*/
+function escapeWxmlText(value) {
+	return value.replace(WXML_TEXT_ESCAPE_RE, (char) => WXML_TEXT_ESCAPE_MAP[char] ?? char);
+}
+/**
+* @description 按 exparser 与 glass-easel 的共同规则序列化双引号 WXML 属性值。
+*/
+function escapeWxmlAttribute(value) {
+	return value.replace(WXML_ATTRIBUTE_ESCAPE_RE, (char) => WXML_ATTRIBUTE_ESCAPE_MAP[char] ?? char);
+}
+//#endregion
+export { escapeWxmlAttribute, escapeWxmlText };