@nextcommerce/campaigns-os 1.33.0

package/contracts/template-brand-contract.olympus-mv-two-step.v0.json

@@ -0,0 +1,28 @@
+{
+  "schema_version": "template-brand-contract/v0",
+  "family": "olympus-mv-two-step",
+  "extends": "template-brand-contract.shared-commerce.v0.json",
+  "description": "Brand contract for the Olympus MV two-step select-then-checkout starter-template family.",
+  "family_inventory": {
+    "supported_pages": ["landing", "presell", "select", "checkout", "upsell", "receipt"],
+    "required_sdk_anchors": {
+      "select": ["data-next-bundle-selector", "data-next-bundle-card"],
+      "checkout": ["data-next-bundle-slots-for", "data-next-bundle-slot-template-id", "data-next-payment-method", "data-next-cart-summary"],
+      "upsell": ["data-next-upsell", "data-next-bundle-selector", "data-next-bundle-slots-for"],
+      "receipt": ["data-next-order-items"]
+    },
+    "theme_insertion_point": "Load brand-theme.css from frontmatter styles after css/next-core.css on select, checkout, upsell, downsell, and receipt pages.",
+    "default_color_residue": ["#3c7dff", "#0a265c"],
+    "pricing_presentation": "Select-step bundle cards and checkout MV slots use SDK display modes for compare/current, unit-plus-total, savings, and full-price presentations.",
+    "bundle_picker": "Two-step flow: select page chooses cart/package, checkout stage resolves configurable variant slots.",
+    "order_bump": "Optional bump variants are valid only when prepurchase packages exist and must not sync line total unless specified.",
+    "upsell_downsell": "MV and bundle upsell includes use upsell_offer, upsell_mv_tiers, or upsell_bundle_tiers with visible price rows.",
+    "exit_pop": {
+      "default_included": false,
+      "include": "exit-intent-popup.html",
+      "default_coupon_codes": ["SAVE10"],
+      "behavior": "Available include only; strip unless CampaignSpec checkout exit_intent or promo_code_input maps an offer/code."
+    },
+    "qa_selectors": [".checkout-wrapper", ".submit-button", ".os-card.next-selected", ".price-wrapper", ".brand-logo"]
+  }
+}

package/contracts/template-brand-contract.olympus.v0.json

@@ -0,0 +1,27 @@
+{
+  "schema_version": "template-brand-contract/v0",
+  "family": "olympus",
+  "extends": "template-brand-contract.shared-commerce.v0.json",
+  "description": "Brand contract for the Olympus tiered-bundle starter-template family.",
+  "family_inventory": {
+    "supported_pages": ["landing", "presell", "checkout", "upsell", "receipt"],
+    "required_sdk_anchors": {
+      "checkout": ["data-next-bundle-selector", "data-next-bundle-card", "data-next-payment-method", "data-next-payment-form", "data-next-express-checkout"],
+      "upsell": ["data-next-upsell", "data-next-bundle-selector", "data-next-bundle-card"],
+      "receipt": ["data-next-order-items"]
+    },
+    "theme_insertion_point": "Load brand-theme.css from frontmatter styles after css/next-core.css on checkout, upsell, downsell, and receipt pages.",
+    "default_color_residue": ["#3c7dff", "#0a265c"],
+    "pricing_presentation": "Tiered checkout cards and bundle upsells support compare/current, savings badge/amount, unit-plus-total, and full-price modes through SDK display nodes.",
+    "bundle_picker": "Tiered bundle cards with data-next-bundle-selector and data-next-bundle-card anchors.",
+    "order_bump": "Pre-purchase bump variants use bump-check01.html or bump-switch01.html and data-next-package-toggle anchors.",
+    "upsell_downsell": "Bundle stepper, tier-pills, and tier-cards upsells require a visible price row above the accept CTA.",
+    "exit_pop": {
+      "default_included": false,
+      "include": "exit-intent-popup.html",
+      "default_coupon_codes": ["EXIT5"],
+      "behavior": "Available include only; strip unless CampaignSpec checkout exit_intent or promo_code_input maps an offer/code."
+    },
+    "qa_selectors": [".checkout-wrapper", ".submit-button", ".os-card.next-selected", ".price-wrapper", ".brand-logo"]
+  }
+}

package/contracts/template-brand-contract.shared-commerce.v0.json

