@endora-commerce/mod-catalog 0.108.0 → 0.110.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 (571) hide show
  1. package/dist/admin/components/CopyToChannelsDialog.d.ts +37 -0
  2. package/dist/admin/components/CopyToChannelsDialog.d.ts.map +1 -0
  3. package/dist/admin/components/CopyToChannelsDialog.js +83 -0
  4. package/dist/admin/components/CopyToChannelsDialog.js.map +1 -0
  5. package/dist/admin/components/PackagingUnitsEditor.d.ts +16 -1
  6. package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
  7. package/dist/admin/components/PackagingUnitsEditor.js +20 -14
  8. package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
  9. package/dist/admin/components/ProductAttachmentsSection.d.ts +3 -0
  10. package/dist/admin/components/ProductAttachmentsSection.d.ts.map +1 -0
  11. package/dist/admin/components/ProductAttachmentsSection.js +98 -0
  12. package/dist/admin/components/ProductAttachmentsSection.js.map +1 -0
  13. package/dist/admin/components/ProductAttributesTab.d.ts +1 -11
  14. package/dist/admin/components/ProductAttributesTab.d.ts.map +1 -1
  15. package/dist/admin/components/ProductAttributesTab.js +128 -119
  16. package/dist/admin/components/ProductAttributesTab.js.map +1 -1
  17. package/dist/admin/components/ProductContentCard.d.ts +41 -0
  18. package/dist/admin/components/ProductContentCard.d.ts.map +1 -0
  19. package/dist/admin/components/ProductContentCard.js +28 -0
  20. package/dist/admin/components/ProductContentCard.js.map +1 -0
  21. package/dist/admin/components/ProductGallerySection.d.ts +3 -0
  22. package/dist/admin/components/ProductGallerySection.d.ts.map +1 -0
  23. package/dist/admin/components/ProductGallerySection.js +129 -0
  24. package/dist/admin/components/ProductGallerySection.js.map +1 -0
  25. package/dist/admin/components/ProductOrderRulesCard.d.ts +11 -15
  26. package/dist/admin/components/ProductOrderRulesCard.d.ts.map +1 -1
  27. package/dist/admin/components/ProductOrderRulesCard.js +15 -140
  28. package/dist/admin/components/ProductOrderRulesCard.js.map +1 -1
  29. package/dist/admin/components/ProductScopeBar.d.ts +28 -0
  30. package/dist/admin/components/ProductScopeBar.d.ts.map +1 -0
  31. package/dist/admin/components/ProductScopeBar.js +70 -0
  32. package/dist/admin/components/ProductScopeBar.js.map +1 -0
  33. package/dist/admin/components/ProductScopeOverview.d.ts +38 -0
  34. package/dist/admin/components/ProductScopeOverview.d.ts.map +1 -0
  35. package/dist/admin/components/ProductScopeOverview.js +222 -0
  36. package/dist/admin/components/ProductScopeOverview.js.map +1 -0
  37. package/dist/admin/components/ProductStatusPills.d.ts +17 -0
  38. package/dist/admin/components/ProductStatusPills.d.ts.map +1 -0
  39. package/dist/admin/components/ProductStatusPills.js +23 -0
  40. package/dist/admin/components/ProductStatusPills.js.map +1 -0
  41. package/dist/admin/components/ProductUrlRedirects.d.ts +15 -0
  42. package/dist/admin/components/ProductUrlRedirects.d.ts.map +1 -0
  43. package/dist/admin/components/ProductUrlRedirects.js +70 -0
  44. package/dist/admin/components/ProductUrlRedirects.js.map +1 -0
  45. package/dist/admin/components/ProductsBulkEditDialog.d.ts +30 -0
  46. package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +1 -1
  47. package/dist/admin/components/ProductsBulkEditDialog.js +288 -133
  48. package/dist/admin/components/ProductsBulkEditDialog.js.map +1 -1
  49. package/dist/admin/components/editor/DetailsTab.d.ts +30 -0
  50. package/dist/admin/components/editor/DetailsTab.d.ts.map +1 -0
  51. package/dist/admin/components/editor/DetailsTab.js +59 -0
  52. package/dist/admin/components/editor/DetailsTab.js.map +1 -0
  53. package/dist/admin/components/editor/ImmediateBadge.d.ts +21 -0
  54. package/dist/admin/components/editor/ImmediateBadge.d.ts.map +1 -0
  55. package/dist/admin/components/editor/ImmediateBadge.js +21 -0
  56. package/dist/admin/components/editor/ImmediateBadge.js.map +1 -0
  57. package/dist/admin/components/editor/confirm-removal.d.ts +13 -0
  58. package/dist/admin/components/editor/confirm-removal.d.ts.map +1 -0
  59. package/dist/admin/components/editor/confirm-removal.js +33 -0
  60. package/dist/admin/components/editor/confirm-removal.js.map +1 -0
  61. package/dist/admin/components/editor/editor-context.d.ts +53 -0
  62. package/dist/admin/components/editor/editor-context.d.ts.map +1 -0
  63. package/dist/admin/components/editor/editor-context.js +88 -0
  64. package/dist/admin/components/editor/editor-context.js.map +1 -0
  65. package/dist/admin/components/editor/scoped-controls.d.ts +46 -0
  66. package/dist/admin/components/editor/scoped-controls.d.ts.map +1 -0
  67. package/dist/admin/components/editor/scoped-controls.js +64 -0
  68. package/dist/admin/components/editor/scoped-controls.js.map +1 -0
  69. package/dist/admin/index.d.ts +2 -2
  70. package/dist/admin/index.d.ts.map +1 -1
  71. package/dist/admin/index.js +20 -0
  72. package/dist/admin/index.js.map +1 -1
  73. package/dist/admin/lib/attribute-scope.d.ts +23 -0
  74. package/dist/admin/lib/attribute-scope.d.ts.map +1 -0
  75. package/dist/admin/lib/attribute-scope.js +21 -0
  76. package/dist/admin/lib/attribute-scope.js.map +1 -0
  77. package/dist/admin/lib/bulk-operation-log-text.d.ts +9 -0
  78. package/dist/admin/lib/bulk-operation-log-text.d.ts.map +1 -0
  79. package/dist/admin/lib/bulk-operation-log-text.js +13 -0
  80. package/dist/admin/lib/bulk-operation-log-text.js.map +1 -0
  81. package/dist/admin/lib/editor-scope.d.ts +35 -0
  82. package/dist/admin/lib/editor-scope.d.ts.map +1 -0
  83. package/dist/admin/lib/editor-scope.js +114 -0
  84. package/dist/admin/lib/editor-scope.js.map +1 -0
  85. package/dist/admin/lib/order-minimum-input.d.ts +13 -0
  86. package/dist/admin/lib/order-minimum-input.d.ts.map +1 -0
  87. package/dist/admin/lib/order-minimum-input.js +16 -0
  88. package/dist/admin/lib/order-minimum-input.js.map +1 -0
  89. package/dist/admin/lib/product-labels.d.ts +12 -0
  90. package/dist/admin/lib/product-labels.d.ts.map +1 -0
  91. package/dist/admin/lib/product-labels.js +23 -0
  92. package/dist/admin/lib/product-labels.js.map +1 -0
  93. package/dist/admin/lib/product-scopes-api.d.ts +23 -0
  94. package/dist/admin/lib/product-scopes-api.d.ts.map +1 -0
  95. package/dist/admin/lib/product-scopes-api.js +57 -0
  96. package/dist/admin/lib/product-scopes-api.js.map +1 -0
  97. package/dist/admin/lib/product-url-keys-api.d.ts +23 -0
  98. package/dist/admin/lib/product-url-keys-api.d.ts.map +1 -0
  99. package/dist/admin/lib/product-url-keys-api.js +61 -0
  100. package/dist/admin/lib/product-url-keys-api.js.map +1 -0
  101. package/dist/admin/lib/resolve-product-selection.d.ts +29 -1
  102. package/dist/admin/lib/resolve-product-selection.d.ts.map +1 -1
  103. package/dist/admin/lib/resolve-product-selection.js +42 -6
  104. package/dist/admin/lib/resolve-product-selection.js.map +1 -1
  105. package/dist/admin/lib/scope-overview.d.ts +73 -0
  106. package/dist/admin/lib/scope-overview.d.ts.map +1 -0
  107. package/dist/admin/lib/scope-overview.js +178 -0
  108. package/dist/admin/lib/scope-overview.js.map +1 -0
  109. package/dist/admin/lib/scoped-editor-store.d.ts +81 -0
  110. package/dist/admin/lib/scoped-editor-store.d.ts.map +1 -0
  111. package/dist/admin/lib/scoped-editor-store.js +198 -0
  112. package/dist/admin/lib/scoped-editor-store.js.map +1 -0
  113. package/dist/admin/lib/scoped-values-api.d.ts +14 -0
  114. package/dist/admin/lib/scoped-values-api.d.ts.map +1 -0
  115. package/dist/admin/lib/scoped-values-api.js +55 -0
  116. package/dist/admin/lib/scoped-values-api.js.map +1 -0
  117. package/dist/admin/pages/AttributesManager.d.ts.map +1 -1
  118. package/dist/admin/pages/AttributesManager.js +186 -28
  119. package/dist/admin/pages/AttributesManager.js.map +1 -1
  120. package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +1 -1
  121. package/dist/admin/pages/BulkOperationDetailPage.js +4 -19
  122. package/dist/admin/pages/BulkOperationDetailPage.js.map +1 -1
  123. package/dist/admin/pages/ProductContentPage.d.ts +27 -0
  124. package/dist/admin/pages/ProductContentPage.d.ts.map +1 -0
  125. package/dist/admin/pages/ProductContentPage.js +161 -0
  126. package/dist/admin/pages/ProductContentPage.js.map +1 -0
  127. package/dist/admin/pages/ProductCreateForm.d.ts +3 -0
  128. package/dist/admin/pages/ProductCreateForm.d.ts.map +1 -0
  129. package/dist/admin/pages/ProductCreateForm.js +87 -0
  130. package/dist/admin/pages/ProductCreateForm.js.map +1 -0
  131. package/dist/admin/pages/ProductEditor.d.ts +0 -4
  132. package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
  133. package/dist/admin/pages/ProductEditor.js +878 -627
  134. package/dist/admin/pages/ProductEditor.js.map +1 -1
  135. package/dist/admin/pages/ProductsList.d.ts +12 -0
  136. package/dist/admin/pages/ProductsList.d.ts.map +1 -1
  137. package/dist/admin/pages/ProductsList.js +111 -54
  138. package/dist/admin/pages/ProductsList.js.map +1 -1
  139. package/dist/backend/admin-search-provider.d.ts +3 -2
  140. package/dist/backend/admin-search-provider.d.ts.map +1 -1
  141. package/dist/backend/admin-search-provider.js +2 -3
  142. package/dist/backend/admin-search-provider.js.map +1 -1
  143. package/dist/backend/commands/attribute-commands.d.ts +4 -3
  144. package/dist/backend/commands/attribute-commands.d.ts.map +1 -1
  145. package/dist/backend/commands/attribute-commands.js +82 -21
  146. package/dist/backend/commands/attribute-commands.js.map +1 -1
  147. package/dist/backend/commands/product-content-commands.d.ts +31 -0
  148. package/dist/backend/commands/product-content-commands.d.ts.map +1 -0
  149. package/dist/backend/commands/product-content-commands.js +70 -0
  150. package/dist/backend/commands/product-content-commands.js.map +1 -0
  151. package/dist/backend/commands/scoped-values.commands.d.ts +95 -0
  152. package/dist/backend/commands/scoped-values.commands.d.ts.map +1 -0
  153. package/dist/backend/commands/scoped-values.commands.js +235 -0
  154. package/dist/backend/commands/scoped-values.commands.js.map +1 -0
  155. package/dist/backend/demo/reset.d.ts.map +1 -1
  156. package/dist/backend/demo/reset.js +2 -1
  157. package/dist/backend/demo/reset.js.map +1 -1
  158. package/dist/backend/demo/rows.d.ts +25 -0
  159. package/dist/backend/demo/rows.d.ts.map +1 -1
  160. package/dist/backend/demo/rows.js +35 -12
  161. package/dist/backend/demo/rows.js.map +1 -1
  162. package/dist/backend/demo/seed.d.ts +2 -1
  163. package/dist/backend/demo/seed.d.ts.map +1 -1
  164. package/dist/backend/demo/seed.js +22 -8
  165. package/dist/backend/demo/seed.js.map +1 -1
  166. package/dist/backend/entities/bulk-operation.entity.d.ts +10 -0
  167. package/dist/backend/entities/bulk-operation.entity.d.ts.map +1 -1
  168. package/dist/backend/entities/bulk-operation.entity.js.map +1 -1
  169. package/dist/backend/entities/gallery-item-scope-override.entity.d.ts +30 -0
  170. package/dist/backend/entities/gallery-item-scope-override.entity.d.ts.map +1 -0
  171. package/dist/backend/entities/gallery-item-scope-override.entity.js +80 -0
  172. package/dist/backend/entities/gallery-item-scope-override.entity.js.map +1 -0
  173. package/dist/backend/entities/gallery-item.entity.d.ts +9 -1
  174. package/dist/backend/entities/gallery-item.entity.d.ts.map +1 -1
  175. package/dist/backend/entities/gallery-item.entity.js +16 -0
  176. package/dist/backend/entities/gallery-item.entity.js.map +1 -1
  177. package/dist/backend/entities/gallery-role-scope-override.entity.d.ts +28 -0
  178. package/dist/backend/entities/gallery-role-scope-override.entity.d.ts.map +1 -0
  179. package/dist/backend/entities/gallery-role-scope-override.entity.js +75 -0
  180. package/dist/backend/entities/gallery-role-scope-override.entity.js.map +1 -0
  181. package/dist/backend/entities/product-attachment-scope-override.entity.d.ts +30 -0
  182. package/dist/backend/entities/product-attachment-scope-override.entity.d.ts.map +1 -0
  183. package/dist/backend/entities/product-attachment-scope-override.entity.js +80 -0
  184. package/dist/backend/entities/product-attachment-scope-override.entity.js.map +1 -0
  185. package/dist/backend/entities/product-attachment.entity.d.ts +6 -1
  186. package/dist/backend/entities/product-attachment.entity.d.ts.map +1 -1
  187. package/dist/backend/entities/product-attachment.entity.js +9 -0
  188. package/dist/backend/entities/product-attachment.entity.js.map +1 -1
  189. package/dist/backend/entities/product-attribute.entity.d.ts +5 -9
  190. package/dist/backend/entities/product-attribute.entity.d.ts.map +1 -1
  191. package/dist/backend/entities/product-attribute.entity.js +5 -13
  192. package/dist/backend/entities/product-attribute.entity.js.map +1 -1
  193. package/dist/backend/entities/product-channel-language-scope.entity.d.ts +23 -0
  194. package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +1 -0
  195. package/dist/backend/entities/product-channel-language-scope.entity.js +61 -0
  196. package/dist/backend/entities/product-channel-language-scope.entity.js.map +1 -0
  197. package/dist/backend/entities/product-channel-scope.entity.d.ts +47 -0
  198. package/dist/backend/entities/product-channel-scope.entity.d.ts.map +1 -0
  199. package/dist/backend/entities/product-channel-scope.entity.js +113 -0
  200. package/dist/backend/entities/product-channel-scope.entity.js.map +1 -0
  201. package/dist/backend/entities/product-content-value.entity.d.ts +39 -0
  202. package/dist/backend/entities/product-content-value.entity.d.ts.map +1 -0
  203. package/dist/backend/entities/product-content-value.entity.js +81 -0
  204. package/dist/backend/entities/product-content-value.entity.js.map +1 -0
  205. package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts +30 -0
  206. package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts.map +1 -0
  207. package/dist/backend/entities/product-packaging-unit-scope-override.entity.js +80 -0
  208. package/dist/backend/entities/product-packaging-unit-scope-override.entity.js.map +1 -0
  209. package/dist/backend/entities/product-url-key.entity.d.ts +27 -0
  210. package/dist/backend/entities/product-url-key.entity.d.ts.map +1 -0
  211. package/dist/backend/entities/product-url-key.entity.js +70 -0
  212. package/dist/backend/entities/product-url-key.entity.js.map +1 -0
  213. package/dist/backend/entities/product-url-redirect.entity.d.ts +18 -0
  214. package/dist/backend/entities/product-url-redirect.entity.d.ts.map +1 -0
  215. package/dist/backend/entities/product-url-redirect.entity.js +57 -0
  216. package/dist/backend/entities/product-url-redirect.entity.js.map +1 -0
  217. package/dist/backend/entities/product-variant.entity.d.ts +8 -1
  218. package/dist/backend/entities/product-variant.entity.d.ts.map +1 -1
  219. package/dist/backend/entities/product-variant.entity.js +13 -2
  220. package/dist/backend/entities/product-variant.entity.js.map +1 -1
  221. package/dist/backend/entities/product.entity.d.ts +48 -16
  222. package/dist/backend/entities/product.entity.d.ts.map +1 -1
  223. package/dist/backend/entities/product.entity.js +65 -35
  224. package/dist/backend/entities/product.entity.js.map +1 -1
  225. package/dist/backend/index.d.ts +29 -2
  226. package/dist/backend/index.d.ts.map +1 -1
  227. package/dist/backend/index.js +311 -29
  228. package/dist/backend/index.js.map +1 -1
  229. package/dist/backend/plugin.d.ts +79 -8
  230. package/dist/backend/plugin.d.ts.map +1 -1
  231. package/dist/backend/plugin.js +98 -17
  232. package/dist/backend/plugin.js.map +1 -1
  233. package/dist/backend/prompt-tools.d.ts +11 -0
  234. package/dist/backend/prompt-tools.d.ts.map +1 -1
  235. package/dist/backend/prompt-tools.js +124 -9
  236. package/dist/backend/prompt-tools.js.map +1 -1
  237. package/dist/backend/routes.admin.d.ts +42 -14
  238. package/dist/backend/routes.admin.d.ts.map +1 -1
  239. package/dist/backend/routes.admin.js +214 -134
  240. package/dist/backend/routes.admin.js.map +1 -1
  241. package/dist/backend/routes.admin.url-keys.d.ts +23 -0
  242. package/dist/backend/routes.admin.url-keys.d.ts.map +1 -0
  243. package/dist/backend/routes.admin.url-keys.js +14 -0
  244. package/dist/backend/routes.admin.url-keys.js.map +1 -0
  245. package/dist/backend/routes.api-key.d.ts.map +1 -1
  246. package/dist/backend/routes.api-key.js +18 -3
  247. package/dist/backend/routes.api-key.js.map +1 -1
  248. package/dist/backend/routes.external.d.ts.map +1 -1
  249. package/dist/backend/routes.external.js +6 -1
  250. package/dist/backend/routes.external.js.map +1 -1
  251. package/dist/backend/routes.public.d.ts +31 -7
  252. package/dist/backend/routes.public.d.ts.map +1 -1
  253. package/dist/backend/routes.public.js +114 -33
  254. package/dist/backend/routes.public.js.map +1 -1
  255. package/dist/backend/routes.public.url-keys.d.ts +26 -0
  256. package/dist/backend/routes.public.url-keys.d.ts.map +1 -0
  257. package/dist/backend/routes.public.url-keys.js +17 -0
  258. package/dist/backend/routes.public.url-keys.js.map +1 -0
  259. package/dist/backend/services/asset-references.d.ts +12 -1
  260. package/dist/backend/services/asset-references.d.ts.map +1 -1
  261. package/dist/backend/services/asset-references.js +85 -32
  262. package/dist/backend/services/asset-references.js.map +1 -1
  263. package/dist/backend/services/attachment-packaging-scopes.d.ts +61 -0
  264. package/dist/backend/services/attachment-packaging-scopes.d.ts.map +1 -0
  265. package/dist/backend/services/attachment-packaging-scopes.js +98 -0
  266. package/dist/backend/services/attachment-packaging-scopes.js.map +1 -0
  267. package/dist/backend/services/attachment.service.d.ts +8 -1
  268. package/dist/backend/services/attachment.service.d.ts.map +1 -1
  269. package/dist/backend/services/attachment.service.js +105 -21
  270. package/dist/backend/services/attachment.service.js.map +1 -1
  271. package/dist/backend/services/attribute-filter-match.d.ts +14 -0
  272. package/dist/backend/services/attribute-filter-match.d.ts.map +1 -0
  273. package/dist/backend/services/attribute-filter-match.js +19 -0
  274. package/dist/backend/services/attribute-filter-match.js.map +1 -0
  275. package/dist/backend/services/attribute-scope-preview.d.ts +48 -0
  276. package/dist/backend/services/attribute-scope-preview.d.ts.map +1 -0
  277. package/dist/backend/services/attribute-scope-preview.js +76 -0
  278. package/dist/backend/services/attribute-scope-preview.js.map +1 -0
  279. package/dist/backend/services/attribute-set.service.d.ts +10 -1
  280. package/dist/backend/services/attribute-set.service.d.ts.map +1 -1
  281. package/dist/backend/services/attribute-set.service.js +30 -4
  282. package/dist/backend/services/attribute-set.service.js.map +1 -1
  283. package/dist/backend/services/attribute-type-mapping.d.ts +2 -2
  284. package/dist/backend/services/attribute-type-mapping.d.ts.map +1 -1
  285. package/dist/backend/services/attribute-type-mapping.js +6 -0
  286. package/dist/backend/services/attribute-type-mapping.js.map +1 -1
  287. package/dist/backend/services/attribute-usage.d.ts +31 -0
  288. package/dist/backend/services/attribute-usage.d.ts.map +1 -0
  289. package/dist/backend/services/attribute-usage.js +29 -0
  290. package/dist/backend/services/attribute-usage.js.map +1 -0
  291. package/dist/backend/services/bulk-operation.service.d.ts +36 -0
  292. package/dist/backend/services/bulk-operation.service.d.ts.map +1 -1
  293. package/dist/backend/services/bulk-operation.service.js +210 -37
  294. package/dist/backend/services/bulk-operation.service.js.map +1 -1
  295. package/dist/backend/services/bundle.service.d.ts +9 -1
  296. package/dist/backend/services/bundle.service.d.ts.map +1 -1
  297. package/dist/backend/services/bundle.service.js +31 -3
  298. package/dist/backend/services/bundle.service.js.map +1 -1
  299. package/dist/backend/services/catalog-admin-search.service.d.ts +4 -3
  300. package/dist/backend/services/catalog-admin-search.service.d.ts.map +1 -1
  301. package/dist/backend/services/catalog-admin-search.service.js +7 -7
  302. package/dist/backend/services/catalog-admin-search.service.js.map +1 -1
  303. package/dist/backend/services/catalog-admin.service.d.ts +171 -27
  304. package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
  305. package/dist/backend/services/catalog-admin.service.js +634 -315
  306. package/dist/backend/services/catalog-admin.service.js.map +1 -1
  307. package/dist/backend/services/catalog-attribute-read.service.d.ts +14 -0
  308. package/dist/backend/services/catalog-attribute-read.service.d.ts.map +1 -1
  309. package/dist/backend/services/catalog-attribute-read.service.js +7 -19
  310. package/dist/backend/services/catalog-attribute-read.service.js.map +1 -1
  311. package/dist/backend/services/catalog-bulk-import.service.d.ts +72 -3
  312. package/dist/backend/services/catalog-bulk-import.service.d.ts.map +1 -1
  313. package/dist/backend/services/catalog-bulk-import.service.js +212 -38
  314. package/dist/backend/services/catalog-bulk-import.service.js.map +1 -1
  315. package/dist/backend/services/catalog-bulk-update.service.d.ts +35 -5
  316. package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
  317. package/dist/backend/services/catalog-bulk-update.service.js +123 -14
  318. package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
  319. package/dist/backend/services/catalog-org-price-decorator.d.ts +12 -25
  320. package/dist/backend/services/catalog-org-price-decorator.d.ts.map +1 -1
  321. package/dist/backend/services/catalog-org-price-decorator.js +48 -13
  322. package/dist/backend/services/catalog-org-price-decorator.js.map +1 -1
  323. package/dist/backend/services/catalog-product-filter.service.d.ts +16 -2
  324. package/dist/backend/services/catalog-product-filter.service.d.ts.map +1 -1
  325. package/dist/backend/services/catalog-product-filter.service.js +80 -3
  326. package/dist/backend/services/catalog-product-filter.service.js.map +1 -1
  327. package/dist/backend/services/catalog-product-read.service.d.ts +11 -1
  328. package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
  329. package/dist/backend/services/catalog-product-read.service.js +40 -23
  330. package/dist/backend/services/catalog-product-read.service.js.map +1 -1
  331. package/dist/backend/services/catalog-query.service.d.ts +170 -42
  332. package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
  333. package/dist/backend/services/catalog-query.service.js +797 -430
  334. package/dist/backend/services/catalog-query.service.js.map +1 -1
  335. package/dist/backend/services/catalog-quick-search.service.d.ts +18 -2
  336. package/dist/backend/services/catalog-quick-search.service.d.ts.map +1 -1
  337. package/dist/backend/services/catalog-quick-search.service.js +53 -21
  338. package/dist/backend/services/catalog-quick-search.service.js.map +1 -1
  339. package/dist/backend/services/catalog-write-ports.d.ts +16 -1
  340. package/dist/backend/services/catalog-write-ports.d.ts.map +1 -1
  341. package/dist/backend/services/catalog-write-ports.js +18 -0
  342. package/dist/backend/services/catalog-write-ports.js.map +1 -1
  343. package/dist/backend/services/category-admin.service.d.ts +12 -1
  344. package/dist/backend/services/category-admin.service.d.ts.map +1 -1
  345. package/dist/backend/services/category-admin.service.js +32 -3
  346. package/dist/backend/services/category-admin.service.js.map +1 -1
  347. package/dist/backend/services/channel-url-facts.d.ts +17 -0
  348. package/dist/backend/services/channel-url-facts.d.ts.map +1 -0
  349. package/dist/backend/services/channel-url-facts.js +20 -0
  350. package/dist/backend/services/channel-url-facts.js.map +1 -0
  351. package/dist/backend/services/content-attribute-rules.d.ts +49 -0
  352. package/dist/backend/services/content-attribute-rules.d.ts.map +1 -0
  353. package/dist/backend/services/content-attribute-rules.js +89 -0
  354. package/dist/backend/services/content-attribute-rules.js.map +1 -0
  355. package/dist/backend/services/effective-value.sql.d.ts +42 -0
  356. package/dist/backend/services/effective-value.sql.d.ts.map +1 -0
  357. package/dist/backend/services/effective-value.sql.js +61 -0
  358. package/dist/backend/services/effective-value.sql.js.map +1 -0
  359. package/dist/backend/services/gallery-scopes.d.ts +63 -0
  360. package/dist/backend/services/gallery-scopes.d.ts.map +1 -0
  361. package/dist/backend/services/gallery-scopes.js +158 -0
  362. package/dist/backend/services/gallery-scopes.js.map +1 -0
  363. package/dist/backend/services/gallery.service.d.ts +32 -4
  364. package/dist/backend/services/gallery.service.d.ts.map +1 -1
  365. package/dist/backend/services/gallery.service.js +182 -44
  366. package/dist/backend/services/gallery.service.js.map +1 -1
  367. package/dist/backend/services/grouped.service.d.ts.map +1 -1
  368. package/dist/backend/services/grouped.service.js +13 -1
  369. package/dist/backend/services/grouped.service.js.map +1 -1
  370. package/dist/backend/services/linkable-asset.d.ts +21 -0
  371. package/dist/backend/services/linkable-asset.d.ts.map +1 -0
  372. package/dist/backend/services/linkable-asset.js +31 -0
  373. package/dist/backend/services/linkable-asset.js.map +1 -0
  374. package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
  375. package/dist/backend/services/packaging-unit.service.js +73 -47
  376. package/dist/backend/services/packaging-unit.service.js.map +1 -1
  377. package/dist/backend/services/page-builder-content.d.ts +64 -0
  378. package/dist/backend/services/page-builder-content.d.ts.map +1 -0
  379. package/dist/backend/services/page-builder-content.js +113 -0
  380. package/dist/backend/services/page-builder-content.js.map +1 -0
  381. package/dist/backend/services/primary-asset-url.d.ts +12 -1
  382. package/dist/backend/services/primary-asset-url.d.ts.map +1 -1
  383. package/dist/backend/services/primary-asset-url.js +50 -14
  384. package/dist/backend/services/primary-asset-url.js.map +1 -1
  385. package/dist/backend/services/product-availability.service.d.ts +92 -0
  386. package/dist/backend/services/product-availability.service.d.ts.map +1 -0
  387. package/dist/backend/services/product-availability.service.js +260 -0
  388. package/dist/backend/services/product-availability.service.js.map +1 -0
  389. package/dist/backend/services/product-availability.sql.d.ts +71 -0
  390. package/dist/backend/services/product-availability.sql.d.ts.map +1 -0
  391. package/dist/backend/services/product-availability.sql.js +77 -0
  392. package/dist/backend/services/product-availability.sql.js.map +1 -0
  393. package/dist/backend/services/product-content.service.d.ts +62 -0
  394. package/dist/backend/services/product-content.service.d.ts.map +1 -0
  395. package/dist/backend/services/product-content.service.js +122 -0
  396. package/dist/backend/services/product-content.service.js.map +1 -0
  397. package/dist/backend/services/product-editor-preferences.service.d.ts +6 -0
  398. package/dist/backend/services/product-editor-preferences.service.d.ts.map +1 -1
  399. package/dist/backend/services/product-editor-preferences.service.js +12 -0
  400. package/dist/backend/services/product-editor-preferences.service.js.map +1 -1
  401. package/dist/backend/services/product-global-field-rules.d.ts +39 -0
  402. package/dist/backend/services/product-global-field-rules.d.ts.map +1 -0
  403. package/dist/backend/services/product-global-field-rules.js +84 -0
  404. package/dist/backend/services/product-global-field-rules.js.map +1 -0
  405. package/dist/backend/services/product-link.service.d.ts +10 -9
  406. package/dist/backend/services/product-link.service.d.ts.map +1 -1
  407. package/dist/backend/services/product-link.service.js +44 -36
  408. package/dist/backend/services/product-link.service.js.map +1 -1
  409. package/dist/backend/services/product-list-view-service.d.ts.map +1 -1
  410. package/dist/backend/services/product-list-view-service.js +5 -8
  411. package/dist/backend/services/product-list-view-service.js.map +1 -1
  412. package/dist/backend/services/product-page-revalidation.d.ts +60 -0
  413. package/dist/backend/services/product-page-revalidation.d.ts.map +1 -0
  414. package/dist/backend/services/product-page-revalidation.js +165 -0
  415. package/dist/backend/services/product-page-revalidation.js.map +1 -0
  416. package/dist/backend/services/product-scopes.service.d.ts +221 -0
  417. package/dist/backend/services/product-scopes.service.d.ts.map +1 -0
  418. package/dist/backend/services/product-scopes.service.js +692 -0
  419. package/dist/backend/services/product-scopes.service.js.map +1 -0
  420. package/dist/backend/services/product-summary-text.d.ts +8 -0
  421. package/dist/backend/services/product-summary-text.d.ts.map +1 -0
  422. package/dist/backend/services/product-summary-text.js +8 -0
  423. package/dist/backend/services/product-summary-text.js.map +1 -0
  424. package/dist/backend/services/product-value-resolver.service.d.ts +2 -2
  425. package/dist/backend/services/product-value-resolver.service.d.ts.map +1 -1
  426. package/dist/backend/services/product-value-resolver.service.js +4 -7
  427. package/dist/backend/services/product-value-resolver.service.js.map +1 -1
  428. package/dist/backend/services/publication-window-sweep.d.ts +131 -0
  429. package/dist/backend/services/publication-window-sweep.d.ts.map +1 -0
  430. package/dist/backend/services/publication-window-sweep.js +204 -0
  431. package/dist/backend/services/publication-window-sweep.js.map +1 -0
  432. package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
  433. package/dist/backend/services/scheduled-work-probe.d.ts.map +1 -0
  434. package/dist/backend/services/scheduled-work-probe.js +30 -0
  435. package/dist/backend/services/scheduled-work-probe.js.map +1 -0
  436. package/dist/backend/services/scope-completeness.d.ts +107 -0
  437. package/dist/backend/services/scope-completeness.d.ts.map +1 -0
  438. package/dist/backend/services/scope-completeness.js +173 -0
  439. package/dist/backend/services/scope-completeness.js.map +1 -0
  440. package/dist/backend/services/scope-overview.service.d.ts +112 -0
  441. package/dist/backend/services/scope-overview.service.d.ts.map +1 -0
  442. package/dist/backend/services/scope-overview.service.js +329 -0
  443. package/dist/backend/services/scope-overview.service.js.map +1 -0
  444. package/dist/backend/services/scoped-store-adapters.d.ts +58 -0
  445. package/dist/backend/services/scoped-store-adapters.d.ts.map +1 -0
  446. package/dist/backend/services/scoped-store-adapters.js +92 -0
  447. package/dist/backend/services/scoped-store-adapters.js.map +1 -0
  448. package/dist/backend/services/scoped-values-global-only.d.ts +36 -0
  449. package/dist/backend/services/scoped-values-global-only.d.ts.map +1 -0
  450. package/dist/backend/services/scoped-values-global-only.js +92 -0
  451. package/dist/backend/services/scoped-values-global-only.js.map +1 -0
  452. package/dist/backend/services/scoped-values-import.d.ts +86 -0
  453. package/dist/backend/services/scoped-values-import.d.ts.map +1 -0
  454. package/dist/backend/services/scoped-values-import.js +320 -0
  455. package/dist/backend/services/scoped-values-import.js.map +1 -0
  456. package/dist/backend/services/scoped-values-read.service.d.ts +56 -0
  457. package/dist/backend/services/scoped-values-read.service.d.ts.map +1 -0
  458. package/dist/backend/services/scoped-values-read.service.js +289 -0
  459. package/dist/backend/services/scoped-values-read.service.js.map +1 -0
  460. package/dist/backend/services/scoped-values-save.service.d.ts +79 -0
  461. package/dist/backend/services/scoped-values-save.service.d.ts.map +1 -0
  462. package/dist/backend/services/scoped-values-save.service.js +675 -0
  463. package/dist/backend/services/scoped-values-save.service.js.map +1 -0
  464. package/dist/backend/services/scoped-values-state.d.ts +94 -0
  465. package/dist/backend/services/scoped-values-state.d.ts.map +1 -0
  466. package/dist/backend/services/scoped-values-state.js +159 -0
  467. package/dist/backend/services/scoped-values-state.js.map +1 -0
  468. package/dist/backend/services/scoped-values.service.d.ts +36 -0
  469. package/dist/backend/services/scoped-values.service.d.ts.map +1 -0
  470. package/dist/backend/services/scoped-values.service.js +92 -0
  471. package/dist/backend/services/scoped-values.service.js.map +1 -0
  472. package/dist/backend/services/sql-id-arrays.d.ts +16 -0
  473. package/dist/backend/services/sql-id-arrays.d.ts.map +1 -0
  474. package/dist/backend/services/sql-id-arrays.js +24 -0
  475. package/dist/backend/services/sql-id-arrays.js.map +1 -0
  476. package/dist/backend/services/storefront-value-overrides.d.ts +7 -8
  477. package/dist/backend/services/storefront-value-overrides.d.ts.map +1 -1
  478. package/dist/backend/services/storefront-value-overrides.js +11 -14
  479. package/dist/backend/services/storefront-value-overrides.js.map +1 -1
  480. package/dist/backend/services/url-key-resolution.service.d.ts +70 -0
  481. package/dist/backend/services/url-key-resolution.service.d.ts.map +1 -0
  482. package/dist/backend/services/url-key-resolution.service.js +179 -0
  483. package/dist/backend/services/url-key-resolution.service.js.map +1 -0
  484. package/dist/backend/services/url-key.service.d.ts +123 -0
  485. package/dist/backend/services/url-key.service.d.ts.map +1 -0
  486. package/dist/backend/services/url-key.service.js +566 -0
  487. package/dist/backend/services/url-key.service.js.map +1 -0
  488. package/dist/manifest.d.ts +9 -1
  489. package/dist/manifest.d.ts.map +1 -1
  490. package/dist/manifest.js +204 -10
  491. package/dist/manifest.js.map +1 -1
  492. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts +28 -0
  493. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +1 -0
  494. package/dist/migrations/20261022T035133_catalog_product_scopes.js +92 -0
  495. package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +1 -0
  496. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts +32 -0
  497. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +1 -0
  498. package/dist/migrations/20261022T054223_catalog_product_url_keys.js +81 -0
  499. package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +1 -0
  500. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts +34 -0
  501. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +1 -0
  502. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js +57 -0
  503. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +1 -0
  504. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts +26 -0
  505. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +1 -0
  506. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js +54 -0
  507. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +1 -0
  508. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts +27 -0
  509. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +1 -0
  510. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js +45 -0
  511. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +1 -0
  512. package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts +36 -0
  513. package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts.map +1 -0
  514. package/dist/migrations/20261030T113855_catalog_scope_model_texts.js +225 -0
  515. package/dist/migrations/20261030T113855_catalog_scope_model_texts.js.map +1 -0
  516. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts +18 -0
  517. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts.map +1 -0
  518. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js +39 -0
  519. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js.map +1 -0
  520. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts +6 -0
  521. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts.map +1 -0
  522. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js +119 -0
  523. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js.map +1 -0
  524. package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts +6 -0
  525. package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts.map +1 -0
  526. package/dist/migrations/20261030T113908_catalog_scope_model_media.js +185 -0
  527. package/dist/migrations/20261030T113908_catalog_scope_model_media.js.map +1 -0
  528. package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts +36 -0
  529. package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts.map +1 -0
  530. package/dist/migrations/20261104T121504_catalog_product_content_values.js +53 -0
  531. package/dist/migrations/20261104T121504_catalog_product_content_values.js.map +1 -0
  532. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts +33 -0
  533. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts.map +1 -0
  534. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js +58 -0
  535. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js.map +1 -0
  536. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts +36 -0
  537. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts.map +1 -0
  538. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js +40 -0
  539. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js.map +1 -0
  540. package/dist/migrations/index.d.ts +13 -1
  541. package/dist/migrations/index.d.ts.map +1 -1
  542. package/dist/migrations/index.js +25 -1
  543. package/dist/migrations/index.js.map +1 -1
  544. package/docs/catalog/attachments.md +60 -8
  545. package/docs/catalog/attribute-sets.md +2 -2
  546. package/docs/catalog/attributes.md +68 -8
  547. package/docs/catalog/category-content.md +3 -0
  548. package/docs/catalog/composite-products.md +2 -2
  549. package/docs/catalog/editing-a-product-at-a-scope.md +95 -0
  550. package/docs/catalog/gallery-and-labels.md +68 -8
  551. package/docs/catalog/packaging-units.md +56 -10
  552. package/docs/catalog/per-channel-per-language-overrides.md +68 -237
  553. package/docs/catalog/product-content.md +180 -0
  554. package/docs/catalog/product-links.md +2 -2
  555. package/docs/catalog/url-keys-and-redirects.md +142 -0
  556. package/docs/catalog.md +241 -20
  557. package/i18n/en.json +977 -123
  558. package/i18n/pl.json +976 -122
  559. package/package.json +12 -12
  560. package/dist/admin/components/ProductScopeEditor.d.ts +0 -94
  561. package/dist/admin/components/ProductScopeEditor.d.ts.map +0 -1
  562. package/dist/admin/components/ProductScopeEditor.js +0 -395
  563. package/dist/admin/components/ProductScopeEditor.js.map +0 -1
  564. package/dist/backend/services/product-overrides.service.d.ts +0 -77
  565. package/dist/backend/services/product-overrides.service.d.ts.map +0 -1
  566. package/dist/backend/services/product-overrides.service.js +0 -204
  567. package/dist/backend/services/product-overrides.service.js.map +0 -1
  568. package/dist/backend/services/product-scope-context.service.d.ts +0 -36
  569. package/dist/backend/services/product-scope-context.service.d.ts.map +0 -1
  570. package/dist/backend/services/product-scope-context.service.js +0 -106
  571. package/dist/backend/services/product-scope-context.service.js.map +0 -1
