@thorprovider/storefront 0.6.3 → 0.9.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 (161) hide show
  1. package/README.md +22 -2
  2. package/assets/templates/AGENTS.md +14 -2
  3. package/assets/templates/app/app/[[...slug]]/page.tsx +9 -2
  4. package/assets/templates/app/lib/__STOREFRONT__/account-address.ts +129 -0
  5. package/assets/templates/app/lib/__STOREFRONT__/account-lifecycle.client.tsx +2 -2
  6. package/assets/templates/app/lib/__STOREFRONT__/account-private.core.ts +143 -0
  7. package/assets/templates/app/lib/__STOREFRONT__/account-profile.ts +220 -0
  8. package/assets/templates/app/lib/__STOREFRONT__/actions.ts +1234 -75
  9. package/assets/templates/app/lib/__STOREFRONT__/addresses-port.ts +107 -0
  10. package/assets/templates/app/lib/__STOREFRONT__/checkout-shipping.core.ts +37 -0
  11. package/assets/templates/app/lib/__STOREFRONT__/commerce.ts +460 -35
  12. package/assets/templates/app/lib/__STOREFRONT__/confirmation.core.ts +240 -0
  13. package/assets/templates/app/lib/__STOREFRONT__/customer-profile-port.ts +103 -0
  14. package/assets/templates/app/lib/__STOREFRONT__/order-detail-port.ts +26 -0
  15. package/assets/templates/app/lib/__STOREFRONT__/orders-port.ts +30 -0
  16. package/assets/templates/app/lib/__STOREFRONT__/ports.ts +18 -0
  17. package/assets/templates/app/lib/__STOREFRONT__/projection-ownership.client.tsx +4 -4
  18. package/assets/templates/app/lib/__STOREFRONT__/session.ts +24 -6
  19. package/assets/templates/app/lib/__STOREFRONT__/state.core.ts +28 -1
  20. package/assets/templates/app/lib/__STOREFRONT__/views/sections/address-book-advanced.client.tsx +29 -0
  21. package/assets/templates/app/lib/__STOREFRONT__/views/sections/checkout-commerce-v1.client.tsx +19 -0
  22. package/assets/templates/app/lib/__STOREFRONT__/views/sections/checkout-commerce-v1.tsx +16 -0
  23. package/assets/templates/app/lib/__STOREFRONT__/views/sections/customer-profile.client.tsx +27 -0
  24. package/assets/templates/app/lib/__STOREFRONT__/views/sections/index.ts +5 -1
  25. package/assets/templates/app/lib/__STOREFRONT__/views/sections/marketplace-product-card.client.tsx +19 -0
  26. package/assets/templates/app/lib/__STOREFRONT__/views/sections/marketplace-product-card.tsx +16 -0
  27. package/assets/templates/app/lib/__STOREFRONT__/views/sections/mega-menu-universal.client.tsx +19 -0
  28. package/assets/templates/app/lib/__STOREFRONT__/views/sections/mega-menu-universal.tsx +16 -0
  29. package/assets/templates/app/lib/__STOREFRONT__/views/sections/schema.address-book-advanced.ts +437 -0
  30. package/assets/templates/app/lib/__STOREFRONT__/views/sections/schema.checkout-commerce-v1.ts +398 -0
  31. package/assets/templates/app/lib/__STOREFRONT__/views/sections/schema.customer-profile.ts +138 -0
  32. package/assets/templates/app/lib/__STOREFRONT__/views/sections/schema.marketplace-product-card.ts +67 -0
  33. package/assets/templates/app/lib/__STOREFRONT__/views/sections/schema.mega-menu-universal.ts +76 -0
  34. package/assets/templates/app/lib/__STOREFRONT__/views/sections/schema.universal-banner.ts +217 -0
  35. package/assets/templates/app/lib/__STOREFRONT__/views/sections/universal-banner.client.tsx +24 -0
  36. package/assets/templates/app/lib/__STOREFRONT__/views/sections/universal-banner.tsx +16 -0
  37. package/assets/templates/features/checkout/handlers.ts +348 -33
  38. package/assets/templates/features/checkout/state.ts +79 -3
  39. package/assets/templates/features/customer-addresses/handlers.ts +11 -0
  40. package/assets/templates/features/customer-addresses/state.ts +33 -0
  41. package/assets/templates/features/customer-auth/state.ts +10 -0
  42. package/assets/templates/features/customer-profile/handlers.ts +11 -0
  43. package/assets/templates/features/customer-profile/state.ts +18 -0
  44. package/assets/templates/views/account/address-book-advanced.defaults.ts +534 -0
  45. package/assets/templates/views/account/assembly/assembly.json +41 -0
  46. package/assets/templates/views/account/assembly/index.skeleton.tsx +229 -0
  47. package/assets/templates/views/account/assembly/registry.skeleton.tsx +1116 -0
  48. package/assets/templates/views/account/assembly/slots/addresses/AddressBookAdvanced/binding.json +5 -0
  49. package/assets/templates/views/account/assembly/slots/addresses/AddressBookAdvanced/catalog.part +4 -0
  50. package/assets/templates/views/account/assembly/slots/addresses/AddressBookAdvanced/element.part +5 -0
  51. package/assets/templates/views/account/assembly/slots/addresses/AddressBookAdvanced/registry.part +1 -0
  52. package/assets/templates/views/account/assembly/slots/addresses/cards/catalog.part +5 -0
  53. package/assets/templates/views/account/assembly/slots/addresses/cards/element.part +10 -0
  54. package/assets/templates/views/account/assembly/slots/addresses/cards/registry.part +1 -0
  55. package/assets/templates/views/account/assembly/slots/boot/AccountBoot/catalog.part +5 -0
  56. package/assets/templates/views/account/assembly/slots/boot/AccountBoot/element.part +5 -0
  57. package/assets/templates/views/account/assembly/slots/boot/AccountBoot/registry.part +1 -0
  58. package/assets/templates/views/account/assembly/slots/login/card/catalog.part +4 -0
  59. package/assets/templates/views/account/assembly/slots/login/card/element.part +13 -0
  60. package/assets/templates/views/account/assembly/slots/login/card/registry.part +1 -0
  61. package/assets/templates/views/account/assembly/slots/orders/OrderHistory/catalog.part +5 -0
  62. package/assets/templates/views/account/assembly/slots/orders/OrderHistory/element.part +5 -0
  63. package/assets/templates/views/account/assembly/slots/orders/OrderHistory/registry.part +2 -0
  64. package/assets/templates/views/account/assembly/slots/orders/OrderHistoryAdvanced/binding.json +5 -0
  65. package/assets/templates/views/account/assembly/slots/orders/OrderHistoryAdvanced/catalog.part +5 -0
  66. package/assets/templates/views/account/assembly/slots/orders/OrderHistoryAdvanced/element.part +5 -0
  67. package/assets/templates/views/account/assembly/slots/orders/OrderHistoryAdvanced/registry.part +1 -0
  68. package/assets/templates/views/account/assembly/slots/profile/CustomerProfileAdvanced/binding.json +5 -0
  69. package/assets/templates/views/account/assembly/slots/profile/CustomerProfileAdvanced/catalog.part +4 -0
  70. package/assets/templates/views/account/assembly/slots/profile/CustomerProfileAdvanced/element.part +5 -0
  71. package/assets/templates/views/account/assembly/slots/profile/CustomerProfileAdvanced/registry.part +1 -0
  72. package/assets/templates/views/account/assembly/slots/profile/form/catalog.part +5 -0
  73. package/assets/templates/views/account/assembly/slots/profile/form/element.part +10 -0
  74. package/assets/templates/views/account/assembly/slots/profile/form/registry.part +1 -0
  75. package/assets/templates/views/account/assembly/slots/register/SignUpPage1/catalog.part +4 -0
  76. package/assets/templates/views/account/assembly/slots/register/SignUpPage1/element.part +13 -0
  77. package/assets/templates/views/account/assembly/slots/register/SignUpPage1/registry.part +1 -0
  78. package/assets/templates/views/account/assembly/slots/summary/stack/catalog.part +5 -0
  79. package/assets/templates/views/account/assembly/slots/summary/stack/element.part +5 -0
  80. package/assets/templates/views/account/assembly/slots/summary/stack/registry.part +1 -0
  81. package/assets/templates/views/account/assembly/slots/summary/tabs/catalog.part +5 -0
  82. package/assets/templates/views/account/assembly/slots/summary/tabs/element.part +5 -0
  83. package/assets/templates/views/account/assembly/slots/summary/tabs/registry.part +1 -0
  84. package/assets/templates/views/account/content.ts +326 -0
  85. package/assets/templates/views/account/customer-profile.defaults.ts +136 -0
  86. package/assets/templates/views/account/index.tsx +218 -35
  87. package/assets/templates/views/account/order-detail.client.tsx +35 -0
  88. package/assets/templates/views/account/order-detail.defaults.ts +457 -0
  89. package/assets/templates/views/account/orders-advanced.client.tsx +166 -0
  90. package/assets/templates/views/account/orders-advanced.defaults.ts +230 -0
  91. package/assets/templates/views/account/registry.tsx +944 -369
  92. package/assets/templates/views/account/schema.ts +50 -0
  93. package/assets/templates/views/account/sections-data.ts +2 -0
  94. package/assets/templates/views/cart/content.ts +1 -0
  95. package/assets/templates/views/category/assembly/index.skeleton.tsx +1 -0
  96. package/assets/templates/views/category/assembly/slots/filter/CategoryListing/element.part +1 -0
  97. package/assets/templates/views/category/content.ts +2 -0
  98. package/assets/templates/views/category/index.tsx +2 -0
  99. package/assets/templates/views/category/sections-data.ts +2 -0
  100. package/assets/templates/views/checkout/checkout-commerce-hosted.tsx +1089 -0
  101. package/assets/templates/views/checkout/content.ts +114 -2
  102. package/assets/templates/views/checkout/index.tsx +7 -1
  103. package/assets/templates/views/checkout/props.ts +70 -22
  104. package/assets/templates/views/checkout/registry.tsx +400 -71
  105. package/assets/templates/views/checkout/schema.ts +260 -9
  106. package/assets/templates/views/home/assembly/assembly.json +28 -0
  107. package/assets/templates/views/home/assembly/index.skeleton.tsx +1 -0
  108. package/assets/templates/views/home/content.ts +2 -0
  109. package/assets/templates/views/home/index.tsx +1 -0
  110. package/assets/templates/views/home/sections-data.ts +2 -0
  111. package/assets/templates/views/product/content.ts +1 -0
  112. package/assets/templates/views/static/content.ts +1 -0
  113. package/bin/storefront.js +343 -13
  114. package/package.json +2 -1
  115. package/recipes/adapter-surface.json +158 -0
  116. package/recipes/archetypes.json +38 -3
  117. package/recipes/catalog.json +138 -1
  118. package/recipes/feature.schema.json +9 -0
  119. package/recipes/features.json +72 -1
  120. package/recipes/manifest.schema.json +5 -0
  121. package/recipes/recipe.schema.json +14 -2
  122. package/recipes/recipes.json +35 -5
  123. package/recipes/section.schema.json +112 -0
  124. package/recipes/sections.json +289 -3
  125. package/recipes/validate.mjs +83 -1
  126. package/scripts/adapter-surface.mjs +41 -0
  127. package/scripts/agent-blocks.mjs +700 -0
  128. package/scripts/block-validator.mjs +45 -0
  129. package/scripts/candidate.mjs +5 -4
  130. package/scripts/composers.mjs +7 -2
  131. package/scripts/default-sections.mjs +78 -0
  132. package/scripts/file-classes.mjs +15 -0
  133. package/scripts/generate-adapter-surface.mjs +148 -0
  134. package/scripts/operations.mjs +100 -0
  135. package/scripts/reconcile.mjs +67 -39
  136. package/scripts/section-configure.mjs +316 -0
  137. package/scripts/sync-assets.mjs +1 -0
  138. package/scripts/view-assembly.mjs +101 -14
  139. package/skills/sf-feature/SKILL.md +19 -0
  140. package/skills/sf-view-gen/SKILL.md +79 -7
  141. package/skills/sf-view-gen/assets/recipes/archetypes.json +38 -3
  142. package/skills/sf-view-gen/assets/recipes/catalog.json +138 -1
  143. package/skills/sf-view-gen/assets/recipes/features.json +72 -1
  144. package/skills/sf-view-gen/assets/recipes/recipes.json +35 -5
  145. package/skills/sf-view-gen/assets/recipes/section.schema.json +112 -0
  146. package/skills/sf-view-gen/assets/recipes/sections.json +289 -3
  147. package/skills/sf-view-gen/assets/templates/views/sections/checkout-commerce-v1.client.tsx +19 -0
  148. package/skills/sf-view-gen/assets/templates/views/sections/checkout-commerce-v1.tsx +16 -0
  149. package/skills/sf-view-gen/assets/templates/views/sections/marketplace-product-card.client.tsx +19 -0
  150. package/skills/sf-view-gen/assets/templates/views/sections/marketplace-product-card.tsx +16 -0
  151. package/skills/sf-view-gen/assets/templates/views/sections/mega-menu-universal.client.tsx +19 -0
  152. package/skills/sf-view-gen/assets/templates/views/sections/mega-menu-universal.tsx +16 -0
  153. package/skills/sf-view-gen/assets/templates/views/sections/schema.checkout-commerce-v1.ts +398 -0
  154. package/skills/sf-view-gen/assets/templates/views/sections/schema.marketplace-product-card.ts +67 -0
  155. package/skills/sf-view-gen/assets/templates/views/sections/schema.mega-menu-universal.ts +76 -0
  156. package/skills/sf-view-gen/assets/templates/views/sections/schema.universal-banner.ts +217 -0
  157. package/skills/sf-view-gen/assets/templates/views/sections/universal-banner.client.tsx +24 -0
  158. package/skills/sf-view-gen/assets/templates/views/sections/universal-banner.tsx +16 -0
  159. package/skills/sf-view-gen/scripts/validate.mjs +83 -1
  160. package/skills/storefront-workflow/SKILL.md +5 -0
  161. package/skills/storefront-workflow/references/mobile-responsiveness.md +1 -1
