@thorprovider/storefront 0.7.0 → 0.10.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 (164) 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 +677 -80
  9. package/assets/templates/app/lib/__STOREFRONT__/addresses-port.ts +107 -0
  10. package/assets/templates/app/lib/__STOREFRONT__/commerce.ts +477 -38
  11. package/assets/templates/app/lib/__STOREFRONT__/confirmation.core.ts +240 -0
  12. package/assets/templates/app/lib/__STOREFRONT__/customer-profile-port.ts +103 -0
  13. package/assets/templates/app/lib/__STOREFRONT__/fulfillment-evidence-port.ts +31 -0
  14. package/assets/templates/app/lib/__STOREFRONT__/handlers.core.ts +21 -4
  15. package/assets/templates/app/lib/__STOREFRONT__/mappers.ts +6 -2
  16. package/assets/templates/app/lib/__STOREFRONT__/order-detail-mapper.ts +642 -0
  17. package/assets/templates/app/lib/__STOREFRONT__/order-detail-port.ts +25 -0
  18. package/assets/templates/app/lib/__STOREFRONT__/orders-port.ts +30 -0
  19. package/assets/templates/app/lib/__STOREFRONT__/ports.ts +28 -0
  20. package/assets/templates/app/lib/__STOREFRONT__/projection-ownership.client.tsx +4 -4
  21. package/assets/templates/app/lib/__STOREFRONT__/session.ts +24 -6
  22. package/assets/templates/app/lib/__STOREFRONT__/state.core.ts +21 -0
  23. package/assets/templates/app/lib/__STOREFRONT__/views/sections/address-book-advanced.client.tsx +29 -0
  24. package/assets/templates/app/lib/__STOREFRONT__/views/sections/checkout-commerce-v1.client.tsx +19 -0
  25. package/assets/templates/app/lib/__STOREFRONT__/views/sections/checkout-commerce-v1.tsx +16 -0
  26. package/assets/templates/app/lib/__STOREFRONT__/views/sections/customer-profile.client.tsx +27 -0
  27. package/assets/templates/app/lib/__STOREFRONT__/views/sections/index.ts +4 -1
  28. package/assets/templates/app/lib/__STOREFRONT__/views/sections/mega-menu-universal.client.tsx +19 -0
  29. package/assets/templates/app/lib/__STOREFRONT__/views/sections/mega-menu-universal.tsx +16 -0
  30. package/assets/templates/app/lib/__STOREFRONT__/views/sections/schema.address-book-advanced.ts +437 -0
  31. package/assets/templates/app/lib/__STOREFRONT__/views/sections/schema.checkout-commerce-v1.ts +398 -0
  32. package/assets/templates/app/lib/__STOREFRONT__/views/sections/schema.customer-profile.ts +138 -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 +24 -4
  38. package/assets/templates/features/customer-addresses/handlers.ts +11 -0
  39. package/assets/templates/features/customer-addresses/state.ts +33 -0
  40. package/assets/templates/features/customer-auth/state.ts +10 -0
  41. package/assets/templates/features/customer-profile/handlers.ts +11 -0
  42. package/assets/templates/features/customer-profile/state.ts +18 -0
  43. package/assets/templates/views/account/address-book-advanced.defaults.ts +534 -0
  44. package/assets/templates/views/account/assembly/assembly.json +36 -0
  45. package/assets/templates/views/account/assembly/index.skeleton.tsx +277 -0
  46. package/assets/templates/views/account/assembly/registry.skeleton.tsx +1057 -0
  47. package/assets/templates/views/account/assembly/slots/addresses/AddressBookAdvanced/binding.json +5 -0
  48. package/assets/templates/views/account/assembly/slots/addresses/AddressBookAdvanced/catalog.part +4 -0
  49. package/assets/templates/views/account/assembly/slots/addresses/AddressBookAdvanced/element.part +5 -0
  50. package/assets/templates/views/account/assembly/slots/addresses/AddressBookAdvanced/registry.part +1 -0
  51. package/assets/templates/views/account/assembly/slots/addresses/cards/catalog.part +5 -0
  52. package/assets/templates/views/account/assembly/slots/addresses/cards/element.part +10 -0
  53. package/assets/templates/views/account/assembly/slots/addresses/cards/registry.part +1 -0
  54. package/assets/templates/views/account/assembly/slots/login/card/catalog.part +4 -0
  55. package/assets/templates/views/account/assembly/slots/login/card/element.part +13 -0
  56. package/assets/templates/views/account/assembly/slots/login/card/registry.part +1 -0
  57. package/assets/templates/views/account/assembly/slots/orders/OrderHistory/catalog.part +5 -0
  58. package/assets/templates/views/account/assembly/slots/orders/OrderHistory/element.part +5 -0
  59. package/assets/templates/views/account/assembly/slots/orders/OrderHistory/registry.part +2 -0
  60. package/assets/templates/views/account/assembly/slots/orders/OrderHistoryAdvanced/binding.json +5 -0
  61. package/assets/templates/views/account/assembly/slots/orders/OrderHistoryAdvanced/catalog.part +5 -0
  62. package/assets/templates/views/account/assembly/slots/orders/OrderHistoryAdvanced/element.part +5 -0
  63. package/assets/templates/views/account/assembly/slots/orders/OrderHistoryAdvanced/registry.part +1 -0
  64. package/assets/templates/views/account/assembly/slots/profile/CustomerProfileAdvanced/binding.json +5 -0
  65. package/assets/templates/views/account/assembly/slots/profile/CustomerProfileAdvanced/catalog.part +4 -0
  66. package/assets/templates/views/account/assembly/slots/profile/CustomerProfileAdvanced/element.part +5 -0
  67. package/assets/templates/views/account/assembly/slots/profile/CustomerProfileAdvanced/registry.part +1 -0
  68. package/assets/templates/views/account/assembly/slots/profile/form/catalog.part +5 -0
  69. package/assets/templates/views/account/assembly/slots/profile/form/element.part +10 -0
  70. package/assets/templates/views/account/assembly/slots/profile/form/registry.part +1 -0
  71. package/assets/templates/views/account/assembly/slots/register/SignUpPage1/catalog.part +4 -0
  72. package/assets/templates/views/account/assembly/slots/register/SignUpPage1/element.part +13 -0
  73. package/assets/templates/views/account/assembly/slots/register/SignUpPage1/registry.part +1 -0
  74. package/assets/templates/views/account/assembly/slots/summary/stack/catalog.part +5 -0
  75. package/assets/templates/views/account/assembly/slots/summary/stack/element.part +5 -0
  76. package/assets/templates/views/account/assembly/slots/summary/stack/registry.part +1 -0
  77. package/assets/templates/views/account/assembly/slots/summary/tabs/catalog.part +5 -0
  78. package/assets/templates/views/account/assembly/slots/summary/tabs/element.part +5 -0
  79. package/assets/templates/views/account/assembly/slots/summary/tabs/registry.part +1 -0
  80. package/assets/templates/views/account/content.ts +326 -0
  81. package/assets/templates/views/account/customer-profile.defaults.ts +136 -0
  82. package/assets/templates/views/account/fulfillment-evidence.client.tsx +34 -0
  83. package/assets/templates/views/account/fulfillment-evidence.defaults.ts +145 -0
  84. package/assets/templates/views/account/fulfillment-evidence.schema.ts +15 -0
  85. package/assets/templates/views/account/index.tsx +259 -38
  86. package/assets/templates/views/account/order-detail.client.tsx +35 -0
  87. package/assets/templates/views/account/order-detail.defaults.ts +457 -0
  88. package/assets/templates/views/account/orders-advanced.client.tsx +77 -0
  89. package/assets/templates/views/account/orders-advanced.defaults.ts +230 -0
  90. package/assets/templates/views/account/registry.tsx +935 -420
  91. package/assets/templates/views/account/schema.ts +50 -0
  92. package/assets/templates/views/account/sections-data.ts +2 -0
  93. package/assets/templates/views/cart/content.ts +1 -0
  94. package/assets/templates/views/category/assembly/index.skeleton.tsx +1 -0
  95. package/assets/templates/views/category/assembly/slots/filter/CategoryListing/element.part +1 -0
  96. package/assets/templates/views/category/content.ts +2 -0
  97. package/assets/templates/views/category/index.tsx +2 -0
  98. package/assets/templates/views/category/sections-data.ts +2 -0
  99. package/assets/templates/views/checkout/checkout-commerce-hosted.tsx +1089 -0
  100. package/assets/templates/views/checkout/content.ts +51 -0
  101. package/assets/templates/views/checkout/index.tsx +1 -1
  102. package/assets/templates/views/checkout/props.ts +10 -2
  103. package/assets/templates/views/checkout/registry.tsx +104 -42
  104. package/assets/templates/views/checkout/schema.ts +76 -1
  105. package/assets/templates/views/home/assembly/assembly.json +23 -2
  106. package/assets/templates/views/home/assembly/index.skeleton.tsx +4 -1
  107. package/assets/templates/views/home/assembly/registry.skeleton.tsx +1 -0
  108. package/assets/templates/views/home/assembly/slots/hero/UniversalBanner/binding.json +5 -0
  109. package/assets/templates/views/home/assembly/slots/hero/UniversalBanner/catalog.part +4 -0
  110. package/assets/templates/views/home/assembly/slots/hero/UniversalBanner/element.part +4 -0
  111. package/assets/templates/views/home/assembly/slots/hero/UniversalBanner/registry.part +10 -0
  112. package/assets/templates/views/home/content.ts +247 -1
  113. package/assets/templates/views/home/data.ts +10 -1
  114. package/assets/templates/views/home/index.tsx +8 -6
  115. package/assets/templates/views/home/props.ts +7 -1
  116. package/assets/templates/views/home/registry.tsx +11 -28
  117. package/assets/templates/views/home/schema.ts +163 -0
  118. package/assets/templates/views/home/sections-data.ts +2 -0
  119. package/assets/templates/views/product/content.ts +1 -0
  120. package/assets/templates/views/static/content.ts +1 -0
  121. package/bin/storefront.js +356 -27
  122. package/package.json +2 -1
  123. package/recipes/adapter-surface.json +159 -0
  124. package/recipes/archetypes.json +43 -4
  125. package/recipes/catalog.json +147 -2
  126. package/recipes/feature.schema.json +9 -0
  127. package/recipes/features.json +72 -1
  128. package/recipes/manifest.schema.json +5 -0
  129. package/recipes/recipe.schema.json +13 -1
  130. package/recipes/recipes.json +37 -7
  131. package/recipes/section.schema.json +112 -0
  132. package/recipes/sections.json +281 -4
  133. package/recipes/validate.mjs +83 -1
  134. package/scripts/adapter-surface.mjs +41 -0
  135. package/scripts/agent-blocks.mjs +700 -0
  136. package/scripts/block-validator.mjs +45 -0
  137. package/scripts/candidate.mjs +56 -14
  138. package/scripts/composers.mjs +7 -2
  139. package/scripts/default-sections.mjs +78 -0
  140. package/scripts/file-classes.mjs +18 -0
  141. package/scripts/generate-adapter-surface.mjs +148 -0
  142. package/scripts/operations.mjs +100 -0
  143. package/scripts/reconcile.mjs +67 -39
  144. package/scripts/section-configure.mjs +316 -0
  145. package/scripts/sync-assets.mjs +1 -0
  146. package/scripts/view-assembly.mjs +101 -14
  147. package/skills/sf-feature/SKILL.md +19 -0
  148. package/skills/sf-view-gen/SKILL.md +73 -7
  149. package/skills/sf-view-gen/assets/recipes/archetypes.json +43 -4
  150. package/skills/sf-view-gen/assets/recipes/catalog.json +147 -2
  151. package/skills/sf-view-gen/assets/recipes/features.json +72 -1
  152. package/skills/sf-view-gen/assets/recipes/recipes.json +37 -7
  153. package/skills/sf-view-gen/assets/recipes/section.schema.json +112 -0
  154. package/skills/sf-view-gen/assets/recipes/sections.json +281 -4
  155. package/skills/sf-view-gen/assets/templates/views/sections/checkout-commerce-v1.client.tsx +19 -0
  156. package/skills/sf-view-gen/assets/templates/views/sections/checkout-commerce-v1.tsx +16 -0
  157. package/skills/sf-view-gen/assets/templates/views/sections/mega-menu-universal.client.tsx +19 -0
  158. package/skills/sf-view-gen/assets/templates/views/sections/mega-menu-universal.tsx +16 -0
  159. package/skills/sf-view-gen/assets/templates/views/sections/schema.checkout-commerce-v1.ts +398 -0
  160. package/skills/sf-view-gen/assets/templates/views/sections/schema.mega-menu-universal.ts +76 -0
  161. package/skills/sf-view-gen/assets/templates/views/sections/schema.universal-banner.ts +217 -0
  162. package/skills/sf-view-gen/assets/templates/views/sections/universal-banner.client.tsx +24 -0
  163. package/skills/sf-view-gen/assets/templates/views/sections/universal-banner.tsx +16 -0
  164. package/skills/sf-view-gen/scripts/validate.mjs +83 -1