@@ -0,0 +1,95 @@
1
+ ---
2
+ title: Editing a product at a scope
3
+ description: How to use the scope switcher in the product editor to set Global, Channel and Channel × language values, and what the editor tells you while you do.
4
+ ---
5
+
6
+ # Editing a product at a scope
7
+
8
+ The product editor edits **one scope at a time**. The scope switcher in the editor header chooses which one, and
9
+ every tab then shows and saves the values at that scope. For what the three levels mean and how a value is resolved,
10
+ see [Product scopes — Global, Channel and Channel × language](./per-channel-per-language-overrides.md).
11
+
12
+ ## The scope switcher
13
+
14
+ The switcher offers three levels, narrowest last:
15
+
16
+ 1. **Global** — the value for every sales channel and every language;
17
+ 2. **Channel** — pick a sales channel (the language stays "All languages") to edit the value for that channel;
18
+ 3. **Channel × language** — pick a sales channel, then one of its languages.
19
+
20
+ Only scopes that are valid for the product are offered: the product must be in the channel, and the channel must
21
+ offer the language. A product that is in no sales channel can only be edited at Global. If the address you open names
22
+ a channel or language that is no longer valid, the editor opens at the nearest valid scope and says why ("Opened at
23
+ …"). A banner reading "Changes apply only to *scope*" is shown whenever you are not at Global, and the editor says in
24
+ words where you are ("Editing …"). Next to it is a link to the **Scope map** tab.
25
+
26
+ Saving applies to the current scope only. A save never changes a value at any other scope.
27
+
28
+ ## Switching with unsaved changes
29
+
30
+ Changes are saved one scope at a time, so switching scope (or leaving the product, or using the browser's Back
31
+ button) with unsaved changes opens a dialog with three choices:
32
+
33
+ - **Save and continue** — save the changes at the scope you are leaving, then switch;
34
+ - **Discard changes** — drop them and switch;
35
+ - **Stay here** — close the dialog and keep editing.
36
+
37
+ If the save is refused, you stay where you are and the refusal is shown on the field. If someone else saved the
38
+ product in the meantime, the editor reports a version conflict; **Reload** discards your staged changes and reads the
39
+ product again, and the button says so.
40
+
41
+ ## Inherit, or set a value here
42
+
43
+ At Channel and Channel × language, every field that can be set at that scope shows where its value comes from:
44
+
45
+ - **Inherited** — the field is ticked "Use value from *parent scope*" and shows the parent's value, with its source,
46
+ read-only. A text field at Channel × language reads "Not translated"; "No value" appears when nothing in the
47
+ chain has one;
48
+ - **Overridden** — the field holds its own value at this scope;
49
+ - **Empty here** — the field holds a deliberately empty value, which stops the chain: the parent's value is not used.
50
+
51
+ To set a value at this scope, untick "Use value from *parent scope*" and type it. To go back to the parent's value,
52
+ tick it again; the own value is removed when you save. A required field (the name, a required attribute) cannot be
53
+ left empty at a scope: enter a value or tick "Use value from *scope*".
54
+
55
+ The same action is available on the Scope map as **Use value from *scope***, after a confirmation.
56
+
57
+ ## What is missing at this scope
58
+
59
+ Under the scope switcher the editor lists the required values that would block publishing at the scope you are
60
+ editing: "Missing here" and, at a channel, "Missing in this channel" with the languages concerned. A value counts as
61
+ present when it exists at the scope, at the channel, or at Global, in that order. At Global the list becomes
62
+ "*N* incomplete scopes" with a link to the Scope map. The list reflects **saved** values; the check made when you
63
+ save counts saved and staged values together.
64
+
65
+ ## The Scope map tab
66
+
67
+ The **Scope map** tab is the overview of every scope of the product: one cell per sales channel in one language, a
68
+ "Whole channel" column for values set for the channel itself, the status in each cell (set here, from the channel or
69
+ from Global, and whether the product is live there now), and what is missing. **Edit at *scope*** opens the editor at
70
+ that scope, and a field's link focuses that field. Values kept for a channel or language the product has left are
71
+ listed under "No longer applies" and can be deleted there.
72
+
73
+ ## Read-only mode
74
+
75
+ Without the `catalog:write` permission the editor is read-only: "Read-only — you can view values at every scope".
76
+ You can switch scope and read the values, their sources and the Scope map, but no field can be changed.
77
+
78
+ ## Fields that exist only at Global, or only at Channel
79
+
80
+ - **Global only** — SKU, type, attribute set, categories, stock settings, the download file, the gallery image set,
81
+ attachment files and order, packaging units and quantities, and every attribute that is not marked scopable. At
82
+ another scope these tabs show the value read-only with "This is the same in every scope" and an **Edit at Global**
83
+ link.
84
+ - **Global and Channel, not Channel × language** — publication window, audience, minimum order quantity, returnable,
85
+ and scopable attributes that are not text (numbers, selects, booleans). At Channel × language these fields are not
86
+ offered.
87
+
88
+ ## Required attributes and Global saves
89
+
90
+ The completeness check looks at each channel and language separately, so a required attribute may be absent at
91
+ Global. There is one exception, kept on purpose: **a Global save that carries an attribute cell or an attribute-set
92
+ change is refused (`required_empty`) for every empty required attribute, whether or not you changed it.** Fill the
93
+ attributes it names, or save without touching the attributes section. A Global save with no attribute cell, and
94
+ saves at Channel or Channel × language, are not refused for this. The name and the URL key can never be cleared at
95
+ Global.
@@ -1,8 +1,8 @@
1
1
  ---
2
- title: Product Gallery
2
+ title: Product gallery
3
3
  ---
4
4
 
5
- # Product Gallery
5
+ # Product gallery
6
6
 
7
7
  Each Product can carry a curated gallery of image and video Assets, with
8
8
  three labels that pin the storefront's resolution chain:
@@ -24,18 +24,70 @@ typed conflict error rather than silent data corruption.
24
24
  | `GET /api/v1/admin/catalog/products/:id/gallery` | admin | List the Product's gallery |
25
25
  | `POST /api/v1/admin/catalog/products/:id/gallery` | admin | Attach an existing image/video Asset with optional labels |
26
26
  | `POST .../gallery?replace=true` | admin | Atomic-swap: remove conflicting labels from other items in this Product, then assign |
27
- | `PATCH /api/v1/admin/catalog/products/:id/gallery/:itemId` | admin | Update labels (same `?replace=true` toggle) |
27
+ | `PATCH /api/v1/admin/catalog/products/:id/gallery/:itemId` | admin | Move the item (`position`) |
28
+ | `PUT /api/v1/admin/catalog/products/:id/scoped-values` | admin | Alt text, hidden flag and role holders at Global, a channel, or a channel and language (see below) |
28
29
  | `DELETE /api/v1/admin/catalog/products/:id/gallery/:itemId` | admin | Remove from gallery (Asset row survives) |
29
30
  | `PUT /api/v1/admin/catalog/products/:id/gallery/order` | admin | Reorder by id list |
30
31
 
31
32
  ## Atomic label swap
32
33
 
33
34
  Without the `?replace=true` query, assigning a label that already exists
34
- on another item returns `409 GALLERY_LABEL_ALREADY_TAKEN`. With it, the
35
+ on another item when adding it returns `409 GALLERY_LABEL_ALREADY_TAKEN`. With it, the
35
36
  service drops the conflicting assignments first then inserts the new
36
37
  one — all in a single transaction, so concurrent admins never see a
37
38
  half-applied state.
38
39
 
40
+ ## Per scope: Global, Channel, Channel × language
41
+
42
+ The set of images is the same in every sales channel: a channel cannot add an image
43
+ of its own or reorder the gallery. What a scope can change is the image's alt text,
44
+ whether the image is shown, and which image holds each role. All three are scoped
45
+ fields, saved with the rest of the scope by `PUT …/products/:id/scoped-values`:
46
+
47
+ ```json
48
+ {
49
+ "scope": { "channelId": "<retail-uuid>", "languageCode": "pl-PL" },
50
+ "version": "7",
51
+ "changes": {
52
+ "gallery": {
53
+ "items": { "<itemId>": { "altText": "Wiertarka z boku", "hidden": { "inherit": true } } },
54
+ "roles": { "baseImage": "<itemId>", "smallImage": null }
55
+ }
56
+ }
57
+ }
58
+ ```
59
+
60
+ - **Alt text** — at Global, a channel, or a channel and language. With no product alt
61
+ text anywhere up the chain, the asset's own alt text in the request's language
62
+ applies. A deliberately empty alt text (`null`) renders as `alt=""`: the image is
63
+ decorative there, and the asset's alt text is not used.
64
+ - **Hidden** — at Global, a channel, or a channel and language; `true` or `false`, never
65
+ empty. A hidden image is not served at that scope: not in the product page's gallery,
66
+ not as the listing card's image, not as the Open Graph image, not in a product feed
67
+ and not in a comparison.
68
+ - **Role holders** (`baseImage`, `smallImage`, `thumbnail`) — at Global, a channel, or a
69
+ channel and language. `null` stores an empty override: no image holds the role there.
70
+ `{ "inherit": true }` returns the role to the parent scope. A role whose holder is
71
+ hidden at the scope has no holder there, so the listing card moves on to the next
72
+ image in its chain. Removing the holding image makes an override inherit again.
73
+
74
+ A scope that does not write a field inherits it from the parent scope —
75
+ Channel × language → Channel → Global. Writing at a channel the product is not in,
76
+ or a language the channel does not offer, answers `422 SCOPE_INVALID`. Removing an
77
+ override is always allowed, even after the product has left the channel.
78
+
79
+ Hiding is presentation, not access control. A hidden image is not shown at the
80
+ scope, but its file keeps its stable URL, and anyone who has that URL can still
81
+ fetch it. Do not rely on hiding to keep an image confidential: a file that must
82
+ not be public must not be in the product's gallery.
83
+
84
+ A save is one audited Command, `product.scoped_values.save`, and announces
85
+ `product.updated.v1`. `PUT …/gallery/order` records `orderedGalleryItemIds` before and
86
+ after, and runs in one transaction. Deleting an item is recorded once, as
87
+ `gallery_item.delete`, and removes its overrides at every scope.
88
+
89
+ With no override, every channel and language shows the Global gallery.
90
+
39
91
  ## Errors
40
92
 
41
93
  | Code | Status | When |
@@ -44,11 +96,14 @@ half-applied state.
44
96
  | `GALLERY_LABEL_LIMIT_EXCEEDED` | 400 | More than 3 labels on a single item |
45
97
  | `ASSET_KIND_NOT_SUPPORTED` | 400 | Asset kind ∉ `{image, video}` |
46
98
  | `GALLERY_ITEM_NOT_FOUND` | 404 | `:itemId` missing |
99
+ | `SCOPE_INVALID` | 422 | A scoped gallery value for a channel the product is not in, or a language the channel does not offer |
47
100
  | `PRODUCT_NOT_FOUND` | 404 | `:id` missing |
48
101
 
49
102
  ## Storefront integration
50
103
 
51
- `productDetail.gallery[]` carries `{id, position, labels[], asset{id, kind, url}}`.
104
+ `productDetail.gallery[]` carries `{id, position, labels[], asset{id, kind, url}, altText}`,
105
+ as the request's sales channel and language show it: hidden items are left out, `labels`
106
+ are the effective roles there, and `altText` is the effective alt text there.
52
107
  The `<GallerySwitcher>` component renders the Base Image as the primary
53
108
  `<img>` (or the first item if no Base Image is set) and emits a thumbnail
54
109
  strip with the Small Image marked via `data-small-image="true"` for
@@ -67,7 +122,12 @@ over the listing thumbnail so social shares get the marketer's hero shot.
67
122
 
68
123
  ## Storage
69
124
 
70
- `gallery_items` (id, product_id FK CASCADE, asset_id FK RESTRICT,
71
- position, timestamps) + `gallery_item_labels` (composite PK on
125
+ `gallery_items` (id, product_id FK CASCADE, asset_id FK RESTRICT, position, the Global
126
+ `alt_text` and `hidden`, timestamps) + `gallery_item_labels` (composite PK on
72
127
  (gallery_item_id, label), `UNIQUE (product_id, label)`, CHECK label IN
73
- ('base_image', 'small_image', 'thumbnail')).
128
+ ('base_image', 'small_image', 'thumbnail')) — the Global role holders.
129
+ `gallery_item_scope_overrides` holds an item's alt text and hidden flag at a channel
130
+ or a channel and language, and `gallery_role_scope_overrides` a role's holder there
131
+ (`gallery_item_id` `null` = no image holds it). Both reference the item together with
132
+ its product, so an override cannot point at another product's image, and both cascade
133
+ on the product's, the item's and the channel's delete.
@@ -1,8 +1,8 @@
1
1
  ---
2
- title: Packaging Units
2
+ title: Packaging units
3
3
  ---
4
4
 
5
- # Packaging Units
5
+ # Packaging units
6
6
 
7
7
  Named ordering units attached to a product — for example a **Paleta** worth
8
8
  480 pieces. They let B2B buyers order in bulk units without typing the exact
@@ -14,7 +14,8 @@ request.
14
14
  Manage packaging units in the **Inventory** section of the product card
15
15
  (simple and configurable products only). Each unit has:
16
16
 
17
- - a **name** (operator text, e.g. `Paleta`, `Karton`) — unique within the product,
17
+ - a **name** (operator text, e.g. `Paleta`, `Karton`) — the Global name is unique within
18
+ the product; a channel or a channel and language can override it (see *Name per scope* below),
18
19
  - a **base quantity** (whole number ≥ 1) — how many base pieces the unit holds,
19
20
  - a **default** flag — the unit pre-selected on the storefront,
20
21
  - a **position** — the order units appear in,
@@ -46,6 +47,46 @@ match one of the product's units. Anything else is refused with
46
47
  `422 PACKAGING_UNIT_MISMATCH` — an id that is unknown, deleted or another
47
48
  product's unit all give the same reason.
48
49
 
50
+ **For API clients:** a name sent without an id is matched against the unit's
51
+ **Global** name only, never against a channel's or a language's name (see *Name per
52
+ scope*). A line that sends the name a buyer saw in a translated storefront — `Pallet`
53
+ where the Global name is `Paleta` — is refused with
54
+ `422 PACKAGING_UNIT_MISMATCH` (reason `name_unknown`). Send the
55
+ `packagingUnitId`, or the Global name.
56
+
57
+ ## Name per scope
58
+
59
+ A unit's name is a scoped field: it has a Global value and can be overridden at a sales
60
+ channel or at a channel and language. It is saved with the rest of the scope by
61
+ `PUT …/products/:id/scoped-values`, e.g.
62
+ `{ "changes": { "packagingUnits": { "<unitId>": { "name": "Pallet" } } } }` at
63
+ `{ "channelId": "…", "languageCode": "en-US" }`. Each name is at most 160 characters;
64
+ `{ "inherit": true }` removes the scope's own name, and `null` stores a deliberately
65
+ empty name at a channel or a channel and language. The Global name cannot be empty. It
66
+ is the one that must be unique within the product, the one a quote line sent without
67
+ an id is matched against, and the one minimum refusals name.
68
+
69
+ Where a buyer sees the unit, its name is the effective name at the request's channel and
70
+ language — Channel × language → Channel → Global:
71
+
72
+ - the product page's `packagingUnits[].name`;
73
+ - the name a basket line snapshots — at the basket's channel and language. When
74
+ an administrator names the channel on a customer's behalf, the name is taken in
75
+ that channel's default language, like the product name beside it;
76
+ - the name a buyer's quote-request line snapshots — at the channel and language the
77
+ request is raised in.
78
+
79
+ A deliberately empty name at the scope does not produce an unnamed line: the basket,
80
+ quote and order snapshots then keep the Global name.
81
+
82
+ Creating or updating a unit is recorded once in the audit log, as
83
+ `packaging_unit.create` or `packaging_unit.update`, with the unit's state before and
84
+ after (its product, Global name, base quantity, default flag and minimum). Sending the
85
+ recorded before-state back through the same route (without `productId`) restores it.
86
+ A scoped save is recorded as `product.scoped_values.save`. Both announce
87
+ `product.updated.v1`. A request that changes nothing writes nothing and announces
88
+ nothing. Deleting a unit removes its overrides at every scope.
89
+
49
90
  ## For buyers
50
91
 
51
92
  On the product page a selector offers the available units plus a *single piece*
@@ -57,7 +98,7 @@ line of the same product stay separate.
57
98
  ## How the label travels
58
99
 
59
100
  The unit name and base quantity are **snapshotted** on the line when it is
60
- created, so later edits to (or deletion of) a product's packaging units never
101
+ created — the effective name at the line's channel and language, as above — so later edits to (or deletion of) a product's packaging units never
61
102
  change historical carts, orders, or quote requests.
62
103
 
63
104
  - **Cart** — `cart_items` snapshot the unit; the cart serializer composes a
@@ -80,15 +121,16 @@ count.
80
121
 
81
122
  - Admin CRUD: `GET/POST /api/v1/admin/catalog/products/:id/packaging-units`,
82
123
  `PATCH/DELETE …/:unitId`, `PATCH …/packaging-units/reorder`
83
- (gated by `catalog:read` / `catalog:write`). Create and update accept an
84
- optional `minOrderUnits` (`1…1000000`, or `null` to clear); the response
85
- always carries it. The in-process `CatalogPackagingPort`, used by PIM
124
+ (gated by `catalog:read` / `catalog:write`). Create takes the Global name; update
125
+ takes the base quantity, default flag, position and an optional `minOrderUnits`
126
+ (`1…1000000`, or `null` to clear) — the name at any scope is written through
127
+ `PUT …/scoped-values`. The response always carries `minOrderUnits`. The in-process `CatalogPackagingPort`, used by PIM
86
128
  connectors, accepts the same optional field and refuses an out-of-range
87
129
  value with `422 VALIDATION_FAILED`; a writer that never sends it keeps
88
130
  working.
89
131
  - Public: the product detail (`GET /api/v1/catalog/products/:idOrSlug`)
90
- includes an optional `packagingUnits` array; each unit carries
91
- `minOrderUnits` (`null` when none).
132
+ includes an optional `packagingUnits` array; each unit carries its effective
133
+ name at the request's channel and language and `minOrderUnits` (`null` when none).
92
134
  - Cart: `POST /api/v1/cart/items` accepts an optional `packagingUnitId`; the
93
135
  resulting line quantity is `baseQuantity × quantity`.
94
136
 
@@ -99,7 +141,11 @@ Table `product_packaging_units` (migration
99
141
  (FK → `products`, cascade delete), `name`, `base_quantity`
100
142
  (`CHECK >= 1`), `position`, `is_default`, timestamps; `UNIQUE (product_id,
101
143
  name)`. Migration `20261016T082008_catalog_order_rules.ts` adds
102
- `min_order_units` (nullable, `CHECK` 1–1 000 000). Additive snapshot columns, each added by its owning module:
144
+ `min_order_units` (nullable, `CHECK` 1–1 000 000).
145
+ `20261030T113908_catalog_scope_model_media.ts` replaces the per-language
146
+ `name_translations` with `product_packaging_unit_scope_overrides`: a name at a
147
+ channel or a channel and language, referencing the unit together with its product
148
+ and cascading on the unit's, the product's and the channel's delete. Additive snapshot columns, each added by its owning module:
103
149
  `cart_items` (`20260611T140413_carts_cart_item_packaging.ts`), `order_items`
104
150
  (`20260611T140414_orders_order_item_packaging.ts`), `quote_request_items`
105
151
  (`20260611T140415_quote_requests_qr_item_packaging.ts`; its