@@ -0,0 +1,229 @@
1
+ // Thor Commerce view module: account
2
+ // Server Component module: elements + catalog entries + route + loader only.
3
+ // The client-side component mappings live in ./registry.tsx ('use client'); this
4
+ // module imports them as data so the RSC graph never evaluates @json-render/react
5
+ // on the server. Registered by importing it in ../index.ts. Recipe: recipes.json -> "account".
6
+ //
7
+ // The initial render does NOT read the auth cookie here (this module is part of
8
+ // the client catalog graph). The catch-all page seeds the account identity for
9
+ // every route and the globally mounted shared account lifecycle owns identity;
10
+ // the headless `AccountBoot` boundary is passive and only surfaces the retryable
11
+ // unavailable status, so no route-level identity fetch happens here.
12
+ //
13
+ // The element tree is assembled from the registered slots (boot, login,
14
+ // register, summary, orders, profile, addresses). Module slots render only when
15
+ // their feature is installed and the shopper is authenticated; the account frame
16
+ // owns the shape (stack/tabs) and the module navigation.
17
+
18
+ import { notFound } from 'next/navigation'
19
+ import { getDataSource } from '../../store-context'
20
+ import { pageRoot } from '../../spec/page-root'
21
+ import type { StorefrontElement } from '../../spec/types'
22
+ import type { ViewModule } from '../types'
23
+ import { registry } from './registry'
24
+ import { sectionData } from './sections-data'
25
+ import { accountContent } from './content'
26
+ import { orderDetailDefaults } from './order-detail.defaults'
27
+ import { accountOrdersAdvancedDefaults } from './orders-advanced.defaults'@@SECTION_IMPORTS@@
28
+ import {
29
+ accountAddressPropsSchema,
30
+ accountEmptyPropsSchema,
31
+ accountFramePropsSchema,
32
+ accountLoginPropsSchema,
33
+ accountOrderDetailPropsSchema,
34
+ accountOrdersAdvancedPropsSchema,
35
+ accountOrdersPropsSchema,
36
+ accountProfilePropsSchema,
37
+ accountRegisterPropsSchema,
38
+ } from './schema'
39
+ import { customerProfileDefaults } from './customer-profile.defaults'
40
+ import { customerProfilePropsSchema } from '../sections/schema.customer-profile'
41
+ import { addressBookAdvancedDefaults } from './address-book-advanced.defaults'
42
+ import { addressBookAdvancedPropsSchema } from '../sections/schema.address-book-advanced'
43
+
44
+ // Existing stores keep a user-owned content.ts that may predate the advanced
45
+ // orders variant; the derived defaults keep the element type-safe and renderable
46
+ // until the store opts into its own copy.
47
+ const ordersAdvancedContent =
48
+ (accountContent as { ordersAdvanced?: typeof accountOrdersAdvancedDefaults }).ordersAdvanced ??
49
+ accountOrdersAdvancedDefaults
50
+
51
+ const elements: Record<string, StorefrontElement> = {
52
+ // Route-only detail element: it belongs to /account/orders/[id], never to the
53
+ // account page root. The loader supplies the id and the port is injected by
54
+ // the client binding.
55
+ 'account.orderDetail': {
56
+ type: 'AccountOrderDetail',
57
+ props: {
58
+ orderId: { $state: '/orderDetailId' },
59
+ ...orderDetailDefaults,
60
+ },
61
+ },
62
+ @@ELEMENTS@@
63
+ // Route-specific shell roots. The same shell component receives the active
64
+ // module as children; the route, not a client tab, decides which module is
65
+ // current.
66
+ 'account.shell.overview': {
67
+ type: 'AccountShell',
68
+ visible: { $state: '/accountAuthenticated' },
69
+ props: {},
70
+ children: ['account.overview'],
71
+ },
72
+ 'account.shell.orders': {
73
+ type: 'AccountShell',
74
+ visible: { $state: '/accountAuthenticated' },
75
+ props: {},
76
+ children: ['account.orders'],
77
+ },
78
+ 'account.shell.profile': {
79
+ type: 'AccountShell',
80
+ visible: { $state: '/accountAuthenticated' },
81
+ props: {},
82
+ children: ['account.profile'],
83
+ },
84
+ 'account.shell.addresses': {
85
+ type: 'AccountShell',
86
+ visible: { $state: '/accountAuthenticated' },
87
+ props: {},
88
+ children: ['account.addresses'],
89
+ },
90
+ 'account.shell.favorites': {
91
+ type: 'AccountShell',
92
+ visible: { $state: '/accountAuthenticated' },
93
+ props: {},
94
+ children: ['account.favorites'],
95
+ },
96
+ 'account.overview': {
97
+ type: 'AccountOverview',
98
+ visible: { $state: '/accountAuthenticated' },
99
+ props: {},
100
+ },
101
+ 'account.favorites': {
102
+ type: 'AccountModulePlaceholder',
103
+ visible: { $state: '/accountAuthenticated' },
104
+ props: {},
105
+ },
106
+ }
107
+
108
+ const catalog = {
109
+ AccountOrderDetail: {
110
+ props: accountOrderDetailPropsSchema,
111
+ description:
112
+ 'Route-only order detail surface for one authenticated customer order; the host port supplies the data and the block owns its states.',
113
+ },
114
+ @@CATALOG@@
115
+ AccountShell: {
116
+ props: accountEmptyPropsSchema,
117
+ description:
118
+ 'Signed-in designer account shell: identity header, module context bar and the active module as children. The host supplies the customer, capabilities and labels; the shell chooses no panel.',
119
+ },
120
+ AccountOverview: {
121
+ props: accountEmptyPropsSchema,
122
+ description:
123
+ 'Signed-in account overview: a capability-gated card dashboard that links to the account modules. No summaries or counters are invented.',
124
+ },
125
+ AccountModulePlaceholder: {
126
+ props: accountEmptyPropsSchema,
127
+ description:
128
+ 'Documented planned-module panel for the account shell. It describes what the module will hold and exposes no fake data or mutation.',
129
+ },
130
+ }
131
+
132
+ export const account: ViewModule = {
133
+ name: 'account',
134
+ elements,
135
+ catalog,
136
+ registry,
137
+ route: [
138
+ {
139
+ path: '/account',
140
+ loaderName: 'account',
141
+ layout: 'default',
142
+ metadata: {
143
+ title: 'Mi cuenta',
144
+ description: 'Inicia sesión o crea una cuenta para gestionar tu cuenta.',
145
+ },
146
+ entry: pageRoot('account', ['account.boot', 'account.login', 'account.register', 'account.shell.overview'], elements),
147
+ },
148
+ {
149
+ path: '/account/orders',
150
+ loaderName: 'account',
151
+ layout: 'default',
152
+ metadata: {
153
+ title: 'Mis pedidos',
154
+ description: 'Consulta tus pedidos y su estado.',
155
+ },
156
+ entry: pageRoot(
157
+ 'accountOrders',
158
+ ['account.boot', 'account.login', 'account.register', 'account.shell.orders'],
159
+ elements,
160
+ ),
161
+ },
162
+ {
163
+ path: '/account/profile',
164
+ loaderName: 'account',
165
+ layout: 'default',
166
+ metadata: {
167
+ title: 'Mi perfil',
168
+ description: 'Actualiza tus datos personales y de contacto.',
169
+ },
170
+ entry: pageRoot(
171
+ 'accountProfile',
172
+ ['account.boot', 'account.login', 'account.register', 'account.shell.profile'],
173
+ elements,
174
+ ),
175
+ },
176
+ {
177
+ path: '/account/addresses',
178
+ loaderName: 'account',
179
+ layout: 'default',
180
+ metadata: {
181
+ title: 'Direcciones',
182
+ description: 'Gestiona tus direcciones de envío y facturación.',
183
+ },
184
+ entry: pageRoot(
185
+ 'accountAddresses',
186
+ ['account.boot', 'account.login', 'account.register', 'account.shell.addresses'],
187
+ elements,
188
+ ),
189
+ },
190
+ {
191
+ path: '/account/favorites',
192
+ loaderName: 'account',
193
+ layout: 'default',
194
+ metadata: {
195
+ title: 'Listas de compras',
196
+ description: 'Guarda productos para comprarlos más adelante.',
197
+ },
198
+ entry: pageRoot(
199
+ 'accountFavorites',
200
+ ['account.boot', 'account.login', 'account.register', 'account.shell.favorites'],
201
+ elements,
202
+ ),
203
+ },
204
+ {
205
+ // The order detail is a second route of the account view: it inherits the
206
+ // account feature gating and session lifecycle without a new view or
207
+ // feature. The loader only binds the dynamic segment; the loader-free port
208
+ // owns the data read and its typed states.
209
+ path: '/account/orders/[id]',
210
+ loaderName: 'orderDetail',
211
+ layout: 'default',
212
+ metadata: {
213
+ title: 'Pedido',
214
+ description: 'Detalle de tu pedido.',
215
+ },
216
+ entry: pageRoot('accountOrderDetail', ['account.orderDetail'], {
217
+ 'account.orderDetail': elements['account.orderDetail'],
218
+ }),
219
+ },
220
+ ],
221
+ loader: {
222
+ account: async () => ({ dataSource: getDataSource(), dataError: null }),
223
+ orderDetail: async (params) => {
224
+ const orderId = Array.isArray(params.id) ? params.id[0] : params.id
225
+ if (!orderId) notFound()
226
+ return { orderDetailId: orderId }
227
+ },
228
+ },
229
+ }