@@ -0,0 +1,190 @@
+{
+  "schema_version": "template-brand-contract/v0",
+  "description": "Shared brand, residue, pricing, and offer-surface rules for starter-template commerce families that consume next-core.css brand tokens.",
+  "brand_tokens": {
+    "consumed_namespace": "--brand--*",
+    "required_overrides": [
+      "--brand--color--primary",
+      "--brand--color--primary-dark"
+    ],
+    "recommended_overrides": [
+      "--brand--color--cta-primary",
+      "--brand--color--primary-light",
+      "--brand--color--primary-lighter",
+      "--brand--color--rating-star"
+    ],
+    "forbidden_default_values": {
+      "--brand--color--primary": "#3c7dff",
+      "--brand--color--primary-dark": "#0a265c"
+    },
+    "note": "Starter commerce pages consume --brand--* tokens from next-core.css. Campaign-namespace tokens style custom source markup only; they never restyle SDK commerce surfaces unless mapped into --brand--* overrides."
+  },
+  "css_load_order": {
+    "core_stylesheet": "next-core.css",
+    "brand_layer": "brand-theme.css",
+    "rule": "brand_layer_after_core",
+    "applies_to_page_types": ["checkout", "select", "upsell", "downsell", "receipt"]
+  },
+  "default_residue": {
+    "logo": {
+      "asset": "images/next-logo.png",
+      "selector": "img.brand-logo",
+      "page_types": ["checkout", "select", "upsell", "downsell", "receipt"],
+      "rule": "Campaign brand logo must replace the starter next-logo.png on commerce pages unless the CampaignSpec store branding intentionally keeps it."
+    },
+    "payment_chrome": {
+      "methods": ["paypal", "klarna"],
+      "selectors": [
+        ".payment-method__icon--paypal-logo",
+        ".payment-method__icon--paypal-txt",
+        ".payment-method__icon--klarna-logo"
+      ],
+      "assets": [
+        "images/paypal.svg",
+        "images/paypal-logo.svg",
+        "images/paypal-txt.svg",
+        "images/klarna-logo.svg",
+        "images/upsell-payment-logos.svg"
+      ],
+      "asset_sha256": {
+        "images/paypal.svg": "7c84e9a91a694ca48ad6899325862bb509ba927281198d4c9d1c5da31de6054a",
+        "images/paypal-logo.svg": "adf9b3c556710fac2e0f2ecf748a1f82afd023d7957336ef228db33f1deb83d3",
+        "images/paypal-txt.svg": "65b5b5ac3704273a1a888af98295d7ef805682c6c3c24554349eb10ef7f6f2ef",
+        "images/klarna-logo.svg": "e0229bc62001597c3c2428e64c1032a53963f082b90560f8fad21c3c34a8bec6",
+        "images/upsell-payment-logos.svg": "54a8f046ae047a79d1318a98ac808cc61f15ca31cd1a232f7b5577405caa4936"
+      },
+      "asset_pin": {
+        "repo": "NextCommerceCo/campaign-cart-starter-templates",
+        "sha": "a7cc8beaf9d332c5d8e501d36fb9d4d7e3667468",
+        "path": "src/<family>/assets/<asset>",
+        "note": "asset_sha256 is the sha256 of each shipped starter asset at this commit (the commerce-surface-catalog _synced_from_sha pin; the bytes are identical across every family). A served asset whose bytes hash to the shipped value is the untouched starter asset and counts as residue even though its markup names no method; different bytes mean it was edited in place. check-template-doctrine verifies these hashes against the pinned checkout."
+      },
+      "rule": "Remove unless the method is listed in CampaignSpec available_payment_methods / available_express_payment_methods. Template chrome outside the SDK payment-method include counts as implied payment-method residue.",
+      "note": "paypal intentionally has two selectors. QA fails if any selector for an unsupported method remains visible."
+    }
+  },
+  "demo_assets": {
+    "page_types": ["checkout", "select", "upsell", "downsell", "receipt", "presell", "landing"],
+    "assets": ["images/1x1_1.svg", "images/1x1_2.svg"],
+    "rule": "Template demo placeholder assets (1x1 spacer SVGs, repeated benefit icons, starter imagery) must be re-skinned to the campaign's real assets before launch. Surviving demo assets are a warning, not a blocker: the agent should replace them rather than ship template placeholders. Declared per family; arrays replace on extends, so a family lists its own demo-asset set."
+  },
+  "qa_inspection": {
+    "forbidden_computed_colors": [
+      { "hex": "#3c7dff", "rgb": "rgb(60, 125, 255)", "token": "--brand--color--primary" },
+      { "hex": "#0a265c", "rgb": "rgb(10, 38, 92)", "token": "--brand--color--primary-dark" }
+    ],
+    "placeholder_text_residue": {
+      "page_types": ["checkout", "select", "upsell", "downsell", "receipt", "presell", "landing"],
+      "terms": ["Lorem", "lorem ipsum", "Placeholder", "TODO", "Product Name"],
+      "rule": "Rendered campaign output must not contain literal template placeholder copy. Every term is replaced from the CampaignSpec/design before QA; QA fails (blocker) on any match in visible page text, regardless of any theme-gate waiver. Matched on word boundaries, case-insensitive. Scope is governed by page_types: the blocker applies only to the listed campaign funnel page types (generic, non-funnel pages whose type is not listed are not checked). Narrow page_types to exempt a page type where placeholder copy is acceptable."
+    },
+    "computed_style_checks": [
+      {
+        "id": "checkout_submit_button",
+        "page_types": ["checkout"],
+        "selector": ".submit-button",
+        "properties": ["background-color", "border-color"],
+        "optional": false
+      },
+      {
+        "id": "selected_bundle_card",
+        "page_types": ["checkout", "select"],
+        "selector": ".os-card.next-selected",
+        "properties": ["border-color", "outline-color"],
+        "optional": true
+      },
+      {
+        "id": "announcement_bar",
+        "page_types": ["checkout", "upsell", "downsell"],
+        "selector": ".announcement",
+        "properties": ["background-color"],
+        "optional": true
+      },
+      {
+        "id": "bump_outline",
+        "page_types": ["checkout"],
+        "selector": "[data-next-package-sync='false'], .bump-offer, .order-bump",
+        "properties": ["border-color", "outline-color"],
+        "optional": true
+      },
+      {
+        "id": "upsell_accept_cta",
+        "page_types": ["upsell", "downsell"],
+        "selector": "[data-next-action='accept'], [data-next-upsell-action='add'], a[href*='upsell-accept'], .submit-button",
+        "properties": ["background-color"],
+        "optional": false
+      }
+    ]
+  },
+  "pricing_surfaces": {
+    "modes": ["full_price", "compare_at_current", "unit_price_plus_total", "savings_badge_amount", "code_discounted_post_checkout"],
+    "legacy_aliases": {
+      "discounted": "compare_at_current",
+      "compare_at": "compare_at_current",
+      "unit_total": "unit_price_plus_total",
+      "unit_only": "full_price"
+    },
+    "rule": "Pricing surfaces render via mode-driven partial arguments, never via campaign CSS that hides price rows. Campaign stylesheets must not apply display:none to price wrappers or SDK price displays.",
+    "same_price_strike_rule": "If no offer, voucher, compare-at value, or code-discounted post-checkout state governs an order bump, upsell, or downsell, render full_price only; do not show identical struck-through and current prices.",
+    "forbidden_css_hides": [
+      ".price-wrapper",
+      ".prices-text-wrapper",
+      ".price-display",
+      ".cart-price",
+      ".summary_price",
+      "[data-next-display*='price']"
+    ],
+    "surfaces": {
+      "checkout_bundle": {
+        "default_mode": "compare_at_current",
+        "price_row_selectors": [".price-wrapper", ".cart-price", "[data-next-bundle-display*='price']", "[data-next-display*='price']"]
+      },
+      "bump": {
+        "default_mode": "full_price",
+        "price_row_selectors": [".price-wrapper", ".cart-price", "[data-next-display*='price']"]
+      },
+      "upsell": {
+        "default_mode": "full_price",
+        "price_row_selectors": [".price-wrapper", ".price-display", ".summary_price", "[data-next-display*='price']"],
+        "visible_price_rows_by_mode": {
+          "full_price": 1,
+          "compare_at_current": 2,
+          "unit_price_plus_total": 2,
+          "savings_badge_amount": 2,
+          "code_discounted_post_checkout": 2
+        },
+        "note": "A full_price upsell shows exactly one visible price row adjacent to the accept control. Zero visible price rows on an upsell/downsell offer is a blocker."
+      }
+    }
+  },
+  "checkout_fields": {
+    "initial_hint_state": {
+      "rule": "Empty checkout fields must have a legible initial hint state: either visible labels, placeholder-style hints, or both. Accessible-only labels are not sufficient if the visible placeholder/hint text is stripped from empty inputs.",
+      "valid_patterns": ["visible_label", "placeholder_style_hint", "visible_label_plus_placeholder"],
+      "applies_to": ["customer", "shipping", "billing", "payment_hosted_fields"],
+      "surface_definitions": {
+        "customer": "Customer identity fields rendered by the checkout template, such as email and phone.",
+        "shipping": "Shipping address fields rendered by the checkout template.",
+        "billing": "Billing address fields rendered by the checkout template when distinct from shipping.",
+        "payment_hosted_fields": "Third-party hosted payment iframes or SDK-owned payment fields whose initial visible labels, placeholders, or frame hints must remain legible."
+      },
+      "polish_evidence_key": "checkout_review.field_labels"
+    }
+  },
+  "exit_pop": {
+    "requires_spec_surface": ["exit_intent", "promo_code_input"],
+    "residue_literals": [
+      "exit-intent-popup",
+      "data-template=\"exit-intent\"",
+      "data-exit-intent-action",
+      "data-coupon-code=\"EXIT5\"",
+      "data-coupon-code=\"EXIT10\"",
+      "data-coupon-code=\"SAVE10\""
+    ],
+    "blank_widget_literals": [
+      "data-coupon-code=\"\"",
+      "Apply My Discount Coupon"
+    ],
+    "rule": "If an exit-intent include or default widget ships without CampaignSpec checkout exit_intent or promo_code_input behavior, strip it or record a hard warning. If present, it must apply the mapped offer through the SDK/API coupon path and use cart.hasCoupon(\"CODE\") style conditionals for applied-state presentation."
+  }
+}

