@alipay/ams-checkout 2.0.25 → 2.0.27

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 {};