@thorprovider/storefront 0.4.0-mvp.0 → 0.4.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.
Files changed (225) hide show
  1. package/README.md +174 -156
  2. package/VENDOR.md +69 -0
  3. package/assets/openspec/config.yaml +38 -0
  4. package/assets/templates/AGENTS.md +76 -0
  5. package/assets/templates/app/app/[[...slug]]/page.tsx +56 -2
  6. package/assets/templates/app/app/[[...slug]]/renderer.tsx +44 -2
  7. package/assets/templates/app/app/globals.css +5 -8
  8. package/assets/templates/app/app/layout.tsx +1 -5
  9. package/assets/templates/app/app/robots.ts +9 -3
  10. package/assets/templates/app/app/sitemap.ts +64 -5
  11. package/assets/templates/app/lib/__STOREFRONT__/account-boundary.client.tsx +76 -0
  12. package/assets/templates/app/lib/__STOREFRONT__/account-lifecycle.client.tsx +461 -0
  13. package/assets/templates/app/lib/__STOREFRONT__/account-mutation.client.ts +46 -0
  14. package/assets/templates/app/lib/__STOREFRONT__/account-private.core.ts +103 -0
  15. package/assets/templates/app/lib/__STOREFRONT__/account-reconcile.client.ts +465 -0
  16. package/assets/templates/app/lib/__STOREFRONT__/account-session.core.ts +177 -0
  17. package/assets/templates/app/lib/__STOREFRONT__/account-session.ts +44 -0
  18. package/assets/templates/app/lib/__STOREFRONT__/account-user.core.ts +65 -0
  19. package/assets/templates/app/lib/__STOREFRONT__/actions.ts +135 -16
  20. package/assets/templates/app/lib/__STOREFRONT__/catalog.ts +19 -9
  21. package/assets/templates/app/lib/__STOREFRONT__/commerce.ts +61 -0
  22. package/assets/templates/app/lib/__STOREFRONT__/composition.ts +26 -0
  23. package/assets/templates/app/lib/__STOREFRONT__/handlers.core.ts +36 -4
  24. package/assets/templates/app/lib/__STOREFRONT__/mappers.ts +17 -18
  25. package/assets/templates/app/lib/__STOREFRONT__/projection-ownership.client.tsx +209 -0
  26. package/assets/templates/app/lib/__STOREFRONT__/projection-ownership.ts +247 -0
  27. package/assets/templates/app/lib/__STOREFRONT__/registry.tsx +123 -62
  28. package/assets/templates/app/lib/__STOREFRONT__/runtime.ts +3 -0
  29. package/assets/templates/app/lib/__STOREFRONT__/schema.ts +78 -25
  30. package/assets/templates/app/lib/__STOREFRONT__/section-observation.ts +182 -0
  31. package/assets/templates/app/lib/__STOREFRONT__/section-sources.ts +128 -0
  32. package/assets/templates/app/lib/__STOREFRONT__/shell/content.ts +31 -7
  33. package/assets/templates/app/lib/__STOREFRONT__/shell/props.ts +4 -0
  34. package/assets/templates/app/lib/__STOREFRONT__/spec/index.ts +81 -26
  35. package/assets/templates/app/lib/__STOREFRONT__/spec/seo.ts +165 -0
  36. package/assets/templates/app/lib/__STOREFRONT__/state.core.ts +4 -2
  37. package/assets/templates/app/lib/__STOREFRONT__/store-context.ts +26 -7
  38. package/assets/templates/app/lib/__STOREFRONT__/views/sections/cta.client.tsx +1 -1
  39. package/assets/templates/app/lib/__STOREFRONT__/views/sections/faq.client.tsx +1 -1
  40. package/assets/templates/app/lib/__STOREFRONT__/views/sections/index.ts +2 -1
  41. package/assets/templates/app/lib/__STOREFRONT__/views/sections/logoCloud.tsx +1 -1
  42. package/assets/templates/app/lib/__STOREFRONT__/views/sections/pricing.tsx +1 -1
  43. package/assets/templates/app/lib/__STOREFRONT__/views/sections/products.client.tsx +100 -0
  44. package/assets/templates/app/lib/__STOREFRONT__/views/sections/products.tsx +19 -0
  45. package/assets/templates/app/lib/__STOREFRONT__/views/sections/schema.products.ts +39 -0
  46. package/assets/templates/app/lib/__STOREFRONT__/views/sections/statistics.tsx +1 -1
  47. package/assets/templates/app/lib/__STOREFRONT__/views/sections/testimonials.tsx +1 -1
  48. package/assets/templates/features/checkout/handlers.ts +6 -0
  49. package/assets/templates/features/customer-auth/handlers.ts +19 -23
  50. package/assets/templates/features/customer-auth/state.ts +31 -1
  51. package/assets/templates/views/account/index.tsx +20 -8
  52. package/assets/templates/views/account/registry.tsx +294 -154
  53. package/assets/templates/views/account/schema.ts +1 -0
  54. package/assets/templates/views/cart/content.ts +11 -0
  55. package/assets/templates/views/cart/data.ts +23 -0
  56. package/assets/templates/views/cart/index.tsx +53 -0
  57. package/assets/templates/views/cart/props.ts +12 -0
  58. package/assets/templates/views/cart/registry.tsx +82 -0
  59. package/assets/templates/views/cart/schema.ts +52 -0
  60. package/assets/templates/views/category/assembly/assembly.json +2 -1
  61. package/assets/templates/views/category/assembly/index.skeleton.tsx +64 -6
  62. package/assets/templates/views/category/assembly/registry.skeleton.tsx +7 -6
  63. package/assets/templates/views/category/assembly/slots/breadcrumb/Breadcrumb/binding.json +5 -0
  64. package/assets/templates/views/category/assembly/slots/breadcrumb/Breadcrumb/catalog.part +4 -0
  65. package/assets/templates/views/category/assembly/slots/breadcrumb/Breadcrumb/element.part +7 -0
  66. package/assets/templates/views/category/assembly/slots/breadcrumb/Breadcrumb/registry.part +18 -0
  67. package/assets/templates/views/category/index.tsx +76 -7
  68. package/assets/templates/views/category/props.ts +7 -0
  69. package/assets/templates/views/category/registry.tsx +25 -6
  70. package/assets/templates/views/category/schema.ts +13 -0
  71. package/assets/templates/views/checkout/registry.tsx +3 -5
  72. package/assets/templates/views/home/assembly/assembly.json +12 -3
  73. package/assets/templates/views/home/assembly/index.skeleton.tsx +24 -5
  74. package/assets/templates/views/home/assembly/registry.skeleton.tsx +4 -1
  75. package/assets/templates/views/home/assembly/slots/benefits/cards/binding.json +5 -0
  76. package/assets/templates/views/home/assembly/slots/benefits/cards/registry.part +17 -0
  77. package/assets/templates/views/home/assembly/slots/benefits/split/binding.json +5 -0
  78. package/assets/templates/views/home/assembly/slots/benefits/{Feature1 → split}/registry.part +6 -2
  79. package/assets/templates/views/home/assembly/slots/categories/CategoryGrid/binding.json +5 -0
  80. package/assets/templates/views/home/assembly/slots/categories/CategoryGrid/catalog.part +8 -0
  81. package/assets/templates/views/home/assembly/slots/categories/{ProductCategory2 → CategoryGrid}/element.part +1 -1
  82. package/assets/templates/views/home/assembly/slots/categories/CategoryGrid/registry.part +31 -0
  83. package/assets/templates/views/home/assembly/slots/hero/StorefrontHero/binding.json +5 -0
  84. package/assets/templates/views/home/assembly/slots/hero/StorefrontHero/catalog.part +4 -0
  85. package/assets/templates/views/home/assembly/slots/hero/StorefrontHero/element.part +5 -0
  86. package/assets/templates/views/home/assembly/slots/hero/{StorefrontHero1 → StorefrontHero}/registry.part +5 -3
  87. package/assets/templates/views/home/content.ts +22 -0
  88. package/assets/templates/views/home/data.ts +9 -0
  89. package/assets/templates/views/home/index.tsx +34 -11
  90. package/assets/templates/views/home/props.ts +1 -0
  91. package/assets/templates/views/home/registry.tsx +41 -17
  92. package/assets/templates/views/home/schema.ts +141 -24
  93. package/assets/templates/views/product/data.ts +5 -3
  94. package/assets/templates/views/product/index.tsx +49 -5
  95. package/assets/templates/views/product/props.ts +7 -0
  96. package/assets/templates/views/product/registry.tsx +34 -5
  97. package/assets/templates/views/product/schema.ts +49 -1
  98. package/assets/templates/views/static/content.ts +4 -4
  99. package/assets/templates/views/static/index.tsx +1 -1
  100. package/bin/storefront.js +1231 -154
  101. package/examples/merchandising/category-led.json +37 -0
  102. package/examples/merchandising/collection-led.json +37 -0
  103. package/package.json +10 -7
  104. package/recipes/archetypes.json +33 -46
  105. package/recipes/catalog.json +245 -153
  106. package/recipes/catalog.mjs +10 -0
  107. package/recipes/catalog.schema.json +4 -0
  108. package/recipes/features.json +28 -5
  109. package/recipes/recipe.schema.json +1 -1
  110. package/recipes/recipes.json +159 -59
  111. package/recipes/sections.json +10 -0
  112. package/recipes/validate.mjs +75 -4
  113. package/scripts/candidate.mjs +4 -4
  114. package/scripts/composers.mjs +25 -5
  115. package/scripts/env-file.mjs +86 -0
  116. package/scripts/file-classes.mjs +15 -0
  117. package/scripts/migrate-english-routes.mjs +276 -0
  118. package/scripts/ownership-conflict.mjs +5 -2
  119. package/scripts/pinning.mjs +74 -5
  120. package/scripts/plan-apply.mjs +149 -5
  121. package/scripts/reconcile.mjs +49 -11
  122. package/scripts/render-templates.mjs +97 -44
  123. package/scripts/section-config.mjs +253 -0
  124. package/scripts/starter.mjs +17 -0
  125. package/scripts/theme/color.mjs +185 -0
  126. package/scripts/theme/css-theme.mjs +233 -0
  127. package/scripts/theme/fonts.mjs +123 -0
  128. package/scripts/theme/import-export.mjs +125 -0
  129. package/scripts/theme/preset.mjs +93 -0
  130. package/scripts/theme/theme-plan.mjs +292 -0
  131. package/scripts/theme/tokens.mjs +137 -0
  132. package/scripts/view-assembly.mjs +57 -3
  133. package/scripts/view-selection.mjs +1 -1
  134. package/skills/sf-feature/SKILL.md +32 -19
  135. package/skills/sf-setup/SKILL.md +79 -0
  136. package/skills/sf-theme-gen/SKILL.md +99 -36
  137. package/skills/sf-theme-gen/references/shadcn-theming.md +87 -0
  138. package/skills/{shadcn-theming/references/templates → sf-theme-gen/references}/theme-setup.md +15 -19
  139. package/skills/{shadcn-theming → sf-theme-gen}/references/theming-guide.md +6 -11
  140. package/skills/sf-view-gen/SKILL.md +63 -40
  141. package/skills/sf-view-gen/assets/recipes/archetypes.json +33 -46
  142. package/skills/sf-view-gen/assets/recipes/catalog.json +245 -153
  143. package/skills/sf-view-gen/assets/recipes/catalog.schema.json +4 -0
  144. package/skills/sf-view-gen/assets/recipes/features.json +28 -5
  145. package/skills/sf-view-gen/assets/recipes/recipes.json +159 -59
  146. package/skills/sf-view-gen/assets/recipes/sections.json +10 -0
  147. package/skills/sf-view-gen/assets/templates/views/sections/cta.client.tsx +1 -1
  148. package/skills/sf-view-gen/assets/templates/views/sections/faq.client.tsx +1 -1
  149. package/skills/sf-view-gen/assets/templates/views/sections/logoCloud.client.tsx +1 -1
  150. package/skills/sf-view-gen/assets/templates/views/sections/pricing.client.tsx +1 -1
  151. package/skills/sf-view-gen/assets/templates/views/sections/products.client.tsx +100 -0
  152. package/skills/sf-view-gen/assets/templates/views/sections/products.tsx +19 -0
  153. package/skills/sf-view-gen/assets/templates/views/sections/schema.products.ts +39 -0
  154. package/skills/sf-view-gen/assets/templates/views/sections/statistics.client.tsx +1 -1
  155. package/skills/sf-view-gen/assets/templates/views/sections/testimonials.client.tsx +1 -1
  156. package/skills/{json-render-core/SKILL.md → sf-view-gen/references/json-render-core.md} +4 -27
  157. package/skills/{json-render-next/SKILL.md → sf-view-gen/references/json-render-next.md} +5 -8
  158. package/skills/{json-render-react/SKILL.md → sf-view-gen/references/json-render-react.md} +3 -5
  159. package/skills/{json-render-shadcn/SKILL.md → sf-view-gen/references/json-render-shadcn.md} +3 -5
  160. package/skills/sf-view-gen/references/views.md +28 -37
  161. package/skills/sf-view-gen/scripts/catalog.mjs +10 -0
  162. package/skills/sf-view-gen/scripts/validate.mjs +75 -4
  163. package/skills/storefront-workflow/SKILL.md +94 -31
  164. package/skills/{storefront-best-practices/reference/design.md → storefront-workflow/references/design-consistency.md} +13 -29
  165. package/CHANGELOG.md +0 -84
  166. package/assets/templates/views/home/assembly/slots/benefits/Feature1/binding.json +0 -5
  167. package/assets/templates/views/home/assembly/slots/benefits/Feature2/binding.json +0 -5
  168. package/assets/templates/views/home/assembly/slots/benefits/Feature2/registry.part +0 -10
  169. package/assets/templates/views/home/assembly/slots/categories/ProductCategory2/binding.json +0 -5
  170. package/assets/templates/views/home/assembly/slots/categories/ProductCategory2/catalog.part +0 -4
  171. package/assets/templates/views/home/assembly/slots/categories/ProductCategory2/registry.part +0 -16
  172. package/assets/templates/views/home/assembly/slots/hero/StorefrontHero1/binding.json +0 -5
  173. package/assets/templates/views/home/assembly/slots/hero/StorefrontHero1/catalog.part +0 -4
  174. package/assets/templates/views/home/assembly/slots/hero/StorefrontHero1/element.part +0 -5
  175. package/assets/templates/views/user-panel/index.tsx +0 -106
  176. package/assets/templates/views/user-panel/registry.tsx +0 -54
  177. package/assets/templates/views/user-panel/schema.ts +0 -79
  178. package/commands/sf-add-view.md +0 -57
  179. package/commands/sf-feature.md +0 -28
  180. package/commands/sf-theme.md +0 -26
  181. package/commands/sf-view.md +0 -67
  182. package/skills/building-storefronts/SKILL.md +0 -178
  183. package/skills/building-storefronts/references/frontend-integration.md +0 -229
  184. package/skills/json-render-remotion/SKILL.md +0 -111
  185. package/skills/json-render-solid/SKILL.md +0 -204
  186. package/skills/nextjs-shadcn/SKILL.md +0 -367
  187. package/skills/nextjs-shadcn/references/architecture.md +0 -499
  188. package/skills/nextjs-shadcn/references/project-setup.md +0 -162
  189. package/skills/nextjs-shadcn/references/shadcn-platform.md +0 -261
  190. package/skills/nextjs-shadcn/references/sidebar.md +0 -274
  191. package/skills/nextjs-shadcn/references/styling.md +0 -555
  192. package/skills/shadcn-component-discovery/SKILL.md +0 -273
  193. package/skills/shadcn-component-discovery/references/registries.md +0 -226
  194. package/skills/shadcn-theming/SKILL.md +0 -104
  195. package/skills/storefront-best-practices/SKILL.md +0 -421
  196. package/skills/storefront-best-practices/reference/components/breadcrumbs.md +0 -123
  197. package/skills/storefront-best-practices/reference/components/cart-popup.md +0 -189
  198. package/skills/storefront-best-practices/reference/components/country-selector.md +0 -298
  199. package/skills/storefront-best-practices/reference/components/footer.md +0 -112
  200. package/skills/storefront-best-practices/reference/components/hero.md +0 -241
  201. package/skills/storefront-best-practices/reference/components/megamenu.md +0 -239
  202. package/skills/storefront-best-practices/reference/components/navbar.md +0 -397
  203. package/skills/storefront-best-practices/reference/components/popups.md +0 -221
  204. package/skills/storefront-best-practices/reference/components/product-card.md +0 -125
  205. package/skills/storefront-best-practices/reference/components/product-reviews.md +0 -217
  206. package/skills/storefront-best-practices/reference/components/product-slider.md +0 -174
  207. package/skills/storefront-best-practices/reference/components/search.md +0 -101
  208. package/skills/storefront-best-practices/reference/connecting-to-backend.md +0 -391
  209. package/skills/storefront-best-practices/reference/features/promotions.md +0 -307
  210. package/skills/storefront-best-practices/reference/features/wishlist.md +0 -230
  211. package/skills/storefront-best-practices/reference/layouts/account.md +0 -380
  212. package/skills/storefront-best-practices/reference/layouts/cart.md +0 -316
  213. package/skills/storefront-best-practices/reference/layouts/checkout.md +0 -486
  214. package/skills/storefront-best-practices/reference/layouts/home-page.md +0 -264
  215. package/skills/storefront-best-practices/reference/layouts/order-confirmation.md +0 -231
  216. package/skills/storefront-best-practices/reference/layouts/product-details.md +0 -527
  217. package/skills/storefront-best-practices/reference/layouts/product-listing.md +0 -520
  218. package/skills/storefront-best-practices/reference/layouts/static-pages.md +0 -356
  219. package/skills/storefront-best-practices/reference/medusa.md +0 -307
  220. /package/assets/templates/views/home/assembly/slots/benefits/{Feature1 → cards}/catalog.part +0 -0
  221. /package/assets/templates/views/home/assembly/slots/benefits/{Feature1 → cards}/element.part +0 -0
  222. /package/assets/templates/views/home/assembly/slots/benefits/{Feature2 → split}/catalog.part +0 -0
  223. /package/assets/templates/views/home/assembly/slots/benefits/{Feature2 → split}/element.part +0 -0
  224. /package/skills/{storefront-best-practices/reference → storefront-workflow/references}/mobile-responsiveness.md +0 -0
  225. /package/skills/{storefront-best-practices/reference → storefront-workflow/references}/seo.md +0 -0