@@ -0,0 +1,159 @@
1
+ {
2
+ "version": "1.0.0",
3
+ "commerce": [
4
+ "addShippingMethod",
5
+ "addToCart",
6
+ "applyDiscountCode",
7
+ "cancelOrder",
8
+ "checkInventoryLevels",
9
+ "completeCheckout",
10
+ "createCart",
11
+ "createFulfillment",
12
+ "createRefund",
13
+ "getAdminOrders",
14
+ "getCart",
15
+ "getCategories",
16
+ "getCategory",
17
+ "getCategoryProducts",
18
+ "getCollection",
19
+ "getCollectionProducts",
20
+ "getCollections",
21
+ "getFulfillmentOptions",
22
+ "getPaymentMethods",
23
+ "getProduct",
24
+ "getProductRecommendations",
25
+ "getProducts",
26
+ "getRegionCountries",
27
+ "getShippingMethods",
28
+ "getStockLocations",
29
+ "getStorefrontContext",
30
+ "initiatePaymentSession",
31
+ "isStorefrontRequired",
32
+ "removeDiscountCode",
33
+ "removeFromCart",
34
+ "updateCart",
35
+ "validateCartStock"
36
+ ],
37
+ "auth": [
38
+ "createAddress",
39
+ "deleteAddress",
40
+ "deleteCustomerAccount",
41
+ "getAddresses",
42
+ "getAuthToken",
43
+ "getCurrentCustomer",
44
+ "isAuthenticated",
45
+ "login",
46
+ "logout",
47
+ "register",
48
+ "requestPasswordReset",
49
+ "resetPassword",
50
+ "updateAddress",
51
+ "updateCustomer"
52
+ ],
53
+ "runtime": [
54
+ "addCartLines",
55
+ "addShippingMethod",
56
+ "addToCart",
57
+ "applyCategoryQueryChange",
58
+ "applyCheckoutShippingGroups",
59
+ "applyManualTestPayment",
60
+ "applyPaymentMethod",
61
+ "applySavedAddress",
62
+ "assertCartMatchesContext",
63
+ "assignCartToCustomer",
64
+ "buildActiveFilterChips",
65
+ "buildCategoryQueryHref",
66
+ "buildCategoryRepairHref",
67
+ "buildPagination",
68
+ "catalogHistoryMode",
69
+ "catalogResultsCacheKey",
70
+ "checkoutShippingGroupId",
71
+ "clearFilterParams",
72
+ "completeCart",
73
+ "completeCheckout",
74
+ "createCart",
75
+ "createCartForContext",
76
+ "createCustomerAddress",
77
+ "deleteCustomerAddress",
78
+ "deriveDefaultFilterSet",
79
+ "getCart",
80
+ "getCartForContext",
81
+ "getCatalogResults",
82
+ "getCatalogSortKeys",
83
+ "getCategoryProductsByHandle",
84
+ "getCategoryProductsByHandleWithSource",
85
+ "getCheckoutCountries",
86
+ "getCheckoutShippingGroups",
87
+ "getCollectionOptions",
88
+ "getCommerceClient",
89
+ "getCommerceClientWithToken",
90
+ "getCurrentCustomer",
91
+ "getCustomerAddresses",
92
+ "getCustomerOrderDetail",
93
+ "getCustomerOrders",
94
+ "getCustomerOrdersPage",
95
+ "getDataSource",
96
+ "getEligibleShippingMethods",
97
+ "getGeoCities",
98
+ "getGeoProvinces",
99
+ "getMerchandiseByHandle",
100
+ "getMockCommerceClient",
101
+ "getPaymentMethods",
102
+ "getPaymentMethodsByRegion",
103
+ "getProductByHandle",
104
+ "getProductDetailByHandle",
105
+ "getProductDetailById",
106
+ "getRegionCountries",
107
+ "getShippingMethods",
108
+ "initiatePaymentSession",
109
+ "isCountryEligible",
110
+ "loadCategoryListing",
111
+ "loginCustomer",
112
+ "logoutCustomer",
113
+ "makeTokenStorage",
114
+ "mapCatalogOutcomeToStatus",
115
+ "mapCatalogResultsToCategoryListing",
116
+ "normalizePriceRange",
117
+ "prefillCheckoutFromCustomer",
118
+ "reconcileCart",
119
+ "registerCustomer",
120
+ "removeActiveFilter",
121
+ "removeCartLines",
122
+ "removeFromCart",
123
+ "resolveAbsoluteQuantity",
124
+ "resolveCategoryFacetSupport",
125
+ "resolveCategoryListingSupport",
126
+ "resolveVariantPrice",
127
+ "selectApprovedManualTestProvider",
128
+ "selectFirstPurchasableVariant",
129
+ "selectShippingMethod",
130
+ "selectVariant",
131
+ "toAbsoluteLineUpdate",
132
+ "toCardProduct",
133
+ "toCartItem",
134
+ "toCartItems",
135
+ "toCatalogProductDetail",
136
+ "toCatalogVariant",
137
+ "toCategoryTree",
138
+ "toCheckoutShippingGroups",
139
+ "toCommerceError",
140
+ "toCompletionError",
141
+ "toListingProduct",
142
+ "toStoreCategory",
143
+ "updateBillingAddress",
144
+ "updateCart",
145
+ "updateCartLines",
146
+ "updateCustomer",
147
+ "updateCustomerAddress",
148
+ "updateShippingAddress",
149
+ "validateCheckoutAddress",
150
+ "validateCheckoutAddressForRegion",
151
+ "validateCustomerAddressForRegion",
152
+ "withCommerceProvider"
153
+ ],
154
+ "generatedFrom": [
155
+ "packages/types/src/commerce-provider.ts",
156
+ "packages/types/src/auth.ts",
157
+ "packages/runtime/src/commerce"
158
+ ]
159
+ }
@@ -4,8 +4,12 @@
4
4
  "description": "Archetype (intent) layer. Maps a slot to named intents so selection is by meaning, not by variant ordinal. Each intent resolves to a variant that MUST be allowed by the recipe for that slot.",