package/contracts/template-brand-contract.shop-single-step.v0.json

@@ -0,0 +1,27 @@
+{
+  "schema_version": "template-brand-contract/v0",
+  "family": "shop-single-step",
+  "extends": "template-brand-contract.shared-commerce.v0.json",
+  "description": "Brand contract for the Shop single-step checkout starter-template family.",
+  "family_inventory": {
+    "supported_pages": ["landing", "presell", "checkout", "upsell", "receipt"],
+    "required_sdk_anchors": {
+      "checkout": ["data-next-cart-summary", "data-next-express-checkout", "data-next-payment-method", "data-next-payment-form"],
+      "upsell": ["data-next-upsell", "data-next-bundle-selector"],
+      "receipt": ["data-next-order-items"]
+    },
+    "theme_insertion_point": "Load brand-theme.css from frontmatter styles after css/next-core.css on checkout, upsell, downsell, and receipt pages.",
+    "default_color_residue": ["#3c7dff", "#0a265c"],
+    "pricing_presentation": "Shop summary/payment shell uses SDK cart summary prices; upsells support full-price and offer-discounted compare/current modes.",
+    "bundle_picker": "No tiered checkout picker by default; cart summary and payment shell are the protected SDK surface.",
+    "order_bump": "Shop bump-check02.html can render only when a bump package exists; otherwise remove the bump surface.",
+    "upsell_downsell": "Shop upsell offer includes use upsell_offer or upsell_bundle_tiers with a visible price row above the accept CTA.",
+    "exit_pop": {
+      "default_included": false,
+      "include": "exit-intent-popup.html",
+      "default_coupon_codes": ["SAVE10"],
+      "behavior": "Available include only; strip unless CampaignSpec checkout exit_intent or promo_code_input maps an offer/code."
+    },
+    "qa_selectors": [".checkout-wrapper", ".submit-button", ".cart-price", ".price-wrapper", ".brand-logo"]
+  }
+}

