@alipay/ams-checkout 0.0.1788166152-dev.0 → 0.0.1788166152-dev.2

package/esm/modern/modern/sdk/types.d.ts

@@ -1,8 +1,9 @@
 import { AntomError } from '@antintl/antom-toolset';
 import type { BaseElements, BaseFactoryConfig, BaseMainElement } from '@antintl/opensdk-core';
 import type { CVVAppearance } from './elements/CVVElement';
-import type { OpenModalParams } from './tools/openModal';
 import type { PaymentSubmitParams } from './elements/PaymentElement';
+import type { OpenModalParams } from './tools/openModal';
+export type { AppearanceLayoutDeclarations, AppearanceLayoutProperty, AppearancePaintProperty, AppearanceRuleScopeSuffix, AppearanceRuleSelector, AppearanceSpacingToken, AppearanceSpacingValue, } from './elements/appearanceRules';
 export type * from './eventsMap';
 export type AntomPreloadElement = 'payment' | 'express' | 'vaulting' | 'CVV';
 export interface AntomPreloadConfig {
@@ -49,18 +50,22 @@ export interface ConfirmCardSetupOptions {
     elements: BaseMainElement | BaseElements;
     redirect?: 'always' | 'if_required';
 }
-export interface ConfirmPaymentOptions extends Omit<ConfirmCardSetupOptions, 'elements'>, PaymentSubmitParams {
-    sessionData: string;
-    /**
-     * @description 传入已挂载的 CVVElement / PaymentElement / Elements 实例，不传则使用无 UI 自动提交模式
-     */
-    elements?: BaseMainElement | BaseElements;
+export type ConfirmPaymentOptions = PaymentSubmitParams & {
     appearance?: CVVAppearance;
     /**
      * @description 集成用户自定义信息（如 cardHolderName）
      */
     params?: Record<string, unknown>;
-}
+} & ({
+    /** 已挂载的 Element；确认时使用其创建时绑定的会话。 */
+    elements: BaseMainElement | BaseElements;
+    /** @deprecated 传入 elements 时无需重复传递，且不会覆盖 Element 的会话。 */
+    sessionData?: string;
+} | {
+    elements?: undefined;
+    /** 无 UI 模式必填，仅用于创建内部 CVVElement。 */
+    sessionData: string;
+});
 export type { ToastParams } from './tools/showToast';
 /**
  * modal打开参数类型
@@ -163,9 +168,29 @@ export declare const AntomSDKErrorCodes: {
      */
     readonly AMOUNT_VALUE_EMPTY: "AMOUNT_VALUE_EMPTY";
     /**
-     * @description 金额格式非法（仅允许整数和小数）
+     * @description 金额格式非法（仅允许 ASCII 数字字符串）
      */
     readonly AMOUNT_VALUE_INVALID: "AMOUNT_VALUE_INVALID";
+    /**
+     * @description Amount currency does not match the payment session currency
+     */
+    readonly AMOUNT_CURRENCY_MISMATCH: "AMOUNT_CURRENCY_MISMATCH";
+    /**
+     * @description Amount currency is not supported
+     */
+    readonly AMOUNT_CURRENCY_UNSUPPORTED: "AMOUNT_CURRENCY_UNSUPPORTED";
+    /**
+     * @description Amount currency precision is not supported
+     */
+    readonly AMOUNT_PRECISION_UNSUPPORTED: "AMOUNT_PRECISION_UNSUPPORTED";
+    /**
+     * @description Amount conversion timed out
+     */
+    readonly AMOUNT_RESOLVE_TIMEOUT: "AMOUNT_RESOLVE_TIMEOUT";
+    /**
+     * @description Amount conversion failed
+     */
+    readonly AMOUNT_RESOLVE_FAILED: "AMOUNT_RESOLVE_FAILED";
     readonly GENERATE_ELEMENT_KEY_FAILED: "GENERATE_ELEMENT_KEY_FAILED";
     readonly ELEMENT_INIT_FAILED: "ELEMENT_INIT_FAILED";
     readonly MOUNT_TIMEOUT: "MOUNT_TIMEOUT";
@@ -211,4 +236,74 @@ export declare const themeColorMap: Record<AntomTheme, {
     backgroundColor: string;
 }>;
 export type AntomLayouts = 'tabs' | 'accordion';
-export type AntomVariables = 'content-primary' | 'content-secondary' | 'content-tertiary' | 'content-quaternary' | 'background-primary' | 'background-secondary' | 'background-disable' | 'background-transparency' | 'border-primary' | 'border-secondary' | 'border-disable' | 'action-normal' | 'action-hover' | 'action-disable' | 'action-secondary' | 'state-failure' | 'state-warning' | 'state-success' | 'state-info' | 'state-marketing' | 'state-conventional' | 'radius-backup' | 'radius-module' | 'radius-component' | 'radius-button' | 'wrapper-padding' | 'stroke-default' | 'stroke-active' | 'fontFamily';
+/**
+ * 对客公开 appearance variables 类型（Token 2.x，figma-v4「3 层 + 状态」命名）。
+ * 字段名为新 CSS 变量名去掉 '--' 前缀（如 color-text-primary）。
+ *
+ * 权威源：`antom-web-checkout-v2/packages/elements2/src/utils/themeConfig.ts` 的 `PUBLIC_TOKENS`
+ * （54 color + 4 radius + 10 spacing = 68 项）。本 union 是该清单的手工镜像，
+ * 增删 token 时必须两侧同步，否则商户会遇到「类型报错但运行时可用」的错位。
+ *
+ * 命名规则：`--color-<scene>-<level>[-<state>]`；brand 场景并入 scene 段的 camelCase
+ * （如 `color-backgroundBrand-primary-hover`），CSS 变量大小写敏感，不可改写为 kebab。
+ *
+ * @example
+ *   variables: { 'color-text-primary': '#2a3a52', 'radius-sm': '4px' }
+ */
+export type AppearanceVariables = 'color-background-primary' | 'color-background-primary-hover' | 'color-background-primary-active' | 'color-background-secondary' | 'color-background-secondary-hover' | 'color-background-secondary-active' | 'color-background-layout' | 'color-background-inverse' | 'color-background-disabled' | 'color-background-transparency' | 'color-background-mask' | 'color-background-success' | 'color-background-warning' | 'color-background-danger' | 'color-background-info' | 'color-background-neutral' | 'color-background-promotional' | 'color-backgroundBrand-primary' | 'color-backgroundBrand-primary-hover' | 'color-backgroundBrand-secondary' | 'color-backgroundBrand-secondary-hover' | 'color-backgroundBrand-tertiary' | 'color-backgroundBrand-disabled' | 'color-text-primary' | 'color-text-secondary' | 'color-text-tertiary' | 'color-text-inverse' | 'color-text-active' | 'color-text-disabled' | 'color-text-success' | 'color-text-warning' | 'color-text-danger' | 'color-text-info' | 'color-text-neutral' | 'color-text-promotional' | 'color-textBrand-primary' | 'color-textBrand-secondary' | 'color-textBrand-secondary-hover' | 'color-textBrand-disabled' | 'color-border-primary' | 'color-border-secondary' | 'color-border-inverse' | 'color-border-active' | 'color-border-subtle' | 'color-border-disabled' | 'color-border-success' | 'color-border-warning' | 'color-border-danger' | 'color-border-info' | 'color-border-neutral' | 'color-border-promotional' | 'color-borderBrand-primary' | 'color-borderBrand-primary-hover' | 'color-borderBrand-disabled' | 'radius-sm' | 'radius-md' | 'radius-lg' | 'radius-xl' | 'spacing-base' | 'spacing-none' | 'spacing-2xs' | 'spacing-xs' | 'spacing-sm' | 'spacing-md' | 'spacing-lg' | 'spacing-xl' | 'spacing-2xl' | 'spacing-3xl';
+/**
+ * @deprecated Token 1.0 老字段类型 — 请迁移到 {@link AppearanceVariables}。
+ * 所有字段均已废弃，运行时由 WebApp 侧 LEGACY_TO_NEW_TOKEN_MAP 翻译为新 token。
+ *
+ * @deprecated 'content-primary'        → color-text-primary
+ * @deprecated 'content-secondary'      → color-text-secondary
+ * @deprecated 'content-tertiary'       → color-text-tertiary
+ * @deprecated 'content-quaternary'     → color-text-inverse
+ * @deprecated 'background-primary'     → color-background-primary
+ * @deprecated 'background-secondary'   → color-background-secondary
+ * @deprecated 'background-disable'     → color-background-disabled
+ * @deprecated 'background-transparency' → color-background-transparency
+ * @deprecated 'border-primary'         → color-border-primary
+ * @deprecated 'border-secondary'       → color-border-secondary
+ * @deprecated 'border-disable'         → color-border-disabled
+ * @deprecated 'border-active'          → color-border-active
+ * @deprecated 'action-normal'          → 一对多 fan-out（无单值映射；运行时展开为 3 个新 token，老 key 不再注入）：
+ *                                        - background/background-color → color-backgroundBrand-primary
+ *                                        - border/border-color/box-shadow → color-border-active
+ *                                        - color/文本/图标/勾选态 → color-text-active
+ * @deprecated 'action-hover'           → 一对多 fan-out（运行时展开为 2 个新 token，老 key 不再注入）：
+ *                                        - background → color-backgroundBrand-primary-hover
+ *                                        - border     → color-borderBrand-primary-hover
+ *                                        文字色 color-textBrand-secondary-hover 不参与派生
+ *                                        （设计稿中与 bg/border 不同色阶），需要时请显式传入该新 token 键
+ * @deprecated 'action-secondary'       → color-backgroundBrand-secondary
+ * @deprecated 'action-disable'         → 一对多 fan-out（运行时展开为 2 个新 token，老 key 不再注入）：
+ *                                        - background/background-color → color-backgroundBrand-disabled
+ *                                        - border/border-color         → color-borderBrand-disabled
+ *                                        文字色 color-textBrand-disabled 不参与派生
+ *                                        （设计稿中全部主题均与 bg/border 不同色阶），需要时请显式传入该新 token 键
+ * @deprecated 'state-success'          → color-text-success
+ * @deprecated 'state-failure'          → color-text-danger
+ * @deprecated 'state-warning'          → color-text-warning
+ * @deprecated 'state-info'             → color-text-info
+ * @deprecated 'state-conventional'     → color-text-neutral
+ * @deprecated 'state-marketing'        → color-text-promotional（color 上下文；background 上下文由 CSS 层直接迁移）
+ * @deprecated 'radius-backup'          → radius-sm
+ * @deprecated 'radius-component'       → radius-md
+ * @deprecated 'radius-module'          → radius-lg
+ * @deprecated 'radius-button'          → radius-lg（与 radius-module 同档合并）
+ * @deprecated 'wrapper-padding'        → spacing-lg
+ * @deprecated 'stroke-default'         → 由 Rules 机制接管
+ * @deprecated 'stroke-active'          → 由 Rules 机制接管
+ *
+ * 注：fan-out 展开基数以 figma-v4 设计稿的色阶一致性为准，故 action-hover / action-disable
+ * 为 1→2 而非 1→3；三者合计派生 7 项。
+ */
+export type LegacyAppearanceVariables = 'content-primary' | 'content-secondary' | 'content-tertiary' | 'content-quaternary' | 'background-primary' | 'background-secondary' | 'background-disable' | 'background-transparency' | 'border-primary' | 'border-secondary' | 'border-disable' | 'action-normal' | 'action-hover' | 'action-disable' | 'action-secondary' | 'state-failure' | 'state-warning' | 'state-success' | 'state-info' | 'state-marketing' | 'state-conventional' | 'radius-backup' | 'radius-module' | 'radius-component' | 'radius-button' | 'wrapper-padding' | 'stroke-default' | 'stroke-active'
+/** 非 Token 体系字段，由 WebApp 侧展开为 design-font-family-* 系列 */
+ | 'fontFamily';
+/**
+ * @deprecated Use {@link AppearanceVariables} (Token 2.0) instead.
+ * 保留仅为向后兼容，将在下一个 major 版本中删除。
+ */
+export type AntomVariables = LegacyAppearanceVariables;

package/esm/modern/modern/tools.d.ts

@@ -4,14 +4,15 @@
 export { buildPageUrl } from './sdk/tools/buildPageUrl';
 export { getDevReqConfig } from './sdk/tools/getDevReqConfig';
 export { getLocaleFromRenderData } from './sdk/tools/getLocaleFromRenderData';
-export { getMetaData, isElements2, adjustSessionData } from './sdk/tools/getMetaData';
+export { getModalMessageTrackData, installModalMessageMonitor } from './sdk/tools/modalMessageMonitor';
+export { getMetaData, isElements2, adjustSessionData, isModernWeb } from './sdk/tools/getMetaData';
 export { checkSessionData } from './sdk/tools/checkSessionData';
 export { openModal, type OpenModalParams } from './sdk/tools/openModal';
 export { showToast, type ToastParams } from './sdk/tools/showToast';
 export { awaitWrap } from './sdk/tools/awaitWrap';
 export { sdkQuery, oneAccountQuery } from './sdk/oneapi/iexpfront/PaymentSessionService';
+export type { AntomBridgeEventMap, SubmitResult, AntomTheme, AntomLayouts, AntomVariables, AppearanceVariables, LegacyAppearanceVariables } from './sdk/types';
 export { themeColorMap } from './sdk/types';
-export type { AntomBridgeEventMap, AntomLayouts, AntomTheme } from './sdk/types';
 export type { PaymentSubmitResult, PaymentAppearance, PaymentAppConfig } from './sdk/elements/PaymentElement';
 export type { CashierSdkActionQueryResult } from './sdk/oneapi/iexpfront/definitions';
 export type { ErrorPayload, BaseBridgeEventMap, BridgeMode } from '@antintl/opensdk-core';

package/esm/modern/preload/preloadAntomElements.d.ts

@@ -2,7 +2,7 @@ import type { AntomPreloadElement } from './config';
 export declare function preloadAntomElements(elements: readonly AntomPreloadElement[]): Promise<void>;
 export declare function getAntomPreloadTelemetry(element: AntomPreloadElement): {
     requested: boolean;
-    phaseAtElementCreate: "resolving" | "failed" | "critical_completed" | "skipped" | "not_requested" | "running";
+    phaseAtElementCreate: "running" | "failed" | "skipped" | "not_requested" | "resolving" | "critical_completed";
     leadTimeMs: number;
     criticalDurationMs: number;
     taskId: string;

package/esm/modern/preload/sgPreconnection.d.ts

@@ -23,7 +23,7 @@ export declare function getSgPreconnectionSnapshot(env?: 'sandbox' | 'prod'): {
     predictedRegion: "SG";
     actualRegion?: string;
     predictionResult?: "hit" | "miss";
-    status: "failed" | "completed" | "running";
+    status: "running" | "completed" | "failed";
     preconnectionStartTime: number;
     preconnectionEndTime?: number;
     firstRpcStartTime?: number;

package/esm/modern/preload/startAntomPreload.d.ts

@@ -0,0 +1,2 @@
+import type { AntomPreloadElement } from './config';
+export declare function startAntomPreload(env: 'sandbox' | 'prod', elements?: readonly AntomPreloadElement[]): void;

package/esm/modern/preload/startAntomPreload.js

@@ -0,0 +1,9 @@
+import { preloadAntomElements } from "./preloadAntomElements";
+import { startDefaultSgPreconnection } from "./sgPreconnection";
+export function startAntomPreload(env, elements) {
+  if (!(elements !== null && elements !== void 0 && elements.length)) return;
+  void startDefaultSgPreconnection(env);
+  void preloadAntomElements(elements).catch(function () {
+    return undefined;
+  });
+}

package/esm/modern/sdk/elements/appearanceRules.d.ts

@@ -0,0 +1,59 @@
+import type { PickAppearance } from '@antintl/opensdk-core';
+/** Semantic states accepted by the merchant selector grammar. */
+type AppearanceRuleState = 'hover' | 'focus' | 'focus-visible' | 'active' | 'disabled' | 'loading' | 'selected' | 'checked' | 'expanded' | 'invalid' | 'success' | 'error';
+/** Controlled pseudo-class accepted by the merchant selector grammar. */
+type AppearanceRulePseudoClass = 'autofill';
+/** Controlled pseudo-element accepted by the merchant selector grammar. */
+type AppearanceRulePseudoElement = 'placeholder' | 'selection';
+/**
+ * Optional state or controlled pseudo suffix on one alias.
+ */
+export type AppearanceRuleScopeSuffix = '' | `:${AppearanceRuleState | AppearanceRulePseudoClass}` | `::${AppearanceRulePseudoElement}`;
+/** One merchant alias with an optional semantic suffix. */
+export type AppearanceRuleSelector<RuleAlias extends string> = `${RuleAlias}${AppearanceRuleScopeSuffix}`;
+/** Paint-only property names exposed by the SDK contract. */
+export type AppearancePaintProperty = 'color' | 'WebkitTextFillColor' | 'textDecorationColor' | 'textDecorationLine' | 'textDecorationStyle' | 'textShadow' | 'backgroundColor' | 'borderColor' | 'borderTopColor' | 'borderRightColor' | 'borderBottomColor' | 'borderLeftColor' | 'borderRadius' | 'borderTopLeftRadius' | 'borderTopRightRadius' | 'borderBottomRightRadius' | 'borderBottomLeftRadius' | 'borderStyle' | 'boxShadow' | 'fill' | 'stroke' | 'fillOpacity' | 'strokeOpacity' | 'strokeWidth' | 'outlineColor' | 'outlineStyle' | 'outlineWidth' | 'outlineOffset' | 'caretColor' | 'accentColor';
+/** Controlled layout longhands intersected with the concrete Part at runtime. */
+export type AppearanceLayoutProperty = 'marginTop' | 'marginRight' | 'marginBottom' | 'marginLeft' | 'paddingTop' | 'paddingRight' | 'paddingBottom' | 'paddingLeft' | 'height';
+/** Exact official spacing Token accepted by controlled margin and padding. */
+export type AppearanceSpacingToken = `var(--spacing-${'base' | 'none' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl'})`;
+/** Runtime-constrained non-negative integer pixel value for spacing longhands. */
+export type AppearanceSpacingValue = '0' | `${number}px` | AppearanceSpacingToken;
+/** Paint declarations accepted before WebApp and Components runtime validation. */
+type AppearancePaintDeclarations = Partial<Record<Exclude<AppearancePaintProperty, 'fillOpacity' | 'strokeOpacity' | 'strokeWidth' | 'textDecorationStyle' | 'outlineStyle'>, string> & Record<'fillOpacity' | 'strokeOpacity' | 'strokeWidth', string | number> & {
+    textDecorationStyle: '-moz-initial' | 'inherit' | 'initial' | 'revert' | 'revert-layer' | 'unset' | 'dashed' | 'dotted' | 'double' | 'solid' | 'wavy';
+    outlineStyle: '-moz-initial' | 'inherit' | 'initial' | 'revert' | 'revert-layer' | 'unset' | 'auto' | 'dashed' | 'dotted' | 'double' | 'groove' | 'inset' | 'none' | 'outset' | 'ridge' | 'solid';
+}>;
+/** Target-level layout declarations admitted before runtime capability intersection. */
+export type AppearanceLayoutDeclarations = {
+    [Property in Exclude<AppearanceLayoutProperty, 'height'>]?: AppearanceSpacingValue;
+} & {
+    /** Exact integer-pixel enum allocated by the target contract. */
+    readonly height?: `${number}px`;
+};
+/** Paint declarations plus controlled typography and target-level layout fields. */
+type AppearanceRuleDeclarations = AppearancePaintDeclarations & AppearanceLayoutDeclarations & {
+    /** Single font family identifier admitted only for authorized targets at runtime. */
+    readonly fontFamily?: string;
+    /** Integer pixel size admitted only for authorized text targets at runtime. */
+    readonly fontSize?: `${number}px`;
+    /** Controlled font weight admitted only for authorized text targets at runtime. */
+    readonly fontWeight?: 400 | 500 | 600 | 700;
+    /** Controlled font style admitted only for authorized text targets at runtime. */
+    readonly fontStyle?: 'normal' | 'italic';
+};
+/** Builds an Antom appearance type with the restricted Rules declaration contract. */
+export type PickAntomAppearance<T extends Record<string, any>> = PickAppearance<T, AppearanceRuleDeclarations>;
+type AppearanceRulesAppConfig = {
+    appearance?: {
+        rules?: unknown;
+    };
+};
+/**
+ * Resets stored Rules before the core deep merge handles an explicit empty patch.
+ *
+ * @param currentConfig - Current complete SDK configuration.
+ * @param update - Merchant configuration patch being merged.
+ */
+export declare function prepareAppearanceRulesUpdate(currentConfig: AppearanceRulesAppConfig, update: AppearanceRulesAppConfig): void;
+export {};