@funnelsgrove/cli 0.1.229 → 0.1.233

package/template_scaffold/.funnelsgrove-scaffold.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "bdd5f1d836e83dc9ee5c577deb6baef15b809a708bd5073ddaee4646785a71bb",
+  "sourceTreeHash": "30901fb7b8177a1ba9430b78ba2fc14dfddd9b664eaaea88ddb33f60aa0a3da5",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.221",
+  "docsBundleVersion": "2.0.225",
   "files": [
     {
       "path": ".env.example",
@@ -16,12 +16,12 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "856b6f77ac9e1cfb10112624544b3af970734bf71a8e9be67fa4099f2e5778e9",
+      "sha256": "bd3b4bfecc4384106929d79f0b9c3e20cbf959faba28efe513f8419e719d5b7e",
       "mode": "100644"
     },
     {
       "path": "AGENTS.md",
-      "sha256": "22118f0f909a747f8a27f4eed16ceb5ec2a9283fd9645114fda961c0405a2a6b",
+      "sha256": "3860d21f4a3f9b0c25ca54f7a87762d801f14b82a181b4c0b941c57187908f99",
       "mode": "100644"
     },
     {
@@ -81,7 +81,7 @@
     },
     {
       "path": "docs/funnelsgrove/contracts/content-answers.md",
-      "sha256": "403b286060dd6cda33757df7c55c5b0e17395f2d90aad0fc133d6ba1919a04b3",
+      "sha256": "44686934b2a6837142a12e76f9fc84bd5181179bcd3bf82d636a8ad26b72ce01",
       "mode": "100644"
     },
     {
@@ -101,7 +101,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "d86fab03c5a3bb31b2b62302a4fba47422c7f39d049decf4604b052cd55ae363",
+      "sha256": "02e1409d391497b8860b5c2942bc07881853f53480daa4fb2972f561e8baa047",
       "mode": "100644"
     },
     {
@@ -236,7 +236,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "d59565cd958ed65a1794437e1c69ba5b1d2a0d4465b30e52073374caf0130095",
+      "sha256": "6767f2a0ee02bc43a4fd4b1b9c07e938099fac90976796636ebc66202050fe54",
       "mode": "100644"
     },
     {
@@ -261,12 +261,12 @@
     },
     {
       "path": "package-lock.json",
-      "sha256": "fec6165d3f1b8a1a691008252ffa04d72660fc2e4ff64a9085468f3475967aa7",
+      "sha256": "dc0ad84d804b31f929acd7a5ab149000c2dd1c30c9c2f3f4e4a999579a700d35",
       "mode": "100644"
     },
     {
       "path": "package.json",
-      "sha256": "e616a7a9d0659e307dee1199a5d674f2fa12c9db1c00df4b6732887e5efd957e",
+      "sha256": "235b4a5ea331121ecd52af8534e90e6fbca5523644f7694191a747a539737383",
       "mode": "100644"
     },
     {
@@ -311,7 +311,7 @@
     },
     {
       "path": "src/app/subscription-dashboard/page.tsx",
-      "sha256": "765ebe25423289453891afa711423dd09e0e9a50cd12b55c2a1c878a12193ea9",
+      "sha256": "a8ecbb077fe6baf0a7eaa9e762dd4e7c61db67009be0be8cf15273fb3d4364f7",
       "mode": "100644"
     },
     {
@@ -321,7 +321,17 @@
     },
     {
       "path": "src/components/FunnelFlow.tsx",
-      "sha256": "846aa4002cdc893cc0805483c58bc0ff8b18e50d20e8482ea1877aad6a9aca77",
+      "sha256": "64424cf80a192ccec542ed1a188ab143a2bb33261a8717b8daa50726c848f0d3",
+      "mode": "100644"
+    },
+    {
+      "path": "src/components/paywall/PaywallRenewalDisclaimer.tsx",
+      "sha256": "d163e0220b655fcb2b057f50655bac1ed141ff2d5805010431c8e280570901ba",
+      "mode": "100644"
+    },
+    {
+      "path": "src/components/paywall/localize-paywall-plan-labels.ts",
+      "sha256": "f1969b2657d235518c0f0f83f79bb31464f46035b01da45fc7e0f11afe18a626",
       "mode": "100644"
     },
     {
@@ -331,12 +341,12 @@
     },
     {
       "path": "src/config/billing.plans.ts",
-      "sha256": "8b25bf44bf8b04275a6a978b76f2a9f7c0be7187e7578ab41c54fd5edca7ed65",
+      "sha256": "71a268bbefd624b58f5d63a66a4f35c36973931ddac4f3f49d38f03576dbe36a",
       "mode": "100644"
     },
     {
       "path": "src/config/billing.test.plans.ts",
-      "sha256": "1a5ac5f14321748a7d19631adf32ca4412f2d129ed31080683ae2e25b21a1ef8",
+      "sha256": "921f3c2e523606f292091762501f256b87479461fbf4e6327cd8fc0c8fb10a68",
       "mode": "100644"
     },
     {
@@ -479,6 +489,11 @@
       "sha256": "b5770c01f838edc543fd32ea80a251d652586525029bff42cd0533a9bdd660e4",
       "mode": "100644"
     },
+    {
+      "path": "src/steps/content/runtime.content.ts",
+      "sha256": "c0db996c0040b0ed50349017249c8f418332e0a27410ab70dac64cc65b2e6dc6",
+      "mode": "100644"
+    },
     {
       "path": "src/steps/content/step-01.content.ts",
       "sha256": "a663c938ad341c21e84eb49b17b31287448e3a8abd68ccd7a294a7b820a3e14f",
@@ -486,7 +501,12 @@
     },
     {
       "path": "src/steps/content/step-32-paywall.content.ts",
-      "sha256": "509ae6f98854ff024e14a1c53e04f583c2f29fa4cc409f432eba7fe845e3d320",
+      "sha256": "1a763425633ad6b8ece3d8f800f4272a72e7dc93cf845d379e9f23faee0d4cd5",
+      "mode": "100644"
+    },
+    {
+      "path": "src/steps/content/subscription-dashboard.content.ts",
+      "sha256": "ef47843635e5a3dd6c184ededb40c64e081e61281a5e0056213feaf75265f251",
       "mode": "100644"
     },
     {
@@ -551,7 +571,7 @@
     },
     {
       "path": "src/steps/step-32-paywall.tsx",
-      "sha256": "283a035dacfb9b4d56f269c1176ac84d8519a69b67eb11e0d392ada4535e2f62",
+      "sha256": "46d1a44a37b71f4e73fe5dd7d6ff4d3956929943364b1d285caa9e6846d213a9",
       "mode": "100644"
     },
     {

package/template_scaffold/AGENTS.md

@@ -9,6 +9,7 @@ This file is generated from the FunnelsGrove step contract. Start at [the agent
 | Add a step | [Add a step](docs/funnelsgrove/recipes/add-step.md) |
 | Edit a step | [Edit a step](docs/funnelsgrove/recipes/edit-step.md) |
 | Change metadata or routing | [Step metadata](docs/funnelsgrove/contracts/step-metadata.md) and [flow routing](docs/funnelsgrove/contracts/flow-routing.md) |
+| Add a locale or translate visitor copy | [Localization](docs/funnelsgrove/contracts/content-answers.md#localization) |
 | Add or edit choices | [Content and answers](docs/funnelsgrove/contracts/content-answers.md) |
 | Edit product strategy, plan, or copy | [Content and answers](docs/funnelsgrove/contracts/content-answers.md) |
 | Add an experiment | [Add an experiment](docs/funnelsgrove/recipes/add-experiment.md) |

package/template_scaffold/docs/funnelsgrove/contracts/content-answers.md

@@ -42,3 +42,53 @@ Keep builder-editable values in content definitions, expose matching editor sect
 - Update the owning artifact in the same change. Never implement a step absent from `PLAN.md`.
 
 See the exact choice and form pages in the [step-type index](../steps/INDEX.md). Run `fgrove validate` and test reload persistence before completion.
+
+## Localization
+
+All funnel-authored visitor copy belongs in `src/**/*.content.ts` localized
+content definitions: headings, options, CTA labels, placeholders, validation and
+error messages, loading/empty states, accessible labels, shared shell copy, and
+paywall/legal copy. JSX renders resolved content; metadata IDs, answer keys,
+provider IDs, prices and billing rules retain their existing owners. Provider-hosted
+payment fields and messages are configured through that provider's locale support.
+
+1. Run `fgrove locales add ru --dir .` to copy each definition's `defaultLocale`
+   into `locales.ru`. Use BCP 47 tags such as `pt-BR`. The command edits local source
+   only, requires no login, and never translates, syncs or publishes. Repeating it
+   keeps existing translations and fills only missing locale entries.
+2. Translate the new entries in **every** content module, including shared shell
+   and returning-subscriber content. Preserve object keys, option IDs, placeholders
+   such as `{amount}`, URLs and variable tokens. Same-file references to another
+   definition's base locale are copied as references to its new locale. Imported
+   content and other expressions remain references: inspect them and move any
+   remaining visitor copy into locale-owned definitions before completion.
+3. Keep `defaultLocale` and `locales` as explicit literal properties. Locale maps
+   use explicit keys; CLI rejects dynamic maps, spreads at the locale-map level,
+   and non-object base content before writing files. Nested content may contain
+   expressions. A new step must include every supported funnel locale.
+4. Resolve step copy with `usePreviewStepLocalizedContent(stepId, definition,
+   getStepContentLocale(attributes))`. Runtime versions supporting localization
+   give `?locale=ru` priority; otherwise the requested/browser language applies.
+   Lookup uses exact match, base language (`pt-BR` → `pt`), then `defaultLocale`.
+   The override persists in step URLs and never changes country, currency or offers.
+5. Review each language with `?locale=ru`, including direct step links, reload,
+   next/back, validation errors, long text and checkout. Builder **Preview language**
+   selects languages announced by its live frame and carries the choice into the
+   external preview link. Static screenshots cannot switch language. Older
+   published runtimes need an SDK update and republish before exposing this control.
+6. Run `fgrove validate`, sync through the funnel's normal CLI/GitHub workflow,
+   then publish preview. Existing funnels keep their own source and package pins;
+   adding a locale does not upgrade their SDK or migrate hard-coded JSX. Update
+   those explicitly and review the diff. Refresh this managed guide with `fgrove docs`.
+
+New funnel code must route shell buttons and custom action-bar text through
+content too. `src/steps/content/runtime.content.ts` owns the starter's shared
+Continue/loading/unavailable messages. Server-returned display labels need
+locale-owned presentation overrides; changing copy must not change plan IDs,
+amounts, billing intervals or provider configuration.
+
+The starter paywall's `catalogLabels` maps exact catalog display text to localized
+text. Keep its keys unchanged and translate the values, preserving monetary
+amounts. Add mappings for new admin-authored labels as needed. Unrecognized
+catalog labels remain unchanged; translation never substitutes one offer for
+another or alters payment identifiers and amounts.

package/template_scaffold/docs/funnelsgrove/migrations/step-contract-v3.md

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/runtime` `0.14.2` first, then `@funnelsgrove/analytics` `0.1.104`, then `@funnelsgrove/payments` `0.15.8`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.229`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/runtime` `0.14.4` first, then `@funnelsgrove/analytics` `0.1.106`, then `@funnelsgrove/payments` `0.15.11`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.233`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
 <!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
 
 ## Version-last policy

package/template_scaffold/funnel-docs.config.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.221",
+  "bundleVersion": "2.0.225",
   "contractSource": "funnelsgrove-repository://apps/funnel-runtime/contracts/step-contract-v2.json",
   "fullyGenerated": [
     ".funnelsgrove-docs.json",

package/template_scaffold/package-lock.json

@@ -8,9 +8,9 @@
       "name": "funnel-template",
       "version": "0.1.0",
       "dependencies": {
-        "@funnelsgrove/analytics": "^0.1.97",
-        "@funnelsgrove/payments": "^0.12.0",
-        "@funnelsgrove/runtime": "^0.12.0",
+        "@funnelsgrove/analytics": "^0.1.106",
+        "@funnelsgrove/payments": "^0.15.11",
+        "@funnelsgrove/runtime": "^0.14.4",
         "@stripe/react-stripe-js": "^5.6.0",
         "@stripe/stripe-js": "^8.7.0",
         "lucide-react": "^0.553.0",
@@ -938,20 +938,20 @@
       }
     },
     "node_modules/@funnelsgrove/analytics": {
-      "version": "0.1.97",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.1.97.tgz",
-      "integrity": "sha512-9FtZrzkjpwtfGZIbpYsnutK8T870MalxkWiGGzYGkzVJcoBfeCKTPEDXRwfNiaAyLUCDbeY7/gheJac2MllZAw==",
+      "version": "0.1.106",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.1.106.tgz",
+      "integrity": "sha512-S2hzj6C7FFz9Ui1GIE+NGMCVWnpWR81dZ4/HNSakedTSYcnP5Pu9JYtVLD+EXtiYRclF5PDgIIUbhkQxIuO8Mw==",
       "dependencies": {
-        "@funnelsgrove/runtime": "0.12.0"
+        "@funnelsgrove/runtime": "0.14.4"
       }
     },
     "node_modules/@funnelsgrove/payments": {
-      "version": "0.12.0",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/payments/-/payments-0.12.0.tgz",
-      "integrity": "sha512-i1rmGFNcSAr54qn5Q+QUiqzK2zYCNXr8uUMKN7UhEPEHYzP8cir2KR6XgI0rqQA3BOvDkqTpMNZOoE15uiPWIA==",
+      "version": "0.15.11",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/payments/-/payments-0.15.11.tgz",
+      "integrity": "sha512-X9k+/6NduXXQa2RTf+bbZenbckxunULCazROXsjpWcuJDkby/DdPH4Y+OZMNBpS/BIp3tbTO9z877p+7wz41/g==",
       "dependencies": {
-        "@funnelsgrove/analytics": "^0.1.97",
-        "@funnelsgrove/runtime": "^0.12.0",
+        "@funnelsgrove/analytics": "0.1.106",
+        "@funnelsgrove/runtime": "0.14.4",
         "@solidgate/react-sdk": "1.34.0",
         "@stripe/react-stripe-js": "^5.6.0",
         "@stripe/stripe-js": "^8.7.0",
@@ -961,9 +961,9 @@
       }
     },
     "node_modules/@funnelsgrove/runtime": {
-      "version": "0.12.0",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.12.0.tgz",
-      "integrity": "sha512-WyuSRoYyDFcndMPEW+swoXhbYrWLG2icN4IgYv8KKQ3q/3mR8jAjlsQLY0hTdaaz6UxnV2w5+NXfYVB8eDxQBg==",
+      "version": "0.14.4",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.14.4.tgz",
+      "integrity": "sha512-Rloc3yKoe0mUDxiHTsFKuUt+cspzFAJHkUUkjV5Z+v79ogjW/K+1LxRG6vnwghB4QWj24Fjp5l1FKwREqqERIA==",
       "dependencies": {
         "posthog-js": "^1.369.2",
         "react": "19.2.3",

package/template_scaffold/package.json

@@ -12,9 +12,9 @@
     "validate:funnel": "vite-node --config src/contract/funnel-validator.vite.config.ts src/contract/validate-funnel.cli.ts"
   },
   "dependencies": {
-    "@funnelsgrove/analytics": "^0.1.97",
-    "@funnelsgrove/payments": "^0.12.0",
-    "@funnelsgrove/runtime": "^0.12.0",
+    "@funnelsgrove/analytics": "^0.1.106",
+    "@funnelsgrove/payments": "^0.15.11",
+    "@funnelsgrove/runtime": "^0.14.4",
     "@stripe/react-stripe-js": "^5.6.0",
     "@stripe/stripe-js": "^8.7.0",
     "lucide-react": "^0.553.0",

package/template_scaffold/src/app/subscription-dashboard/page.tsx

@@ -1,9 +1,12 @@
 'use client';
 
 import { useCallback, useEffect, useState } from 'react';
-import { apiService, type ManageSubscriptionsResponse } from '@funnelsgrove/runtime';
+import { apiService, usePreviewStepLocalizedContent, type ManageSubscriptionsResponse } from '@funnelsgrove/runtime';
+
+import { subscriptionDashboardContent } from '@/steps/content/subscription-dashboard.content';
 
 export default function ManageSubscriptionPage() {
+  const content = usePreviewStepLocalizedContent('subscription-dashboard', subscriptionDashboardContent);
   const [data, setData] = useState<ManageSubscriptionsResponse | null>(null);
   const [loading, setLoading] = useState(true);
   const [error, setError] = useState<string | null>(null);
@@ -17,11 +20,11 @@ export default function ManageSubscriptionPage() {
       const payload = await apiService.getManageSubscriptions();
       setData(payload);
     } catch (err) {
-      setError(err instanceof Error ? err.message : 'Failed to load subscriptions');
+      setError(err instanceof Error ? err.message : content.loadError);
     } finally {
       setLoading(false);
     }
-  }, []);
+  }, [content.loadError]);
 
   useEffect(() => {
     void load();
@@ -38,7 +41,7 @@ export default function ManageSubscriptionPage() {
       });
       setData(payload);
     } catch (err) {
-      setError(err instanceof Error ? err.message : `Failed to ${action} subscription`);
+      setError(err instanceof Error ? err.message : (action === 'cancel' ? content.cancelError : content.renewError));
     } finally {
       setUpdatingSubscriptionId(null);
     }
@@ -48,35 +51,35 @@ export default function ManageSubscriptionPage() {
     <main className="manage-subscription-page">
       <section className="manage-subscription-card">
         <header>
-          <p className="manage-subscription-tag">App Deals</p>
-          <h1 className="manage-subscription-title">Manage Subscription</h1>
+          <p className="manage-subscription-tag">{content.brand}</p>
+          <h1 className="manage-subscription-title">{content.title}</h1>
           <p className="manage-subscription-description">
-            View active plans and manage cancellation or renewal.
+            {content.description}
           </p>
         </header>
 
-        {loading ? <p className="manage-subscription-muted">Loading subscription data...</p> : null}
+        {loading ? <p className="manage-subscription-muted">{content.loading}</p> : null}
         {error ? <p className="manage-subscription-error">{error}</p> : null}
 
         {!loading && data?.user ? (
           <section className="manage-subscription-user">
             <p>
-              <strong>User ID:</strong> {data.user.user_id}
+              <strong>{content.userId}</strong> {data.user.user_id}
             </p>
             <p>
-              <strong>Email:</strong> {data.user.email || 'Not provided'}
+              <strong>{content.email}</strong> {data.user.email || content.notProvided}
             </p>
             <p>
-              <strong>Status:</strong> {data.user.subscriptionStatus || 'unknown'}
+              <strong>{content.status}</strong> {data.user.subscriptionStatus || content.unknown}
             </p>
             <p>
-              <strong>Tracked events:</strong> {data.eventsCount}
+              <strong>{content.events}</strong> {data.eventsCount}
             </p>
           </section>
         ) : null}
 
         {!loading && (!data || data.subscriptions.length === 0) ? (
-          <p className="manage-subscription-muted">No subscriptions found for this user.</p>
+          <p className="manage-subscription-muted">{content.empty}</p>
         ) : null}
 
         {!loading && data?.subscriptions.length ? (
@@ -92,12 +95,12 @@ export default function ManageSubscriptionPage() {
                   </p>
                   <p className="manage-subscription-item-meta">
                     {subscription.cancelAtPeriodEnd
-                      ? 'Will cancel at period end'
-                      : 'Auto-renew is active'}
+                      ? content.cancelAtEnd
+                      : content.autoRenew}
                   </p>
                   {subscription.currentPeriodEnd ? (
                     <p className="manage-subscription-item-meta">
-                      Current period ends:{' '}
+                      {content.periodEnds}{' '}
                       {new Date(subscription.currentPeriodEnd).toLocaleString()}
                     </p>
                   ) : null}
@@ -111,7 +114,7 @@ export default function ManageSubscriptionPage() {
                       disabled={updatingSubscriptionId === subscription.id}
                       onClick={() => mutate(subscription.id, 'renew')}
                     >
-                      {updatingSubscriptionId === subscription.id ? 'Updating...' : 'Renew'}
+                      {updatingSubscriptionId === subscription.id ? content.updating : content.renew}
                     </button>
                   ) : (
                     <button
@@ -120,7 +123,7 @@ export default function ManageSubscriptionPage() {
                       disabled={updatingSubscriptionId === subscription.id}
                       onClick={() => mutate(subscription.id, 'cancel')}
                     >
-                      {updatingSubscriptionId === subscription.id ? 'Updating...' : 'Cancel'}
+                      {updatingSubscriptionId === subscription.id ? content.updating : content.cancel}
                     </button>
                   )}
                 </div>
@@ -130,7 +133,7 @@ export default function ManageSubscriptionPage() {
         ) : null}
 
         <button type="button" className="manage-subscription-refresh" onClick={() => void load()}>
-          Refresh
+          {content.refresh}
         </button>
       </section>
 

package/template_scaffold/src/components/FunnelFlow.tsx

@@ -9,8 +9,11 @@ import {
   runtimePublicConfig,
   scheduleNextStepImagePreload,
   usePreviewDefinitionOverrideRevision,
+  usePreviewStepLocalizedContent,
 } from '@funnelsgrove/runtime';
 import { FunnelEditorPanel, FunnelEditorPanelStyles } from './FunnelEditorPanel';
+import { runtimeContent } from '@/steps/content/runtime.content';
+import { getStepContentLocale } from '@/runtime/step-content-context';
 import { funnelManifest } from '@/config/funnel.manifest';
 import type { FunnelStepId } from '@/runtime/funnel-runtime';
 import { useFunnelFlowController } from '@/runtime/use-funnel-flow-controller';
@@ -23,21 +26,23 @@ type FunnelFlowProps = {
 };
 
 function RuntimeConfigLoading() {
+  const content = usePreviewStepLocalizedContent('runtime', runtimeContent, getStepContentLocale({}));
   return (
-    <section className="runtime-config-loading" role="status" aria-label="Loading" aria-busy="true">
+    <section className="runtime-config-loading" role="status" aria-label={content.loadingLabel} aria-busy="true">
       <span className="runtime-config-loading__progress" />
     </section>
   );
 }
 
 function RuntimeConfigStatus() {
+  const content = usePreviewStepLocalizedContent('runtime', runtimeContent, getStepContentLocale({}));
   return (
     <section className="runtime-config-status" role="alert" aria-live="polite">
       <div className="runtime-config-status__content">
-        <h1>This experience is temporarily unavailable</h1>
-        <p>Please check your connection and try again.</p>
+        <h1>{content.unavailableTitle}</h1>
+        <p>{content.unavailableDescription}</p>
         <button type="button" onClick={() => window.location.reload()}>
-          Try again
+          {content.retryLabel}
         </button>
       </div>
     </section>
@@ -88,6 +93,7 @@ function FunnelFlowRuntime({
   previewFrameMounted: boolean;
 }) {
   const previewDefinitionRevision = usePreviewDefinitionOverrideRevision();
+  const content = usePreviewStepLocalizedContent('runtime', runtimeContent, getStepContentLocale({}));
   const controller = useFunnelFlowController({
     initialStepId,
     lockToInitialStep,
@@ -144,7 +150,7 @@ function FunnelFlowRuntime({
                 onClick={controller.handleContinue}
                 className={controller.buttonVariant === 'muted' ? 'is-muted' : undefined}
               >
-                {controller.buttonText}
+                {controller.activeStepMeta.actionBar?.buttonText ? controller.buttonText : content.continueLabel}
               </PrimaryButton>
             </footer>
           ) : null}

package/template_scaffold/src/components/paywall/PaywallRenewalDisclaimer.tsx

@@ -0,0 +1,23 @@
+import type { PaywallPlan } from '@funnelsgrove/payments';
+import type { StepPaywallLocaleContent } from '@/steps/content/step-32-paywall.content';
+
+type Props = {
+  plan: Pick<PaywallPlan, 'priceLabel' | 'billingInterval' | 'billingIntervalCount'> | null;
+  hasActiveDiscount: boolean;
+  copy: StepPaywallLocaleContent['checkout'];
+  catalogLabels: Record<string, string>;
+};
+
+export function PaywallRenewalDisclaimer({ plan, hasActiveDiscount, copy, catalogLabels }: Props) {
+  if (!plan) return <p className='paywall-v2-disclaimer' />;
+  const count = Math.max(1, plan.billingIntervalCount || 1);
+  const cadenceCopy = plan.billingInterval ? copy.cadence[plan.billingInterval] : null;
+  const cadence = cadenceCopy
+    ? (count === 1 ? cadenceCopy.one : cadenceCopy.many).replace('{count}', String(count))
+    : copy.cadenceFallback;
+  const text = copy.renewalConsentTemplate
+    .replace('{intro}', hasActiveDiscount ? copy.discountedIntroLabel : copy.selectedIntroLabel)
+    .replace('{amount}', catalogLabels[plan.priceLabel] ?? plan.priceLabel)
+    .replace('{cadence}', cadence);
+  return <p className='paywall-v2-disclaimer'>{text}</p>;
+}

package/template_scaffold/src/components/paywall/localize-paywall-plan-labels.ts

@@ -0,0 +1,15 @@
+import type { PaywallDisplayPlan } from '@funnelsgrove/payments';
+
+/** Translate recognized display labels while retaining arbitrary catalog copy and payment data. */
+export function localizePaywallPlanLabels(plan: PaywallDisplayPlan, labels: Record<string, string>): PaywallDisplayPlan {
+  const translate = (value: string) => typeof labels[value] === 'string' ? labels[value] : value;
+  return {
+    ...plan,
+    title: translate(plan.title),
+    priceLabel: translate(plan.priceLabel),
+    basePriceLabel: translate(plan.basePriceLabel),
+    oldPriceLabel: plan.oldPriceLabel ? translate(plan.oldPriceLabel) : plan.oldPriceLabel,
+    checkoutSummaryLabel: plan.checkoutSummaryLabel ? translate(plan.checkoutSummaryLabel) : plan.checkoutSummaryLabel,
+    featuredTag: plan.featuredTag ? translate(plan.featuredTag) : plan.featuredTag,
+  };
+}

package/template_scaffold/src/config/billing.plans.ts

@@ -1,3 +1,4 @@
+import { stepPaywallContent } from '@/steps/content/step-32-paywall.content';
 import {
   buildBillingDiscountCatalog,
   createRuntimeModeBillingPlanCatalog,
@@ -19,36 +20,36 @@ const starterLivePlans = {
     offerSetId: STARTER_OFFER_SET_ID,
     offerSetKey: STARTER_OFFER_SET_KEY,
     projectPlanId: '32b31f69-5907-4736-89c7-76d3acb38813',
-    title: '1-Week Plan',
+    title: stepPaywallContent.locales.en.catalogLabels["1-Week Plan"],
     providerPlanId: 'price_1T9WL2PPRN41Ty94g2NNOgif',
-    priceLabel: '$7.99/week',
+    priceLabel: stepPaywallContent.locales.en.catalogLabels["$7.99/week"],
     perDayAmount: '$1.14',
     amountCents: 799,
-    checkoutSummaryLabel: '$7.99 today',
+    checkoutSummaryLabel: stepPaywallContent.locales.en.catalogLabels["$7.99 today"],
   },
   secondary: {
     offerSetId: STARTER_OFFER_SET_ID,
     offerSetKey: STARTER_OFFER_SET_KEY,
     projectPlanId: 'ce0a0022-7bf0-41f2-a707-edc5e6113a07',
-    title: '1-Month Plan',
+    title: stepPaywallContent.locales.en.catalogLabels["1-Month Plan"],
     providerPlanId: 'price_1TP0IIPPRN41Ty94npkzVeDR',
-    featuredTag: '🔥 Most Popular Choice',
-    priceLabel: '$29.99/month',
+    featuredTag: stepPaywallContent.locales.en.catalogLabels["🔥 Most Popular Choice"],
+    priceLabel: stepPaywallContent.locales.en.catalogLabels["$29.99/month"],
     perDayAmount: '$1.00',
     amountCents: 2999,
-    checkoutSummaryLabel: '$29.99 today',
+    checkoutSummaryLabel: stepPaywallContent.locales.en.catalogLabels["$29.99 today"],
     isDefault: true,
   },
   tertiary: {
     offerSetId: STARTER_OFFER_SET_ID,
     offerSetKey: STARTER_OFFER_SET_KEY,
     projectPlanId: 'fb623ebc-c2fd-4e6a-8eb6-b8ed92db1b21',
-    title: '1-Year Plan',
+    title: stepPaywallContent.locales.en.catalogLabels["1-Year Plan"],
     providerPlanId: 'price_1T06AEPPRN41Ty94zvVt5xrk',
-    priceLabel: '$59.99/year',
+    priceLabel: stepPaywallContent.locales.en.catalogLabels["$59.99/year"],
     perDayAmount: '$0.16',
     amountCents: 5999,
-    checkoutSummaryLabel: '$59.99 today',
+    checkoutSummaryLabel: stepPaywallContent.locales.en.catalogLabels["$59.99 today"],
   },
 } satisfies BillingPlanCatalog;
 

package/template_scaffold/src/config/billing.test.plans.ts

@@ -1,32 +1,33 @@
+import { stepPaywallContent } from '@/steps/content/step-32-paywall.content';
 import type { BillingPlanCatalog } from '@funnelsgrove/payments';
 
 export const billingTestPlans = {
   primary: {
     projectPlanId: '32b31f69-5907-4736-89c7-76d3acb38813',
-    title: '1-Week Plan',
+    title: stepPaywallContent.locales.en.catalogLabels["1-Week Plan"],
     providerPlanId: 'price_1TOQ2fPEfkEVo5khumapOSsI',
-    priceLabel: '$9.99/week',
+    priceLabel: stepPaywallContent.locales.en.catalogLabels["$9.99/week"],
     perDayAmount: '$1.43',
     amountCents: 999,
-    checkoutSummaryLabel: '$9.99 today',
+    checkoutSummaryLabel: stepPaywallContent.locales.en.catalogLabels["$9.99 today"],
   },
   secondary: {
     projectPlanId: 'ce0a0022-7bf0-41f2-a707-edc5e6113a07',
-    title: '1-Month Plan',
+    title: stepPaywallContent.locales.en.catalogLabels["1-Month Plan"],
     providerPlanId: 'price_1TSgPZPEfkEVo5khMbtAlqsG',
-    featuredTag: '🔥 Most Popular Choice',
-    priceLabel: '$29.99/month',
+    featuredTag: stepPaywallContent.locales.en.catalogLabels["🔥 Most Popular Choice"],
+    priceLabel: stepPaywallContent.locales.en.catalogLabels["$29.99/month"],
     perDayAmount: '$1.00',
     amountCents: 2999,
-    checkoutSummaryLabel: '$29.99 today',
+    checkoutSummaryLabel: stepPaywallContent.locales.en.catalogLabels["$29.99 today"],
   },
   tertiary: {
     projectPlanId: 'fb623ebc-c2fd-4e6a-8eb6-b8ed92db1b21',
-    title: '1-Year Plan',
+    title: stepPaywallContent.locales.en.catalogLabels["1-Year Plan"],
     providerPlanId: 'price_1TBgcaPEfkEVo5khbGnGhrBA',
-    priceLabel: '$59.99/year',
+    priceLabel: stepPaywallContent.locales.en.catalogLabels["$59.99/year"],
     perDayAmount: '$0.16',
     amountCents: 5999,
-    checkoutSummaryLabel: '$59.99 today',
+    checkoutSummaryLabel: stepPaywallContent.locales.en.catalogLabels["$59.99 today"],
   },
 } satisfies BillingPlanCatalog;

package/template_scaffold/src/steps/content/runtime.content.ts

@@ -0,0 +1,22 @@
+import type { LocalizedStepContent } from '@funnelsgrove/runtime';
+
+type RuntimeContent = {
+  loadingLabel: string;
+  unavailableTitle: string;
+  unavailableDescription: string;
+  retryLabel: string;
+  continueLabel: string;
+};
+
+export const runtimeContent = {
+  defaultLocale: 'en',
+  locales: {
+    en: {
+      loadingLabel: 'Loading',
+      unavailableTitle: 'This experience is temporarily unavailable',
+      unavailableDescription: 'Please check your connection and try again.',
+      retryLabel: 'Try again',
+      continueLabel: 'Continue',
+    },
+  },
+} as const satisfies LocalizedStepContent<RuntimeContent>;