@hook-sdk/template 0.19.0 → 0.21.0

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, ComponentType, Component } from 'react';
 import * as _hook_sdk_sdk from '@hook-sdk/sdk';
-import { CheckoutMethod as CheckoutMethod$1, CheckoutCycle, CheckoutResult, CheckoutCardData, CheckoutHolderInfo, PlanState, ReminderSlot } from '@hook-sdk/sdk';
+import { HookContextValue, CheckoutMethod as CheckoutMethod$1, CheckoutCycle, CheckoutResult, CheckoutCardData, CheckoutHolderInfo, PlanState, ReminderSlot } from '@hook-sdk/sdk';
 export { PlanInfo, PlanState, useTrackOnboardingStep } from '@hook-sdk/sdk';
 import { z } from 'zod';
 
@@ -19,7 +19,27 @@ type PaywallConfig = {
     mode: 'free';
 } | {
     mode: 'trial' | 'pay_first';
+    /**
+     * Legacy flat trial — fallback when per-method fields aren't set.
+     * Read via `trialDaysForMethod(method)` helper on `usePaywallState`.
+     */
     trialDays?: number;
+    /**
+     * Per-method trial overrides (ADR-022 Amendment 2026-05-12 + G154).
+     * - `trialDaysCard` — days of free trial on the card method.
+     *   Default 7 in the backend, but apps can opt down to 0 if they want
+     *   PIX-style "pay now" semantics on cards too.
+     * - `trialDaysPix` — days of free trial on PIX Auto. Default 0 because
+     *   Asaas does not implement BCB Jornada 2 (consent-only authorization).
+     *   Any value > 0 forces the R$ 0,01 capture workaround — see G123-G127.
+     */
+    trialDaysCard?: number;
+    trialDaysPix?: number;
+    /**
+     * Which method the paywall preselects. Reflects creator audience,
+     * not Hook bias. `null`/`undefined` = no preselection — user picks.
+     */
+    defaultMethod?: CheckoutMethod | null;
     cycles: Cycle[];
     prices: {
         monthlyCents: number;
@@ -120,6 +140,33 @@ interface AuthScreenProps {
     onNavigate?: (target: 'login' | 'signup' | 'forgot' | 'reset') => void;
 }
 
+interface SkipDefaults {
+    /**
+     * Final flag the host app's ProtectedRoute reads. If unset here, the helper
+     * forces it to `true` after merging defaults.
+     */
+    onboarding_completed?: boolean;
+    /**
+     * Free-form per-app fields (userName, mainGoal, faixa, kids[], etc.). The
+     * helper merges this object verbatim into `appData.set('onboarding_data', …)`.
+     */
+    [field: string]: unknown;
+    /**
+     * Optional per-app seed callback. Use to insert anything that lives outside
+     * `onboarding_data` (e.g. seed first workout in `hook.db.collection('workouts')`).
+     * Awaited after `appData.set` and before the hard reload.
+     */
+    __seed?: (hook: HookContextValue) => Promise<void>;
+}
+/**
+ * Programmatic skip helper. Exposed for advanced consumers / tests; the FAB
+ * just calls this on confirm.
+ */
+declare function skipOnboarding(hook: HookContextValue, defaults: SkipDefaults, appSlug: string): Promise<void>;
+declare function DevSkipOnboardingFab({ defaults }: {
+    defaults: SkipDefaults;
+}): react_jsx_runtime.JSX.Element;
+
 declare function PaymentReturnHandler({ children }: {
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
@@ -145,27 +192,54 @@ type AppRootProps = AppRootSlots & {
     testRouter?: 'memory';
     /** Test-only: initial entries for MemoryRouter. */
     testInitialEntries?: string[];
+    /**
+     * Staging-only dev tools. When this prop is set AND
+     * `VITE_HOOK_DEV_TOOLS=1` AND the hostname is staging/localhost, AppRoot
+     * mounts a floating "skip onboarding" button that pre-fills
+     * `appData.onboarding_data` with the supplied defaults and lands the user
+     * on `/app/<slug>/`. Tree-shaken from prod builds via the build-time env
+     * replacement (see `dev/env.ts`).
+     */
+    devSkipOnboarding?: {
+        defaults: SkipDefaults;
+    };
 };
 
 declare function AppRoot(props: AppRootProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Build-time + runtime gate for dev-only tools (e.g. <DevSkipOnboardingFab>).
+ *
+ * Two independent signals must agree:
+ *
+ *   1. Build-time: `import.meta.env.VITE_HOOK_DEV_TOOLS === '1'`. Vite folds
+ *      this constant at build time — when unset, the entire dev tree is
+ *      tree-shaken from the prod bundle (sideEffects:false in package.json
+ *      makes that effective). Set `VITE_HOOK_DEV_TOOLS=1` only in
+ *      `.env.staging` builds.
+ *
+ *   2. Runtime: hostname must be staging-ish. Belt-and-suspenders against
+ *      a misconfigured build that somehow ships the FAB to prod.
+ */
+declare function isDevToolsEnabled(): boolean;
+
 interface PushPromptTexts {
     cta: string;
     declineCta: string;
     iosInstallTitle: string;
     iosInstallBody: string;
     iosInstallCta?: string;
-    deniedTitle: string;
-    deniedBody: string;
-    /**
-     * Audit Wave 3 — Fix #33: per-platform recovery copy shown when permission
-     * is denied. All four are optional; if the matching platform's copy is
-     * missing the recovery paragraph is omitted (back-compat for callers that
-     * haven't supplied them yet).
-     */
+    /** @deprecated denied state no longer renders UI; field retained for back-compat. */
+    deniedTitle?: string;
+    /** @deprecated denied state no longer renders UI; field retained for back-compat. */
+    deniedBody?: string;
+    /** @deprecated denied state no longer renders UI; field retained for back-compat. */
     deniedRecoveryIos?: string;
+    /** @deprecated denied state no longer renders UI; field retained for back-compat. */
     deniedRecoveryAndroid?: string;
+    /** @deprecated denied state no longer renders UI; field retained for back-compat. */
     deniedRecoveryDesktop?: string;
+    /** @deprecated denied state no longer renders UI; field retained for back-compat. */
     deniedRecoveryInApp?: string;
     unsupportedBody: string;
 }
@@ -464,6 +538,16 @@ declare function usePaywallState(): {
     methods: readonly CheckoutMethod$1[];
     selectedMethod: CheckoutMethod$1;
     setSelectedMethod: react.Dispatch<react.SetStateAction<CheckoutMethod$1>>;
+    hasConsumedTrial: boolean;
+    currentPriceCents: number;
+    currentMonthlyEquivCents: number;
+    anchorPriceCents: number | null;
+    selectMethod: (next: CheckoutMethod$1) => void;
+    selectCycle: (next: CheckoutCycle) => void;
+    isFree: boolean;
+    trialDaysForMethod: (method: CheckoutMethod$1) => number;
+    trialDaysCard: number;
+    trialDaysPix: number;
     cpfState: CpfState;
     cardState: CardFormStateWithSetter;
     submit: () => Promise<CheckoutResult | undefined>;
@@ -882,6 +966,13 @@ declare const AppConfigSchema: z.ZodObject<{
             pay_first: "pay_first";
         }>;
         trialDays: z.ZodOptional<z.ZodNumber>;
+        trialDaysCard: z.ZodOptional<z.ZodNumber>;
+        trialDaysPix: z.ZodOptional<z.ZodNumber>;
+        defaultMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            card: "card";
+            "pix-auto": "pix-auto";
+            "pix-once": "pix-once";
+        }>>>;
         cycles: z.ZodArray<z.ZodEnum<{
             MONTHLY: "MONTHLY";
             YEARLY: "YEARLY";
@@ -950,4 +1041,153 @@ declare const AppConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 declare function parseAppConfig(input: unknown): AppConfig;
 
-export { type AndroidBrowser, type AppConfig, AppConfigProvider, AppConfigSchema, AppRoot, type AppRootProps, type AppRootSlots, type AuthFlowConfig, type AuthFormError, type AuthFormErrorCode, type AuthScreenProps, type CheckoutMethod, type Cycle, DeepLinkHandler, type DeepLinks, EmptyState, ErrorBoundary, type I18nConfig, I18nProvider, type I18nProviderProps, type IOSBrowser, type InAppApp, type InstallActions, InstallGate, InstallSplash, type InstallState, type InstallVariant, LanguageSwitcher, type LanguageSwitcherProps, LoadingState, type OnboardingConfig, OnboardingFlow, type OnboardingFlowProps, type OnboardingStep, type OnboardingStepCtx, type OnboardingStepDef, type PaymentMethod, PaymentReturnHandler, type PaywallConfig, type PersistedKey, PersistenceRegistry, type PersistenceRegistryProps, type PixPending, type Platform, PreAuthShell, type PreAuthShellProps, PushPrompt, type PushPromptProps, type PushPromptTexts, type PushUiState, RouteBoundary, type RouteBoundaryProps, type SubscriptionStatus, type ToastItem, type UseLoginFormResult, type UseResetFormResult, asaasErrorMessage, computeAnchorCents, dailyFromYearly, detectAndroidBrowser, detectIOSBrowser, detectInAppApp, detectPlatform, detectStandalone, discountPercent, formatBRL, monthlyFromYearly, parseAppConfig, shouldBlockInstall, shouldShowPermanentOption, useAppConfig, useAuth, useAuthPrimitives, useFeature, useForgotForm, useInstallPrompt, useLoginForm, useOnboardingStep, usePaywallState, usePlan, usePush, useReminders, useResetForm, useSignupForm, useSubscription, useToast };
+type PaywallMethodCopy = {
+    /** Tab label, e.g. "⚡ PIX" or "💳 Cartão" */
+    tabLabel: string;
+    /** 3 body rows under the active tab. Use literal strings; price/days come from the hook. */
+    bodyRows: [string, string, string];
+    /** CTA label template. `{price}` and `{days}` placeholders are interpolated. */
+    ctaTemplate: string;
+    /** Switch-hint copy shown under the CTA when the OTHER tab is available. */
+    switchHint: string;
+};
+type PaywallCopy = {
+    headline: string;
+    features: readonly string[];
+    socialProof?: string;
+    /** Trust line above sticky CTA. Shared across methods. */
+    trustLine: string;
+    pix: PaywallMethodCopy;
+    card: PaywallMethodCopy;
+    /** Used when `usePaywallState().hasConsumedTrial === true`. Card tab body + CTA shift. */
+    cardConsumedTrial: Omit<PaywallMethodCopy, 'tabLabel' | 'switchHint'>;
+    cycle: {
+        annualLabel: string;
+        monthlyLabel: string;
+        /** Append after price on annual card, e.g. "/mês · anual" */
+        annualSuffix: string;
+        /** Append after price on monthly card, e.g. "/mês" */
+        monthlySuffix: string;
+    };
+    /** Optional override for the "free" CTA when `paywall.mode === 'free'`. */
+    freeCta?: string;
+};
+type PaywallThemeClasses = {
+    /** Container wrapper. Default: empty. */
+    container?: string;
+    /** Headline `<h1>`. */
+    headline?: string;
+    /** Feature row `<li>`. */
+    feature?: string;
+    /** Cycle picker card. */
+    cycleCard?: string;
+    /** Cycle picker card when selected. */
+    cycleCardSelected?: string;
+    /** Method tabs wrapper (pill background). */
+    tabs?: string;
+    /** Individual tab. */
+    tab?: string;
+    /** Individual tab when active. */
+    tabActive?: string;
+    /** Tab body card. */
+    tabContent?: string;
+    /** Tab body row (one row per icon+text). */
+    tabContentRow?: string;
+    /** CTA button — applied when method=pix-auto. */
+    ctaPix?: string;
+    /** CTA button — applied when method=card. */
+    ctaCard?: string;
+    /** Switch-hint line under CTA. */
+    switchHint?: string;
+    /** Trust line under switch hint. */
+    trustLine?: string;
+    /** Social proof badge. */
+    socialProof?: string;
+    /** Anchor strikethrough price. */
+    anchorPrice?: string;
+};
+type PaywallSlots = {
+    /** Above headline (hero image, brand visual). */
+    heroSlot?: ReactNode;
+    /** Below tab content, above CTA (e.g. testimonials). */
+    beforeCtaSlot?: ReactNode;
+    /** Replace the cycle picker entirely. */
+    cyclePickerSlot?: ReactNode;
+};
+type PaywallProps = {
+    copy: PaywallCopy;
+    themeClasses?: PaywallThemeClasses;
+    slots?: PaywallSlots;
+    /** Called immediately before checkout dispatches. Use for opening CPF modal etc. */
+    onBeforeCheckout?: (method: CheckoutMethod, cycle: Cycle) => void | Promise<void>;
+};
+
+/**
+ * Composed top-level paywall component. Apps wrap it in their `PaywallOffer.tsx`
+ * (or `Offer.tsx`) and pass copy + themeClasses + slots. Logic + telemetry live
+ * here. To customize layout entirely, drop down to the primitives.
+ */
+declare function Paywall({ copy, themeClasses, slots, onBeforeCheckout, }: PaywallProps): react_jsx_runtime.JSX.Element;
+
+type PaywallMethodTabsProps = {
+    methods: readonly CheckoutMethod[];
+    selected: CheckoutMethod;
+    onSelect: (m: CheckoutMethod) => void;
+    labels: Partial<Record<CheckoutMethod, string>>;
+    className?: string;
+    tabClassName?: string;
+    tabActiveClassName?: string;
+};
+declare function PaywallMethodTabs({ methods, selected, onSelect, labels, className, tabClassName, tabActiveClassName, }: PaywallMethodTabsProps): react_jsx_runtime.JSX.Element | null;
+
+type PaywallMethodContentProps = {
+    method: CheckoutMethod;
+    copy: Pick<PaywallCopy, 'pix' | 'card'> & {
+        cardConsumedTrial?: PaywallCopy['cardConsumedTrial'];
+    };
+    hasConsumedTrial?: boolean;
+    className?: string;
+    rowClassName?: string;
+};
+declare function PaywallMethodContent({ method, copy, hasConsumedTrial, className, rowClassName, }: PaywallMethodContentProps): react_jsx_runtime.JSX.Element;
+
+type CycleLabels = {
+    annualLabel: string;
+    monthlyLabel: string;
+    annualSuffix: string;
+    monthlySuffix: string;
+};
+type PaywallCyclePickerProps = {
+    cycles: readonly Cycle[];
+    selected: Cycle;
+    onSelect: (c: Cycle) => void;
+    /** Raw price for the cycle (used to show full annual/monthly). */
+    priceCentsByCycle: Record<Cycle, number>;
+    /** Anchor strikethrough price, null when not set. */
+    anchorCentsByCycle: Record<Cycle, number | null>;
+    /** Monthly-equiv for YEARLY (priceCents / 12). Same as priceCentsByCycle for MONTHLY. */
+    monthlyEquivByCycle: Record<Cycle, number>;
+    labels: CycleLabels;
+    className?: string;
+    cardClassName?: string;
+    cardSelectedClassName?: string;
+    anchorClassName?: string;
+};
+declare function PaywallCyclePicker({ cycles, selected, onSelect, priceCentsByCycle, anchorCentsByCycle, monthlyEquivByCycle, labels, className, cardClassName, cardSelectedClassName, anchorClassName, }: PaywallCyclePickerProps): react_jsx_runtime.JSX.Element | null;
+
+type PaywallCtaProps = {
+    ctaLabel: string;
+    loadingLabel?: string;
+    switchHint?: string;
+    trustLine: string;
+    onClick: () => void;
+    disabled?: boolean;
+    loading?: boolean;
+    className?: string;
+    buttonClassName?: string;
+    switchHintClassName?: string;
+    trustClassName?: string;
+};
+declare function PaywallCta({ ctaLabel, loadingLabel, switchHint, trustLine, onClick, disabled, loading, className, buttonClassName, switchHintClassName, trustClassName, }: PaywallCtaProps): react_jsx_runtime.JSX.Element;
+
+export { type AndroidBrowser, type AppConfig, AppConfigProvider, AppConfigSchema, AppRoot, type AppRootProps, type AppRootSlots, type AuthFlowConfig, type AuthFormError, type AuthFormErrorCode, type AuthScreenProps, type CheckoutMethod, type Cycle, type CycleLabels, DeepLinkHandler, type DeepLinks, DevSkipOnboardingFab, EmptyState, ErrorBoundary, type I18nConfig, I18nProvider, type I18nProviderProps, type IOSBrowser, type InAppApp, type InstallActions, InstallGate, InstallSplash, type InstallState, type InstallVariant, LanguageSwitcher, type LanguageSwitcherProps, LoadingState, type OnboardingConfig, OnboardingFlow, type OnboardingFlowProps, type OnboardingStep, type OnboardingStepCtx, type OnboardingStepDef, type PaymentMethod, PaymentReturnHandler, Paywall, type PaywallConfig, type PaywallCopy, PaywallCta, type PaywallCtaProps, PaywallCyclePicker, type PaywallCyclePickerProps, PaywallMethodContent, type PaywallMethodContentProps, type PaywallMethodCopy, PaywallMethodTabs, type PaywallMethodTabsProps, type PaywallProps, type PaywallSlots, type PaywallThemeClasses, type PersistedKey, PersistenceRegistry, type PersistenceRegistryProps, type PixPending, type Platform, PreAuthShell, type PreAuthShellProps, PushPrompt, type PushPromptProps, type PushPromptTexts, type PushUiState, RouteBoundary, type RouteBoundaryProps, type SkipDefaults, type SubscriptionStatus, type ToastItem, type UseLoginFormResult, type UseResetFormResult, asaasErrorMessage, computeAnchorCents, dailyFromYearly, detectAndroidBrowser, detectIOSBrowser, detectInAppApp, detectPlatform, detectStandalone, discountPercent, formatBRL, isDevToolsEnabled, monthlyFromYearly, parseAppConfig, shouldBlockInstall, shouldShowPermanentOption, skipOnboarding, useAppConfig, useAuth, useAuthPrimitives, useFeature, useForgotForm, useInstallPrompt, useLoginForm, useOnboardingStep, usePaywallState, usePlan, usePush, useReminders, useResetForm, useSignupForm, useSubscription, useToast };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, ComponentType, Component } from 'react';
 import * as _hook_sdk_sdk from '@hook-sdk/sdk';
-import { CheckoutMethod as CheckoutMethod$1, CheckoutCycle, CheckoutResult, CheckoutCardData, CheckoutHolderInfo, PlanState, ReminderSlot } from '@hook-sdk/sdk';
+import { HookContextValue, CheckoutMethod as CheckoutMethod$1, CheckoutCycle, CheckoutResult, CheckoutCardData, CheckoutHolderInfo, PlanState, ReminderSlot } from '@hook-sdk/sdk';
 export { PlanInfo, PlanState, useTrackOnboardingStep } from '@hook-sdk/sdk';
 import { z } from 'zod';
 
@@ -19,7 +19,27 @@ type PaywallConfig = {
     mode: 'free';
 } | {
     mode: 'trial' | 'pay_first';
+    /**
+     * Legacy flat trial — fallback when per-method fields aren't set.
+     * Read via `trialDaysForMethod(method)` helper on `usePaywallState`.
+     */
     trialDays?: number;
+    /**
+     * Per-method trial overrides (ADR-022 Amendment 2026-05-12 + G154).
+     * - `trialDaysCard` — days of free trial on the card method.
+     *   Default 7 in the backend, but apps can opt down to 0 if they want
+     *   PIX-style "pay now" semantics on cards too.
+     * - `trialDaysPix` — days of free trial on PIX Auto. Default 0 because
+     *   Asaas does not implement BCB Jornada 2 (consent-only authorization).
+     *   Any value > 0 forces the R$ 0,01 capture workaround — see G123-G127.
+     */
+    trialDaysCard?: number;
+    trialDaysPix?: number;
+    /**
+     * Which method the paywall preselects. Reflects creator audience,
+     * not Hook bias. `null`/`undefined` = no preselection — user picks.
+     */
+    defaultMethod?: CheckoutMethod | null;
     cycles: Cycle[];
     prices: {
         monthlyCents: number;
@@ -120,6 +140,33 @@ interface AuthScreenProps {
     onNavigate?: (target: 'login' | 'signup' | 'forgot' | 'reset') => void;
 }
 
+interface SkipDefaults {
+    /**
+     * Final flag the host app's ProtectedRoute reads. If unset here, the helper
+     * forces it to `true` after merging defaults.
+     */
+    onboarding_completed?: boolean;
+    /**
+     * Free-form per-app fields (userName, mainGoal, faixa, kids[], etc.). The
+     * helper merges this object verbatim into `appData.set('onboarding_data', …)`.
+     */
+    [field: string]: unknown;
+    /**
+     * Optional per-app seed callback. Use to insert anything that lives outside
+     * `onboarding_data` (e.g. seed first workout in `hook.db.collection('workouts')`).
+     * Awaited after `appData.set` and before the hard reload.
+     */
+    __seed?: (hook: HookContextValue) => Promise<void>;
+}
+/**
+ * Programmatic skip helper. Exposed for advanced consumers / tests; the FAB
+ * just calls this on confirm.
+ */
+declare function skipOnboarding(hook: HookContextValue, defaults: SkipDefaults, appSlug: string): Promise<void>;
+declare function DevSkipOnboardingFab({ defaults }: {
+    defaults: SkipDefaults;
+}): react_jsx_runtime.JSX.Element;
+
 declare function PaymentReturnHandler({ children }: {
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
@@ -145,27 +192,54 @@ type AppRootProps = AppRootSlots & {
     testRouter?: 'memory';
     /** Test-only: initial entries for MemoryRouter. */
     testInitialEntries?: string[];
+    /**
+     * Staging-only dev tools. When this prop is set AND
+     * `VITE_HOOK_DEV_TOOLS=1` AND the hostname is staging/localhost, AppRoot
+     * mounts a floating "skip onboarding" button that pre-fills
+     * `appData.onboarding_data` with the supplied defaults and lands the user
+     * on `/app/<slug>/`. Tree-shaken from prod builds via the build-time env
+     * replacement (see `dev/env.ts`).
+     */
+    devSkipOnboarding?: {
+        defaults: SkipDefaults;
+    };
 };
 
 declare function AppRoot(props: AppRootProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Build-time + runtime gate for dev-only tools (e.g. <DevSkipOnboardingFab>).
+ *
+ * Two independent signals must agree:
+ *
+ *   1. Build-time: `import.meta.env.VITE_HOOK_DEV_TOOLS === '1'`. Vite folds
+ *      this constant at build time — when unset, the entire dev tree is
+ *      tree-shaken from the prod bundle (sideEffects:false in package.json
+ *      makes that effective). Set `VITE_HOOK_DEV_TOOLS=1` only in
+ *      `.env.staging` builds.
+ *
+ *   2. Runtime: hostname must be staging-ish. Belt-and-suspenders against
+ *      a misconfigured build that somehow ships the FAB to prod.
+ */
+declare function isDevToolsEnabled(): boolean;
+
 interface PushPromptTexts {
     cta: string;
     declineCta: string;
     iosInstallTitle: string;
     iosInstallBody: string;
     iosInstallCta?: string;
-    deniedTitle: string;
-    deniedBody: string;
-    /**
-     * Audit Wave 3 — Fix #33: per-platform recovery copy shown when permission
-     * is denied. All four are optional; if the matching platform's copy is
-     * missing the recovery paragraph is omitted (back-compat for callers that
-     * haven't supplied them yet).
-     */
+    /** @deprecated denied state no longer renders UI; field retained for back-compat. */
+    deniedTitle?: string;
+    /** @deprecated denied state no longer renders UI; field retained for back-compat. */
+    deniedBody?: string;
+    /** @deprecated denied state no longer renders UI; field retained for back-compat. */
     deniedRecoveryIos?: string;
+    /** @deprecated denied state no longer renders UI; field retained for back-compat. */
     deniedRecoveryAndroid?: string;
+    /** @deprecated denied state no longer renders UI; field retained for back-compat. */
     deniedRecoveryDesktop?: string;
+    /** @deprecated denied state no longer renders UI; field retained for back-compat. */
     deniedRecoveryInApp?: string;
     unsupportedBody: string;
 }
@@ -464,6 +538,16 @@ declare function usePaywallState(): {
     methods: readonly CheckoutMethod$1[];
     selectedMethod: CheckoutMethod$1;
     setSelectedMethod: react.Dispatch<react.SetStateAction<CheckoutMethod$1>>;
+    hasConsumedTrial: boolean;
+    currentPriceCents: number;
+    currentMonthlyEquivCents: number;
+    anchorPriceCents: number | null;
+    selectMethod: (next: CheckoutMethod$1) => void;
+    selectCycle: (next: CheckoutCycle) => void;
+    isFree: boolean;
+    trialDaysForMethod: (method: CheckoutMethod$1) => number;
+    trialDaysCard: number;
+    trialDaysPix: number;
     cpfState: CpfState;
     cardState: CardFormStateWithSetter;
     submit: () => Promise<CheckoutResult | undefined>;
@@ -882,6 +966,13 @@ declare const AppConfigSchema: z.ZodObject<{
             pay_first: "pay_first";
         }>;
         trialDays: z.ZodOptional<z.ZodNumber>;
+        trialDaysCard: z.ZodOptional<z.ZodNumber>;
+        trialDaysPix: z.ZodOptional<z.ZodNumber>;
+        defaultMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            card: "card";
+            "pix-auto": "pix-auto";
+            "pix-once": "pix-once";
+        }>>>;
         cycles: z.ZodArray<z.ZodEnum<{
             MONTHLY: "MONTHLY";
             YEARLY: "YEARLY";
@@ -950,4 +1041,153 @@ declare const AppConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 declare function parseAppConfig(input: unknown): AppConfig;
 
-export { type AndroidBrowser, type AppConfig, AppConfigProvider, AppConfigSchema, AppRoot, type AppRootProps, type AppRootSlots, type AuthFlowConfig, type AuthFormError, type AuthFormErrorCode, type AuthScreenProps, type CheckoutMethod, type Cycle, DeepLinkHandler, type DeepLinks, EmptyState, ErrorBoundary, type I18nConfig, I18nProvider, type I18nProviderProps, type IOSBrowser, type InAppApp, type InstallActions, InstallGate, InstallSplash, type InstallState, type InstallVariant, LanguageSwitcher, type LanguageSwitcherProps, LoadingState, type OnboardingConfig, OnboardingFlow, type OnboardingFlowProps, type OnboardingStep, type OnboardingStepCtx, type OnboardingStepDef, type PaymentMethod, PaymentReturnHandler, type PaywallConfig, type PersistedKey, PersistenceRegistry, type PersistenceRegistryProps, type PixPending, type Platform, PreAuthShell, type PreAuthShellProps, PushPrompt, type PushPromptProps, type PushPromptTexts, type PushUiState, RouteBoundary, type RouteBoundaryProps, type SubscriptionStatus, type ToastItem, type UseLoginFormResult, type UseResetFormResult, asaasErrorMessage, computeAnchorCents, dailyFromYearly, detectAndroidBrowser, detectIOSBrowser, detectInAppApp, detectPlatform, detectStandalone, discountPercent, formatBRL, monthlyFromYearly, parseAppConfig, shouldBlockInstall, shouldShowPermanentOption, useAppConfig, useAuth, useAuthPrimitives, useFeature, useForgotForm, useInstallPrompt, useLoginForm, useOnboardingStep, usePaywallState, usePlan, usePush, useReminders, useResetForm, useSignupForm, useSubscription, useToast };
+type PaywallMethodCopy = {
+    /** Tab label, e.g. "⚡ PIX" or "💳 Cartão" */
+    tabLabel: string;
+    /** 3 body rows under the active tab. Use literal strings; price/days come from the hook. */
+    bodyRows: [string, string, string];
+    /** CTA label template. `{price}` and `{days}` placeholders are interpolated. */
+    ctaTemplate: string;
+    /** Switch-hint copy shown under the CTA when the OTHER tab is available. */
+    switchHint: string;
+};
+type PaywallCopy = {
+    headline: string;
+    features: readonly string[];
+    socialProof?: string;
+    /** Trust line above sticky CTA. Shared across methods. */
+    trustLine: string;
+    pix: PaywallMethodCopy;
+    card: PaywallMethodCopy;
+    /** Used when `usePaywallState().hasConsumedTrial === true`. Card tab body + CTA shift. */
+    cardConsumedTrial: Omit<PaywallMethodCopy, 'tabLabel' | 'switchHint'>;
+    cycle: {
+        annualLabel: string;
+        monthlyLabel: string;
+        /** Append after price on annual card, e.g. "/mês · anual" */
+        annualSuffix: string;
+        /** Append after price on monthly card, e.g. "/mês" */
+        monthlySuffix: string;
+    };
+    /** Optional override for the "free" CTA when `paywall.mode === 'free'`. */
+    freeCta?: string;
+};
+type PaywallThemeClasses = {
+    /** Container wrapper. Default: empty. */
+    container?: string;
+    /** Headline `<h1>`. */
+    headline?: string;
+    /** Feature row `<li>`. */
+    feature?: string;
+    /** Cycle picker card. */
+    cycleCard?: string;
+    /** Cycle picker card when selected. */
+    cycleCardSelected?: string;
+    /** Method tabs wrapper (pill background). */
+    tabs?: string;
+    /** Individual tab. */
+    tab?: string;
+    /** Individual tab when active. */
+    tabActive?: string;
+    /** Tab body card. */
+    tabContent?: string;
+    /** Tab body row (one row per icon+text). */
+    tabContentRow?: string;
+    /** CTA button — applied when method=pix-auto. */
+    ctaPix?: string;
+    /** CTA button — applied when method=card. */
+    ctaCard?: string;
+    /** Switch-hint line under CTA. */
+    switchHint?: string;
+    /** Trust line under switch hint. */
+    trustLine?: string;
+    /** Social proof badge. */
+    socialProof?: string;
+    /** Anchor strikethrough price. */
+    anchorPrice?: string;
+};
+type PaywallSlots = {
+    /** Above headline (hero image, brand visual). */
+    heroSlot?: ReactNode;
+    /** Below tab content, above CTA (e.g. testimonials). */
+    beforeCtaSlot?: ReactNode;
+    /** Replace the cycle picker entirely. */
+    cyclePickerSlot?: ReactNode;
+};
+type PaywallProps = {
+    copy: PaywallCopy;
+    themeClasses?: PaywallThemeClasses;
+    slots?: PaywallSlots;
+    /** Called immediately before checkout dispatches. Use for opening CPF modal etc. */
+    onBeforeCheckout?: (method: CheckoutMethod, cycle: Cycle) => void | Promise<void>;
+};
+
+/**
+ * Composed top-level paywall component. Apps wrap it in their `PaywallOffer.tsx`
+ * (or `Offer.tsx`) and pass copy + themeClasses + slots. Logic + telemetry live
+ * here. To customize layout entirely, drop down to the primitives.
+ */
+declare function Paywall({ copy, themeClasses, slots, onBeforeCheckout, }: PaywallProps): react_jsx_runtime.JSX.Element;
+
+type PaywallMethodTabsProps = {
+    methods: readonly CheckoutMethod[];
+    selected: CheckoutMethod;
+    onSelect: (m: CheckoutMethod) => void;
+    labels: Partial<Record<CheckoutMethod, string>>;
+    className?: string;
+    tabClassName?: string;
+    tabActiveClassName?: string;
+};
+declare function PaywallMethodTabs({ methods, selected, onSelect, labels, className, tabClassName, tabActiveClassName, }: PaywallMethodTabsProps): react_jsx_runtime.JSX.Element | null;
+
+type PaywallMethodContentProps = {
+    method: CheckoutMethod;
+    copy: Pick<PaywallCopy, 'pix' | 'card'> & {
+        cardConsumedTrial?: PaywallCopy['cardConsumedTrial'];
+    };
+    hasConsumedTrial?: boolean;
+    className?: string;
+    rowClassName?: string;
+};
+declare function PaywallMethodContent({ method, copy, hasConsumedTrial, className, rowClassName, }: PaywallMethodContentProps): react_jsx_runtime.JSX.Element;
+
+type CycleLabels = {
+    annualLabel: string;
+    monthlyLabel: string;
+    annualSuffix: string;
+    monthlySuffix: string;
+};
+type PaywallCyclePickerProps = {
+    cycles: readonly Cycle[];
+    selected: Cycle;
+    onSelect: (c: Cycle) => void;
+    /** Raw price for the cycle (used to show full annual/monthly). */
+    priceCentsByCycle: Record<Cycle, number>;
+    /** Anchor strikethrough price, null when not set. */
+    anchorCentsByCycle: Record<Cycle, number | null>;
+    /** Monthly-equiv for YEARLY (priceCents / 12). Same as priceCentsByCycle for MONTHLY. */
+    monthlyEquivByCycle: Record<Cycle, number>;
+    labels: CycleLabels;
+    className?: string;
+    cardClassName?: string;
+    cardSelectedClassName?: string;
+    anchorClassName?: string;
+};
+declare function PaywallCyclePicker({ cycles, selected, onSelect, priceCentsByCycle, anchorCentsByCycle, monthlyEquivByCycle, labels, className, cardClassName, cardSelectedClassName, anchorClassName, }: PaywallCyclePickerProps): react_jsx_runtime.JSX.Element | null;
+
+type PaywallCtaProps = {
+    ctaLabel: string;
+    loadingLabel?: string;
+    switchHint?: string;
+    trustLine: string;
+    onClick: () => void;
+    disabled?: boolean;
+    loading?: boolean;
+    className?: string;
+    buttonClassName?: string;
+    switchHintClassName?: string;
+    trustClassName?: string;
+};
+declare function PaywallCta({ ctaLabel, loadingLabel, switchHint, trustLine, onClick, disabled, loading, className, buttonClassName, switchHintClassName, trustClassName, }: PaywallCtaProps): react_jsx_runtime.JSX.Element;
+
+export { type AndroidBrowser, type AppConfig, AppConfigProvider, AppConfigSchema, AppRoot, type AppRootProps, type AppRootSlots, type AuthFlowConfig, type AuthFormError, type AuthFormErrorCode, type AuthScreenProps, type CheckoutMethod, type Cycle, type CycleLabels, DeepLinkHandler, type DeepLinks, DevSkipOnboardingFab, EmptyState, ErrorBoundary, type I18nConfig, I18nProvider, type I18nProviderProps, type IOSBrowser, type InAppApp, type InstallActions, InstallGate, InstallSplash, type InstallState, type InstallVariant, LanguageSwitcher, type LanguageSwitcherProps, LoadingState, type OnboardingConfig, OnboardingFlow, type OnboardingFlowProps, type OnboardingStep, type OnboardingStepCtx, type OnboardingStepDef, type PaymentMethod, PaymentReturnHandler, Paywall, type PaywallConfig, type PaywallCopy, PaywallCta, type PaywallCtaProps, PaywallCyclePicker, type PaywallCyclePickerProps, PaywallMethodContent, type PaywallMethodContentProps, type PaywallMethodCopy, PaywallMethodTabs, type PaywallMethodTabsProps, type PaywallProps, type PaywallSlots, type PaywallThemeClasses, type PersistedKey, PersistenceRegistry, type PersistenceRegistryProps, type PixPending, type Platform, PreAuthShell, type PreAuthShellProps, PushPrompt, type PushPromptProps, type PushPromptTexts, type PushUiState, RouteBoundary, type RouteBoundaryProps, type SkipDefaults, type SubscriptionStatus, type ToastItem, type UseLoginFormResult, type UseResetFormResult, asaasErrorMessage, computeAnchorCents, dailyFromYearly, detectAndroidBrowser, detectIOSBrowser, detectInAppApp, detectPlatform, detectStandalone, discountPercent, formatBRL, isDevToolsEnabled, monthlyFromYearly, parseAppConfig, shouldBlockInstall, shouldShowPermanentOption, skipOnboarding, useAppConfig, useAuth, useAuthPrimitives, useFeature, useForgotForm, useInstallPrompt, useLoginForm, useOnboardingStep, usePaywallState, usePlan, usePush, useReminders, useResetForm, useSignupForm, useSubscription, useToast };