@@ -8,62 +8,156 @@
8
8
  "description": "Storefront landing page with hero, benefits, and category highlights",
9
9
  "route": "/",
10
10
  "loader": "home",
11
- "requiredDataKeys": ["heroProducts", "categories"],
11
+ "requiredDataKeys": [
12
+ "heroProducts",
13
+ "categories"
14
+ ],
12
15
  "defaultVariants": {
13
- "hero": "StorefrontHero1",
14
- "benefits": "Feature1",
15
- "categories": "ProductCategory2"
16
+ "hero": "StorefrontHero",
17
+ "benefits": "cards",
18
+ "categories": "CategoryGrid"
16
19
  },
17
20
  "allowedVariants": {
18
- "hero": ["StorefrontHero1", "StorefrontHero2", "StorefrontHero5", "StorefrontHero6"],
19
- "benefits": ["Feature1", "Feature2"],
20
- "categories": ["ProductCategory1", "ProductCategory2", "ProductCategory4", "ProductCategory5"],
21
- "productCard": ["ProductCard1", "ProductCard2", "ProductCard3", "ProductCard5"]
21
+ "hero": [
22
+ "StorefrontHero"
23
+ ],
24
+ "benefits": [
25
+ "cards",
26
+ "split"
27
+ ],
28
+ "categories": [
29
+ "CategoryGrid"
30
+ ],
31
+ "productCard": [
32
+ "ProductGrid"
33
+ ]
22
34
  },