package/contracts/template-brand-contract.shop-three-step.v0.json

@@ -0,0 +1,29 @@
+{
+  "schema_version": "template-brand-contract/v0",
+  "family": "shop-three-step",
+  "extends": "template-brand-contract.shared-commerce.v0.json",
+  "description": "Brand contract for the Shop three-step information/shipping/billing starter-template family.",
+  "family_inventory": {
+    "supported_pages": ["landing", "presell", "information", "shipping", "billing", "upsell", "receipt"],
+    "required_sdk_anchors": {
+      "information": ["next-success-url"],
+      "shipping": ["data-next-shipping-id"],
+      "billing": ["data-next-payment-method", "data-next-payment-form"],
+      "upsell": ["data-next-upsell", "data-next-bundle-selector"],
+      "receipt": ["data-next-order-items"]
+    },
+    "theme_insertion_point": "Load brand-theme.css from frontmatter styles after css/next-core.css on information, shipping, billing, upsell, downsell, and receipt pages.",
+    "default_color_residue": ["#3c7dff", "#0a265c"],
+    "pricing_presentation": "Billing and upsell surfaces use SDK cart/order displays; shipping prices come from window.next.getShippingMethods(), not static Olympus-style shipping_methods frontmatter.",
+    "bundle_picker": "No checkout bundle picker; the family uses a multi-step shop flow with dynamic shipping before billing.",
+    "order_bump": "No promoted order-bump contract yet; unsupported bump widgets must be removed unless the family contract is promoted.",
+    "upsell_downsell": "Shop three-step upsells currently include inline refs plus upsell_offer/upsell_bundle_tiers mapping hints; both must be replaced from CampaignSpec/API.",
+    "exit_pop": {
+      "default_included": false,
+      "include": null,
+      "default_coupon_codes": [],
+      "behavior": "No promoted exit-pop include in the three-step family; any copied exit widget must be stripped unless CampaignSpec maps an offer/code."
+    },
+    "qa_selectors": [".checkout-wrapper", ".submit-button", ".price-wrapper", ".brand-logo", "[data-next-shipping-id]"]
+  }
+}