5
5
  "slots": {
6
6
  "home.hero": {
7
- "default": "compact",
7
+ "default": "campaign",
8
8
  "intents": {
9
+ "campaign": {
10
+ "variant": "UniversalBanner",
11
+ "when": "A deal-forward multi-banner campaign wall grounded in the connected catalog (universal-banner family)."
12
+ },
9
13
  "compact": {
10
14
  "variant": "StorefrontHero",
11
15
  "when": "A simple, text-forward hero with a single call to action (canonical `presentation: 'compact'`)."
@@ -146,15 +150,50 @@
146
150
  }
147
151
  },
148
152
  "account.orders": {
149
- "default": "cards",
153
+ "default": "advanced",
150
154
  "intents": {
155
+ "advanced": {
156
+ "variant": "OrderHistoryAdvanced",
157
+ "when": "The signed-in shopper's full order history: search, quick filters, sort, counts and order cards driven by the host `OrdersPort` (the default surface)."
158
+ },
151
159
  "cards": {
152
160
  "variant": "OrderHistory",
153
- "when": "A signed-in shopper's order history with one card per order and details on demand (canonical `presentation: 'cards'`)."
161
+ "when": "A minimal order history rendered by the canonical `OrderHistory` block with one summary card per order and no query controls."
154
162
  },
155
163
  "rows": {
156
164
  "variant": "OrderHistory",
157
- "when": "A compact, list-first order history with one bordered row per order (canonical `presentation: 'rows'`)."
165
+ "when": "A minimal, list-first order history rendered by the canonical `OrderHistory` block in its `rows` presentation."
166
+ }
167
+ }
168
+ },
169
+ "account.summary": {
170
+ "default": "stack",
171
+ "intents": {
172
+ "stack": {
173
+ "variant": "stack",
174
+ "when": "A single scrolling account page: identity, then every installed module in order, with in-page navigation (canonical `presentation: 'stack'`)."
175
+ },
176
+ "tabs": {
177
+ "variant": "tabs",
178
+ "when": "One module visible at a time behind a tablist (canonical `presentation: 'tabs'`)."
179
+ }
180
+ }
181
+ },
182
+ "account.profile": {
183
+ "default": "form",
184
+ "intents": {
185
+ "form": {
186
+ "variant": "form",
187
+ "when": "The shopper's editable profile fields, with the email control present only when the backend supports changing it."
188
+ }
189
+ }
190
+ },
191
+ "account.addresses": {
192
+ "default": "cards",
193
+ "intents": {
194
+ "cards": {
195
+ "variant": "cards",
196
+ "when": "The shopper's saved addresses as cards, with create, edit, delete, and default-address actions."
158
197
  }
159
198
  }
160
199
  }
@@ -4,7 +4,7 @@
4
4
  "description": "Initial semantic executable catalog (E1 tasks 1.2-1.3), classified by source-shape inspection of the @thorprovider/blocks prop contracts and the view templates. Scope: every slot the curated MVP views (home, product, category, checkout, account) render by default, covering both the selectable archetype slots declared by recipes/archetypes.json and the nested default slots that have no archetype (category.productCard, checkout.confirmation) so no legacy default support is dropped. The account view declares canonical LoginPage card/social presentations and SignUpPage1; legacy LoginPage1/LoginPage2 names resolve to card/social through legacyAliases, with social remaining held pending verified account lifecycle wiring. A variant is `executable` only when the slot's canonical data shape can feed its block props without a prop bridge and without inventing data; every other non-default variant is `held` with the specific reason. The one non-default structural choice is home.benefits, which selects between the two bounded presentations (`cards`, `split`) of the single canonical `Feature` block (identical item contract, no bridge); the retired numbered names `Feature1`/`Feature2` resolve through the slot's `legacyAliases`. E2 task 6.1 declares the base listing slot category.filter CategoryFilter2 as the single controlled listing (dataShape `CatalogQuery & CatalogResults`, state controlled) with the search/filter controls contributed by the logical mounts category.search / category.filters (no second block). Source-shape compatibility is not end-to-end backend behavior proof: the render is executable, but the category.search.apply / category.filter.apply actions remain held under the capability catalog (owner: storefront-catalog-search-filters, E2) until a real runtime proof. The `capabilities` map declares those operational capabilities with their requirements and verification state; E1 declares the held category.filter.apply action, E2 adds the held category.search.apply action and the held category.price.range capability that gates the category-filters showPrice option; no capability is claimed verified. The home.hero variants of the retired numbered family (StorefrontHero1/2/5/6) resolve through the slot's `legacyAliases` to the single canonical `StorefrontHero`, whose bounded presentation options (`compact`, `showcase`, `editorial`, `promotional`) preserve the four structural identities; the extended editorial/promotional sections render only from host-supplied data and are omitted otherwise. The category.productCard slot's retired numbered family (ProductCard1/2/3/5) and the previous `ProductCard` variant resolve through the slot's `legacyAliases` to the single canonical `ProductGrid` listing, which renders `ProductCard` item cells with bounded presentation options (`classic`, `minimal`, `rich`) that preserve the three structural identities; the rich presentation's wishlist and view-similar affordances are host-owned and optional, evidence (rating, badge, compare-at) renders only from host-supplied data, and the comparison-table variant `ProductCard5` was discarded as a listing controller, not a card presentation.",
5
5
  "slots": {
6
6
  "home.hero": {
7
- "default": "StorefrontHero",
7
+ "default": "UniversalBanner",
8
8
  "legacyAliases": {
9
9
  "StorefrontHero1": "StorefrontHero",
10
10
  "StorefrontHero2": "StorefrontHero",
@@ -31,6 +31,14 @@
31
31
  "requirements": [
32
32
  "heroProducts"
33
33
  ]
34
+ },
35
+ "UniversalBanner": {
36
+ "status": "executable",
37
+ "block": "UniversalBanner",
38
+ "dataShape": "UniversalBannerData",
39
+ "events": [],
40
+ "state": "uncontrolled",
41
+ "requirements": []
34
42
  }
35
43
  }
36
44
  },
@@ -329,7 +337,7 @@
329
337
  }
330
338
  },
