@aifeatures/react 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1,6 +1,20 @@
1
1
  import * as react_jsx_runtime from 'react/jsx-runtime';
2
2
  import { CSSProperties, ReactNode } from 'react';
3
3
 
4
+ type AifeaturesCaptchaStatus =
5
+ /** Fetching the form's config; nothing rendered yet. */
6
+ 'loading'
7
+ /** The widget is on the page and the check is running or awaiting a click. */
8
+ | 'ready'
9
+ /** A token is in the form. */
10
+ | 'verified'
11
+ /**
12
+ * The check cannot run in this browser: the config endpoint was
13
+ * unreachable, or the Turnstile script never rendered a widget — almost
14
+ * always an ad blocker, privacy extension, or network filter. The
15
+ * component shows its own notice with a retry for this state.
16
+ */
17
+ | 'blocked';
4
18
  interface AifeaturesCaptchaProps {
5
19
  /** Form ID from aifeatures - used to fetch the Turnstile sitekey */
6
20
  formId: string;
@@ -10,6 +24,12 @@ interface AifeaturesCaptchaProps {
10
24
  onVerify?: (token: string) => void;
11
25
  /** Called when CAPTCHA verification fails or expires */
12
26
  onError?: () => void;
27
+ /**
28
+ * Called on every status change. Use it to word the form's own submit
29
+ * message (a `blocked` visitor cannot submit until the check loads) or to
30
+ * surface a fallback contact path. See `AifeaturesCaptchaStatus`.
31
+ */
32
+ onStatusChange?: (status: AifeaturesCaptchaStatus) => void;
13
33
  /** Additional class name for the container */
14
34
  className?: string;
15
35
  }
@@ -27,6 +47,16 @@ interface AifeaturesCaptchaProps {
27
47
  * — invisible has no interactive escape hatch, so a visitor it cannot clear
28
48
  * silently loses the ability to submit at all.
29
49
  *
50
+ * There is one more way a visitor can lose the ability to submit: the check
51
+ * never loads at all, because an ad blocker, privacy extension, or network
52
+ * filter stops `challenges.cloudflare.com` (or the config request). Nothing
53
+ * draws, no token ever arrives, and a form that waits for one waits forever.
54
+ * The component watches for that and renders its own notice — what happened,
55
+ * and a "Try again" that re-fetches the config and remounts the widget — so
56
+ * the visitor is never left staring at a form that silently cannot send.
57
+ * Forms that track the token themselves should never tell the visitor to
58
+ * wait; read `onStatusChange` and offer a fallback (phone, email) instead.
59
+ *
30
60
  * @example
31
61
  * ```tsx
32
62
  * <form action={`https://aifeatures.dev/f/${formId}`} method="POST">
@@ -37,7 +67,10 @@ interface AifeaturesCaptchaProps {
37
67
  * </form>
38
68
  * ```
39
69
  */
40
- declare function AifeaturesCaptcha({ formId, apiUrl, onVerify, onError, className, }: AifeaturesCaptchaProps): react_jsx_runtime.JSX.Element | null;
70
+ declare function AifeaturesCaptcha({ formId, apiUrl, onVerify, onError, onStatusChange, className, }: AifeaturesCaptchaProps): react_jsx_runtime.JSX.Element | null;
71
+ declare namespace AifeaturesCaptcha {
72
+ var neverConsentGate: string;
73
+ }
41
74
 
42
75
  /** One selectable value of an option (e.g. "L" of "Size"). */
43
76
  interface PublicOptionValue {
@@ -1001,6 +1034,9 @@ interface ProductPriceProps {
1001
1034
  * (which have no fixed price).
1002
1035
  */
1003
1036
  declare function ProductPrice({ productId, variantId, apiUrl, locale, className, style, compareAtClassName, }: ProductPriceProps): react_jsx_runtime.JSX.Element | null;
1037
+ declare namespace ProductPrice {
1038
+ var neverConsentGate: string;
1039
+ }
1004
1040
 
1005
1041
  interface VariantPickerProps {
1006
1042
  /** The product's option axes (from `useProduct` / GET /v1/p/:id). */
@@ -1068,6 +1104,9 @@ interface VariantPickerProps {
1068
1104
  * data-available attributes) to match the site's design.
1069
1105
  */
1070
1106
  declare function VariantPicker({ options, variants, value, syncUrl, onChange, onVariantChange, className, style, optionClassName, optionLabelClassName, valueClassName, selectedValueClassName, unavailableValueClassName, swatchClassName, }: VariantPickerProps): react_jsx_runtime.JSX.Element | null;
1107
+ declare namespace VariantPicker {
1108
+ var neverConsentGate: string;
1109
+ }
1071
1110
 
1072
1111
  interface BuyButtonProps {
1073
1112
  /** Product ID from aifeatures */
@@ -1131,6 +1170,9 @@ interface BuyButtonProps {
1131
1170
  * Unstyled by default — pass className/style to match the site's design.
1132
1171
  */
1133
1172
  declare function BuyButton({ productId, variantId, quantity, planId, amount, metadata, successUrl, cancelUrl, customerEmail, apiUrl, disabled, className, style, errorClassName, spinner, children, }: BuyButtonProps): react_jsx_runtime.JSX.Element;
1173
+ declare namespace BuyButton {
1174
+ var neverConsentGate: string;
1175
+ }
1134
1176
 
1135
1177
  interface AddToCartButtonProps {
1136
1178
  /** Product ID from aifeatures */
@@ -1188,6 +1230,9 @@ interface AddToCartButtonProps {
1188
1230
  * role="alert". Unstyled by default — pass className/style.
1189
1231
  */
1190
1232
  declare function AddToCartButton({ productId, variantId, selection, quantity, apiUrl, disabled, className, style, errorClassName, spinner, children, }: AddToCartButtonProps): react_jsx_runtime.JSX.Element;
1233
+ declare namespace AddToCartButton {
1234
+ var neverConsentGate: string;
1235
+ }
1191
1236
 
1192
1237
  interface CartCheckoutButtonProps {
1193
1238
  /** Base URL for the aifeatures API (defaults to https://aifeatures.dev) */
@@ -1237,6 +1282,9 @@ interface CartCheckoutButtonProps {
1237
1282
  * `conflicts`) is the site's job. Unstyled by default — pass className/style.
1238
1283
  */
1239
1284
  declare function CartCheckoutButton({ apiUrl, successUrl, cancelUrl, customerEmail, metadata, shippingOption, disabled, className, style, errorClassName, spinner, children, }: CartCheckoutButtonProps): react_jsx_runtime.JSX.Element;
1285
+ declare namespace CartCheckoutButton {
1286
+ var neverConsentGate: string;
1287
+ }
1240
1288
 
1241
1289
  type OrderStatus = "pending" | "paid" | "failed" | "expired" | "refunded" | "partially_refunded" | "disputed";
1242
1290
  interface OrderFulfillment {
@@ -1420,6 +1468,556 @@ interface OrderConfirmationProps {
1420
1468
  renderFailed?: (session: OrderSession) => ReactNode;
1421
1469
  }
1422
1470
  declare function OrderConfirmation({ apiUrl, className, style, sessionId: sessionIdProp, pollIntervalMs, pollTimeoutMs, followRedirect, redirectDelayMs, renderNoSession, renderPending, renderPaid, renderFailed, }: OrderConfirmationProps): react_jsx_runtime.JSX.Element | null;
1471
+ declare namespace OrderConfirmation {
1472
+ var neverConsentGate: string;
1473
+ }
1474
+
1475
+ /**
1476
+ * INTERNAL module — not exported from the package index (cartStorage
1477
+ * convention). The single storage seam for the visitor's consent choice. The
1478
+ * storage MEDIUM is chosen by HOST CLASS, and the two are never mixed:
1479
+ *
1480
+ * - PLATFORM SHARED HOSTS (getlandingsite.com, landingsite.dev, agncy.dev,
1481
+ * agcy.dev — many unrelated tenants under one suffix, none of it on the
1482
+ * Public Suffix List): PER-ORIGIN storage is authoritative and NO consent
1483
+ * cookie is written or read at all. localStorage first, sessionStorage
1484
+ * when localStorage is unavailable or refuses the write (same per-origin,
1485
+ * untossable property; it keeps the choice usable for the session). A
1486
+ * per-origin store cannot be written by a sibling tenant, and with no
1487
+ * cookie there is nothing for one to plant. Nothing is lost by dropping
1488
+ * the cookie here: one of these hosts serves ONE site, so there is no
1489
+ * www/apex split and no cross-subdomain sharing to preserve.
1490
+ * When neither store is writable nothing persists — the banner appears on
1491
+ * every load (fail-closed and honest) and a one-time console.warn makes
1492
+ * that diagnosable.
1493
+ * - EVERY OTHER HOST (custom domains, landingsite.ai, ...): the first-party
1494
+ * cookie `af-consent-${configId}` scoped to the registrable domain is
1495
+ * authoritative. Per-config-id names (nanoid's A-Za-z0-9_- alphabet is
1496
+ * cookie-name-safe, asserted in consentCookieName) mean two sites sharing
1497
+ * a registrable domain hold two distinct cookies that can never clobber
1498
+ * each other, and every write/clear here touches ONLY the caller's own
1499
+ * name. The domain scope survives the www/apex split and propagates across
1500
+ * subdomains — all of which belong to the site's owner, so the cookie is
1501
+ * honored as written. The registrable domain is derived conservatively by
1502
+ * try-set-and-verify (below), never from a bundled public-suffix list.
1503
+ * localStorage carries a MIRROR of the value — the change-notification
1504
+ * channel (`storage` events never fire for cookies). When the cookie is
1505
+ * absent, only rejection-only mirrors may be rescued: another subdomain
1506
+ * may have revoked an old origin mirror's grants before cookie eviction.
1507
+ * - Reads validate FAIL-CLOSED (R3/R13/D8). Malformed, unsupported, and
1508
+ * unverified values stay in place until replaced by a choice or explicitly
1509
+ * cleared. Deleting their evidence would let the next load treat a prior
1510
+ * rejection as a new visitor's opt-out permission. Genuine expiry alone
1511
+ * returns to first-visit policy and may be cleaned up.
1512
+ * - ONE access path serves every reader: readConsentRecord (may clear),
1513
+ * peekConsentRecord and peekConsentStatus (never write, never clear) all
1514
+ * classify through inspectStoredRecord, so the exported reader and the
1515
+ * engine can never disagree about what a stored value means.
1516
+ * - Geography is NEVER stored (origin geo purpose-limitation): the record is
1517
+ * `cid` is the site's consent config id (tenant isolation), not a location.
1518
+ * Optional revision and GPC-override provenance describe the choice.
1519
+ */
1520
+ type ConsentCategory = 'functional' | 'analytics' | 'advertising';
1521
+ interface ConsentGrants {
1522
+ functional: boolean;
1523
+ analytics: boolean;
1524
+ advertising: boolean;
1525
+ }
1526
+
1527
+ /** Site-owned facts used by the consent UI and the website maintenance agent. */
1528
+ interface ConsentIntegration {
1529
+ id: string;
1530
+ vendor: string;
1531
+ categories: readonly ConsentCategory[];
1532
+ purpose: string;
1533
+ /** Repo-relative location of the integration, for inspection and repair. */
1534
+ source: string;
1535
+ policyUrl?: string;
1536
+ storage?: string;
1537
+ }
1538
+ interface ConsentManifest {
1539
+ /** Change for a new recipient or materially changed purpose, not styling. */
1540
+ revision: string;
1541
+ /** Published same-site path; keeps disclosures available on returning visits. */
1542
+ policyPath: string;
1543
+ integrations: readonly ConsentIntegration[];
1544
+ }
1545
+
1546
+ /** Shared reference copy; legal approval is tracked separately from source. */
1547
+ interface ConsentDisclosureStrings {
1548
+ /** Optional shared fallback for copy that is accurate in every regime.
1549
+ * For translated permission explanations, supply all three variants below. */
1550
+ beforeLink?: string;
1551
+ /** Optional services wait for permission. */
1552
+ beforeLinkStrict?: string;
1553
+ /** Functional services may run; analytics and advertising wait. */
1554
+ beforeLinkStrictTrackers?: string;
1555
+ /** Optional services may run before a choice, with standing opt-out controls. */
1556
+ beforeLinkOptOut?: string;
1557
+ linkText: string;
1558
+ afterLink: string;
1559
+ }
1560
+ interface ConsentBannerDisclosureProps {
1561
+ strings?: Partial<ConsentDisclosureStrings>;
1562
+ className?: string;
1563
+ style?: CSSProperties;
1564
+ }
1565
+ /** Permission-aware disclosure shared by custom layouts and the fallback. */
1566
+ declare function ConsentBannerDisclosure({ strings, className, style }: ConsentBannerDisclosureProps): react_jsx_runtime.JSX.Element;
1567
+ declare namespace ConsentBannerDisclosure {
1568
+ var displayName: string;
1569
+ }
1570
+ /**
1571
+ * PUBLIC SHAPE — mirrored by hand. Changing the props here means updating
1572
+ * landingsite-modal agent/test/fixtures/aifeatures-react.d.ts, which is what
1573
+ * type-checks the snippets the site-builder agent emits. CI there catches a
1574
+ * snippet that disagrees with the mirror; nothing catches the mirror
1575
+ * disagreeing with THIS file except someone remembering it exists.
1576
+ */
1577
+ interface ConsentBannerProps {
1578
+ /** Agent-authored first layer for the strict shape — must contain
1579
+ * `ConsentBanner.AcceptAll`, `ConsentBanner.RejectAll`, and
1580
+ * `ConsentBanner.Preferences` among its descendants. */
1581
+ strict?: ReactNode;
1582
+ /** Agent-authored first layer for the soft shape — must contain
1583
+ * `ConsentBanner.AcceptAll` and `ConsentBanner.Preferences`.
1584
+ *
1585
+ * Only ever painted under mode `adaptive-with-notice`: the default
1586
+ * `adaptive` shows no first layer outside the opt-in regions, so sites
1587
+ * that never opt in leave this undefined. Flipping the mode on without
1588
+ * authoring it falls back to the built-in bar — usable, but not site-styled,
1589
+ * which is why the guidance pairs the mode change with authoring this. */
1590
+ soft?: ReactNode;
1591
+ className?: string;
1592
+ style?: CSSProperties;
1593
+ 'aria-label'?: string;
1594
+ }
1595
+ interface SlotButtonProps {
1596
+ children?: ReactNode;
1597
+ className?: string;
1598
+ style?: CSSProperties;
1599
+ }
1600
+ /** Free-form content area for the agent-authored layer — a plain container
1601
+ * carrying no wiring; present for symmetry with the action slots. */
1602
+ declare function ConsentBannerContent({ children, className, style, }: SlotButtonProps): react_jsx_runtime.JSX.Element;
1603
+ declare namespace ConsentBannerContent {
1604
+ var displayName: string;
1605
+ }
1606
+ /**
1607
+ * The first consent layer (R1/R9). The agent authors BOTH shapes — strict
1608
+ * (equal-prominence Accept All / Reject All + Preferences) and soft (Accept +
1609
+ * Preferences link) — via the `strict` / `soft` props; the engine picks the
1610
+ * one matching the shape verdict resolved for this visitor, and the painted
1611
+ * shape never swaps. The slot subcomponents carry the wiring (actions, focus,
1612
+ * keyboard, ARIA); the agent supplies labels and styling.
1613
+ *
1614
+ * Structural floor: after mount the banner verifies the active shape's
1615
+ * mandatory slots are present among its rendered descendants; when a slot is
1616
+ * missing (or no markup was authored for the active shape) it renders the
1617
+ * built-in, neutrally-styled default banner with the canonical copy instead.
1618
+ *
1619
+ * Non-blocking by contract: a fixed bar, no overlay, no dismiss control, and
1620
+ * Escape does nothing — the page stays fully usable and ignoring the banner
1621
+ * leaves the current geographic permission policy in place.
1622
+ *
1623
+ * @example
1624
+ * ```tsx
1625
+ * <ConsentBanner
1626
+ * strict={
1627
+ * <ConsentBanner.Content>
1628
+ * <p>...translated disclosure...</p>
1629
+ * <ConsentBanner.AcceptAll>Accept all</ConsentBanner.AcceptAll>
1630
+ * <ConsentBanner.RejectAll>Use only necessary</ConsentBanner.RejectAll>
1631
+ * <ConsentBanner.Preferences>Preferences</ConsentBanner.Preferences>
1632
+ * </ConsentBanner.Content>
1633
+ * }
1634
+ * soft={
1635
+ * <ConsentBanner.Content>
1636
+ * <p>...translated disclosure...</p>
1637
+ * <ConsentBanner.AcceptAll>Accept</ConsentBanner.AcceptAll>
1638
+ * <ConsentBanner.Preferences>Preferences</ConsentBanner.Preferences>
1639
+ * </ConsentBanner.Content>
1640
+ * }
1641
+ * />
1642
+ * ```
1643
+ */
1644
+ declare function ConsentBanner({ strict, soft, className, style, 'aria-label': ariaLabel, }: ConsentBannerProps): react_jsx_runtime.JSX.Element | null;
1645
+ declare namespace ConsentBanner {
1646
+ var AcceptAll: {
1647
+ ({ children, className, style }: SlotButtonProps): react_jsx_runtime.JSX.Element;
1648
+ displayName: string;
1649
+ };
1650
+ var RejectAll: {
1651
+ ({ children, className, style }: SlotButtonProps): react_jsx_runtime.JSX.Element;
1652
+ displayName: string;
1653
+ };
1654
+ var Preferences: {
1655
+ ({ children, className, style }: SlotButtonProps): react_jsx_runtime.JSX.Element;
1656
+ displayName: string;
1657
+ };
1658
+ var Content: typeof ConsentBannerContent;
1659
+ var Disclosure: typeof ConsentBannerDisclosure;
1660
+ }
1661
+
1662
+ type PreferencesStrings = typeof DEFAULT_PREFERENCES_STRINGS;
1663
+ declare const DEFAULT_PREFERENCES_STRINGS: {
1664
+ title: string;
1665
+ description: string;
1666
+ essentialLabel: string;
1667
+ essentialDescription: string;
1668
+ essentialAlwaysActive: string;
1669
+ functionalLabel: string;
1670
+ functionalDescription: string;
1671
+ analyticsLabel: string;
1672
+ analyticsDescription: string;
1673
+ advertisingLabel: string;
1674
+ advertisingDescription: string;
1675
+ allowAll: string;
1676
+ declineAll: string;
1677
+ save: string;
1678
+ close: string;
1679
+ policyLink: string;
1680
+ categoryScope: string;
1681
+ gpcOverrideDescription: string;
1682
+ gpcOverrideLabel: string;
1683
+ gpcOverridden: string;
1684
+ /**
1685
+ * Shown only while a Global Privacy Control signal is present. This is a
1686
+ * REGULATORY string, not decoration: 11 CCR §7025(c)(6) took effect
1687
+ * 2026-01-01 and requires a business that processes an opt-out preference
1688
+ * signal to display that it did so. The wording follows the regulation's own
1689
+ * example, "Opt-Out Request Honored", rather than the "Opt-Out Preference
1690
+ * Signal Honored" phrasing that circulates in secondary summaries.
1691
+ *
1692
+ * Translatable like every other string here — the DUTY is to tell the
1693
+ * visitor, not to say it in English.
1694
+ */
1695
+ gpcHonored: string;
1696
+ };
1697
+ interface ConsentThemeTokens {
1698
+ /** Panel background color (hex). */
1699
+ background?: string;
1700
+ /** Panel text color (hex). */
1701
+ text?: string;
1702
+ /** Panel border color (hex). */
1703
+ border?: string;
1704
+ /** Primary action (Allow all) background color (hex). */
1705
+ primaryBackground?: string;
1706
+ /** Primary action (Allow all) text color (hex). */
1707
+ primaryText?: string;
1708
+ /** Backdrop color (any CSS color). */
1709
+ overlay?: string;
1710
+ }
1711
+ /**
1712
+ * PUBLIC SHAPE — mirrored by hand. Changing the props here means updating
1713
+ * landingsite-modal agent/test/fixtures/aifeatures-react.d.ts, which is what
1714
+ * type-checks the snippets the site-builder agent emits. CI there catches a
1715
+ * snippet that disagrees with the mirror; nothing catches the mirror
1716
+ * disagreeing with THIS file except someone remembering it exists.
1717
+ */
1718
+ interface PreferencesPanelProps {
1719
+ /** Per-string overrides — the agent fills these with site-language
1720
+ * translations; structure and behavior are fixed regardless (R7). */
1721
+ strings?: Partial<PreferencesStrings>;
1722
+ /** CSS-variable theme tokens from the site's palette. The primary action
1723
+ * pair is contrast-clamped: below 4.5:1 it falls back to the defaults. */
1724
+ theme?: ConsentThemeTokens;
1725
+ className?: string;
1726
+ /** @internal Provider-rendered fallback instance — skips registration. */
1727
+ __fallback?: boolean;
1728
+ }
1729
+ /**
1730
+ * The standardized Preferences layer (R7) — component-rendered, never
1731
+ * AI-authored: per-category toggles (essential shows "Always active"), Allow
1732
+ * All / Decline All (apply + persist + close immediately), Save (persist the
1733
+ * current toggles + close), and a close control that discards unsaved
1734
+ * changes. First open shows every non-essential toggle OFF; re-open
1735
+ * pre-populates from the stored choice. Renders as a focus-trapped modal
1736
+ * (bottom sheet on small viewports); the provider opens it via
1737
+ * `openPreferences()` and returns focus to the invoking control on close.
1738
+ *
1739
+ * Mount it once inside the provider to customize strings/theme — when no
1740
+ * instance is mounted the provider renders this component itself with
1741
+ * defaults, so Preferences is always reachable.
1742
+ *
1743
+ * @example
1744
+ * ```tsx
1745
+ * <PreferencesPanel
1746
+ * strings={{ title: 'Cookie-Einstellungen', allowAll: 'Alle erlauben' }}
1747
+ * theme={{ primaryBackground: '#0f766e', primaryText: '#ffffff' }}
1748
+ * />
1749
+ * ```
1750
+ */
1751
+ declare function PreferencesPanel({ strings, theme, className, __fallback, }: PreferencesPanelProps): react_jsx_runtime.JSX.Element | null;
1752
+
1753
+ /** Exactly one of `category` / `categories` — the pair is a discriminated
1754
+ * union, so passing both (or neither) is a compile error rather than silently
1755
+ * hidden content. `categories` is the multi-category rule GatedScript uses
1756
+ * (R10): the content renders only when EVERY listed category is granted. */
1757
+ type CategoryProps$1 = {
1758
+ category: ConsentCategory;
1759
+ categories?: never;
1760
+ } | {
1761
+ categories: ConsentCategory[];
1762
+ category?: never;
1763
+ };
1764
+ type GatedContentStrings = typeof DEFAULT_GATED_CONTENT_STRINGS;
1765
+ /** The placeholder identifies the recipient and opens category-wide
1766
+ * preferences. Its button never records consent by itself. */
1767
+ declare const DEFAULT_GATED_CONTENT_STRINGS: {
1768
+ title: string;
1769
+ bodyBeforeVendor: string;
1770
+ bodyAfterVendor: string;
1771
+ scope: string;
1772
+ action: string;
1773
+ };
1774
+ /**
1775
+ * PUBLIC SHAPE — mirrored by hand. Changing the props here means updating
1776
+ * landingsite-modal agent/test/fixtures/aifeatures-react.d.ts, which is what
1777
+ * type-checks the snippets the site-builder agent emits. CI there catches a
1778
+ * snippet that disagrees with the mirror; nothing catches the mirror
1779
+ * disagreeing with THIS file except someone remembering it exists.
1780
+ */
1781
+ type GatedContentProps = CategoryProps$1 & {
1782
+ /** Rendered only once every listed category is granted. */
1783
+ children: ReactNode;
1784
+ /**
1785
+ * The third party the content comes from, named the way a visitor would
1786
+ * recognize them — "YouTube (Google Ireland Ltd.)", "Calendly".
1787
+ *
1788
+ * Passing this asks for the built-in preferences placeholder, which names
1789
+ * the recipient before visitors review the category. Omit it for an invisible
1790
+ * tracker — a pixel or a beacon has nothing to show and no hole to explain.
1791
+ */
1792
+ vendor?: string;
1793
+ /** Per-string overrides for the built-in placeholder — site-language
1794
+ * translations. Ignored when `fallback` replaces the placeholder wholesale. */
1795
+ strings?: Partial<GatedContentStrings>;
1796
+ /**
1797
+ * Replaces the built-in placeholder entirely. Custom fallbacks should open
1798
+ * preferences so visitors can review all recipients in the category.
1799
+ */
1800
+ fallback?: ReactNode;
1801
+ };
1802
+ declare function GatedContent({ category, categories, children, vendor, strings, fallback, }: GatedContentProps): react_jsx_runtime.JSX.Element | null;
1803
+
1804
+ /** Complete visitor copy, selected once on the provider. Site integration facts
1805
+ * still need translation in the manifest. Copy overrides do not change grants. */
1806
+ interface ConsentLocale {
1807
+ regionLabel: string;
1808
+ settingsLabel: string;
1809
+ actions: {
1810
+ acceptAll: string;
1811
+ rejectAll: string;
1812
+ preferences: string;
1813
+ softAccept: string;
1814
+ };
1815
+ disclosure: Required<Omit<ConsentDisclosureStrings, 'beforeLink'>>;
1816
+ preferences: PreferencesStrings;
1817
+ gatedContent: GatedContentStrings;
1818
+ policy: {
1819
+ title: string;
1820
+ strict: string;
1821
+ adaptive: string;
1822
+ off: string;
1823
+ unresolved: string;
1824
+ choices: string;
1825
+ empty: string;
1826
+ };
1827
+ }
1828
+ /** Built-in translations. pt uses Brazilian Portuguese; zh uses Simplified
1829
+ * Chinese; nb uses Norwegian Bokmål. Select a preset using the site's language.
1830
+ * Custom complete ConsentLocale objects and component overrides still work.
1831
+ * These reference translations are not a claim of legal approval.
1832
+ * Keep this declaration compact: agents need the keys and schema, not 20
1833
+ * repeated object shapes when inspecting the installed package's types. */
1834
+ declare const consentLocales: Record<'en' | 'es' | 'ar' | 'fr' | 'de' | 'it' | 'pt' | 'nl' | 'pl' | 'sv' | 'da' | 'nb' | 'fi' | 'tr' | 'ru' | 'uk' | 'ja' | 'ko' | 'zh' | 'hi', ConsentLocale>;
1835
+
1836
+ interface ConsentProviderProps {
1837
+ /** Complete UI copy, including fallback controls. Defaults to English. */
1838
+ locale?: ConsentLocale;
1839
+ /** Consent config ID from aifeatures (returned by setup_cookie_consent). */
1840
+ configId: string;
1841
+ /** Consent runtime base URL. Defaults to the site's same-origin /_ls service. */
1842
+ apiUrl?: string;
1843
+ /** Accessible label for the floating cookie-settings badge the provider
1844
+ * renders when no CookieSettingsLink is mounted. Defaults to the provider
1845
+ * locale's settingsLabel; pass this only to override that wording. */
1846
+ badgeLabel?: string;
1847
+ /** Published integration disclosures. A material revision requires a new choice. */
1848
+ manifest?: ConsentManifest;
1849
+ children?: ReactNode;
1850
+ }
1851
+ /**
1852
+ * The consent engine (cookie-consent plan D1): owns the stored choice, the
1853
+ * config + geo fetches, GPC, the grant map, and the gated-script registry.
1854
+ * Wrap the app in it once; register trackers with `<GatedScript>`, author the
1855
+ * first layer with `<ConsentBanner>`, and read state with `useConsent()`.
1856
+ *
1857
+ * First-paint contract (R13): SSG/prerender renders children and nothing
1858
+ * else; on hydration a valid stored choice applies with ZERO network; only a
1859
+ * choice-less visitor triggers the parallel config + geo fetches, and the
1860
+ * banner renders once — the painted shape never swaps. Every failure path is
1861
+ * strict: optional integrations wait for a choice unless a resolved policy
1862
+ * explicitly permits the category before a choice.
1863
+ *
1864
+ * @example
1865
+ * ```tsx
1866
+ * <ConsentProvider configId={consentConfigId}>
1867
+ * <App />
1868
+ * <GatedScript category="analytics" src="https://www.googletagmanager.com/gtag/js?id=G-XXXX" />
1869
+ * <ConsentBanner strict={...} soft={...} />
1870
+ * <PreferencesPanel />
1871
+ * </ConsentProvider>
1872
+ * ```
1873
+ */
1874
+ declare function ConsentProvider({ configId, apiUrl, locale, badgeLabel, manifest, children, }: ConsentProviderProps): react_jsx_runtime.JSX.Element;
1875
+
1876
+ /** Exactly one of `category` / `categories` — the pair is a discriminated
1877
+ * union, so passing both (or neither) is a compile error rather than a
1878
+ * silently blocked script. `categories` is the multi-category GTM rule (R10):
1879
+ * the script loads only when EVERY listed category is granted. */
1880
+ type CategoryProps = {
1881
+ category: ConsentCategory;
1882
+ categories?: never;
1883
+ } | {
1884
+ categories: ConsentCategory[];
1885
+ category?: never;
1886
+ };
1887
+ /** Exactly one payload: an external `src` or inline code as `children`. */
1888
+ type PayloadProps = {
1889
+ src: string;
1890
+ children?: never;
1891
+ } | {
1892
+ children: string;
1893
+ src?: never;
1894
+ };
1895
+ /**
1896
+ * PUBLIC SHAPE — mirrored by hand. Changing the props here means updating
1897
+ * landingsite-modal agent/test/fixtures/aifeatures-react.d.ts, which is what
1898
+ * type-checks the snippets the site-builder agent emits. CI there catches a
1899
+ * snippet that disagrees with the mirror; nothing catches the mirror
1900
+ * disagreeing with THIS file except someone remembering it exists.
1901
+ */
1902
+ type GatedScriptProps = CategoryProps & PayloadProps & {
1903
+ /** Stable registration id — defaults to `src` (or a hash of the inline
1904
+ * code). Set it when the same src is registered twice on purpose. */
1905
+ id?: string;
1906
+ };
1907
+ /**
1908
+ * Registers a third-party script with the consent engine and renders nothing.
1909
+ * The provider injects the actual `<script>` element only once every listed
1910
+ * category is granted — so accepting applies without a reload, and until a
1911
+ * choice exists (or the owner set mode 'off') the script never executes and
1912
+ * never emits a request (R2 hard block).
1913
+ *
1914
+ * Unmounting removes the REGISTRATION but never an already-injected script:
1915
+ * un-running a script is impossible, consistent with R4's best-effort
1916
+ * withdrawal contract (a new choice fully applies from the next page load).
1917
+ *
1918
+ * UNSUPPORTED placement: inside a ConsentBanner layer. acceptAll unmounts the
1919
+ * banner, unregistering the script before its grant ever applies — it would
1920
+ * never inject. Mount GatedScript at the page level; a console.warn flags the
1921
+ * mistake in development.
1922
+ *
1923
+ * @example
1924
+ * ```tsx
1925
+ * <GatedScript category="analytics" src="https://www.googletagmanager.com/gtag/js?id=G-XXXX" />
1926
+ * <GatedScript category="analytics">{`window.dataLayer = window.dataLayer || [];`}</GatedScript>
1927
+ * <GatedScript categories={['analytics', 'advertising']} src="https://www.googletagmanager.com/gtm.js?id=GTM-XXXX" />
1928
+ * ```
1929
+ */
1930
+ declare function GatedScript({ category, categories, src, children, id, }: GatedScriptProps): null;
1931
+
1932
+ /**
1933
+ * PUBLIC SHAPE — mirrored by hand. Changing the props here means updating
1934
+ * landingsite-modal agent/test/fixtures/aifeatures-react.d.ts, which is what
1935
+ * type-checks the snippets the site-builder agent emits. CI there catches a
1936
+ * snippet that disagrees with the mirror; nothing catches the mirror
1937
+ * disagreeing with THIS file except someone remembering it exists.
1938
+ */
1939
+ interface CookieSettingsLinkProps {
1940
+ /** Link text — defaults to "Cookie settings". */
1941
+ children?: ReactNode;
1942
+ className?: string;
1943
+ style?: CSSProperties;
1944
+ }
1945
+ /**
1946
+ * The persistent re-open affordance (R4): a link-styled button that opens the
1947
+ * Preferences layer with the visitor's current per-category state. Place it
1948
+ * in the site footer on every page. When no CookieSettingsLink is mounted
1949
+ * anywhere, the provider renders a floating-badge fallback instead — so
1950
+ * withdrawal is always reachable.
1951
+ *
1952
+ * @example
1953
+ * ```tsx
1954
+ * <footer>
1955
+ * <CookieSettingsLink>Cookie settings</CookieSettingsLink>
1956
+ * </footer>
1957
+ * ```
1958
+ */
1959
+ declare function CookieSettingsLink({ children, className, style, }: CookieSettingsLinkProps): react_jsx_runtime.JSX.Element;
1960
+
1961
+ /**
1962
+ * The public consent surface — grants and actions ONLY. The provider's
1963
+ * resolved geography (country/region/shape) is deliberately absent from this
1964
+ * type and must never be added: the geo verdict is purpose-limited to the
1965
+ * banner's shape selection (plan D1 privacy boundary).
1966
+ */
1967
+ /**
1968
+ * PUBLIC SHAPE — mirrored by hand. Changing the props here means updating
1969
+ * landingsite-modal agent/test/fixtures/aifeatures-react.d.ts, which is what
1970
+ * type-checks the snippets the site-builder agent emits. CI there catches a
1971
+ * snippet that disagrees with the mirror; nothing catches the mirror
1972
+ * disagreeing with THIS file except someone remembering it exists.
1973
+ */
1974
+ interface UseConsentResult {
1975
+ /**
1976
+ * What is ALLOWED TO RUN — the EFFECTIVE grants, the same map `<GatedScript>`
1977
+ * and `<GatedContent>` gate on. Permissions may be granted before a choice
1978
+ * by the resolved regional/owner policy. Saved refusals and GPC still apply.
1979
+ * Never infer the owner's mode from grants or `hasChoice`.
1980
+ */
1981
+ grants: ConsentGrants;
1982
+ /** True once a valid stored choice exists, including a refusal saved in off mode. */
1983
+ hasChoice: boolean;
1984
+ /** Grant all categories (under Global Privacy Control, advertising stays
1985
+ * withheld — R16). Persists for 12 months. */
1986
+ acceptAll: () => void;
1987
+ /** Decline all non-essential categories. Persists for 12 months. */
1988
+ rejectAll: () => void;
1989
+ /** Persist a per-category choice. GPC still withholds advertising; the
1990
+ * shared PreferencesPanel owns the separately acknowledged override flow. */
1991
+ save: (grants: ConsentGrants) => void;
1992
+ /** Open the Preferences layer showing the current per-category state. */
1993
+ openPreferences: () => void;
1994
+ }
1995
+ /**
1996
+ * Read and change the visitor's consent state. Throws outside a
1997
+ * `<ConsentProvider>`.
1998
+ *
1999
+ * `grants` answers "may I do this thing?", not "what did the visitor click?" —
2000
+ * it is the EFFECTIVE map used by all shared gates. Run SDK effects only in
2001
+ * an allowed child, and dynamically import side-effectful modules there:
2002
+ *
2003
+ * @example
2004
+ * ```tsx
2005
+ * function AnalyticsSession() {
2006
+ * useEffect(() => {
2007
+ * let cancelled = false;
2008
+ * let stop: undefined | (() => void);
2009
+ * void import('./analytics').then(({ start }) => {
2010
+ * if (!cancelled) stop = start(); // start returns the SDK's teardown
2011
+ * });
2012
+ * return () => { cancelled = true; stop?.(); };
2013
+ * }, []);
2014
+ * return null;
2015
+ * }
2016
+ * // Inside the root ConsentProvider, outside ConsentBanner:
2017
+ * <GatedContent category="analytics"><AnalyticsSession /></GatedContent>
2018
+ * ```
2019
+ */
2020
+ declare function useConsent(): UseConsentResult;
1423
2021
 
1424
2022
  /**
1425
2023
  * The recurring price a plan derives from a base one-time price, in minor
@@ -1507,7 +2105,9 @@ interface PlanPickerProps {
1507
2105
  * planId>` (a selected plan locks quantity at 1 and switches the CTA to
1508
2106
  * "Subscribe").
1509
2107
  *
1510
- * Degraded states (plan §Unit 8, default copy is deliberate):
2108
+ * In the editor frame, configured plans remain selectable before payments or
2109
+ * the account route are ready so the merchant can rehearse a test signup.
2110
+ * Degraded states outside the editor (plan §Unit 8):
1511
2111
  * - no subscription block → renders nothing (one-time only);
1512
2112
  * - `ready: false`, not required → renders nothing — plans are silently
1513
2113
  * hidden, the one-time path is untouched, no error surface;
@@ -1515,6 +2115,9 @@ interface PlanPickerProps {
1515
2115
  * (renderUnavailable), with no purchase controls and no reason given.
1516
2116
  */
1517
2117
  declare function PlanPicker({ product, subscription: subscriptionProp, baseUnitAmount, currency, value, onChange, className, style, optionClassName, selectedOptionClassName, oneTimeLabel, renderOption, renderUnavailable, }: PlanPickerProps): react_jsx_runtime.JSX.Element | null;
2118
+ declare namespace PlanPicker {
2119
+ var neverConsentGate: string;
2120
+ }
1518
2121
 
1519
2122
  interface StoredSessionCustomer {
1520
2123
  email: string;
@@ -1665,6 +2268,9 @@ interface AccountLoginProps {
1665
2268
  * check-your-email state is skipped.
1666
2269
  */
1667
2270
  declare function AccountLogin({ apiUrl, session: sessionProp, resendDelayMs, className, style, renderForm, renderSent, renderUnavailable, }: AccountLoginProps): react_jsx_runtime.JSX.Element;
2271
+ declare namespace AccountLogin {
2272
+ var neverConsentGate: string;
2273
+ }
1668
2274
 
1669
2275
  interface AccountPagePmBannerContext {
1670
2276
  /** 'retrying' while a subscription is still past_due after the card
@@ -1731,6 +2337,9 @@ interface AccountPageProps {
1731
2337
  * the buyer on this page.
1732
2338
  */
1733
2339
  declare function AccountPage({ apiUrl, className, style, resendDelayMs, loginProps, renderLoading, renderError, renderEmpty, renderHeader, renderPmBanner, renderManageExpired, }: AccountPageProps): react_jsx_runtime.JSX.Element;
2340
+ declare namespace AccountPage {
2341
+ var neverConsentGate: string;
2342
+ }
1734
2343
 
1735
2344
  /**
1736
2345
  * INTERNAL module — shared wire types + fetch classification for the
@@ -1852,6 +2461,9 @@ interface AccountOrdersProps {
1852
2461
  * defaults; restyle via className or replace rows via renderOrder.
1853
2462
  */
1854
2463
  declare function AccountOrders({ orders, className, style, heading, renderEmpty, renderOrder, }: AccountOrdersProps): react_jsx_runtime.JSX.Element;
2464
+ declare namespace AccountOrders {
2465
+ var neverConsentGate: string;
2466
+ }
1855
2467
 
1856
2468
  /**
1857
2469
  * Which doorway this list acts through:
@@ -1947,5 +2559,20 @@ interface SubscriptionListProps {
1947
2559
  * path onward is resubscribing on the product page.
1948
2560
  */
1949
2561
  declare function SubscriptionList({ apiUrl, subscriptions, auth, onAuthError, onUnavailable, onSubscriptionChange, className, style, heading, renderEmpty, renderRow, }: SubscriptionListProps): react_jsx_runtime.JSX.Element;
2562
+ declare namespace SubscriptionList {
2563
+ var neverConsentGate: string;
2564
+ }
2565
+
2566
+ interface ConsentPolicyDetailsProps {
2567
+ className?: string;
2568
+ style?: CSSProperties;
2569
+ }
2570
+ /** The changing part of a site's cookie policy. Reads the SAME manifest and
2571
+ * resolved owner setting as the provider; it never adds a geo/config request.
2572
+ * Returning visitors can use saved choices without resolving mode, so that
2573
+ * path uses conditional wording instead of guessing the current owner setting.
2574
+ * Add controller/contact, essential services and other site-specific policy
2575
+ * facts around this section. It is not a complete legal policy. */
2576
+ declare function ConsentPolicyDetails({ className, style }: ConsentPolicyDetailsProps): react_jsx_runtime.JSX.Element;
1950
2577
 
1951
- export { AccountLogin, type AccountLoginFormContext, type AccountLoginProps, type AccountLoginSentContext, type AccountMePayload, type AccountOrder, AccountOrders, type AccountOrdersProps, AccountPage, type AccountPagePmBannerContext, type AccountPageProps, type AccountShippingAddressInput, type AccountSubscription, type AddCartLineInput, AddToCartButton, type AddToCartButtonProps, type AddToCartResult, AifeaturesCaptcha, type AifeaturesCaptchaProps, BuyButton, type BuyButtonProps, CartCheckoutButton, type CartCheckoutButtonProps, type CartCheckoutLine, type CartConflictItem, type CartItemLine, type CartLine, type CartLineDisplay, type CartLineStatus, type CartSummary, type CartSummaryShipping, type CartSummaryShippingOption, type LoginResult, MARKET_COUNTRIES, MAX_CART_LINES, type MarketCountry, OrderConfirmation, type OrderConfirmationProps, type OrderFulfillment, type OrderSession, type OrderSessionLineItem, type OrderSessionSubscription, type OrderStatus, PlanPicker, type PlanPickerOptionContext, type PlanPickerProps, ProductPrice, type ProductPriceProps, type PublicOption, type PublicOptionValue, type PublicProduct, type PublicProductSubscription, type PublicSubscriptionPlan, type PublicVariant, type PublicVariantOptionValue, type SessionCustomer, type SessionReason, type SessionStatus, type ShippingOptionConflict, type StartCartCheckoutOptions, type StartCheckoutOptions, SubscriptionList, type SubscriptionListAuth, type SubscriptionListProps, type SubscriptionMutationState, type SubscriptionRowContext, type UseCartCheckoutOptions, type UseCartCheckoutResult, type UseCartItemsOptions, type UseCartItemsResult, type UseCartResult, type UseCartSummaryOptions, type UseCartSummaryResult, type UseCheckoutOptions, type UseCheckoutResult, type UseMarketOptions, type UseMarketResult, type UseProductOptions, type UseProductResult, type UseSessionOptions, type UseSessionResult, VariantPicker, type VariantPickerProps, type VariantSelection, type VerifyResult, ZERO_DECIMAL_CURRENCIES, applySelectionToUrl, formatPrice, getOptions, getVariants, isMultiVariant, isValueAvailable, isValueInCatalog, planRecurringAmount, reanchorSelection, resolveVariant, searchFromSelection, selectedImages, selectedValues, selectionFromSearch, useCart, useCartCheckout, useCartItems, useCartSummary, useCheckout, useMarket, useProduct, useSession, valueSlug, variantPriceRange };
2578
+ export { AccountLogin, type AccountLoginFormContext, type AccountLoginProps, type AccountLoginSentContext, type AccountMePayload, type AccountOrder, AccountOrders, type AccountOrdersProps, AccountPage, type AccountPagePmBannerContext, type AccountPageProps, type AccountShippingAddressInput, type AccountSubscription, type AddCartLineInput, AddToCartButton, type AddToCartButtonProps, type AddToCartResult, AifeaturesCaptcha, type AifeaturesCaptchaProps, BuyButton, type BuyButtonProps, CartCheckoutButton, type CartCheckoutButtonProps, type CartCheckoutLine, type CartConflictItem, type CartItemLine, type CartLine, type CartLineDisplay, type CartLineStatus, type CartSummary, type CartSummaryShipping, type CartSummaryShippingOption, ConsentBanner, type ConsentBannerDisclosureProps, type ConsentBannerProps, type ConsentCategory, type ConsentDisclosureStrings, type ConsentGrants, type ConsentIntegration, type ConsentLocale, type ConsentManifest, ConsentPolicyDetails, type ConsentPolicyDetailsProps, ConsentProvider, type ConsentProviderProps, type ConsentThemeTokens, CookieSettingsLink, type CookieSettingsLinkProps, GatedContent, type GatedContentProps, type GatedContentStrings, GatedScript, type GatedScriptProps, type LoginResult, MARKET_COUNTRIES, MAX_CART_LINES, type MarketCountry, OrderConfirmation, type OrderConfirmationProps, type OrderFulfillment, type OrderSession, type OrderSessionLineItem, type OrderSessionSubscription, type OrderStatus, PlanPicker, type PlanPickerOptionContext, type PlanPickerProps, PreferencesPanel, type PreferencesPanelProps, type PreferencesStrings, ProductPrice, type ProductPriceProps, type PublicOption, type PublicOptionValue, type PublicProduct, type PublicProductSubscription, type PublicSubscriptionPlan, type PublicVariant, type PublicVariantOptionValue, type SessionCustomer, type SessionReason, type SessionStatus, type ShippingOptionConflict, type StartCartCheckoutOptions, type StartCheckoutOptions, SubscriptionList, type SubscriptionListAuth, type SubscriptionListProps, type SubscriptionMutationState, type SubscriptionRowContext, type UseCartCheckoutOptions, type UseCartCheckoutResult, type UseCartItemsOptions, type UseCartItemsResult, type UseCartResult, type UseCartSummaryOptions, type UseCartSummaryResult, type UseCheckoutOptions, type UseCheckoutResult, type UseConsentResult, type UseMarketOptions, type UseMarketResult, type UseProductOptions, type UseProductResult, type UseSessionOptions, type UseSessionResult, VariantPicker, type VariantPickerProps, type VariantSelection, type VerifyResult, ZERO_DECIMAL_CURRENCIES, applySelectionToUrl, consentLocales, formatPrice, getOptions, getVariants, isMultiVariant, isValueAvailable, isValueInCatalog, planRecurringAmount, reanchorSelection, resolveVariant, searchFromSelection, selectedImages, selectedValues, selectionFromSearch, useCart, useCartCheckout, useCartItems, useCartSummary, useCheckout, useConsent, useMarket, useProduct, useSession, valueSlug, variantPriceRange };