23
- "optionalSections": ["testimonials", "faq", "statistics", "logoCloud", "pricing"],
24
- "registeredSlots": ["hero", "benefits", "categories"],
25
- "allowedSections": ["faq", "cta"],
35
+ "optionalSections": [
36
+ "testimonials",
37
+ "faq",
38
+ "statistics",
39
+ "logoCloud",
40
+ "pricing"
41
+ ],
42
+ "registeredSlots": [
43
+ "hero",
44
+ "benefits",
45
+ "categories"
46
+ ],
47
+ "allowedSections": [
48
+ "faq",
49
+ "cta",
50
+ "products"
51
+ ],
26
52
  "maxSections": 4
27
53
  },
28
54
  {
29
55
  "name": "product",
30
56
  "mvp": true,
31
57
  "description": "Single product detail page with overview, gallery, and reviews",
32
- "route": "/productos/[id]",
58
+ "route": "/products/[id]",
33
59
  "loader": "product",
34
- "requiredDataKeys": ["selectedProduct"],
60
+ "requiredDataKeys": [
61
+ "selectedProduct"
62
+ ],
35
63
  "defaultVariants": {
36
- "overview": "ProductOverview1",
37
- "reviews": "ReviewRating1"
64
+ "overview": "ProductOverview",
65
+ "reviews": "ReviewRating1",
66
+ "breadcrumb": "Breadcrumb"
38
67
  },
39
68
  "allowedVariants": {
40
- "overview": ["ProductOverview1", "ProductOverview2", "ProductOverview5"],
41
- "reviews": ["ReviewRating1", "ReviewRating2"],
42
- "productCard": ["ProductCard1", "ProductCard2", "ProductCard3", "ProductCard5"]
69
+ "overview": [
70
+ "ProductOverview"
71
+ ],
72
+ "reviews": [
73
+ "ReviewRating1",
74
+ "ReviewRating2"
75
+ ],
76
+ "breadcrumb": [
77
+ "Breadcrumb"
78
+ ],
79
+ "productCard": [
80
+ "ProductGrid"
81
+ ]
43
82
  },
44
- "optionalSections": ["testimonials", "faq", "statistics"],
45
- "registeredSlots": ["overview", "reviews"],
83
+ "optionalSections": [
84
+ "testimonials",
85
+ "faq",
86
+ "statistics"
87
+ ],
88
+ "registeredSlots": [
89
+ "overview",
90
+ "reviews",
91
+ "breadcrumb"
92
+ ],
46
93
  "allowedSections": [],
47
94
  "maxSections": 4
48
95
  },
