@mearl/client 2.20.4 → 2.20.5

package/dist/check.d.ts

@@ -1,4 +1,5 @@
 import type { CloudConnectorInfo } from '@mearl/cloud-types';
+import { type NativeHostDiagnostic } from './nativeHost.js';
 import type { BrowserCapabilities, BrowserProviderIdentity, BrowserProviderOperation } from './generated-browser-action-protocol.js';
 import { type UnifiedClientOptions, type UnifiedInvokeOptions } from './unified.js';
 export interface UnifiedCheckVersions {
@@ -96,6 +97,7 @@ export interface UnifiedCheckDependencies {
     writeJson?: (json: string) => void;
     writeLine?: (line: string) => void;
     fetchLatestVersion?: (component: string) => Promise<string>;
+    inspectNativeHostInstallation?: () => NativeHostDiagnostic[];
 }
 export declare function parseReleaseVersion(value: unknown): number[] | null;
 export declare function isNewerRelease(latest: string, installed: string): boolean;

package/dist/check.js

@@ -1,3 +1,4 @@
+import { inspectNativeHostInstallation } from './nativeHost.js';
 import { UnifiedClient, normalizeBrowserSelector, } from './unified.js';
 const UPDATE_SOURCES = {
     client: 'https://registry.npmjs.org/@mearl%2Fclient/latest',
@@ -221,6 +222,12 @@ export async function runUnifiedCheck(options, dependencies = {}) {
         }
         const connected = (browserList?.browsers ?? []).filter(browser => browser.status === 'connected' &&
             (options.transport !== 'cdp' || browser.transport === 'cdp'));
+        if ((options.local || !options.serverUrl) &&
+            options.transport !== 'cdp' &&
+            !connected.some(browser => browser.transport === 'extension')) {
+            const diagnostics = (dependencies.inspectNativeHostInstallation ?? inspectNativeHostInstallation)();
+            environment.push(...diagnostics.map(item => ({ status: 'warning', ...item })));
+        }
         let targets = connected;
         if (options.browser) {
             const matches = findBrowsers(connected, options.browser);

package/dist/commands.d.ts

@@ -1056,11 +1056,19 @@ export declare const COMMANDS: readonly [{
     }, {
         readonly name: "profile";
         readonly type: "string";
-        readonly description: `\u5BB9\u5668\u6863\u6848\u540D\uFF08enabled=true \u65F6\u5FC5\u586B\uFF09\uFF1A${string}`;
+        readonly description: `\u5BB9\u5668\u6863\u6848\u540D\uFF08enabled=true \u65F6\u5FC5\u586B\uFF09\uFF1B\u5185\u7F6E ${string}`;
     }, {
         readonly name: "os";
         readonly type: "\"ios\" | \"android\"";
         readonly description: "容器系统，默认 ios";
+    }, {
+        readonly name: "refreshDefinition";
+        readonly type: "boolean";
+        readonly description: "立即采用最新档案定义，保留用户显式设置";
+    }, {
+        readonly name: "lockDefinition";
+        readonly type: "boolean";
+        readonly description: "固定当前定义；默认在下次刷新或文档导航时自动更新";
     }, {
         readonly name: "appVersion";
         readonly type: "string";

package/dist/commands.js

@@ -1153,9 +1153,19 @@ export const COMMANDS = [
             {
                 name: 'profile',
                 type: 'string',
-                description: `容器档案名（enabled=true 时必填）：${APP_PROFILE_NAME_LIST}`,
+                description: `容器档案名（enabled=true 时必填）；内置 ${APP_PROFILE_NAME_LIST}`,
             },
             { name: 'os', type: '"ios" | "android"', description: '容器系统，默认 ios' },
+            {
+                name: 'refreshDefinition',
+                type: 'boolean',
+                description: '立即采用最新档案定义，保留用户显式设置',
+            },
+            {
+                name: 'lockDefinition',
+                type: 'boolean',
+                description: '固定当前定义；默认在下次刷新或文档导航时自动更新',
+            },
             { name: 'appVersion', type: 'string', description: '覆盖档案默认 App 版本号' },
             {
                 name: 'deviceModel',

package/dist/generated-app-profile-definition.d.ts

@@ -0,0 +1,130 @@
+import type { BrowserDevicePresetName, AppBridgeConfig } from './generated-browser-action-protocol.js';
+import type { AppBridgeSpec, AppImagePickerConfig, AppLayerUrlProxyConfig, AppMiniProgramConfig, AppNativeBackConfig, AppOverlayConfig, AppSchemeRule, AppTitleBarHostStyle, BridgeActionMap } from './generated-app-profile-runtime-types.js';
+export interface AppProfilePolicies {
+    titleBar?: 'default' | 'taobao' | 'fliggy' | 'alipay' | 'wechat';
+    navigatorLanguage?: boolean;
+    networkResult?: 'default' | 'alipay';
+    languages?: string[];
+    defaultLanguage?: string;
+}
+export interface AppProfileSetting {
+    id: string;
+    label: string;
+    type: 'select' | 'boolean' | 'number' | 'text' | 'json';
+    target: {
+        option: 'language';
+    } | {
+        method: string;
+        field?: string;
+    };
+    choices?: Array<{
+        label: string;
+        value: string;
+    }>;
+    minimum?: number;
+    maximum?: number;
+}
+export interface AppProfileOptions {
+    /** Keep this definition across document navigations until explicitly refreshed. */
+    lockDefinition?: boolean;
+    os?: 'ios' | 'android';
+    appVersion?: string;
+    language?: string;
+    deviceModel?: string;
+    devicePreset?: BrowserDevicePresetName;
+    orientation?: 'portrait' | 'landscape';
+    bridgeConfig?: AppBridgeConfig;
+}
+export interface AppProfileBinding {
+    version: 1;
+    revision: string;
+    definition: AppProfileDefinition;
+    options: AppProfileOptions;
+    /** Explicit scalar choices; method overrides are always explicit and live in options.bridgeConfig. */
+    explicitOptions?: Omit<AppProfileOptions, 'bridgeConfig'>;
+}
+export interface AppProfileContribution {
+    version: 1;
+    profiles: AppProfileDefinition[];
+}
+export interface AppProfileCatalogEntry {
+    id: string;
+    label: string;
+    source: 'builtin' | 'plugin';
+    available?: boolean;
+    plugin?: string;
+    revision: string;
+    definition: AppProfileDefinition;
+}
+/** 单容器档案（纯数据） */
+export interface AppProfileDefinition {
+    name: string;
+    label: string;
+    /** 容器的应用标识，如 LX / TB / AP / WeChat */
+    appName: string;
+    defaultAppVersion: string;
+    /** UA 主体格式；默认使用 AliApp(appName/version) */
+    uaFamily?: 'aliapp' | 'wechatMiniProgram';
+    uaTemplate?: {
+        ios: string;
+        android: string;
+    };
+    policies?: AppProfilePolicies;
+    settings?: AppProfileSetting[];
+    settingsGroup?: 'fliggy' | 'alipay';
+    /** AliApp UA 主体之后追加的 token，{v} 占位会被替换为 appVersion */
+    uaTokens: string[];
+    /** 额外注入到 window 的变量（公共变量由 resolve 统一生成） */
+    globals: Record<string, string>;
+    bridges: AppBridgeSpec[];
+    /** 页面回到前台时分发到 document 的事件名（如 WV.Event.APP.Active） */
+    activeEvents: string[];
+    actions: BridgeActionMap;
+    schemes: AppSchemeRule[];
+    /** 小程序原生页面与 WebView 通信规则。 */
+    miniProgram?: AppMiniProgramConfig;
+    /** 原生图片页 scheme 的浏览器选图与上传配置 */
+    imagePicker?: AppImagePickerConfig;
+    geolocation?: {
+        reverseGeocodeApi: string;
+        version: string;
+    };
+    /**
+     * 地址栏借位同步的可选 host 白名单：容器栈顶 URL 的 host 命中时，地址栏借 top
+     * 域名同步其 path+query+hash（pushState 同源约束下保持域名不变只改 path）；
+     * 不配置则同步所有 HTTP(S) 业务层 URL。
+     */
+    urlSyncHostSuffixes?: string[];
+    /** URL / pageParams 浮层协议 */
+    overlay?: AppOverlayConfig;
+    /** URL 参数为真时以新 WebView 替换当前业务层。 */
+    popBeforeOpenParam?: string;
+    /** 跨 WebView 消息抵达 opener 时分发的 document 事件。 */
+    messageEvent?: string;
+    /** 原生返回键的页面接管协议。 */
+    nativeBack?: AppNativeBackConfig;
+    /** 开发代理 origin 下的业务层 URL 映射 */
+    layerUrlProxy?: AppLayerUrlProxyConfig;
+    /** App 框架的根 WebView 与自绘标题栏协议。 */
+    rootContainer?: {
+        statusBarHeightCookie?: {
+            name: string;
+            domain?: string;
+            path?: string;
+        };
+    };
+    /** 页面自行绘制导航区域时，不渲染模拟标题栏。 */
+    titleBarHiddenPathnames?: string[];
+    /** 页面级状态栏背景色，key 为业务 pathname。 */
+    statusBarBackgroundColors?: Record<string, string>;
+    /** 按业务根域配置标题栏与状态栏样式。 */
+    titleBarHostStyles?: AppTitleBarHostStyle[];
+    /** 桥存在时仍将 MTOP 传输固定在浏览器 H5 通道 */
+    forceH5Mtop?: boolean;
+}
+export declare const APP_BRIDGE_BEHAVIORS: readonly ["navigate", "closeAll", "closeBackData", "postMessage", "notifySubscribe", "notifyUnsubscribe", "notifyPost", "sharedFileRead", "sharedFileWrite", "sharedDataGet", "sharedDataSet", "legacyBroadcastCreate", "legacyBroadcastPost", "legacyBroadcastClose", "memoryGet", "memorySet", "memoryDelete", "availabilityMap", "userInfo", "authCode", "networkInfo", "geolocation", "permission", "imagePicker", "prefetch", "fptTrack", "mtopStream", "previewFile", "toast", "unsupportedNativeInput", "payment", "userTrack", "calendar", "networkQualityMonitor", "beaconRequest", "voiceRecognition"];
+/** Validate plain data before registration or compiling a document-start configuration. */
+export declare function validateAppProfileDefinition(value: unknown): AppProfileDefinition;
+export declare function validateAppProfileContribution(value: unknown): AppProfileContribution | undefined;
+/** Deterministic identity for immutable definitions; this identifier grants no host permissions. */
+export declare function appProfileRevision(definition: AppProfileDefinition): string;

package/dist/generated-app-profile-definition.js

@@ -0,0 +1,448 @@
+const BRIDGE_STYLES = new Set([
+    'windvane',
+    'fliggy',
+    'alipay',
+    'callback',
+    'btrip',
+    'invoke',
+    'callHandler',
+    'amap',
+    'didi',
+    'easybikeNative',
+    'mega',
+    'wechat',
+    'wechatMiniProgram',
+]);
+export const APP_BRIDGE_BEHAVIORS = [
+    'navigate',
+    'closeAll',
+    'closeBackData',
+    'postMessage',
+    'notifySubscribe',
+    'notifyUnsubscribe',
+    'notifyPost',
+    'sharedFileRead',
+    'sharedFileWrite',
+    'sharedDataGet',
+    'sharedDataSet',
+    'legacyBroadcastCreate',
+    'legacyBroadcastPost',
+    'legacyBroadcastClose',
+    'memoryGet',
+    'memorySet',
+    'memoryDelete',
+    'availabilityMap',
+    'userInfo',
+    'authCode',
+    'networkInfo',
+    'geolocation',
+    'permission',
+    'imagePicker',
+    'prefetch',
+    'fptTrack',
+    'mtopStream',
+    'previewFile',
+    'toast',
+    'unsupportedNativeInput',
+    'payment',
+    'userTrack',
+    'calendar',
+    'networkQualityMonitor',
+    'beaconRequest',
+    'voiceRecognition',
+];
+const BEHAVIORS = new Set(APP_BRIDGE_BEHAVIORS);
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function invalid(path) {
+    throw new Error(`Invalid app profile: ${path}`);
+}
+function text(value) {
+    return (typeof value === 'string' &&
+        value.length <= 4096 &&
+        Array.from(value).every(character => character.charCodeAt(0) > 8));
+}
+function strings(value) {
+    return Array.isArray(value) && value.length <= 200 && value.every(text);
+}
+function fields(value, required, optional, path) {
+    if (!record(value) ||
+        required.some(key => !Object.hasOwn(value, key)) ||
+        Object.keys(value).some(key => !required.includes(key) && !optional.includes(key)))
+        invalid(path);
+}
+function stringMap(value) {
+    return record(value) && Object.keys(value).length <= 200 && Object.values(value).every(text);
+}
+function json(value, depth = 0) {
+    if (depth > 25)
+        return false;
+    if (value === null || typeof value === 'boolean' || text(value))
+        return true;
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.length <= 1000 && value.every(item => json(item, depth + 1));
+    return (record(value) &&
+        Object.entries(value).every(([key, item]) => !['__proto__', 'prototype', 'constructor'].includes(key) && json(item, depth + 1)));
+}
+function validateActions(value) {
+    const arrays = [
+        'open',
+        'close',
+        'title',
+        'navigationBar',
+        'statusBar',
+        'systemInfo',
+        'mtop',
+        'kvGet',
+        'kvSet',
+        'kvDelete',
+        'pageContext',
+        'noop',
+        'silent',
+    ];
+    fields(value, ['open', 'close', 'title', 'systemInfo', 'mtop', 'noop'], [...arrays, 'responses', 'behaviors'], 'actions');
+    for (const key of arrays)
+        if (value[key] !== undefined && !strings(value[key]))
+            invalid(`actions.${key}`);
+    if (value.responses !== undefined && !record(value.responses))
+        invalid('actions.responses');
+    if (value.behaviors !== undefined &&
+        (!stringMap(value.behaviors) ||
+            !Object.values(value.behaviors).every(item => BEHAVIORS.has(item))))
+        invalid('actions.behaviors');
+}
+/** Validate plain data before registration or compiling a document-start configuration. */
+export function validateAppProfileDefinition(value) {
+    if (!json(value))
+        invalid('JSON');
+    if (JSON.stringify(value).length > 65_536)
+        invalid('definition exceeds 64 KiB');
+    const required = [
+        'name',
+        'label',
+        'appName',
+        'defaultAppVersion',
+        'uaTokens',
+        'globals',
+        'bridges',
+        'activeEvents',
+        'actions',
+        'schemes',
+    ];
+    const optional = [
+        'uaFamily',
+        'uaTemplate',
+        'policies',
+        'settings',
+        'settingsGroup',
+        'miniProgram',
+        'imagePicker',
+        'geolocation',
+        'urlSyncHostSuffixes',
+        'overlay',
+        'popBeforeOpenParam',
+        'messageEvent',
+        'nativeBack',
+        'layerUrlProxy',
+        'rootContainer',
+        'titleBarHiddenPathnames',
+        'statusBarBackgroundColors',
+        'titleBarHostStyles',
+        'forceH5Mtop',
+    ];
+    fields(value, required, optional, 'definition');
+    for (const key of ['name', 'label', 'appName', 'defaultAppVersion'])
+        if (!text(value[key]) || !value[key])
+            invalid(key);
+    if (!/^[a-z][a-z0-9-]*(?:\/[a-z][a-z0-9-]*)?$/.test(value.name))
+        invalid('name');
+    for (const key of [
+        'uaTokens',
+        'activeEvents',
+        'urlSyncHostSuffixes',
+        'titleBarHiddenPathnames',
+    ]) {
+        if (value[key] !== undefined && !strings(value[key]))
+            invalid(key);
+    }
+    if (!stringMap(value.globals))
+        invalid('globals');
+    if (!Array.isArray(value.bridges) || value.bridges.length > 20)
+        invalid('bridges');
+    const globals = new Set();
+    for (const bridge of value.bridges) {
+        fields(bridge, ['global', 'style'], ['persistent'], 'bridges');
+        if (!text(bridge.global) ||
+            !/^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*$/.test(bridge.global) ||
+            bridge.global
+                .split('.')
+                .some(part => ['__proto__', 'prototype', 'constructor'].includes(part)) ||
+            globals.has(bridge.global) ||
+            !BRIDGE_STYLES.has(bridge.style) ||
+            (bridge.persistent !== undefined && typeof bridge.persistent !== 'boolean'))
+            invalid('bridge');
+        globals.add(bridge.global);
+    }
+    validateActions(value.actions);
+    if (value.settingsGroup !== undefined &&
+        !['fliggy', 'alipay'].includes(value.settingsGroup))
+        invalid('settingsGroup');
+    if (value.uaFamily !== undefined &&
+        !['aliapp', 'wechatMiniProgram'].includes(value.uaFamily))
+        invalid('uaFamily');
+    if (value.uaTemplate !== undefined) {
+        fields(value.uaTemplate, ['ios', 'android'], [], 'uaTemplate');
+        if (!text(value.uaTemplate.ios) || !text(value.uaTemplate.android))
+            invalid('uaTemplate');
+    }
+    if (value.policies !== undefined) {
+        fields(value.policies, [], ['titleBar', 'navigatorLanguage', 'networkResult', 'languages', 'defaultLanguage'], 'policies');
+        const p = value.policies;
+        if (p.titleBar !== undefined &&
+            !['default', 'taobao', 'fliggy', 'alipay', 'wechat'].includes(p.titleBar))
+            invalid('policies.titleBar');
+        if (p.networkResult !== undefined && !['default', 'alipay'].includes(p.networkResult))
+            invalid('policies.networkResult');
+        if (p.navigatorLanguage !== undefined && typeof p.navigatorLanguage !== 'boolean')
+            invalid('policies.navigatorLanguage');
+        if (p.languages !== undefined && (!strings(p.languages) || !p.languages.length))
+            invalid('policies.languages');
+        if (p.defaultLanguage !== undefined &&
+            (!text(p.defaultLanguage) ||
+                (p.languages && !p.languages.includes(p.defaultLanguage))))
+            invalid('policies.defaultLanguage');
+    }
+    if (!Array.isArray(value.schemes) || value.schemes.length > 100)
+        invalid('schemes');
+    for (const rule of value.schemes) {
+        fields(rule, ['match'], [
+            'hostSuffixes',
+            'param',
+            'useCurrentOrigin',
+            'targetPath',
+            'targetHostPrefix',
+            'targetParams',
+        ], 'scheme');
+        for (const key of ['match', 'param', 'targetPath', 'targetHostPrefix'])
+            if (rule[key] !== undefined && !text(rule[key]))
+                invalid(`scheme.${key}`);
+        if (rule.hostSuffixes !== undefined && !strings(rule.hostSuffixes))
+            invalid('scheme.hostSuffixes');
+        if (rule.useCurrentOrigin !== undefined && typeof rule.useCurrentOrigin !== 'boolean')
+            invalid('scheme.useCurrentOrigin');
+        if (rule.targetParams !== undefined && !stringMap(rule.targetParams))
+            invalid('scheme.targetParams');
+    }
+    if (value.settings !== undefined) {
+        if (!Array.isArray(value.settings) || value.settings.length > 30)
+            invalid('settings');
+        const ids = new Set();
+        for (const setting of value.settings) {
+            fields(setting, ['id', 'label', 'type', 'target'], ['choices', 'minimum', 'maximum'], 'setting');
+            if (!text(setting.id) ||
+                !/^[a-z][a-zA-Z0-9-]*$/.test(setting.id) ||
+                ids.has(setting.id) ||
+                !text(setting.label) ||
+                !['select', 'boolean', 'number', 'text', 'json'].includes(setting.type))
+                invalid('setting');
+            ids.add(setting.id);
+            if (record(setting.target) && setting.target.option !== undefined) {
+                fields(setting.target, ['option'], [], 'setting.target');
+                if (setting.target.option !== 'language')
+                    invalid('setting.target.option');
+            }
+            else {
+                fields(setting.target, ['method'], ['field'], 'setting.target');
+                if (!text(setting.target.method) ||
+                    !setting.target.method ||
+                    ['__proto__', 'prototype', 'constructor'].includes(setting.target.method) ||
+                    (setting.target.field !== undefined &&
+                        (!text(setting.target.field) ||
+                            ['__proto__', 'prototype', 'constructor'].includes(setting.target.field))))
+                    invalid('setting.target.method');
+                const method = setting.target.method;
+                if ([
+                    'open',
+                    'close',
+                    'title',
+                    'navigationBar',
+                    'statusBar',
+                    'systemInfo',
+                    'mtop',
+                    'kvGet',
+                    'kvSet',
+                    'kvDelete',
+                    'pageContext',
+                ].some(key => value.actions[key]?.includes(method)))
+                    invalid('setting targets a structural method');
+            }
+            if (setting.choices !== undefined &&
+                (!Array.isArray(setting.choices) ||
+                    !setting.choices.length ||
+                    setting.choices.some(choice => !record(choice) || !text(choice.label) || !text(choice.value))))
+                invalid('setting.choices');
+            for (const key of ['minimum', 'maximum'])
+                if (setting[key] !== undefined && typeof setting[key] !== 'number')
+                    invalid(`setting.${key}`);
+            if (setting.type === 'select' && !Array.isArray(setting.choices))
+                invalid('setting.choices required');
+            if (setting.minimum !== undefined &&
+                setting.maximum !== undefined &&
+                setting.minimum > setting.maximum)
+                invalid('setting range');
+            if ('option' in setting.target && !['select', 'text'].includes(setting.type))
+                invalid('setting.option type');
+        }
+    }
+    for (const key of ['forceH5Mtop'])
+        if (value[key] !== undefined && typeof value[key] !== 'boolean')
+            invalid(key);
+    for (const key of ['popBeforeOpenParam', 'messageEvent'])
+        if (value[key] !== undefined && !text(value[key]))
+            invalid(key);
+    if (value.statusBarBackgroundColors !== undefined && !stringMap(value.statusBarBackgroundColors))
+        invalid('statusBarBackgroundColors');
+    validateStructuredOptions(value);
+    return JSON.parse(JSON.stringify(value));
+}
+function validateStructuredOptions(value) {
+    const shapes = {
+        nativeBack: [[], ['event', 'controlFunction', 'handler']],
+        geolocation: [['reverseGeocodeApi', 'version'], []],
+        layerUrlProxy: [
+            ['sourceHostPrefix', 'pathPrefix', 'targetHostSuffixes'],
+            ['defaultTargetHost'],
+        ],
+        imagePicker: [
+            ['schemes', 'api', 'version', 'fcId', 'fcGroup', 'uploadUrlFunction', 'prefix', 'region'],
+            [],
+        ],
+        overlay: [
+            [
+                'enabledParam',
+                'topRatioParam',
+                'radiusParam',
+                'maskAlphaParam',
+                'tapCloseParam',
+                'defaultTopRatio',
+                'defaultRadius',
+                'defaultMaskAlpha',
+                'defaultTapClose',
+            ],
+            ['heightRatioParam', 'tapCloseSelectors', 'silentTapClose'],
+        ],
+    };
+    for (const [key, [required, optional]] of Object.entries(shapes)) {
+        if (value[key] === undefined)
+            continue;
+        fields(value[key], required, optional, key);
+        for (const [field, item] of Object.entries(value[key])) {
+            const valid = field.startsWith('default') && field !== 'defaultTargetHost'
+                ? field === 'defaultTapClose'
+                    ? typeof item === 'boolean'
+                    : typeof item === 'number'
+                : field === 'silentTapClose'
+                    ? typeof item === 'boolean'
+                    : ['schemes', 'targetHostSuffixes', 'tapCloseSelectors'].includes(field)
+                        ? strings(item)
+                        : text(item);
+            if (!valid)
+                invalid(`${key}.${field}`);
+        }
+    }
+    if (value.rootContainer !== undefined) {
+        fields(value.rootContainer, [], ['statusBarHeightCookie'], 'rootContainer');
+        if (value.rootContainer.statusBarHeightCookie !== undefined) {
+            fields(value.rootContainer.statusBarHeightCookie, ['name'], ['domain', 'path'], 'rootContainer.statusBarHeightCookie');
+            if (!Object.values(value.rootContainer.statusBarHeightCookie).every(text))
+                invalid('rootContainer.statusBarHeightCookie');
+        }
+    }
+    if (value.titleBarHostStyles !== undefined &&
+        (!Array.isArray(value.titleBarHostStyles) ||
+            value.titleBarHostStyles.some(rule => {
+                fields(rule, ['hostSuffix'], ['titleBarBackgroundColor', 'statusBarBackgroundColor'], 'titleBarHostStyle');
+                return !Object.values(rule).every(text);
+            })))
+        invalid('titleBarHostStyles');
+    if (value.miniProgram !== undefined) {
+        fields(value.miniProgram, [], ['paymentRoutes', 'nativeRoutes', 'messageRules'], 'miniProgram');
+        const shapes = {
+            paymentRoutes: [
+                ['pathname', 'paymentParamsParam', 'successUrlParams', 'failureUrlParams'],
+                ['hostSuffixes', 'successResultParam', 'forwardParams', 'useCurrentOrigin'],
+            ],
+            nativeRoutes: [['pathname', 'actions'], ['hostSuffixes']],
+            messageRules: [['type', 'action'], ['hostSuffixes']],
+        };
+        for (const [key, list] of Object.entries(value.miniProgram)) {
+            if (!Array.isArray(list) || list.length > 100)
+                invalid(`miniProgram.${key}`);
+            for (const rule of list) {
+                fields(rule, ...shapes[key], `miniProgram.${key}`);
+                for (const [field, item] of Object.entries(rule)) {
+                    if ([
+                        'hostSuffixes',
+                        'successUrlParams',
+                        'failureUrlParams',
+                        'forwardParams',
+                        'actions',
+                    ].includes(field)
+                        ? !strings(item)
+                        : field === 'useCurrentOrigin'
+                            ? typeof item !== 'boolean'
+                            : !text(item))
+                        invalid(`miniProgram.${key}.${field}`);
+                }
+                if (key === 'messageRules' &&
+                    !['stageBackData', 'closeAll'].includes(rule.action))
+                    invalid('miniProgram.messageRules.action');
+                if (key === 'nativeRoutes' &&
+                    !rule.actions.every(action => ['navigateMiniProgram', 'subscribeMessage'].includes(action)))
+                    invalid('miniProgram.nativeRoutes.actions');
+            }
+        }
+    }
+}
+export function validateAppProfileContribution(value) {
+    if (value === undefined)
+        return undefined;
+    fields(value, ['version', 'profiles'], [], 'contribution');
+    if (value.version !== 1 ||
+        !Array.isArray(value.profiles) ||
+        !value.profiles.length ||
+        value.profiles.length > 20)
+        invalid('contribution');
+    const profiles = value.profiles.map(validateAppProfileDefinition);
+    if (JSON.stringify(profiles).length > 256_000)
+        invalid('contribution exceeds 256 KiB');
+    if (profiles.some(profile => profile.name.includes('/')))
+        invalid('contribution names must be local identifiers');
+    if (new Set(profiles.map(profile => profile.name)).size !== profiles.length)
+        invalid('duplicate profile name');
+    return { version: 1, profiles };
+}
+/** Deterministic identity for immutable definitions; this identifier grants no host permissions. */
+export function appProfileRevision(definition) {
+    const canonical = (value) => {
+        if (Array.isArray(value))
+            return `[${value.map(canonical).join(',')}]`;
+        if (record(value))
+            return `{${Object.keys(value)
+                .sort()
+                .map(key => `${JSON.stringify(key)}:${canonical(value[key])}`)
+                .join(',')}}`;
+        return JSON.stringify(value);
+    };
+    const source = canonical(definition);
+    let left = 2166136261;
+    let right = 5381;
+    for (let i = 0; i < source.length; i++) {
+        left = Math.imul(left ^ source.charCodeAt(i), 16777619);
+        right = Math.imul(right, 33) ^ source.charCodeAt(i);
+    }
+    return `v1-${(left >>> 0).toString(16).padStart(8, '0')}${(right >>> 0).toString(16).padStart(8, '0')}`;
+}