package/contracts/template-slot-manifest.apollo-mv-single-step.v0.json

@@ -0,0 +1,14 @@
+{
+  "schema_version": "template-slot-manifest/v0",
+  "family": "apollo-mv-single-step",
+  "extends": "template-slot-manifest.shared-content-core.v0.json",
+  "description": "Content-slot manifest for the apollo-mv-single-step starter-template family. Shared slots come from the content-slot core; this overlay declares family-specific keys and commerce-owned pages.",
+  "overlay": {
+    "pages": {}
+  },
+  "commerce_owned_pages": [
+    "checkout",
+    "upsell-mv",
+    "variant-picker"
+  ]
+}

package/contracts/template-slot-manifest.apollo.v0.json

@@ -0,0 +1,12 @@
+{
+  "schema_version": "template-slot-manifest/v0",
+  "family": "apollo",
+  "extends": "template-slot-manifest.shared-content-core.v0.json",
+  "description": "Content-slot manifest for the apollo starter-template family. Shared slots come from the content-slot core; this overlay declares family-specific keys and commerce-owned pages.",
+  "overlay": {
+    "pages": {}
+  },
+  "commerce_owned_pages": [
+    "checkout"
+  ]
+}

package/contracts/template-slot-manifest.demeter.v0.json

@@ -0,0 +1,30 @@
+{
+  "schema_version": "template-slot-manifest/v0",
+  "family": "demeter",
+  "extends": "template-slot-manifest.shared-content-core.v0.json",
+  "description": "Content-slot manifest for the demeter starter-template family. Shared slots come from the content-slot core; this overlay declares family-specific keys and commerce-owned pages.",
+  "overlay": {
+    "pages": {
+      "receipt": {
+        "sections": [
+          {
+            "section": "family_overlay",
+            "slots": [
+              {
+                "key": "receipt_summary",
+                "kind": "commerce",
+                "role": "commerce_structure",
+                "owner": "commerce",
+                "description": "Structured commerce configuration \u2014 owned by the commerce-surface catalog and the family brand contract, not the content-slot layer.",
+                "reference": "integrated_commerce_surface_ref"
+              }
+            ]
+          }
+        ]
+      }
+    }
+  },
+  "commerce_owned_pages": [
+    "checkout"
+  ]
+}

package/contracts/template-slot-manifest.olympus-mv-single-step.v0.json

@@ -0,0 +1,14 @@
+{
+  "schema_version": "template-slot-manifest/v0",
+  "family": "olympus-mv-single-step",
+  "extends": "template-slot-manifest.shared-content-core.v0.json",
+  "description": "Content-slot manifest for the olympus-mv-single-step starter-template family. Shared slots come from the content-slot core; this overlay declares family-specific keys and commerce-owned pages.",
+  "overlay": {
+    "pages": {}
+  },
+  "commerce_owned_pages": [
+    "checkout",
+    "upsell-mv",
+    "variant-picker"
+  ]
+}

package/contracts/template-slot-manifest.olympus-mv-two-step.v0.json

@@ -0,0 +1,15 @@
+{
+  "schema_version": "template-slot-manifest/v0",
+  "family": "olympus-mv-two-step",
+  "extends": "template-slot-manifest.shared-content-core.v0.json",
+  "description": "Content-slot manifest for the olympus-mv-two-step starter-template family. Shared slots come from the content-slot core; this overlay declares family-specific keys and commerce-owned pages.",
+  "overlay": {
+    "pages": {}
+  },
+  "commerce_owned_pages": [
+    "checkout",
+    "upsell-mv",
+    "variant-picker",
+    "select"
+  ]
+}

package/contracts/template-slot-manifest.olympus.v0.json

@@ -0,0 +1,12 @@
+{
+  "schema_version": "template-slot-manifest/v0",
+  "family": "olympus",
+  "extends": "template-slot-manifest.shared-content-core.v0.json",
+  "description": "Content-slot manifest for the olympus starter-template family. Shared slots come from the content-slot core; this overlay declares family-specific keys and commerce-owned pages.",
+  "overlay": {
+    "pages": {}
+  },
+  "commerce_owned_pages": [
+    "checkout"
+  ]
+}