96
+ {
97
+ "name": "cart",
98
+ "mvp": true,
99
+ "description": "Standalone cart review page with authoritative totals and quantity editing",
100
+ "route": "/cart",
101
+ "loader": "cart",
102
+ "requiredDataKeys": [
103
+ "cart"
104
+ ],
105
+ "defaultVariants": {
106
+ "view": "ShoppingCart"
107
+ },
108
+ "allowedVariants": {
109
+ "view": [
110
+ "ShoppingCart"
111
+ ]
112
+ },
113
+ "optionalSections": [],
114
+ "registeredSlots": [
115
+ "view"
116
+ ],
117
+ "allowedSections": [],
118
+ "maxSections": 0
119
+ },
49
120
  {
50
121
  "name": "category",
51
122
  "mvp": true,
52
123
  "description": "Product listing filtered by category with filters and sorting",
53
- "route": "/categorias/[[...slug]]",
124
+ "route": "/categories/[[...slug]]",
54
125
  "loader": "category",
55
- "requiredDataKeys": ["categoryProducts", "storeCategories"],
126
+ "requiredDataKeys": [
127
+ "categoryProducts",
128
+ "storeCategories"
129
+ ],
56
130
  "defaultVariants": {
57
131
  "filter": "CategoryFilter2",
58
- "productCard": "ProductCard1"
132
+ "productCard": "ProductGrid",
133
+ "breadcrumb": "Breadcrumb"
59
134
  },
60
135
  "allowedVariants": {
61
- "filter": ["CategoryFilter1", "CategoryFilter2", "CategoryFilter4"],
62
- "productCard": ["ProductCard1", "ProductCard2", "ProductCard3", "ProductCard5"]
136
+ "filter": [
137
+ "CategoryFilter1",
138
+ "CategoryFilter2",
139
+ "CategoryFilter4"
140
+ ],
141
+ "productCard": [
142
+ "ProductGrid"
143
+ ],
144
+ "breadcrumb": [
145
+ "Breadcrumb"
146
+ ]
63
147
  },
64
- "optionalSections": ["logoCloud", "testimonials"],
65
- "registeredSlots": ["filter", "productCard"],
66
- "allowedSections": ["faq", "cta"],
148
+ "optionalSections": [
149
+ "logoCloud",
150
+ "testimonials"
151
+ ],
152
+ "registeredSlots": [
153
+ "breadcrumb",
154
+ "filter",
155
+ "productCard"
156
+ ],
157
+ "allowedSections": [
158
+ "faq",
159
+ "cta"
160
+ ],
67
161
  "maxSections": 4
68
162
  },