331
339
  "account.orders": {
332
- "default": "OrderHistory",
340
+ "default": "OrderHistoryAdvanced",
333
341
  "variants": {
334
342
  "OrderHistory": {
335
343
  "status": "executable",
@@ -343,12 +351,149 @@
343
351
  "accountCustomer",
344
352
  "accountAuthenticated"
345
353
  ]
354
+ },
355
+ "OrderHistoryAdvanced": {
356
+ "status": "executable",
357
+ "block": "OrderHistoryAdvanced",
358
+ "dataShape": "OrdersPage (host OrdersPort; B2C MVP)",
359
+ "events": [
360
+ "viewOrder",
361
+ "queryChange",
362
+ "presentationChange",
363
+ "orderAction",
364
+ "bulkAction"
365
+ ],
366
+ "state": "uncontrolled",
367
+ "requirements": [
368
+ "accountAuthenticated",
369
+ "ordersPort"
370
+ ]
346
371
  }
347
372
  },
348
373
  "legacyAliases": {
349
374
  "OrderHistory2": "OrderHistory"
350
375
  }
351
376
  },
377
+ "account.summary": {
378
+ "default": "stack",
379
+ "variants": {
380
+ "stack": {
381
+ "status": "executable",
382
+ "block": "AccountFrame",
383
+ "dataShape": "Customer & AccountModule[]",
384
+ "events": [
385
+ "selectModule"
386
+ ],
387
+ "state": "controlled",
388
+ "requirements": [
389
+ "accountCustomer",
390
+ "accountAuthenticated"
391
+ ]
392
+ },
393
+ "tabs": {
394
+ "status": "executable",
395
+ "block": "AccountFrame",
396
+ "dataShape": "Customer & AccountModule[]",
397
+ "events": [
398
+ "selectModule"
399
+ ],
400
+ "state": "controlled",
401
+ "requirements": [
402
+ "accountCustomer",
403
+ "accountAuthenticated"
404
+ ]
405
+ },
406
+ "sidebar": {
407
+ "status": "held",
408
+ "reason": "A dashboard sidebar nests the account navigation inside the storefront chrome and needs a layout the generated storefront does not provide yet.",
409
+ "block": "AccountFrame",
410
+ "dataShape": "Customer & AccountModule[]",
411
+ "events": [
412
+ "selectModule"
413
+ ],
414
+ "state": "controlled",
415
+ "requirements": [
416
+ "accountCustomer",
417
+ "accountAuthenticated"
418
+ ]
419
+ }
420
+ }
421
+ },
422
+ "account.profile": {
423
+ "default": "CustomerProfileAdvanced",
424
+ "variants": {
425
+ "form": {
426
+ "status": "executable",
427
+ "block": "ProfileForm",
428
+ "dataShape": "ProfileField[] & ProfileFormLabels",
429
+ "events": [
430
+ "submit"
431
+ ],
432
+ "state": "controlled",
433
+ "requirements": [
434
+ "accountCustomer",
435
+ "accountAuthenticated",
436
+ "accountProfileAvailable"
437
+ ]
438
+ },
439
+ "CustomerProfileAdvanced": {
440
+ "status": "executable",
441
+ "block": "CustomerProfile",
442
+ "dataShape": "CustomerProfileSnapshot (host CustomerProfilePort)",
443
+ "events": [
444
+ "manageOrganization",
445
+ "requestVerification",
446
+ "retry"
447
+ ],
448
+ "state": "controlled",
449
+ "requirements": [
450
+ "accountAuthenticated",
451
+ "customerProfilePort"
452
+ ]
453
+ }
454
+ }
455
+ },
456
+ "account.addresses": {
457
+ "default": "AddressBookAdvanced",
458
+ "variants": {
459
+ "cards": {
460
+ "status": "executable",
461
+ "block": "AddressBook",
462
+ "dataShape": "AccountAddressView[] & AddressBookLabels",
463
+ "events": [
464
+ "create",
465
+ "edit",
466
+ "delete",
467
+ "setDefaultShipping",
468
+ "setDefaultBilling"
469
+ ],
470
+ "state": "controlled",
471
+ "requirements": [
472
+ "accountCustomer",
473
+ "accountAuthenticated",
474
+ "accountAddressesAvailable"
475
+ ]
476
+ },
477
+ "AddressBookAdvanced": {
478
+ "status": "executable",
479
+ "block": "AddressBookAdvanced",
480
+ "dataShape": "AddressListResult (host AddressBookPort)",
481
+ "events": [
482
+ "create",
483
+ "edit",
484
+ "delete",
485
+ "setDefault",
486
+ "select"
487
+ ],
488
+ "state": "controlled",
489
+ "requirements": [
490
+ "accountAuthenticated",
491
+ "accountAddressesAvailable",
492
+ "addressesPort"
493
+ ]
494
+ }
495
+ }
496
+ },
352
497
  "category.breadcrumb": {
353
498
  "default": "Breadcrumb",
354
499
  "variants": {
@@ -15,6 +15,15 @@
15
15
  "name": { "type": "string", "minLength": 1 },
16
16
  "description": { "type": "string" },
17
17
  "mvp": { "type": "boolean" },
18
+ "starter": { "type": "boolean" },
19
+ "status": { "type": "string", "enum": ["executable", "gated", "held"] },
20
+ "reason": { "type": "string", "minLength": 1 },
21
+ "owner": { "type": "string", "minLength": 1 },
22
+ "requires": { "type": "array", "items": { "type": "string", "minLength": 1 } },
23
+ "backendCapabilities": {
24
+ "type": "array",
25
+ "items": { "type": "string", "minLength": 1 }
26
+ },
18
27
  "route": { "type": "string", "minLength": 1 },
19
28
  "views": { "type": "array", "items": { "type": "string" } },
20
29
  "state": { "type": "array", "items": { "type": "string" } },
@@ -4,6 +4,7 @@
4
4
  {
5
5
  "name": "checkout",
6
6
  "mvp": true,
7
+ "status": "executable",
7
8
  "description": "Multi-step checkout: cart validation, shipping, payment, and order placement.",
8
9
  "route": "/checkout",
9
10
  "views": ["checkout"],
@@ -29,6 +30,7 @@
29
30
  {
30
31
  "name": "customer-auth",
31
32
  "mvp": true,
33
+ "status": "executable",
32
34
  "description": "Customer authentication: registration, login, logout, and a minimal signed-in state. Owns the account view.",
33
35
  "route": "/account",
34
36
  "views": ["account"],
@@ -44,9 +46,57 @@
44
46
  "config": { "type": "object", "additionalProperties": false, "properties": {} },
45
47
  "surfaces": []
46
48
  },
49
+ {
50
+ "name": "customer-profile",
51
+ "mvp": true,
52
+ "starter": false,
53
+ "status": "gated",
54
+ "description": "Signed-in profile editor for the account area (name, phone, and email only where the backend supports changing it). Module of customer-auth.",
55
+ "views": [],
56
+ "state": ["accountProfileAvailable", "accountProfilePending", "accountProfileError"],
57
+ "handlers": [],
58
+ "requires": ["customer-auth"],
59
+ "adapter": { "needs": ["updateCustomer"] },
60
+ "backendCapabilities": ["updateProfile"],
61
+ "config": { "type": "object", "additionalProperties": false, "properties": {} },
62
+ "surfaces": []
63
+ },
64
+ {
65
+ "name": "customer-addresses",
66
+ "mvp": true,
67
+ "starter": false,
68
+ "status": "gated",
69
+ "description": "Signed-in address book for the account area (list, create, edit, delete, default shipping and billing). Module of customer-auth.",
70
+ "views": [],
71
+ "state": [
72
+ "accountAddressesAvailable",
73
+ "accountAddresses",
74
+ "accountAddressesPending",
75
+ "accountAddressesError",
76
+ "accountAddressFormOpen",
77
+ "accountAddressEditingId",
78
+ "accountAddressMutationPending",
79
+ "accountAddressMutationError",
80
+ "accountAddressFieldErrors"
81
+ ],
82
+ "handlers": [],
83
+ "requires": ["customer-auth"],
84
+ "adapter": {
85
+ "needs": [
86
+ "getCustomerAddresses",
87
+ "createCustomerAddress",
88
+ "updateCustomerAddress",
89
+ "deleteCustomerAddress"
90
+ ]
91
+ },
92
+ "backendCapabilities": ["manageAddresses"],
93
+ "config": { "type": "object", "additionalProperties": false, "properties": {} },
94
+ "surfaces": []
95
+ },
47
96
  {
48
97
  "name": "static-pages",
49
98
  "mvp": true,
99
+ "status": "executable",
50
100
  "description": "Content-driven static pages (contact, legal, about) served with per-page metadata. Owns the static view.",
51
101
  "route": "/contact",
52
102
  "views": ["static"],
@@ -59,6 +109,7 @@
59
109
  {
60
110
  "name": "benefits",
61
111
  "mvp": true,
112
+ "status": "executable",
62
113
  "description": "Bounded editorial benefits feature that mounts at the home benefits slot; config selects the canonical Feature block's presentation (compact -> cards, detailed -> split) while the item content stays user-owned.",
63
114
  "views": [],
64
115
  "state": [],
@@ -78,6 +129,7 @@
78
129
  {
79
130
  "name": "catalog-search",
80
131
  "mvp": true,
132
+ "status": "executable",
81
133
  "description": "Optional category-listing search control (E2). Installation is presence, not an enabled flag; the config only supplies an optional placeholder. The search input contributes to the single controlled CategoryListing at the category.search logical slot and never adds a block.",
82
134
  "views": [],
83
135
  "state": [],
@@ -96,6 +148,7 @@
96
148
  {
97
149
  "name": "category-filters",
98
150
  "mvp": true,
151
+ "status": "executable",
99
152
  "description": "Optional category-listing filter controls (E2). Installation is presence, not an enabled flag; the config selects which demonstrated basic filters show (filterSet) and whether the price control is shown (showPrice). The controls contribute to the single controlled CategoryListing at the category.filters logical slot and never add a block.",
100
153
  "views": [],
101
154
  "state": [],
@@ -125,6 +178,7 @@
125
178
  {
126
179
  "name": "navigability",
127
180
  "mvp": true,
181
+ "status": "executable",
128
182
  "description": "Cross-cutting navigability feature: entity-derived breadcrumbs with BreadcrumbList structured data on the product and category surfaces, plus skip-to-content, current-page indication, back-to-top, and a mobile bottom navigation in the shared shell.",
129
183
  "views": [],
130
184
  "state": [],
@@ -148,15 +202,32 @@
148
202
  {
149
203
  "name": "recommendations",
150
204
  "mvp": false,
205
+ "status": "held",
206
+ "reason": "No provider method backs a related-products read; the surface is injected through a catalog fallback and is outside the curated MVP set.",
207
+ "owner": "post-MVP recommendations change",
151
208
  "description": "Related-products surface injected into the product view.",
152
209
  "views": [],
153
210
  "state": ["recommendedProducts"],
154
211
  "handlers": [],
155
- "adapter": { "needs": ["getRelatedProducts"], "fallback": "catalog" },
212
+ "adapter": { "needs": [] },
156
213
  "config": { "type": "object", "additionalProperties": false, "properties": {} },
157
214
  "surfaces": [
158
215
  { "host": "product", "slot": "product.related", "element": "ProductGrid" }
159
216
  ]
217
+ },
218
+ {
219
+ "name": "customer-security",
220
+ "mvp": false,
221
+ "status": "held",
222
+ "reason": "Account deletion has no backend endpoint (the adapter throws NOT_IMPLEMENTED) and customer email change is not supported by the Medusa store API.",
223
+ "owner": "future customer-security change",
224
+ "description": "Account security controls: password reset, email change, and account deletion.",
225
+ "views": [],
226
+ "state": [],
227
+ "handlers": [],
228
+ "adapter": { "needs": [] },
229
+ "config": { "type": "object", "additionalProperties": false, "properties": {} },
230
+ "surfaces": []
160
231
  }
161
232
  ]
162
233
  }
@@ -9,6 +9,11 @@
9
9
  "version": { "type": "string", "minLength": 1 },
10
10
  "name": { "type": "string", "minLength": 1 },
11
11
  "siteName": { "type": "string" },
12
+ "capabilities": {
13
+ "type": "array",
14
+ "items": { "type": "string", "minLength": 1 },
15
+ "description": "Backend capability flags recorded by `storefront setup`. Absent means unknown (probe failed or never ran); an empty array means the backend advertises none."
16
+ },
12
17
  "theme": {
13
18
  "type": "object",
14
19
  "required": ["mode"],
@@ -60,7 +60,19 @@
60
60
  "type": "array",
61
61
  "items": { "type": "string" }
62
62
  },
63
- "maxSections": { "type": "number" }
63
+ "maxSections": { "type": "number" },
64
+ "defaultSections": {
65
+ "type": "array",
66
+ "items": {
67
+ "type": "object",
68
+ "required": ["type"],
69
+ "properties": {
70
+ "type": { "type": "string" },
71
+ "after": { "type": "string" }
72
+ },
73
+ "additionalProperties": false
74
+ }
75
+ }
64
76
  }
65
77
  }
66
78
  }