@funnelsgrove/cli 0.1.231 → 0.1.237
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/README.md +11 -0
- package/dist/cli.js +10 -0
- package/dist/localeContentSource.d.ts +13 -0
- package/dist/localeContentSource.js +117 -0
- package/dist/localeFilePlan.d.ts +4 -0
- package/dist/localeFilePlan.js +63 -0
- package/dist/localeModuleEdits.d.ts +19 -0
- package/dist/localeModuleEdits.js +97 -0
- package/dist/locales.d.ts +6 -0
- package/dist/locales.js +92 -0
- package/funnel-contract-compatibility.json +38 -38
- package/package.json +4 -4
- package/template_docs/.funnelsgrove-docs.json +5 -5
- package/template_docs/AGENTS.md +1 -0
- package/template_docs/docs/funnelsgrove/contracts/content-answers.md +69 -0
- package/template_docs/docs/funnelsgrove/migrations/step-contract-v3.md +1 -1
- package/template_docs/funnel-docs.config.json +1 -1
- package/template_scaffold/.funnelsgrove-docs.json +5 -5
- package/template_scaffold/.funnelsgrove-scaffold.json +35 -15
- package/template_scaffold/AGENTS.md +1 -0
- package/template_scaffold/docs/funnelsgrove/contracts/content-answers.md +69 -0
- package/template_scaffold/docs/funnelsgrove/migrations/step-contract-v3.md +1 -1
- package/template_scaffold/funnel-docs.config.json +1 -1
- package/template_scaffold/package-lock.json +15 -15
- package/template_scaffold/package.json +3 -3
- package/template_scaffold/src/app/subscription-dashboard/page.tsx +22 -19
- package/template_scaffold/src/components/FunnelFlow.tsx +11 -5
- package/template_scaffold/src/components/paywall/PaywallRenewalDisclaimer.tsx +23 -0
- package/template_scaffold/src/components/paywall/localize-paywall-plan-labels.ts +15 -0
- package/template_scaffold/src/config/billing.plans.ts +11 -10
- package/template_scaffold/src/config/billing.test.plans.ts +11 -10
- package/template_scaffold/src/steps/content/runtime.content.ts +22 -0
- package/template_scaffold/src/steps/content/step-32-paywall.content.ts +41 -1
- package/template_scaffold/src/steps/content/subscription-dashboard.content.ts +54 -0
- package/template_scaffold/src/steps/step-32-paywall.tsx +12 -22
|
@@ -4,16 +4,16 @@
|
|
|
4
4
|
"minimumCliVersion": "0.1.20",
|
|
5
5
|
"entries": [
|
|
6
6
|
{
|
|
7
|
-
"repositoryCliVersion": "0.1.
|
|
7
|
+
"repositoryCliVersion": "0.1.237",
|
|
8
8
|
"manifest": {
|
|
9
9
|
"schemaVersion": 1,
|
|
10
|
-
"bundleVersion": "2.0.
|
|
10
|
+
"bundleVersion": "2.0.229",
|
|
11
11
|
"stepContractVersion": 3,
|
|
12
12
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
13
13
|
"managedFiles": [
|
|
14
14
|
{
|
|
15
15
|
"path": "AGENTS.md",
|
|
16
|
-
"sha256": "
|
|
16
|
+
"sha256": "3860d21f4a3f9b0c25ca54f7a87762d801f14b82a181b4c0b941c57187908f99"
|
|
17
17
|
},
|
|
18
18
|
{
|
|
19
19
|
"path": "CLAUDE.md",
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
},
|
|
30
30
|
{
|
|
31
31
|
"path": "docs/funnelsgrove/contracts/content-answers.md",
|
|
32
|
-
"sha256": "
|
|
32
|
+
"sha256": "17c8a91800ec1d2247b1e0fd12cc80fbfce162297aa928432cc0a574acd9fc06"
|
|
33
33
|
},
|
|
34
34
|
{
|
|
35
35
|
"path": "docs/funnelsgrove/contracts/flow-routing.md",
|
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
},
|
|
46
46
|
{
|
|
47
47
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
48
|
-
"sha256": "
|
|
48
|
+
"sha256": "eec04cc76ab67b9ba06ff1b32c68c657d86488883942c70c5a8ce526d05c4c20"
|
|
49
49
|
},
|
|
50
50
|
{
|
|
51
51
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -145,22 +145,22 @@
|
|
|
145
145
|
},
|
|
146
146
|
{
|
|
147
147
|
"path": "funnel-docs.config.json",
|
|
148
|
-
"sha256": "
|
|
148
|
+
"sha256": "6018305fe5a4b85b9411dc53e1d7169e9d0a3670f422b046ab24759f66392c98"
|
|
149
149
|
}
|
|
150
150
|
]
|
|
151
151
|
}
|
|
152
152
|
},
|
|
153
153
|
{
|
|
154
|
-
"repositoryCliVersion": "0.1.
|
|
154
|
+
"repositoryCliVersion": "0.1.236",
|
|
155
155
|
"manifest": {
|
|
156
156
|
"schemaVersion": 1,
|
|
157
|
-
"bundleVersion": "2.0.
|
|
157
|
+
"bundleVersion": "2.0.228",
|
|
158
158
|
"stepContractVersion": 3,
|
|
159
159
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
160
160
|
"managedFiles": [
|
|
161
161
|
{
|
|
162
162
|
"path": "AGENTS.md",
|
|
163
|
-
"sha256": "
|
|
163
|
+
"sha256": "3860d21f4a3f9b0c25ca54f7a87762d801f14b82a181b4c0b941c57187908f99"
|
|
164
164
|
},
|
|
165
165
|
{
|
|
166
166
|
"path": "CLAUDE.md",
|
|
@@ -176,7 +176,7 @@
|
|
|
176
176
|
},
|
|
177
177
|
{
|
|
178
178
|
"path": "docs/funnelsgrove/contracts/content-answers.md",
|
|
179
|
-
"sha256": "
|
|
179
|
+
"sha256": "44686934b2a6837142a12e76f9fc84bd5181179bcd3bf82d636a8ad26b72ce01"
|
|
180
180
|
},
|
|
181
181
|
{
|
|
182
182
|
"path": "docs/funnelsgrove/contracts/flow-routing.md",
|
|
@@ -192,7 +192,7 @@
|
|
|
192
192
|
},
|
|
193
193
|
{
|
|
194
194
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
195
|
-
"sha256": "
|
|
195
|
+
"sha256": "9c83f0df832c3279b39e7eec870ce48831ffbbca5a329f20e98a0c5f981fdb70"
|
|
196
196
|
},
|
|
197
197
|
{
|
|
198
198
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -292,22 +292,22 @@
|
|
|
292
292
|
},
|
|
293
293
|
{
|
|
294
294
|
"path": "funnel-docs.config.json",
|
|
295
|
-
"sha256": "
|
|
295
|
+
"sha256": "1ca7b4ab4b9bfebb726441adf8af784b7fc4405524b6ec0435382315e61e7a07"
|
|
296
296
|
}
|
|
297
297
|
]
|
|
298
298
|
}
|
|
299
299
|
},
|
|
300
300
|
{
|
|
301
|
-
"repositoryCliVersion": "0.1.
|
|
301
|
+
"repositoryCliVersion": "0.1.235",
|
|
302
302
|
"manifest": {
|
|
303
303
|
"schemaVersion": 1,
|
|
304
|
-
"bundleVersion": "2.0.
|
|
304
|
+
"bundleVersion": "2.0.227",
|
|
305
305
|
"stepContractVersion": 3,
|
|
306
306
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
307
307
|
"managedFiles": [
|
|
308
308
|
{
|
|
309
309
|
"path": "AGENTS.md",
|
|
310
|
-
"sha256": "
|
|
310
|
+
"sha256": "3860d21f4a3f9b0c25ca54f7a87762d801f14b82a181b4c0b941c57187908f99"
|
|
311
311
|
},
|
|
312
312
|
{
|
|
313
313
|
"path": "CLAUDE.md",
|
|
@@ -323,7 +323,7 @@
|
|
|
323
323
|
},
|
|
324
324
|
{
|
|
325
325
|
"path": "docs/funnelsgrove/contracts/content-answers.md",
|
|
326
|
-
"sha256": "
|
|
326
|
+
"sha256": "44686934b2a6837142a12e76f9fc84bd5181179bcd3bf82d636a8ad26b72ce01"
|
|
327
327
|
},
|
|
328
328
|
{
|
|
329
329
|
"path": "docs/funnelsgrove/contracts/flow-routing.md",
|
|
@@ -339,7 +339,7 @@
|
|
|
339
339
|
},
|
|
340
340
|
{
|
|
341
341
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
342
|
-
"sha256": "
|
|
342
|
+
"sha256": "b3cf273905125a0308291828e4f9ec39d6478cbcbe27396f1b1756686850bba6"
|
|
343
343
|
},
|
|
344
344
|
{
|
|
345
345
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -439,16 +439,16 @@
|
|
|
439
439
|
},
|
|
440
440
|
{
|
|
441
441
|
"path": "funnel-docs.config.json",
|
|
442
|
-
"sha256": "
|
|
442
|
+
"sha256": "a8289d598d0adb9bfb3f20ada3d20c3e175dafce4efcdf6a6e5ec2af6b29a625"
|
|
443
443
|
}
|
|
444
444
|
]
|
|
445
445
|
}
|
|
446
446
|
},
|
|
447
447
|
{
|
|
448
|
-
"repositoryCliVersion": "0.1.
|
|
448
|
+
"repositoryCliVersion": "0.1.234",
|
|
449
449
|
"manifest": {
|
|
450
450
|
"schemaVersion": 1,
|
|
451
|
-
"bundleVersion": "2.0.
|
|
451
|
+
"bundleVersion": "2.0.226",
|
|
452
452
|
"stepContractVersion": 3,
|
|
453
453
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
454
454
|
"managedFiles": [
|
|
@@ -486,7 +486,7 @@
|
|
|
486
486
|
},
|
|
487
487
|
{
|
|
488
488
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
489
|
-
"sha256": "
|
|
489
|
+
"sha256": "898f23a02a53cc70322fae87a715c0ffc4192a8d06dcdd1f4672af3a1d69e527"
|
|
490
490
|
},
|
|
491
491
|
{
|
|
492
492
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -586,22 +586,22 @@
|
|
|
586
586
|
},
|
|
587
587
|
{
|
|
588
588
|
"path": "funnel-docs.config.json",
|
|
589
|
-
"sha256": "
|
|
589
|
+
"sha256": "2c6634aec2abd46a30c6eecac138323396af8ca9550d2d91488c6a80613af179"
|
|
590
590
|
}
|
|
591
591
|
]
|
|
592
592
|
}
|
|
593
593
|
},
|
|
594
594
|
{
|
|
595
|
-
"repositoryCliVersion": "0.1.
|
|
595
|
+
"repositoryCliVersion": "0.1.233",
|
|
596
596
|
"manifest": {
|
|
597
597
|
"schemaVersion": 1,
|
|
598
|
-
"bundleVersion": "2.0.
|
|
598
|
+
"bundleVersion": "2.0.225",
|
|
599
599
|
"stepContractVersion": 3,
|
|
600
600
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
601
601
|
"managedFiles": [
|
|
602
602
|
{
|
|
603
603
|
"path": "AGENTS.md",
|
|
604
|
-
"sha256": "
|
|
604
|
+
"sha256": "3860d21f4a3f9b0c25ca54f7a87762d801f14b82a181b4c0b941c57187908f99"
|
|
605
605
|
},
|
|
606
606
|
{
|
|
607
607
|
"path": "CLAUDE.md",
|
|
@@ -617,7 +617,7 @@
|
|
|
617
617
|
},
|
|
618
618
|
{
|
|
619
619
|
"path": "docs/funnelsgrove/contracts/content-answers.md",
|
|
620
|
-
"sha256": "
|
|
620
|
+
"sha256": "44686934b2a6837142a12e76f9fc84bd5181179bcd3bf82d636a8ad26b72ce01"
|
|
621
621
|
},
|
|
622
622
|
{
|
|
623
623
|
"path": "docs/funnelsgrove/contracts/flow-routing.md",
|
|
@@ -633,7 +633,7 @@
|
|
|
633
633
|
},
|
|
634
634
|
{
|
|
635
635
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
636
|
-
"sha256": "
|
|
636
|
+
"sha256": "02e1409d391497b8860b5c2942bc07881853f53480daa4fb2972f561e8baa047"
|
|
637
637
|
},
|
|
638
638
|
{
|
|
639
639
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -733,22 +733,22 @@
|
|
|
733
733
|
},
|
|
734
734
|
{
|
|
735
735
|
"path": "funnel-docs.config.json",
|
|
736
|
-
"sha256": "
|
|
736
|
+
"sha256": "6767f2a0ee02bc43a4fd4b1b9c07e938099fac90976796636ebc66202050fe54"
|
|
737
737
|
}
|
|
738
738
|
]
|
|
739
739
|
}
|
|
740
740
|
},
|
|
741
741
|
{
|
|
742
|
-
"repositoryCliVersion": "0.1.
|
|
742
|
+
"repositoryCliVersion": "0.1.232",
|
|
743
743
|
"manifest": {
|
|
744
744
|
"schemaVersion": 1,
|
|
745
|
-
"bundleVersion": "2.0.
|
|
745
|
+
"bundleVersion": "2.0.224",
|
|
746
746
|
"stepContractVersion": 3,
|
|
747
747
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
748
748
|
"managedFiles": [
|
|
749
749
|
{
|
|
750
750
|
"path": "AGENTS.md",
|
|
751
|
-
"sha256": "
|
|
751
|
+
"sha256": "3860d21f4a3f9b0c25ca54f7a87762d801f14b82a181b4c0b941c57187908f99"
|
|
752
752
|
},
|
|
753
753
|
{
|
|
754
754
|
"path": "CLAUDE.md",
|
|
@@ -764,7 +764,7 @@
|
|
|
764
764
|
},
|
|
765
765
|
{
|
|
766
766
|
"path": "docs/funnelsgrove/contracts/content-answers.md",
|
|
767
|
-
"sha256": "
|
|
767
|
+
"sha256": "44686934b2a6837142a12e76f9fc84bd5181179bcd3bf82d636a8ad26b72ce01"
|
|
768
768
|
},
|
|
769
769
|
{
|
|
770
770
|
"path": "docs/funnelsgrove/contracts/flow-routing.md",
|
|
@@ -780,7 +780,7 @@
|
|
|
780
780
|
},
|
|
781
781
|
{
|
|
782
782
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
783
|
-
"sha256": "
|
|
783
|
+
"sha256": "cd4e0392bc88e2c24459a5132b8c7573bdb3e5a01aa7d9684139c30de39e4813"
|
|
784
784
|
},
|
|
785
785
|
{
|
|
786
786
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -880,16 +880,16 @@
|
|
|
880
880
|
},
|
|
881
881
|
{
|
|
882
882
|
"path": "funnel-docs.config.json",
|
|
883
|
-
"sha256": "
|
|
883
|
+
"sha256": "fd3117529acd5a83faf9ffb7bc004d5c1166ba783bcc57c2457ffc5e83c936f4"
|
|
884
884
|
}
|
|
885
885
|
]
|
|
886
886
|
}
|
|
887
887
|
},
|
|
888
888
|
{
|
|
889
|
-
"repositoryCliVersion": "0.1.
|
|
889
|
+
"repositoryCliVersion": "0.1.231",
|
|
890
890
|
"manifest": {
|
|
891
891
|
"schemaVersion": 1,
|
|
892
|
-
"bundleVersion": "2.0.
|
|
892
|
+
"bundleVersion": "2.0.223",
|
|
893
893
|
"stepContractVersion": 3,
|
|
894
894
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
895
895
|
"managedFiles": [
|
|
@@ -927,7 +927,7 @@
|
|
|
927
927
|
},
|
|
928
928
|
{
|
|
929
929
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
930
|
-
"sha256": "
|
|
930
|
+
"sha256": "b77101d16260357a891c26a6f0e6298f5763b3a8d76b38ba94378064a753e9f0"
|
|
931
931
|
},
|
|
932
932
|
{
|
|
933
933
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -1027,7 +1027,7 @@
|
|
|
1027
1027
|
},
|
|
1028
1028
|
{
|
|
1029
1029
|
"path": "funnel-docs.config.json",
|
|
1030
|
-
"sha256": "
|
|
1030
|
+
"sha256": "e111086760618c659a1f72b0e463bf2aa4c67ba9ebc1b4728c84e0d6b20b6510"
|
|
1031
1031
|
}
|
|
1032
1032
|
]
|
|
1033
1033
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@funnelsgrove/cli",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.237",
|
|
4
4
|
"description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -34,14 +34,14 @@
|
|
|
34
34
|
"test": "vitest run"
|
|
35
35
|
},
|
|
36
36
|
"dependencies": {
|
|
37
|
-
"@funnelsgrove/runtime": "0.
|
|
37
|
+
"@funnelsgrove/runtime": "0.14.4",
|
|
38
38
|
"commander": "^12.0.0",
|
|
39
39
|
"ignore": "^7.0.8",
|
|
40
40
|
"typescript": "^5.8.3"
|
|
41
41
|
},
|
|
42
42
|
"devDependencies": {
|
|
43
|
-
"@funnelsgrove/analytics": "0.1.
|
|
44
|
-
"@funnelsgrove/payments": "0.
|
|
43
|
+
"@funnelsgrove/analytics": "0.1.106",
|
|
44
|
+
"@funnelsgrove/payments": "0.15.11",
|
|
45
45
|
"vitest": "^3.0.0"
|
|
46
46
|
}
|
|
47
47
|
}
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
-
"bundleVersion": "2.0.
|
|
3
|
+
"bundleVersion": "2.0.229",
|
|
4
4
|
"stepContractVersion": 3,
|
|
5
5
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
6
6
|
"managedFiles": [
|
|
7
7
|
{
|
|
8
8
|
"path": "AGENTS.md",
|
|
9
|
-
"sha256": "
|
|
9
|
+
"sha256": "3860d21f4a3f9b0c25ca54f7a87762d801f14b82a181b4c0b941c57187908f99"
|
|
10
10
|
},
|
|
11
11
|
{
|
|
12
12
|
"path": "CLAUDE.md",
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
},
|
|
23
23
|
{
|
|
24
24
|
"path": "docs/funnelsgrove/contracts/content-answers.md",
|
|
25
|
-
"sha256": "
|
|
25
|
+
"sha256": "17c8a91800ec1d2247b1e0fd12cc80fbfce162297aa928432cc0a574acd9fc06"
|
|
26
26
|
},
|
|
27
27
|
{
|
|
28
28
|
"path": "docs/funnelsgrove/contracts/flow-routing.md",
|
|
@@ -38,7 +38,7 @@
|
|
|
38
38
|
},
|
|
39
39
|
{
|
|
40
40
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
41
|
-
"sha256": "
|
|
41
|
+
"sha256": "eec04cc76ab67b9ba06ff1b32c68c657d86488883942c70c5a8ce526d05c4c20"
|
|
42
42
|
},
|
|
43
43
|
{
|
|
44
44
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -138,7 +138,7 @@
|
|
|
138
138
|
},
|
|
139
139
|
{
|
|
140
140
|
"path": "funnel-docs.config.json",
|
|
141
|
-
"sha256": "
|
|
141
|
+
"sha256": "6018305fe5a4b85b9411dc53e1d7169e9d0a3670f422b046ab24759f66392c98"
|
|
142
142
|
}
|
|
143
143
|
]
|
|
144
144
|
}
|
package/template_docs/AGENTS.md
CHANGED
|
@@ -9,6 +9,7 @@ This file is generated from the FunnelsGrove step contract. Start at [the agent
|
|
|
9
9
|
| Add a step | [Add a step](docs/funnelsgrove/recipes/add-step.md) |
|
|
10
10
|
| Edit a step | [Edit a step](docs/funnelsgrove/recipes/edit-step.md) |
|
|
11
11
|
| Change metadata or routing | [Step metadata](docs/funnelsgrove/contracts/step-metadata.md) and [flow routing](docs/funnelsgrove/contracts/flow-routing.md) |
|
|
12
|
+
| Add a locale or translate visitor copy | [Localization](docs/funnelsgrove/contracts/content-answers.md#localization) |
|
|
12
13
|
| Add or edit choices | [Content and answers](docs/funnelsgrove/contracts/content-answers.md) |
|
|
13
14
|
| Edit product strategy, plan, or copy | [Content and answers](docs/funnelsgrove/contracts/content-answers.md) |
|
|
14
15
|
| Add an experiment | [Add an experiment](docs/funnelsgrove/recipes/add-experiment.md) |
|
|
@@ -42,3 +42,72 @@ Keep builder-editable values in content definitions, expose matching editor sect
|
|
|
42
42
|
- Update the owning artifact in the same change. Never implement a step absent from `PLAN.md`.
|
|
43
43
|
|
|
44
44
|
See the exact choice and form pages in the [step-type index](../steps/INDEX.md). Run `fgrove validate` and test reload persistence before completion.
|
|
45
|
+
|
|
46
|
+
## Localization
|
|
47
|
+
|
|
48
|
+
All funnel-authored visitor copy belongs in `src/**/*.content.ts` localized
|
|
49
|
+
content definitions: headings, options, CTA labels, placeholders, validation and
|
|
50
|
+
error messages, loading/empty states, accessible labels, shared shell copy, and
|
|
51
|
+
paywall/legal copy. JSX renders resolved content; metadata IDs, answer keys,
|
|
52
|
+
provider IDs, prices and billing rules retain their existing owners. Provider-hosted
|
|
53
|
+
payment fields and messages are configured through that provider's locale support.
|
|
54
|
+
|
|
55
|
+
1. Keep original `*.content.ts` files at their existing locations alongside the
|
|
56
|
+
funnel's steps/shared code. They own the default English content and exported
|
|
57
|
+
content types. Run `fgrove locales add ru --dir .` to create translations under
|
|
58
|
+
`src/localization/ru/`, mirroring each original path relative to `src/`:
|
|
59
|
+
`src/steps/content/intro.content.ts` →
|
|
60
|
+
`src/localization/ru/steps/content/intro.content.ts`.
|
|
61
|
+
Use BCP 47 tags such as `pt-BR`. CLI copies source only: no translation, login,
|
|
62
|
+
sync or publication. Repeating the command preserves translated values, adds missing exports and
|
|
63
|
+
repairs missing registrations in the originals.
|
|
64
|
+
An existing inline locale is extracted with its authored text preserved.
|
|
65
|
+
2. Translate **every** generated content file, including shared shell and
|
|
66
|
+
returning-subscriber content. Each translated export imports its named type
|
|
67
|
+
with `import type` from the original file. Original definitions import these
|
|
68
|
+
translated values into their `locales` map; the reverse import is type-only.
|
|
69
|
+
Preserve keys, option IDs, placeholders such as `{amount}`, URLs and tokens.
|
|
70
|
+
Same-file inheritance from the default or requested locale refers to the
|
|
71
|
+
translated export. References to other locales require explicit copy before
|
|
72
|
+
running the command. Relative imports
|
|
73
|
+
are rebased; imported expressions remain authored references. Inspect those
|
|
74
|
+
references for remaining visitor copy before completing a translation.
|
|
75
|
+
3. Define the complete structure in an exported type in the original content file
|
|
76
|
+
and use `satisfies LocalizedStepContent<YourContentType>`. When adding a field,
|
|
77
|
+
update this type and the English content, then supply the field in **every**
|
|
78
|
+
translation. Keep required fields required; do not silence errors with casts,
|
|
79
|
+
optional fields or English spreads. Run `npx tsc --noEmit` at the funnel root:
|
|
80
|
+
an incomplete translation must fail with its file and missing field.
|
|
81
|
+
Keep `defaultLocale` and `locales` as explicit literal properties. CLI preflights
|
|
82
|
+
unsupported definitions before writing. Use named non-generic content types
|
|
83
|
+
and one default language per file. Local helpers referenced by copied
|
|
84
|
+
content (including enums, classes and type casts) must be inlined or moved to
|
|
85
|
+
independent imported modules. If a registered translation file is lost, restore
|
|
86
|
+
it before retrying; CLI cannot recover translated text from an import. A new step
|
|
87
|
+
must include every supported locale: rerun `locales add` for each language.
|
|
88
|
+
4. Resolve step copy with `usePreviewStepLocalizedContent(stepId, definition,
|
|
89
|
+
getStepContentLocale(attributes))`. Runtime versions supporting localization
|
|
90
|
+
give `?locale=ru` priority; otherwise the requested/browser language applies.
|
|
91
|
+
Lookup uses exact match, base language (`pt-BR` → `pt`), then `defaultLocale`.
|
|
92
|
+
The override persists in step URLs and never changes country, currency or offers.
|
|
93
|
+
5. Review each language with `?locale=ru`, including direct step links, reload,
|
|
94
|
+
next/back, validation errors, long text and checkout. Builder **Preview language**
|
|
95
|
+
selects languages announced by its live frame and carries the choice into the
|
|
96
|
+
external preview link. Static screenshots cannot switch language. Older
|
|
97
|
+
published runtimes need an SDK update and republish before exposing this control.
|
|
98
|
+
6. Run `fgrove validate`, sync through the funnel's normal CLI/GitHub workflow,
|
|
99
|
+
then publish preview. Existing funnels keep their own source and package pins;
|
|
100
|
+
adding a locale does not upgrade their SDK or migrate hard-coded JSX. Update
|
|
101
|
+
those explicitly and review the diff. Refresh this managed guide with `fgrove docs`.
|
|
102
|
+
|
|
103
|
+
New funnel code must route shell buttons and custom action-bar text through
|
|
104
|
+
content too. `src/steps/content/runtime.content.ts` owns the starter's shared
|
|
105
|
+
Continue/loading/unavailable messages. Server-returned display labels need
|
|
106
|
+
locale-owned presentation overrides; changing copy must not change plan IDs,
|
|
107
|
+
amounts, billing intervals or provider configuration.
|
|
108
|
+
|
|
109
|
+
The starter paywall's `catalogLabels` maps exact catalog display text to localized
|
|
110
|
+
text. Keep its keys unchanged and translate the values, preserving monetary
|
|
111
|
+
amounts. Add mappings for new admin-authored labels as needed. Unrecognized
|
|
112
|
+
catalog labels remain unchanged; translation never substitutes one offer for
|
|
113
|
+
another or alters payment identifiers and amounts.
|
|
@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
|
|
|
17
17
|
|
|
18
18
|
### Package release order
|
|
19
19
|
|
|
20
|
-
Release `@funnelsgrove/
|
|
20
|
+
Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.19.0`, then `@funnelsgrove/analytics` `0.1.110`, then `@funnelsgrove/payments` `0.20.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.237`, 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.
|
|
21
21
|
<!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
|
|
22
22
|
|
|
23
23
|
## Version-last policy
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
-
"bundleVersion": "2.0.
|
|
3
|
+
"bundleVersion": "2.0.229",
|
|
4
4
|
"stepContractVersion": 3,
|
|
5
5
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
6
6
|
"managedFiles": [
|
|
7
7
|
{
|
|
8
8
|
"path": "AGENTS.md",
|
|
9
|
-
"sha256": "
|
|
9
|
+
"sha256": "3860d21f4a3f9b0c25ca54f7a87762d801f14b82a181b4c0b941c57187908f99"
|
|
10
10
|
},
|
|
11
11
|
{
|
|
12
12
|
"path": "CLAUDE.md",
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
},
|
|
23
23
|
{
|
|
24
24
|
"path": "docs/funnelsgrove/contracts/content-answers.md",
|
|
25
|
-
"sha256": "
|
|
25
|
+
"sha256": "17c8a91800ec1d2247b1e0fd12cc80fbfce162297aa928432cc0a574acd9fc06"
|
|
26
26
|
},
|
|
27
27
|
{
|
|
28
28
|
"path": "docs/funnelsgrove/contracts/flow-routing.md",
|
|
@@ -38,7 +38,7 @@
|
|
|
38
38
|
},
|
|
39
39
|
{
|
|
40
40
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
41
|
-
"sha256": "
|
|
41
|
+
"sha256": "eec04cc76ab67b9ba06ff1b32c68c657d86488883942c70c5a8ce526d05c4c20"
|
|
42
42
|
},
|
|
43
43
|
{
|
|
44
44
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -138,7 +138,7 @@
|
|
|
138
138
|
},
|
|
139
139
|
{
|
|
140
140
|
"path": "funnel-docs.config.json",
|
|
141
|
-
"sha256": "
|
|
141
|
+
"sha256": "6018305fe5a4b85b9411dc53e1d7169e9d0a3670f422b046ab24759f66392c98"
|
|
142
142
|
}
|
|
143
143
|
]
|
|
144
144
|
}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
-
"sourceTreeHash": "
|
|
3
|
+
"sourceTreeHash": "f14834edab3f8d7a98828a6a0253b40c4457f4d720ec913e3f917da0d3a626e4",
|
|
4
4
|
"stepContractVersion": 3,
|
|
5
|
-
"docsBundleVersion": "2.0.
|
|
5
|
+
"docsBundleVersion": "2.0.229",
|
|
6
6
|
"files": [
|
|
7
7
|
{
|
|
8
8
|
"path": ".env.example",
|
|
@@ -16,12 +16,12 @@
|
|
|
16
16
|
},
|
|
17
17
|
{
|
|
18
18
|
"path": ".funnelsgrove-docs.json",
|
|
19
|
-
"sha256": "
|
|
19
|
+
"sha256": "c56225fdfe22673279acfa36ee110d4098d3b2ccc44a2290042f4ede26b0988b",
|
|
20
20
|
"mode": "100644"
|
|
21
21
|
},
|
|
22
22
|
{
|
|
23
23
|
"path": "AGENTS.md",
|
|
24
|
-
"sha256": "
|
|
24
|
+
"sha256": "3860d21f4a3f9b0c25ca54f7a87762d801f14b82a181b4c0b941c57187908f99",
|
|
25
25
|
"mode": "100644"
|
|
26
26
|
},
|
|
27
27
|
{
|
|
@@ -81,7 +81,7 @@
|
|
|
81
81
|
},
|
|
82
82
|
{
|
|
83
83
|
"path": "docs/funnelsgrove/contracts/content-answers.md",
|
|
84
|
-
"sha256": "
|
|
84
|
+
"sha256": "17c8a91800ec1d2247b1e0fd12cc80fbfce162297aa928432cc0a574acd9fc06",
|
|
85
85
|
"mode": "100644"
|
|
86
86
|
},
|
|
87
87
|
{
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
},
|
|
102
102
|
{
|
|
103
103
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
104
|
-
"sha256": "
|
|
104
|
+
"sha256": "eec04cc76ab67b9ba06ff1b32c68c657d86488883942c70c5a8ce526d05c4c20",
|
|
105
105
|
"mode": "100644"
|
|
106
106
|
},
|
|
107
107
|
{
|
|
@@ -236,7 +236,7 @@
|
|
|
236
236
|
},
|
|
237
237
|
{
|
|
238
238
|
"path": "funnel-docs.config.json",
|
|
239
|
-
"sha256": "
|
|
239
|
+
"sha256": "6018305fe5a4b85b9411dc53e1d7169e9d0a3670f422b046ab24759f66392c98",
|
|
240
240
|
"mode": "100644"
|
|
241
241
|
},
|
|
242
242
|
{
|
|
@@ -261,12 +261,12 @@
|
|
|
261
261
|
},
|
|
262
262
|
{
|
|
263
263
|
"path": "package-lock.json",
|
|
264
|
-
"sha256": "
|
|
264
|
+
"sha256": "dc0ad84d804b31f929acd7a5ab149000c2dd1c30c9c2f3f4e4a999579a700d35",
|
|
265
265
|
"mode": "100644"
|
|
266
266
|
},
|
|
267
267
|
{
|
|
268
268
|
"path": "package.json",
|
|
269
|
-
"sha256": "
|
|
269
|
+
"sha256": "235b4a5ea331121ecd52af8534e90e6fbca5523644f7694191a747a539737383",
|
|
270
270
|
"mode": "100644"
|
|
271
271
|
},
|
|
272
272
|
{
|
|
@@ -311,7 +311,7 @@
|
|
|
311
311
|
},
|
|
312
312
|
{
|
|
313
313
|
"path": "src/app/subscription-dashboard/page.tsx",
|
|
314
|
-
"sha256": "
|
|
314
|
+
"sha256": "a8ecbb077fe6baf0a7eaa9e762dd4e7c61db67009be0be8cf15273fb3d4364f7",
|
|
315
315
|
"mode": "100644"
|
|
316
316
|
},
|
|
317
317
|
{
|
|
@@ -321,7 +321,17 @@
|
|
|
321
321
|
},
|
|
322
322
|
{
|
|
323
323
|
"path": "src/components/FunnelFlow.tsx",
|
|
324
|
-
"sha256": "
|
|
324
|
+
"sha256": "64424cf80a192ccec542ed1a188ab143a2bb33261a8717b8daa50726c848f0d3",
|
|
325
|
+
"mode": "100644"
|
|
326
|
+
},
|
|
327
|
+
{
|
|
328
|
+
"path": "src/components/paywall/PaywallRenewalDisclaimer.tsx",
|
|
329
|
+
"sha256": "d163e0220b655fcb2b057f50655bac1ed141ff2d5805010431c8e280570901ba",
|
|
330
|
+
"mode": "100644"
|
|
331
|
+
},
|
|
332
|
+
{
|
|
333
|
+
"path": "src/components/paywall/localize-paywall-plan-labels.ts",
|
|
334
|
+
"sha256": "f1969b2657d235518c0f0f83f79bb31464f46035b01da45fc7e0f11afe18a626",
|
|
325
335
|
"mode": "100644"
|
|
326
336
|
},
|
|
327
337
|
{
|
|
@@ -331,12 +341,12 @@
|
|
|
331
341
|
},
|
|
332
342
|
{
|
|
333
343
|
"path": "src/config/billing.plans.ts",
|
|
334
|
-
"sha256": "
|
|
344
|
+
"sha256": "71a268bbefd624b58f5d63a66a4f35c36973931ddac4f3f49d38f03576dbe36a",
|
|
335
345
|
"mode": "100644"
|
|
336
346
|
},
|
|
337
347
|
{
|
|
338
348
|
"path": "src/config/billing.test.plans.ts",
|
|
339
|
-
"sha256": "
|
|
349
|
+
"sha256": "921f3c2e523606f292091762501f256b87479461fbf4e6327cd8fc0c8fb10a68",
|
|
340
350
|
"mode": "100644"
|
|
341
351
|
},
|
|
342
352
|
{
|
|
@@ -479,6 +489,11 @@
|
|
|
479
489
|
"sha256": "b5770c01f838edc543fd32ea80a251d652586525029bff42cd0533a9bdd660e4",
|
|
480
490
|
"mode": "100644"
|
|
481
491
|
},
|
|
492
|
+
{
|
|
493
|
+
"path": "src/steps/content/runtime.content.ts",
|
|
494
|
+
"sha256": "c69d6129aac089842d3c046abeae0d6a0e29ff53471116651194d02e4000a9af",
|
|
495
|
+
"mode": "100644"
|
|
496
|
+
},
|
|
482
497
|
{
|
|
483
498
|
"path": "src/steps/content/step-01.content.ts",
|
|
484
499
|
"sha256": "a663c938ad341c21e84eb49b17b31287448e3a8abd68ccd7a294a7b820a3e14f",
|
|
@@ -486,7 +501,12 @@
|
|
|
486
501
|
},
|
|
487
502
|
{
|
|
488
503
|
"path": "src/steps/content/step-32-paywall.content.ts",
|
|
489
|
-
"sha256": "
|
|
504
|
+
"sha256": "1a763425633ad6b8ece3d8f800f4272a72e7dc93cf845d379e9f23faee0d4cd5",
|
|
505
|
+
"mode": "100644"
|
|
506
|
+
},
|
|
507
|
+
{
|
|
508
|
+
"path": "src/steps/content/subscription-dashboard.content.ts",
|
|
509
|
+
"sha256": "b54b05675a3c239f6003508818e64f6ee19e02e2bcec2fe8c3ce95bed4b90d04",
|
|
490
510
|
"mode": "100644"
|
|
491
511
|
},
|
|
492
512
|
{
|
|
@@ -551,7 +571,7 @@
|
|
|
551
571
|
},
|
|
552
572
|
{
|
|
553
573
|
"path": "src/steps/step-32-paywall.tsx",
|
|
554
|
-
"sha256": "
|
|
574
|
+
"sha256": "46d1a44a37b71f4e73fe5dd7d6ff4d3956929943364b1d285caa9e6846d213a9",
|
|
555
575
|
"mode": "100644"
|
|
556
576
|
},
|
|
557
577
|
{
|
|
@@ -9,6 +9,7 @@ This file is generated from the FunnelsGrove step contract. Start at [the agent
|
|
|
9
9
|
| Add a step | [Add a step](docs/funnelsgrove/recipes/add-step.md) |
|
|
10
10
|
| Edit a step | [Edit a step](docs/funnelsgrove/recipes/edit-step.md) |
|
|
11
11
|
| Change metadata or routing | [Step metadata](docs/funnelsgrove/contracts/step-metadata.md) and [flow routing](docs/funnelsgrove/contracts/flow-routing.md) |
|
|
12
|
+
| Add a locale or translate visitor copy | [Localization](docs/funnelsgrove/contracts/content-answers.md#localization) |
|
|
12
13
|
| Add or edit choices | [Content and answers](docs/funnelsgrove/contracts/content-answers.md) |
|
|
13
14
|
| Edit product strategy, plan, or copy | [Content and answers](docs/funnelsgrove/contracts/content-answers.md) |
|
|
14
15
|
| Add an experiment | [Add an experiment](docs/funnelsgrove/recipes/add-experiment.md) |
|