69
163
  {
@@ -72,17 +166,29 @@
72
166
  "description": "Multi-step checkout with cart summary, shipping, and payment",
73
167
  "route": "/checkout",
74
168
  "loader": "checkout",
75
- "requiredDataKeys": ["checkoutCountries", "checkoutPaymentMethods"],
169
+ "requiredDataKeys": [
170
+ "checkoutCountries",
171
+ "checkoutPaymentMethods"
172
+ ],
76
173
  "defaultVariants": {
77
174
  "checkout": "CheckoutForm1",
78
175
  "confirmation": "CheckoutConfirmation"
79
176
  },
80
177
  "allowedVariants": {
81
- "checkout": ["CheckoutForm1", "CheckoutForm2", "CheckoutForm3"],
82
- "confirmation": ["CheckoutConfirmation"]
178
+ "checkout": [
179
+ "CheckoutForm1",
180
+ "CheckoutForm2",
181
+ "CheckoutForm3"
182
+ ],
183
+ "confirmation": [
184
+ "CheckoutConfirmation"
185
+ ]
83
186
  },
84
187
  "optionalSections": [],
85
- "registeredSlots": ["checkout", "confirmation"],
188
+ "registeredSlots": [
189
+ "checkout",
190
+ "confirmation"
191
+ ],
86
192
  "allowedSections": [],
87
193
  "maxSections": 4
88
194
  },
@@ -90,20 +196,34 @@
90
196
  "name": "account",
91
197
  "mvp": true,
92
198
  "description": "Customer account area with sign-in, registration, and a minimal signed-in state",
93
- "route": "/cuenta",
199
+ "route": "/account",
94
200
  "loader": "account",
95
- "requiredDataKeys": ["accountCustomer"],
201
+ "requiredDataKeys": [
202
+ "accountCustomer"
203
+ ],
96
204
  "defaultVariants": {
97
205
  "login": "LoginPage1",
98
206
  "register": "SignUpPage1"
99
207
  },
100
208
  "allowedVariants": {
101
- "login": ["LoginPage1", "LoginPage2"],
102
- "register": ["SignUpPage1"],
103
- "orders": ["OrderHistory1", "OrderHistory2"]
209
+ "login": [
210
+ "LoginPage1",
211
+ "LoginPage2"
212
+ ],
213
+ "register": [
214
+ "SignUpPage1"
215
+ ],
216
+ "orders": [
217
+ "OrderHistory1",
218
+ "OrderHistory2"
219
+ ]
104
220
  },
105
221
  "optionalSections": [],
106
- "registeredSlots": ["login", "register", "orders"],
222
+ "registeredSlots": [
223
+ "login",
224
+ "register",
225
+ "orders"
226
+ ],
107
227
  "allowedSections": [],
108
228
  "maxSections": 4
109
229
  },
@@ -111,7 +231,7 @@
111
231
  "name": "static",
112
232
  "mvp": true,
113
233
  "description": "Content-driven static pages (contact, legal, about) with per-page metadata",
114
- "route": "/contacto",
234
+ "route": "/contact",
115
235
  "loader": "static",
116
236
  "requiredDataKeys": [],
117
237
  "defaultVariants": {},
@@ -120,26 +240,6 @@
120
240
  "registeredSlots": [],
121
241
  "allowedSections": [],
122
242
  "maxSections": 0
123
- },
124
- {
125
- "name": "user-panel",
126
- "mvp": false,
127
- "description": "Customer account area with order history and account navigation",
128
- "route": "/cuenta",
129
- "loader": "userPanel",
130
- "requiredDataKeys": ["lastOrder", "lastOrderLines", "orderPlaced"],
131
- "defaultVariants": {
132
- "shell": "AppShell1",
133
- "orderHistory": "OrderHistory1"
134
- },
135
- "allowedVariants": {
136
- "shell": ["AppShell1"],
137
- "orderHistory": ["OrderHistory1", "OrderHistory2"]
138
- },
139
- "optionalSections": [],
140
- "registeredSlots": ["shell", "orderHistory"],
141
- "allowedSections": [],
142
- "maxSections": 4
143
243
  }
144
244
  ]
145
245
  }
@@ -31,6 +31,16 @@
31
31
  "propsHint": "badgeText, title, description, primaryCta/secondaryCta (label, href)",
32
32
  "status": "executable"
33
33
  },
34
+ {
35
+ "name": "products",
36
+ "description": "Data-bound product presentation (grid or combined grid-and-carousel) whose selection is configured independently per instance",
37
+ "elementType": "Products",
38
+ "variants": ["ProductGrid", "ProductShowcase1"],
39
+ "defaultVariant": "ProductGrid",
40
+ "dataBound": true,
41
+ "propsHint": "per-instance selection configured in views/<view>/data.ts sectionSources[id] (canonical category/collection/search/ordering query); heading, description, objective, ctaLabel/ctaHref are editorial content",
42
+ "status": "executable"
43
+ },
34
44
  {
35
45
  "name": "statistics",
36
46
  "description": "Key metrics or trust statistics",
@@ -5,7 +5,7 @@
5
5
  // 'use client' boundary, but this fragment keeps the explicit client boundary so
6
6
  // the section composes identically in any consumer graph.
7
7
 
8
- import { CtaSection1 as CtaBlock } from '@thorprovider/blocks'
8
+ import { CtaSection1 as CtaBlock } from '@thorprovider/blocks/blocks/marketing/cta/cta-section-1'
9
9
  import { ctaSection1PropsSchema } from './schema.cta'
10
10
  import type { ViewRegistry } from '../types'
11
11
 
@@ -5,7 +5,7 @@
5
5
  // 'use client' boundary, but this fragment keeps the explicit client boundary so
6
6
  // the section composes identically in any consumer graph.
7
7
 
8
- import { FaqBlock1 as FaqBlock } from '@thorprovider/blocks'
8
+ import { FaqBlock1 as FaqBlock } from '@thorprovider/blocks/blocks/marketing/faq/faq-block-1'
9
9
  import { faqPropsSchema } from './schema.faq'
10
10
  import type { ViewRegistry } from '../types'
11
11
 
@@ -3,7 +3,7 @@
3
3
  // Optional section fragment: logoCloud (mirrors recipes/sections.json) — client registry.
4
4
  // The matching server-side catalog entry lives in logoCloud.tsx.
5
5
 
6
- import { LogoCloud1 as LogoCloudBlock } from '@thorprovider/blocks'
6
+ import { LogoCloud1 as LogoCloudBlock } from '@thorprovider/blocks/blocks/marketing/logo-clouds/logo-cloud-1'
7
7
  import { logoCloudPropsSchema } from './schema.logoCloud'
8
8
  import type { ViewRegistry } from '../types'
9
9
 
@@ -3,7 +3,7 @@
3
3
  // Optional section fragment: pricing (mirrors recipes/sections.json) — client registry.
4
4
  // The matching server-side catalog entry lives in pricing.tsx.
5
5
 
6
- import { PricingSection1 as PricingBlock } from '@thorprovider/blocks'
6
+ import { PricingSection1 as PricingBlock } from '@thorprovider/blocks/blocks/marketing/pricing/pricing-section-1'
7
7
  import { pricingPropsSchema } from './schema.pricing'
8
8
  import type { ViewRegistry } from '../types'
9
9
 
@@ -0,0 +1,100 @@
1
+ 'use client'
2
+
3
+ // Optional section fragment: products (mirrors recipes/sections.json) — client registry.
4
+ // The matching server-side catalog lives in products.tsx. A data-bound section
5
+ // renders one of two verified presentations (the canonical ProductGrid listing,
6
+ // or the combined grid-and-carousel ProductShowcase1) chosen by the resolved
7
+ // `variant`. The selection and resolved products arrive through the view state;
8
+ // this boundary only validates them and wires navigation/purchase callbacks.
9
+
10
+ import { ProductGrid as ProductGridBlock } from '@thorprovider/blocks/blocks/e-commerce/product-list/product-grid'
11
+ import ProductShowcase1Block from '@thorprovider/blocks/blocks/e-commerce/product-list/product-showcase-1'
12
+ import type { ProductPresentation } from '@thorprovider/blocks/contracts'
13
+ import { useStateStore } from '@json-render/react'
14
+ import { useSectionObservation } from '../../section-observation'
15
+ import { productsPropsSchema, type ProductsStatus } from './schema.products'
16
+ import type { ViewRegistry } from '../types'
17
+
18
+ // Truthful, actionable messages for the non-`ready` states. A failed or
19
+ // unconfigured section never fabricates products.
20
+ function sectionStatusMessage(status: ProductsStatus): string {
21
+ switch (status) {
22
+ case 'unconfigured':
23
+ return 'Esta sección de productos aún no tiene una selección configurada.'
24
+ case 'empty':
25
+ return 'Esta selección no tiene productos disponibles por ahora.'
26
+ case 'invalid-query':
27
+ return 'La selección de productos de esta sección no es válida.'
28
+ case 'unsupported-query':
29
+ return 'Esta selección usa criterios que el catálogo no admite.'
30
+ case 'unmounted-capability':
31
+ return 'Esta selección requiere una capacidad que este catálogo no tiene montada.'
32
+ case 'data-error':
33
+ return 'No se pudieron cargar los productos de esta sección.'
34
+ default:
35
+ return ''
36
+ }
37
+ }
38
+
39
+ export const productsRegistry: ViewRegistry = {
40
+ Products: ({ props, emit }) => {
41
+ const { set } = useStateStore()
42
+ const parsed = productsPropsSchema.parse(props)
43
+ const { containerRef, noteProductClick } = useSectionObservation({
44
+ sectionId: parsed.sectionId ?? '',
45
+ sectionType: parsed.sectionType ?? 'products',
46
+ ...(parsed.variant ? { sectionVariant: parsed.variant } : {}),
47
+ ...(parsed.objective ? { objective: parsed.objective } : {}),
48
+ })
49
+
50
+ if (parsed.status !== 'ready') {
51
+ return (
52
+ <section
53
+ aria-label={parsed.heading ?? 'Productos'}
54
+ className="mx-auto w-full max-w-7xl px-4 py-12"
55
+ >
56
+ {parsed.heading ? (
57
+ <h2 className="mb-2 text-2xl font-semibold tracking-tight">{parsed.heading}</h2>
58
+ ) : null}
59
+ <p className="text-sm text-muted-foreground">{sectionStatusMessage(parsed.status)}</p>
60
+ </section>
61
+ )
62
+ }
63
+
64
+ // The detail affordance opens the product so a variant is chosen explicitly.
65
+ // It is also the section's observation origin (disabled by default).
66
+ const openProduct = (product: ProductPresentation) => {
67
+ noteProductClick(product)
68
+ set('/lastClicked', product)
69
+ emit('openProduct')
70
+ }
71
+
72
+ // Product-card shortcut: the add affordance adds the product's first
73
+ // purchasable variant (resolved server-side from the product id), then opens
74
+ // the mini-cart. It is not the section's observation origin.
75
+ const addToCart = (product: ProductPresentation) => {
76
+ set('/lastClicked', product)
77
+ emit('addClickedToCart')
78
+ }
79
+
80
+ const shared = {
81
+ onAddToCart: addToCart,
82
+ onProductClick: openProduct,
83
+ }
84
+
85
+ return (
86
+ <div ref={containerRef}>
87
+ {parsed.variant === 'ProductShowcase1' ? (
88
+ <ProductShowcase1Block
89
+ {...shared}
90
+ heading={parsed.heading}
91
+ description={parsed.description}
92
+ products={parsed.products}
93
+ />
94
+ ) : (
95
+ <ProductGridBlock {...shared} heading={parsed.heading} items={parsed.products} />
96
+ )}
97
+ </div>
98
+ )
99
+ },
100
+ }
@@ -0,0 +1,19 @@
1
+ // Optional section fragment: products (mirrors recipes/sections.json)
2
+ // Server-side part: element type + zod catalog entry. The component mappings
3
+ // live in products.client.tsx ('use client'). Unlike the stateless editorial
4
+ // fragments (faq/cta), the products section is data-bound: its per-instance
5
+ // selection is resolved by the host loader and delivered through the view state,
6
+ // so this catalog entry describes the *resolved* props shape.
7
+
8
+ import { productsPropsSchema } from './schema.products'
9
+
10
+ export const productsSection = {
11
+ elementType: 'Products',
12
+ catalog: {
13
+ Products: {
14
+ props: productsPropsSchema,
15
+ description: 'Data-bound product presentation (grid or combined grid-and-carousel).',
16
+ },
17
+ },
18
+ registryModule: './products.client',
19
+ }
@@ -0,0 +1,39 @@
1
+ // Optional section fragment: products (mirrors recipes/sections.json) — shared contract.
2
+ // Zod mirror of the resolved Products section props, shared by the server catalog
3
+ // (products.tsx) and the client registry (products.client.tsx). The product list
4
+ // reuses the canonical presentation contract owned by @thorprovider/blocks so the
5
+ // section renders exactly what the host mapped from the catalog result.
6
+
7
+ import { z } from 'zod'
8
+ import { productPresentationSchema } from '@thorprovider/blocks/contracts'
9
+
10
+ // The per-instance resolution status the host loader computes for a data-bound
11
+ // section. `ready`/`empty` carry resolved products; the remaining states carry no
12
+ // products and render an actionable, truthful message instead.
13
+ export const productsStatusSchema = z.enum([
14
+ 'unconfigured',
15
+ 'ready',
16
+ 'empty',
17
+ 'invalid-query',
18
+ 'unsupported-query',
19
+ 'unmounted-capability',
20
+ 'data-error',
21
+ ])
22
+
23
+ export const productsPropsSchema = z.object({
24
+ sectionId: z.string().min(1).optional(),
25
+ sectionType: z.string().min(1).optional(),
26
+ variant: z.string().optional(),
27
+ // Defensive defaults: a missing resolved state (e.g. the view loader could not
28
+ // run) degrades to a truthful error instead of crashing the render.
29
+ status: productsStatusSchema.default('data-error'),
30
+ products: z.array(productPresentationSchema).default([]),
31
+ heading: z.string().optional(),
32
+ description: z.string().optional(),
33
+ objective: z.string().optional(),
34
+ ctaLabel: z.string().optional(),
35
+ ctaHref: z.string().optional(),
36
+ })
37
+
38
+ export type ProductsProps = z.infer<typeof productsPropsSchema>
39
+ export type ProductsStatus = z.infer<typeof productsStatusSchema>
@@ -3,7 +3,7 @@
3
3
  // Optional section fragment: statistics (mirrors recipes/sections.json) — client registry.
4
4
  // The matching server-side catalog entry lives in statistics.tsx.
5
5
 
6
- import { Statistic1 as StatisticBlock } from '@thorprovider/blocks'
6
+ import { Statistic1 as StatisticBlock } from '@thorprovider/blocks/blocks/marketing/statistics/statistic-1'
7
7
  import { statisticsPropsSchema } from './schema.statistics'
8
8
  import { resolveIcon } from '../../icon-map'
9
9
  import type { ViewRegistry } from '../types'
@@ -3,7 +3,7 @@
3
3
  // Optional section fragment: testimonials (mirrors recipes/sections.json) — client registry.
4
4
  // The matching server-side catalog entry lives in testimonials.tsx.
5
5
 
6
- import { Testimonial1 as TestimonialBlock } from '@thorprovider/blocks'
6
+ import { Testimonial1 as TestimonialBlock } from '@thorprovider/blocks/blocks/marketing/testimonials/testimonial-1'
7
7
  import { testimonialsPropsSchema } from './schema.testimonials'
8
8
  import type { ViewRegistry } from '../types'
9
9
 
@@ -1,38 +1,15 @@
1
- ---
2
- name: core
3
- description: Core package for defining schemas, catalogs, and AI prompt generation for json-render. Use when working with @json-render/core, defining schemas, creating catalogs, or building JSON specs for UI/video generation.
4
- ---
1
+ # @json-render/core reference
5
2
 
6
- # @json-render/core
7
-
8
- Core package for schema definition, catalog creation, and spec streaming.
3
+ Reference material for the `sf-view-gen` skill: schema definition, catalog
4
+ creation, and spec shape for `@json-render/core`.
9
5
 
10
6
  ## Key Concepts
11
7
 
12
8
  - **Schema**: Defines the structure of specs and catalogs (use `defineSchema`)
13
9
  - **Catalog**: Maps component/action names to their definitions (use `defineCatalog`)
14
- - **Spec**: JSON output from AI that conforms to the schema
10
+ - **Spec**: JSON output that conforms to the schema
15
11
  - **SpecStream**: JSONL streaming format for progressive spec building
16
12
 
17
- ## Experimental Decision-Model Composition
18
-
19
- For decision-model composition, import `experimental_composeSpec` and `experimental_createEvaluator` from `@json-render/core`. These APIs are unreleased; use a source build until published, then pin exact versions. Experimental exports and `Experimental_` types can change in any release.
20
-
21
- - Run the Gateway evaluator server-side with `{ model: "typesafe-ai/jev", apiKey: process.env.AI_GATEWAY_API_KEY! }`. A plain model identifier is required; Jev is the current example; do not import a provider constructor.
22
- - Call `experimental_composeSpec({ catalog, candidates, prompt, evaluate, initialState, signal })`. It is an async generator; stream `step.spec` snapshots to your existing renderer and inspect `complete.stopReason` (`finish`, `limit`, `unavailable`). Errors and cancellation throw; retain the last snapshot as partial UI.
23
- - New trees default to `strategy: "batch"`: one evaluation selects root/membership, then a second arranges the selected elements when needed. The first snapshot contains selected content in catalog order under the root's default/first slot. Resource variants share one exclusive question; repeated counts include the root. Root selection takes precedence over conflicting speculative membership for that recipe/resource. Equal sibling positions retain catalog order. Combined layouts are validated before publication; cycles or excessive depth throw. `maxElements` caps batched creation (default 32). Limit-truncated selections or a missing required layout call return `limit`. Use `strategy: "sequential"` for legacy `next`/`parent` adapters or sequential creation. Edits stay sequential.
24
- - Batched trace steps use `choice: "select" | "layout"` and an `answers` record. Count each trace as one evaluation, including its tokens and latency once. Custom evaluators must answer every offered question; names/choices are opaque and include `root`/`select_*`, then `parent_*`/`order_*` for batches.
25
- - For follow-up edits, pass the selected version as `initialSpec`. It is cloned and validated; the evaluator may add, replace, remove non-root subtrees, or move/reorder them. Unchanged IDs, bindings, and state are preserved. Optional `elementDescriptions` shares identifying descriptions without exposing raw props/state. `initialState` overrides the seed state. Seeds must be valid trees within the catalog, expression subset, and depth limit. Matching recipes consume usage/resource limits; removals/replacements release them. Replacements/moves use two evaluations (select target, then recipe/destination), each counted against the budget. Treat operation and position keys as opaque.
26
- - Supply atomic candidates with `{ id, description, element: { type, props, on?, visible? }, root?, maxUses?, resource? }`. Catalog alone is insufficient: the app must supply values and binding recipes. Jev chooses elements and parent slots, never free-form text or code. It never executes actions.
27
- - Candidates are configured component instances, not page templates. Build them from current app records/operations or bind props to `initialState`; offer explicit alternatives for chart types, field configurations, and layout variants. The model chooses grouping and order within those options. Name required sections in prompts; structural validity does not imply semantic completeness.
28
- - V1 supports flat Spec catalogs, named slots, literals, `$state`, `$bindState`, and state visibility. No prebuilt children, repeat/watch, computed/template/conditional props, or custom directives. Success/error callbacks must reference allowed actions. Events must be declared in the component catalog.
29
- - Props and action params are validated against initial state without applying schema transforms/defaults. Supply valid initial values and validate/authorize action calls at runtime. Built-ins without parameter schemas get name validation only.
30
- - `root` defaults true, `maxUses` defaults one, shared `resource` values make alternatives mutually exclusive. Defaults: 32 evaluations (terminal calls included; no extra finish call for batches), depth eight, 10-second Gateway timeout per call. Supply an overall abort signal.
31
- - Candidate descriptions, prompt, instructions, topology, and explicit `context` are sent to the evaluator. Initial state and raw props/binding values are not sent automatically.
32
- - For custom providers implement `Experimental_CompositionEvaluator`: accept `{ state, questions, signal }`, return `{ answers: { [question]: { choice, confidence? } }, usage?: { inputTokens? } }`. Only return offered criteria keys.
33
-
34
- See `packages/core/README.md` and `/docs/jev` for app integration and source-build instructions. The web playground is an example consumer, not a dependency of the API.
35
-
36
13
  ## Defining a Schema
37
14
 
38
15
  ```typescript
@@ -1,17 +1,14 @@
1
- ---
2
- name: next
3
- description: Next.js renderer for json-render that turns JSON specs into full Next.js applications with routes, layouts, SSR, and metadata. Use when working with @json-render/next, building Next.js apps from JSON specs, or creating AI-generated multi-page applications.
4
- ---
1
+ # @json-render/next reference
5
2
 
6
- # @json-render/next
3
+ Reference material for the `sf-view-gen` skill: the Next.js rendering shape that
4
+ converts the json-render spec into routes, layouts, SSR, and metadata.
7
5
 
8
6
  Next.js renderer that converts JSON specs into full Next.js applications with routes, pages, layouts, metadata, and SSR support.
9
7
 
10
8
  ## Quick Start
11
9
 
12
- ```bash
13
- npm install @json-render/core @json-render/react @json-render/next
14
- ```
10
+ `@json-render/core`, `@json-render/react`, and `@json-render/next` are already
11
+ dependencies of the generated storefront; no install step is needed.
15
12
 
16
13
  ### 1. Define Your Spec
17
14
 
@@ -1,9 +1,7 @@
1
- ---
2
- name: react
3
- description: React renderer for json-render that turns JSON specs into React components. Use when working with @json-render/react, building React UIs from JSON, creating component catalogs, or rendering AI-generated specs.
4
- ---
1
+ # @json-render/react reference
5
2
 
6
- # @json-render/react
3
+ Reference material for the `sf-view-gen` skill: registry mapping, providers,
4
+ bindings, and action wiring for the React renderer.
7
5
 
8
6
  React renderer that converts JSON specs into React component trees.
9
7
 
@@ -1,9 +1,7 @@
1
- ---
2
- name: shadcn
3
- description: Pre-built shadcn/ui components for json-render. Use when working with @json-render/shadcn, adding standard UI components to a catalog, or building web UIs with Radix UI + Tailwind CSS components.
4
- ---
1
+ # @json-render/shadcn reference
5
2
 
6
- # @json-render/shadcn
3
+ Reference material for the `sf-view-gen` skill: the standard shadcn/ui component
4
+ definitions and implementations available to a catalog.
7
5
 
8
6
  Pre-built shadcn/ui component definitions and implementations for json-render. Provides 36 components built on Radix UI + Tailwind CSS.
9
7