@endora-commerce/mod-catalog 0.109.0 → 0.111.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 (615) hide show
  1. package/dist/admin/components/CopyToChannelsDialog.d.ts +37 -0
  2. package/dist/admin/components/CopyToChannelsDialog.js +83 -0
  3. package/dist/admin/components/PackagingUnitsEditor.d.ts +13 -4
  4. package/dist/admin/components/PackagingUnitsEditor.js +21 -85
  5. package/dist/admin/components/ProductAttachmentsSection.d.ts +1 -3
  6. package/dist/admin/components/ProductAttachmentsSection.js +59 -98
  7. package/dist/admin/components/ProductAttributesTab.d.ts +1 -11
  8. package/dist/admin/components/ProductAttributesTab.js +128 -119
  9. package/dist/admin/components/ProductContentCard.d.ts +41 -0
  10. package/dist/admin/components/ProductContentCard.js +28 -0
  11. package/dist/admin/components/ProductEditorSaveAction.d.ts +22 -0
  12. package/dist/admin/components/ProductEditorSaveAction.js +23 -0
  13. package/dist/admin/components/ProductGallerySection.d.ts +2 -13
  14. package/dist/admin/components/ProductGallerySection.js +98 -354
  15. package/dist/admin/components/ProductInventoryTab.d.ts +12 -1
  16. package/dist/admin/components/ProductInventoryTab.js +52 -115
  17. package/dist/admin/components/ProductOrderRulesCard.d.ts +11 -15
  18. package/dist/admin/components/ProductOrderRulesCard.js +15 -268
  19. package/dist/admin/components/ProductScopeBar.d.ts +34 -0
  20. package/dist/admin/components/ProductScopeBar.js +70 -0
  21. package/dist/admin/components/ProductScopeOverview.d.ts +13 -1
  22. package/dist/admin/components/ProductScopeOverview.js +56 -37
  23. package/dist/admin/components/ProductUrlRedirects.d.ts +15 -0
  24. package/dist/admin/components/ProductUrlRedirects.js +70 -0
  25. package/dist/admin/components/ProductsBulkEditDialog.js +4 -3
  26. package/dist/admin/components/editor/DetailsTab.d.ts +30 -0
  27. package/dist/admin/components/editor/DetailsTab.js +60 -0
  28. package/dist/admin/components/editor/SectionHeading.d.ts +22 -0
  29. package/dist/admin/components/editor/SectionHeading.js +19 -0
  30. package/dist/admin/components/editor/confirm-removal.d.ts +13 -0
  31. package/dist/admin/components/editor/confirm-removal.js +33 -0
  32. package/dist/admin/components/editor/editor-context.d.ts +55 -0
  33. package/dist/admin/components/editor/editor-context.js +88 -0
  34. package/dist/admin/components/editor/scoped-controls.d.ts +46 -0
  35. package/dist/admin/components/editor/scoped-controls.js +64 -0
  36. package/dist/admin/index.d.ts +1 -1
  37. package/dist/admin/index.js +11 -0
  38. package/dist/admin/lib/attribute-scope.d.ts +17 -14
  39. package/dist/admin/lib/attribute-scope.js +12 -9
  40. package/dist/admin/lib/bulk-result-outcome.d.ts +14 -0
  41. package/dist/admin/lib/bulk-result-outcome.js +13 -0
  42. package/dist/admin/lib/editor-scope.d.ts +35 -0
  43. package/dist/admin/lib/editor-scope.js +114 -0
  44. package/dist/admin/lib/order-minimum-input.d.ts +13 -0
  45. package/dist/admin/lib/order-minimum-input.js +16 -0
  46. package/dist/admin/lib/product-labels.d.ts +0 -2
  47. package/dist/admin/lib/product-labels.js +1 -5
  48. package/dist/admin/lib/product-scopes-api.d.ts +5 -22
  49. package/dist/admin/lib/product-scopes-api.js +4 -48
  50. package/dist/admin/lib/product-url-keys-api.d.ts +4 -27
  51. package/dist/admin/lib/product-url-keys-api.js +1 -50
  52. package/dist/admin/lib/scope-overview.d.ts +13 -14
  53. package/dist/admin/lib/scope-overview.js +36 -31
  54. package/dist/admin/lib/scoped-editor-store.d.ts +81 -0
  55. package/dist/admin/lib/scoped-editor-store.js +198 -0
  56. package/dist/admin/lib/scoped-values-api.d.ts +14 -0
  57. package/dist/admin/lib/scoped-values-api.js +55 -0
  58. package/dist/admin/pages/AttachmentTypesPage.js +14 -4
  59. package/dist/admin/pages/AttributeSetsPage.js +11 -4
  60. package/dist/admin/pages/AttributesManager.js +130 -40
  61. package/dist/admin/pages/BulkOperationDetailPage.js +11 -4
  62. package/dist/admin/pages/CategoriesTree.d.ts +5 -0
  63. package/dist/admin/pages/CategoriesTree.js +226 -40
  64. package/dist/admin/pages/ProductContentPage.d.ts +27 -0
  65. package/dist/admin/pages/ProductContentPage.js +161 -0
  66. package/dist/admin/pages/ProductCreateForm.d.ts +3 -0
  67. package/dist/admin/pages/ProductCreateForm.js +87 -0
  68. package/dist/admin/pages/ProductEditor.js +938 -458
  69. package/dist/admin/pages/ProductsList.js +33 -38
  70. package/dist/backend/admin-search-provider.d.ts +2 -1
  71. package/dist/backend/admin-search-provider.js +1 -1
  72. package/dist/backend/commands/attribute-commands.d.ts +4 -3
  73. package/dist/backend/commands/attribute-commands.js +137 -30
  74. package/dist/backend/commands/product-content-commands.d.ts +31 -0
  75. package/dist/backend/commands/product-content-commands.js +70 -0
  76. package/dist/backend/commands/scoped-values.commands.d.ts +95 -0
  77. package/dist/backend/commands/scoped-values.commands.js +235 -0
  78. package/dist/backend/demo/reset.js +2 -1
  79. package/dist/backend/demo/rows.d.ts +18 -0
  80. package/dist/backend/demo/rows.js +18 -0
  81. package/dist/backend/demo/seed.d.ts +2 -1
  82. package/dist/backend/demo/seed.js +20 -6
  83. package/dist/backend/entities/gallery-item-scope-override.entity.d.ts +30 -0
  84. package/dist/backend/entities/gallery-item-scope-override.entity.js +80 -0
  85. package/dist/backend/entities/gallery-item.entity.d.ts +7 -6
  86. package/dist/backend/entities/gallery-item.entity.js +11 -6
  87. package/dist/backend/entities/gallery-role-scope-override.entity.d.ts +28 -0
  88. package/dist/backend/entities/gallery-role-scope-override.entity.js +75 -0
  89. package/dist/backend/entities/product-attachment-scope-override.entity.d.ts +30 -0
  90. package/dist/backend/entities/product-attachment-scope-override.entity.js +80 -0
  91. package/dist/backend/entities/product-attachment.entity.d.ts +4 -6
  92. package/dist/backend/entities/product-attachment.entity.js +6 -12
  93. package/dist/backend/entities/product-attribute.entity.d.ts +5 -9
  94. package/dist/backend/entities/product-attribute.entity.js +5 -13
  95. package/dist/backend/entities/product-channel-scope.entity.d.ts +7 -2
  96. package/dist/backend/entities/product-channel-scope.entity.js +10 -1
  97. package/dist/backend/entities/product-content-value.entity.d.ts +39 -0
  98. package/dist/backend/entities/product-content-value.entity.js +81 -0
  99. package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts +30 -0
  100. package/dist/backend/entities/product-packaging-unit-scope-override.entity.js +80 -0
  101. package/dist/backend/entities/product-packaging-unit.entity.d.ts +1 -7
  102. package/dist/backend/entities/product-packaging-unit.entity.js +0 -10
  103. package/dist/backend/entities/product-url-key.entity.d.ts +14 -19
  104. package/dist/backend/entities/product-url-key.entity.js +17 -22
  105. package/dist/backend/entities/product-url-redirect.entity.d.ts +8 -13
  106. package/dist/backend/entities/product-url-redirect.entity.js +13 -14
  107. package/dist/backend/entities/product-variant.entity.d.ts +8 -1
  108. package/dist/backend/entities/product-variant.entity.js +13 -2
  109. package/dist/backend/entities/product.entity.d.ts +31 -14
  110. package/dist/backend/entities/product.entity.js +41 -34
  111. package/dist/backend/index.d.ts +11 -3
  112. package/dist/backend/index.js +155 -49
  113. package/dist/backend/plugin.d.ts +36 -6
  114. package/dist/backend/plugin.js +36 -13
  115. package/dist/backend/prompt-tools.d.ts +3 -2
  116. package/dist/backend/prompt-tools.js +18 -7
  117. package/dist/backend/routes.admin.d.ts +15 -16
  118. package/dist/backend/routes.admin.js +122 -103
  119. package/dist/backend/routes.api-key.js +4 -2
  120. package/dist/backend/routes.external.js +3 -2
  121. package/dist/backend/routes.public.d.ts +8 -1
  122. package/dist/backend/routes.public.js +68 -11
  123. package/dist/backend/services/asset-references.d.ts +12 -1
  124. package/dist/backend/services/asset-references.js +42 -2
  125. package/dist/backend/services/attachment-packaging-scopes.d.ts +38 -20
  126. package/dist/backend/services/attachment-packaging-scopes.js +58 -75
  127. package/dist/backend/services/attachment.service.d.ts +4 -8
  128. package/dist/backend/services/attachment.service.js +35 -49
  129. package/dist/backend/services/attribute-filter-match.d.ts +14 -0
  130. package/dist/backend/services/attribute-filter-match.js +19 -0
  131. package/dist/backend/services/attribute-scope-preview.d.ts +17 -7
  132. package/dist/backend/services/attribute-scope-preview.js +30 -20
  133. package/dist/backend/services/attribute-set.service.d.ts +10 -1
  134. package/dist/backend/services/attribute-set.service.js +30 -4
  135. package/dist/backend/services/attribute-type-mapping.d.ts +2 -2
  136. package/dist/backend/services/attribute-type-mapping.js +6 -0
  137. package/dist/backend/services/attribute-usage.d.ts +31 -0
  138. package/dist/backend/services/attribute-usage.js +29 -0
  139. package/dist/backend/services/bulk-operation.service.d.ts +1 -1
  140. package/dist/backend/services/bulk-operation.service.js +16 -6
  141. package/dist/backend/services/bundle.service.js +19 -1
  142. package/dist/backend/services/catalog-admin-search.service.d.ts +3 -2
  143. package/dist/backend/services/catalog-admin-search.service.js +6 -6
  144. package/dist/backend/services/catalog-admin.service.d.ts +63 -12
  145. package/dist/backend/services/catalog-admin.service.js +368 -195
  146. package/dist/backend/services/catalog-attribute-read.service.d.ts +14 -0
  147. package/dist/backend/services/catalog-attribute-read.service.js +9 -19
  148. package/dist/backend/services/catalog-bulk-import.service.d.ts +58 -5
  149. package/dist/backend/services/catalog-bulk-import.service.js +192 -142
  150. package/dist/backend/services/catalog-bulk-update.service.d.ts +5 -3
  151. package/dist/backend/services/catalog-bulk-update.service.js +21 -8
  152. package/dist/backend/services/catalog-product-read.service.d.ts +11 -1
  153. package/dist/backend/services/catalog-product-read.service.js +37 -17
  154. package/dist/backend/services/catalog-query.service.d.ts +48 -8
  155. package/dist/backend/services/catalog-query.service.js +180 -116
  156. package/dist/backend/services/catalog-quick-search.service.js +5 -5
  157. package/dist/backend/services/catalog-write-ports.d.ts +14 -16
  158. package/dist/backend/services/catalog-write-ports.js +11 -70
  159. package/dist/backend/services/category-admin.service.js +29 -5
  160. package/dist/backend/services/content-attribute-rules.d.ts +61 -0
  161. package/dist/backend/services/content-attribute-rules.js +102 -0
  162. package/dist/backend/services/effective-value.sql.d.ts +24 -38
  163. package/dist/backend/services/effective-value.sql.js +37 -87
  164. package/dist/backend/services/gallery-scopes.d.ts +45 -22
  165. package/dist/backend/services/gallery-scopes.js +116 -109
  166. package/dist/backend/services/gallery.service.d.ts +13 -27
  167. package/dist/backend/services/gallery.service.js +75 -199
  168. package/dist/backend/services/grouped.service.js +20 -3
  169. package/dist/backend/services/packaging-unit.service.js +7 -12
  170. package/dist/backend/services/page-builder-content.d.ts +64 -0
  171. package/dist/backend/services/page-builder-content.js +113 -0
  172. package/dist/backend/services/primary-asset-url.d.ts +6 -1
  173. package/dist/backend/services/primary-asset-url.js +9 -4
  174. package/dist/backend/services/product-availability.service.d.ts +16 -3
  175. package/dist/backend/services/product-availability.service.js +58 -21
  176. package/dist/backend/services/product-content.service.d.ts +62 -0
  177. package/dist/backend/services/product-content.service.js +122 -0
  178. package/dist/backend/services/product-editor-preferences.service.d.ts +6 -0
  179. package/dist/backend/services/product-editor-preferences.service.js +12 -0
  180. package/dist/backend/services/product-global-field-rules.d.ts +39 -0
  181. package/dist/backend/services/product-global-field-rules.js +84 -0
  182. package/dist/backend/services/product-link.service.js +14 -16
  183. package/dist/backend/services/product-list-view-service.js +5 -8
  184. package/dist/backend/services/product-page-revalidation.d.ts +9 -0
  185. package/dist/backend/services/product-page-revalidation.js +19 -0
  186. package/dist/backend/services/product-scopes.service.d.ts +18 -8
  187. package/dist/backend/services/product-scopes.service.js +91 -36
  188. package/dist/backend/services/product-value-resolver.service.d.ts +2 -2
  189. package/dist/backend/services/product-value-resolver.service.js +4 -7
  190. package/dist/backend/services/publication-window-sweep.d.ts +61 -7
  191. package/dist/backend/services/publication-window-sweep.js +106 -19
  192. package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
  193. package/dist/backend/services/scheduled-work-probe.js +30 -0
  194. package/dist/backend/services/scope-completeness.d.ts +11 -11
  195. package/dist/backend/services/scope-completeness.js +26 -33
  196. package/dist/backend/services/scope-overview.service.d.ts +24 -24
  197. package/dist/backend/services/scope-overview.service.js +33 -76
  198. package/dist/backend/services/scoped-store-adapters.d.ts +58 -0
  199. package/dist/backend/services/scoped-store-adapters.js +92 -0
  200. package/dist/backend/services/scoped-values-global-only.d.ts +36 -0
  201. package/dist/backend/services/scoped-values-global-only.js +92 -0
  202. package/dist/backend/services/scoped-values-import.d.ts +86 -0
  203. package/dist/backend/services/scoped-values-import.js +320 -0
  204. package/dist/backend/services/scoped-values-read.service.d.ts +56 -0
  205. package/dist/backend/services/scoped-values-read.service.js +289 -0
  206. package/dist/backend/services/scoped-values-save.service.d.ts +79 -0
  207. package/dist/backend/services/scoped-values-save.service.js +675 -0
  208. package/dist/backend/services/scoped-values-state.d.ts +94 -0
  209. package/dist/backend/services/scoped-values-state.js +159 -0
  210. package/dist/backend/services/scoped-values.service.d.ts +36 -0
  211. package/dist/backend/services/scoped-values.service.js +92 -0
  212. package/dist/backend/services/storefront-value-overrides.d.ts +7 -8
  213. package/dist/backend/services/storefront-value-overrides.js +11 -14
  214. package/dist/backend/services/table-maintenance-queue.d.ts +78 -0
  215. package/dist/backend/services/table-maintenance-queue.js +97 -0
  216. package/dist/backend/services/url-key-resolution.service.d.ts +12 -18
  217. package/dist/backend/services/url-key-resolution.service.js +43 -43
  218. package/dist/backend/services/url-key.service.d.ts +87 -135
  219. package/dist/backend/services/url-key.service.js +447 -619
  220. package/dist/manifest.d.ts +51 -1
  221. package/dist/manifest.js +111 -7
  222. package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts +36 -0
  223. package/dist/migrations/20261030T113855_catalog_scope_model_texts.js +225 -0
  224. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts +18 -0
  225. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js +39 -0
  226. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts +6 -0
  227. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js +119 -0
  228. package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts +6 -0
  229. package/dist/migrations/20261030T113908_catalog_scope_model_media.js +185 -0
  230. package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts +36 -0
  231. package/dist/migrations/20261104T121504_catalog_product_content_values.js +53 -0
  232. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts +33 -0
  233. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js +58 -0
  234. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts +36 -0
  235. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js +40 -0
  236. package/dist/migrations/20261114T000706_catalog_category_main_image.d.ts +37 -0
  237. package/dist/migrations/20261114T000706_catalog_category_main_image.js +56 -0
  238. package/dist/migrations/index.d.ts +9 -1
  239. package/dist/migrations/index.js +17 -1
  240. package/docs/catalog/attachments.md +53 -43
  241. package/docs/catalog/attribute-sets.md +3 -2
  242. package/docs/catalog/attributes.md +99 -25
  243. package/docs/catalog/category-content.md +9 -3
  244. package/docs/catalog/composite-products.md +5 -3
  245. package/docs/catalog/editing-a-product-at-a-scope.md +151 -0
  246. package/docs/catalog/gallery-and-labels.md +61 -60
  247. package/docs/catalog/packaging-units.md +43 -34
  248. package/docs/catalog/per-channel-per-language-overrides.md +83 -410
  249. package/docs/catalog/product-content.md +184 -0
  250. package/docs/catalog/product-links.md +2 -2
  251. package/docs/catalog/url-keys-and-redirects.md +79 -79
  252. package/docs/catalog.md +113 -31
  253. package/i18n/en.json +317 -274
  254. package/i18n/pl.json +319 -276
  255. package/package.json +13 -12
  256. package/dist/admin/components/AttachmentScopesDialog.d.ts +0 -22
  257. package/dist/admin/components/AttachmentScopesDialog.d.ts.map +0 -1
  258. package/dist/admin/components/AttachmentScopesDialog.js +0 -70
  259. package/dist/admin/components/AttachmentScopesDialog.js.map +0 -1
  260. package/dist/admin/components/PackagingUnitsEditor.d.ts.map +0 -1
  261. package/dist/admin/components/PackagingUnitsEditor.js.map +0 -1
  262. package/dist/admin/components/ProductAttachmentsSection.d.ts.map +0 -1
  263. package/dist/admin/components/ProductAttachmentsSection.js.map +0 -1
  264. package/dist/admin/components/ProductAttributesTab.d.ts.map +0 -1
  265. package/dist/admin/components/ProductAttributesTab.js.map +0 -1
  266. package/dist/admin/components/ProductGallerySection.d.ts.map +0 -1
  267. package/dist/admin/components/ProductGallerySection.js.map +0 -1
  268. package/dist/admin/components/ProductInventoryTab.d.ts.map +0 -1
  269. package/dist/admin/components/ProductInventoryTab.js.map +0 -1
  270. package/dist/admin/components/ProductOrderRulesCard.d.ts.map +0 -1
  271. package/dist/admin/components/ProductOrderRulesCard.js.map +0 -1
  272. package/dist/admin/components/ProductScopeControls.d.ts +0 -31
  273. package/dist/admin/components/ProductScopeControls.d.ts.map +0 -1
  274. package/dist/admin/components/ProductScopeControls.js +0 -243
  275. package/dist/admin/components/ProductScopeControls.js.map +0 -1
  276. package/dist/admin/components/ProductScopeEditor.d.ts +0 -88
  277. package/dist/admin/components/ProductScopeEditor.d.ts.map +0 -1
  278. package/dist/admin/components/ProductScopeEditor.js +0 -396
  279. package/dist/admin/components/ProductScopeEditor.js.map +0 -1
  280. package/dist/admin/components/ProductScopeOverview.d.ts.map +0 -1
  281. package/dist/admin/components/ProductScopeOverview.js.map +0 -1
  282. package/dist/admin/components/ProductStatusPills.d.ts.map +0 -1
  283. package/dist/admin/components/ProductStatusPills.js.map +0 -1
  284. package/dist/admin/components/ProductUrlKeysPanel.d.ts +0 -17
  285. package/dist/admin/components/ProductUrlKeysPanel.d.ts.map +0 -1
  286. package/dist/admin/components/ProductUrlKeysPanel.js +0 -215
  287. package/dist/admin/components/ProductUrlKeysPanel.js.map +0 -1
  288. package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +0 -1
  289. package/dist/admin/components/ProductsBulkEditDialog.js.map +0 -1
  290. package/dist/admin/components/ScopedDialogParts.d.ts +0 -23
  291. package/dist/admin/components/ScopedDialogParts.d.ts.map +0 -1
  292. package/dist/admin/components/ScopedDialogParts.js +0 -16
  293. package/dist/admin/components/ScopedDialogParts.js.map +0 -1
  294. package/dist/admin/index.d.ts.map +0 -1
  295. package/dist/admin/index.js.map +0 -1
  296. package/dist/admin/lib/attribute-scope.d.ts.map +0 -1
  297. package/dist/admin/lib/attribute-scope.js.map +0 -1
  298. package/dist/admin/lib/bulk-operation-log-text.d.ts.map +0 -1
  299. package/dist/admin/lib/bulk-operation-log-text.js.map +0 -1
  300. package/dist/admin/lib/media-scopes.d.ts +0 -41
  301. package/dist/admin/lib/media-scopes.d.ts.map +0 -1
  302. package/dist/admin/lib/media-scopes.js +0 -66
  303. package/dist/admin/lib/media-scopes.js.map +0 -1
  304. package/dist/admin/lib/product-labels.d.ts.map +0 -1
  305. package/dist/admin/lib/product-labels.js.map +0 -1
  306. package/dist/admin/lib/product-scope-drafts.d.ts +0 -77
  307. package/dist/admin/lib/product-scope-drafts.d.ts.map +0 -1
  308. package/dist/admin/lib/product-scope-drafts.js +0 -133
  309. package/dist/admin/lib/product-scope-drafts.js.map +0 -1
  310. package/dist/admin/lib/product-scopes-api.d.ts.map +0 -1
  311. package/dist/admin/lib/product-scopes-api.js.map +0 -1
  312. package/dist/admin/lib/product-url-keys-api.d.ts.map +0 -1
  313. package/dist/admin/lib/product-url-keys-api.js.map +0 -1
  314. package/dist/admin/lib/resolve-product-selection.d.ts.map +0 -1
  315. package/dist/admin/lib/resolve-product-selection.js.map +0 -1
  316. package/dist/admin/lib/scope-overview.d.ts.map +0 -1
  317. package/dist/admin/lib/scope-overview.js.map +0 -1
  318. package/dist/admin/pages/AttachmentTypesPage.d.ts.map +0 -1
  319. package/dist/admin/pages/AttachmentTypesPage.js.map +0 -1
  320. package/dist/admin/pages/AttributeSetsPage.d.ts.map +0 -1
  321. package/dist/admin/pages/AttributeSetsPage.js.map +0 -1
  322. package/dist/admin/pages/AttributesManager.d.ts.map +0 -1
  323. package/dist/admin/pages/AttributesManager.js.map +0 -1
  324. package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +0 -1
  325. package/dist/admin/pages/BulkOperationDetailPage.js.map +0 -1
  326. package/dist/admin/pages/BulkOperationsPage.d.ts.map +0 -1
  327. package/dist/admin/pages/BulkOperationsPage.js.map +0 -1
  328. package/dist/admin/pages/CategoriesTree.d.ts.map +0 -1
  329. package/dist/admin/pages/CategoriesTree.js.map +0 -1
  330. package/dist/admin/pages/CategoryContentPage.d.ts.map +0 -1
  331. package/dist/admin/pages/CategoryContentPage.js.map +0 -1
  332. package/dist/admin/pages/ProductEditor.d.ts.map +0 -1
  333. package/dist/admin/pages/ProductEditor.js.map +0 -1
  334. package/dist/admin/pages/ProductsList.d.ts.map +0 -1
  335. package/dist/admin/pages/ProductsList.js.map +0 -1
  336. package/dist/backend/admin-search-provider.d.ts.map +0 -1
  337. package/dist/backend/admin-search-provider.js.map +0 -1
  338. package/dist/backend/commands/attribute-commands.d.ts.map +0 -1
  339. package/dist/backend/commands/attribute-commands.js.map +0 -1
  340. package/dist/backend/demo/reset.d.ts.map +0 -1
  341. package/dist/backend/demo/reset.js.map +0 -1
  342. package/dist/backend/demo/rows.d.ts.map +0 -1
  343. package/dist/backend/demo/rows.js.map +0 -1
  344. package/dist/backend/demo/seed.d.ts.map +0 -1
  345. package/dist/backend/demo/seed.js.map +0 -1
  346. package/dist/backend/entities/attachment-type.entity.d.ts.map +0 -1
  347. package/dist/backend/entities/attachment-type.entity.js.map +0 -1
  348. package/dist/backend/entities/attribute-set-attribute.entity.d.ts.map +0 -1
  349. package/dist/backend/entities/attribute-set-attribute.entity.js.map +0 -1
  350. package/dist/backend/entities/attribute-set.entity.d.ts.map +0 -1
  351. package/dist/backend/entities/attribute-set.entity.js.map +0 -1
  352. package/dist/backend/entities/bulk-operation.entity.d.ts.map +0 -1
  353. package/dist/backend/entities/bulk-operation.entity.js.map +0 -1
  354. package/dist/backend/entities/bundle-slot-option.entity.d.ts.map +0 -1
  355. package/dist/backend/entities/bundle-slot-option.entity.js.map +0 -1
  356. package/dist/backend/entities/bundle-slot.entity.d.ts.map +0 -1
  357. package/dist/backend/entities/bundle-slot.entity.js.map +0 -1
  358. package/dist/backend/entities/category.entity.d.ts.map +0 -1
  359. package/dist/backend/entities/category.entity.js.map +0 -1
  360. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts +0 -14
  361. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts.map +0 -1
  362. package/dist/backend/entities/gallery-item-channel-hidden.entity.js +0 -42
  363. package/dist/backend/entities/gallery-item-channel-hidden.entity.js.map +0 -1
  364. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts +0 -18
  365. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts.map +0 -1
  366. package/dist/backend/entities/gallery-item-channel-label.entity.js +0 -49
  367. package/dist/backend/entities/gallery-item-channel-label.entity.js.map +0 -1
  368. package/dist/backend/entities/gallery-item-label.entity.d.ts.map +0 -1
  369. package/dist/backend/entities/gallery-item-label.entity.js.map +0 -1
  370. package/dist/backend/entities/gallery-item.entity.d.ts.map +0 -1
  371. package/dist/backend/entities/gallery-item.entity.js.map +0 -1
  372. package/dist/backend/entities/grouped-item.entity.d.ts.map +0 -1
  373. package/dist/backend/entities/grouped-item.entity.js.map +0 -1
  374. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts +0 -13
  375. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts.map +0 -1
  376. package/dist/backend/entities/product-attachment-channel-hidden.entity.js +0 -41
  377. package/dist/backend/entities/product-attachment-channel-hidden.entity.js.map +0 -1
  378. package/dist/backend/entities/product-attachment.entity.d.ts.map +0 -1
  379. package/dist/backend/entities/product-attachment.entity.js.map +0 -1
  380. package/dist/backend/entities/product-attribute.entity.d.ts.map +0 -1
  381. package/dist/backend/entities/product-attribute.entity.js.map +0 -1
  382. package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +0 -1
  383. package/dist/backend/entities/product-channel-language-scope.entity.js.map +0 -1
  384. package/dist/backend/entities/product-channel-scope.entity.d.ts.map +0 -1
  385. package/dist/backend/entities/product-channel-scope.entity.js.map +0 -1
  386. package/dist/backend/entities/product-editor-preference.entity.d.ts.map +0 -1
  387. package/dist/backend/entities/product-editor-preference.entity.js.map +0 -1
  388. package/dist/backend/entities/product-link.entity.d.ts.map +0 -1
  389. package/dist/backend/entities/product-link.entity.js.map +0 -1
  390. package/dist/backend/entities/product-list-saved-view.entity.d.ts.map +0 -1
  391. package/dist/backend/entities/product-list-saved-view.entity.js.map +0 -1
  392. package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +0 -1
  393. package/dist/backend/entities/product-packaging-unit.entity.js.map +0 -1
  394. package/dist/backend/entities/product-url-key.entity.d.ts.map +0 -1
  395. package/dist/backend/entities/product-url-key.entity.js.map +0 -1
  396. package/dist/backend/entities/product-url-redirect.entity.d.ts.map +0 -1
  397. package/dist/backend/entities/product-url-redirect.entity.js.map +0 -1
  398. package/dist/backend/entities/product-value-override.entity.d.ts.map +0 -1
  399. package/dist/backend/entities/product-value-override.entity.js.map +0 -1
  400. package/dist/backend/entities/product-variant.entity.d.ts.map +0 -1
  401. package/dist/backend/entities/product-variant.entity.js.map +0 -1
  402. package/dist/backend/entities/product.entity.d.ts.map +0 -1
  403. package/dist/backend/entities/product.entity.js.map +0 -1
  404. package/dist/backend/index.d.ts.map +0 -1
  405. package/dist/backend/index.js.map +0 -1
  406. package/dist/backend/plugin.d.ts.map +0 -1
  407. package/dist/backend/plugin.js.map +0 -1
  408. package/dist/backend/prompt-tools.d.ts.map +0 -1
  409. package/dist/backend/prompt-tools.js.map +0 -1
  410. package/dist/backend/routes.admin.d.ts.map +0 -1
  411. package/dist/backend/routes.admin.js.map +0 -1
  412. package/dist/backend/routes.admin.url-keys.d.ts.map +0 -1
  413. package/dist/backend/routes.admin.url-keys.js.map +0 -1
  414. package/dist/backend/routes.api-key.d.ts.map +0 -1
  415. package/dist/backend/routes.api-key.js.map +0 -1
  416. package/dist/backend/routes.external.d.ts.map +0 -1
  417. package/dist/backend/routes.external.js.map +0 -1
  418. package/dist/backend/routes.public.d.ts.map +0 -1
  419. package/dist/backend/routes.public.js.map +0 -1
  420. package/dist/backend/routes.public.url-keys.d.ts.map +0 -1
  421. package/dist/backend/routes.public.url-keys.js.map +0 -1
  422. package/dist/backend/saved-view-actor.d.ts.map +0 -1
  423. package/dist/backend/saved-view-actor.js.map +0 -1
  424. package/dist/backend/services/asset-references.d.ts.map +0 -1
  425. package/dist/backend/services/asset-references.js.map +0 -1
  426. package/dist/backend/services/attachment-packaging-scopes.d.ts.map +0 -1
  427. package/dist/backend/services/attachment-packaging-scopes.js.map +0 -1
  428. package/dist/backend/services/attachment.service.d.ts.map +0 -1
  429. package/dist/backend/services/attachment.service.js.map +0 -1
  430. package/dist/backend/services/attribute-option-validator.d.ts.map +0 -1
  431. package/dist/backend/services/attribute-option-validator.js.map +0 -1
  432. package/dist/backend/services/attribute-scope-preview.d.ts.map +0 -1
  433. package/dist/backend/services/attribute-scope-preview.js.map +0 -1
  434. package/dist/backend/services/attribute-set-validations.d.ts.map +0 -1
  435. package/dist/backend/services/attribute-set-validations.js.map +0 -1
  436. package/dist/backend/services/attribute-set.service.d.ts.map +0 -1
  437. package/dist/backend/services/attribute-set.service.js.map +0 -1
  438. package/dist/backend/services/attribute-type-mapping.d.ts.map +0 -1
  439. package/dist/backend/services/attribute-type-mapping.js.map +0 -1
  440. package/dist/backend/services/attribute-value-key.service.d.ts.map +0 -1
  441. package/dist/backend/services/attribute-value-key.service.js.map +0 -1
  442. package/dist/backend/services/audit-references.d.ts.map +0 -1
  443. package/dist/backend/services/audit-references.js.map +0 -1
  444. package/dist/backend/services/bulk-operation-queue.d.ts.map +0 -1
  445. package/dist/backend/services/bulk-operation-queue.js.map +0 -1
  446. package/dist/backend/services/bulk-operation.service.d.ts.map +0 -1
  447. package/dist/backend/services/bulk-operation.service.js.map +0 -1
  448. package/dist/backend/services/bundle.service.d.ts.map +0 -1
  449. package/dist/backend/services/bundle.service.js.map +0 -1
  450. package/dist/backend/services/catalog-admin-search.service.d.ts.map +0 -1
  451. package/dist/backend/services/catalog-admin-search.service.js.map +0 -1
  452. package/dist/backend/services/catalog-admin.service.d.ts.map +0 -1
  453. package/dist/backend/services/catalog-admin.service.js.map +0 -1
  454. package/dist/backend/services/catalog-attribute-read.service.d.ts.map +0 -1
  455. package/dist/backend/services/catalog-attribute-read.service.js.map +0 -1
  456. package/dist/backend/services/catalog-bulk-import.service.d.ts.map +0 -1
  457. package/dist/backend/services/catalog-bulk-import.service.js.map +0 -1
  458. package/dist/backend/services/catalog-bulk-update.service.d.ts.map +0 -1
  459. package/dist/backend/services/catalog-bulk-update.service.js.map +0 -1
  460. package/dist/backend/services/catalog-category-read.service.d.ts.map +0 -1
  461. package/dist/backend/services/catalog-category-read.service.js.map +0 -1
  462. package/dist/backend/services/catalog-org-price-decorator.d.ts.map +0 -1
  463. package/dist/backend/services/catalog-org-price-decorator.js.map +0 -1
  464. package/dist/backend/services/catalog-product-filter.service.d.ts.map +0 -1
  465. package/dist/backend/services/catalog-product-filter.service.js.map +0 -1
  466. package/dist/backend/services/catalog-product-read.service.d.ts.map +0 -1
  467. package/dist/backend/services/catalog-product-read.service.js.map +0 -1
  468. package/dist/backend/services/catalog-query.service.d.ts.map +0 -1
  469. package/dist/backend/services/catalog-query.service.js.map +0 -1
  470. package/dist/backend/services/catalog-quick-search.service.d.ts.map +0 -1
  471. package/dist/backend/services/catalog-quick-search.service.js.map +0 -1
  472. package/dist/backend/services/catalog-write-ports.d.ts.map +0 -1
  473. package/dist/backend/services/catalog-write-ports.js.map +0 -1
  474. package/dist/backend/services/category-admin.service.d.ts.map +0 -1
  475. package/dist/backend/services/category-admin.service.js.map +0 -1
  476. package/dist/backend/services/channel-url-facts.d.ts.map +0 -1
  477. package/dist/backend/services/channel-url-facts.js.map +0 -1
  478. package/dist/backend/services/effective-value.sql.d.ts.map +0 -1
  479. package/dist/backend/services/effective-value.sql.js.map +0 -1
  480. package/dist/backend/services/gallery-scopes.d.ts.map +0 -1
  481. package/dist/backend/services/gallery-scopes.js.map +0 -1
  482. package/dist/backend/services/gallery.service.d.ts.map +0 -1
  483. package/dist/backend/services/gallery.service.js.map +0 -1
  484. package/dist/backend/services/grouped.service.d.ts.map +0 -1
  485. package/dist/backend/services/grouped.service.js.map +0 -1
  486. package/dist/backend/services/label-resolver.d.ts.map +0 -1
  487. package/dist/backend/services/label-resolver.js.map +0 -1
  488. package/dist/backend/services/linkable-asset.d.ts.map +0 -1
  489. package/dist/backend/services/linkable-asset.js.map +0 -1
  490. package/dist/backend/services/packaging-unit.service.d.ts.map +0 -1
  491. package/dist/backend/services/packaging-unit.service.js.map +0 -1
  492. package/dist/backend/services/primary-asset-url.d.ts.map +0 -1
  493. package/dist/backend/services/primary-asset-url.js.map +0 -1
  494. package/dist/backend/services/product-availability.service.d.ts.map +0 -1
  495. package/dist/backend/services/product-availability.service.js.map +0 -1
  496. package/dist/backend/services/product-availability.sql.d.ts.map +0 -1
  497. package/dist/backend/services/product-availability.sql.js.map +0 -1
  498. package/dist/backend/services/product-editor-preferences.service.d.ts.map +0 -1
  499. package/dist/backend/services/product-editor-preferences.service.js.map +0 -1
  500. package/dist/backend/services/product-link.service.d.ts.map +0 -1
  501. package/dist/backend/services/product-link.service.js.map +0 -1
  502. package/dist/backend/services/product-list-view-service.d.ts.map +0 -1
  503. package/dist/backend/services/product-list-view-service.js.map +0 -1
  504. package/dist/backend/services/product-overrides.service.d.ts +0 -84
  505. package/dist/backend/services/product-overrides.service.d.ts.map +0 -1
  506. package/dist/backend/services/product-overrides.service.js +0 -211
  507. package/dist/backend/services/product-overrides.service.js.map +0 -1
  508. package/dist/backend/services/product-page-revalidation.d.ts.map +0 -1
  509. package/dist/backend/services/product-page-revalidation.js.map +0 -1
  510. package/dist/backend/services/product-scope-context.service.d.ts +0 -36
  511. package/dist/backend/services/product-scope-context.service.d.ts.map +0 -1
  512. package/dist/backend/services/product-scope-context.service.js +0 -107
  513. package/dist/backend/services/product-scope-context.service.js.map +0 -1
  514. package/dist/backend/services/product-scopes.service.d.ts.map +0 -1
  515. package/dist/backend/services/product-scopes.service.js.map +0 -1
  516. package/dist/backend/services/product-summary-text.d.ts.map +0 -1
  517. package/dist/backend/services/product-summary-text.js.map +0 -1
  518. package/dist/backend/services/product-type-validations.d.ts.map +0 -1
  519. package/dist/backend/services/product-type-validations.js.map +0 -1
  520. package/dist/backend/services/product-value-resolver.service.d.ts.map +0 -1
  521. package/dist/backend/services/product-value-resolver.service.js.map +0 -1
  522. package/dist/backend/services/publication-window-sweep.d.ts.map +0 -1
  523. package/dist/backend/services/publication-window-sweep.js.map +0 -1
  524. package/dist/backend/services/scope-completeness.d.ts.map +0 -1
  525. package/dist/backend/services/scope-completeness.js.map +0 -1
  526. package/dist/backend/services/scope-overview.service.d.ts.map +0 -1
  527. package/dist/backend/services/scope-overview.service.js.map +0 -1
  528. package/dist/backend/services/sql-id-arrays.d.ts.map +0 -1
  529. package/dist/backend/services/sql-id-arrays.js.map +0 -1
  530. package/dist/backend/services/storefront-value-overrides.d.ts.map +0 -1
  531. package/dist/backend/services/storefront-value-overrides.js.map +0 -1
  532. package/dist/backend/services/system-attribute-scopes.d.ts.map +0 -1
  533. package/dist/backend/services/system-attribute-scopes.js.map +0 -1
  534. package/dist/backend/services/url-key-resolution.service.d.ts.map +0 -1
  535. package/dist/backend/services/url-key-resolution.service.js.map +0 -1
  536. package/dist/backend/services/url-key.service.d.ts.map +0 -1
  537. package/dist/backend/services/url-key.service.js.map +0 -1
  538. package/dist/backend/services/viewer-organization.d.ts.map +0 -1
  539. package/dist/backend/services/viewer-organization.js.map +0 -1
  540. package/dist/manifest.d.ts.map +0 -1
  541. package/dist/manifest.js.map +0 -1
  542. package/dist/migrations/20260429T064146_catalog_attribute_sets_init.d.ts.map +0 -1
  543. package/dist/migrations/20260429T064146_catalog_attribute_sets_init.js.map +0 -1
  544. package/dist/migrations/20260429T070004_catalog_product_attribute_extensions.d.ts.map +0 -1
  545. package/dist/migrations/20260429T070004_catalog_product_attribute_extensions.js.map +0 -1
  546. package/dist/migrations/20260429T102322_catalog_product_type_and_virtual_fields.d.ts.map +0 -1
  547. package/dist/migrations/20260429T102322_catalog_product_type_and_virtual_fields.js.map +0 -1
  548. package/dist/migrations/20260429T111839_catalog_gallery_items_and_labels.d.ts.map +0 -1
  549. package/dist/migrations/20260429T111839_catalog_gallery_items_and_labels.js.map +0 -1
  550. package/dist/migrations/20260429T112543_catalog_product_attachments.d.ts.map +0 -1
  551. package/dist/migrations/20260429T112543_catalog_product_attachments.js.map +0 -1
  552. package/dist/migrations/20260429T123726_catalog_product_links.d.ts.map +0 -1
  553. package/dist/migrations/20260429T123726_catalog_product_links.js.map +0 -1
  554. package/dist/migrations/20260429T130803_catalog_grouped_and_bundle.d.ts.map +0 -1
  555. package/dist/migrations/20260429T130803_catalog_grouped_and_bundle.js.map +0 -1
  556. package/dist/migrations/20260501T185835_catalog_product_attribute_is_comparable.d.ts.map +0 -1
  557. package/dist/migrations/20260501T185835_catalog_product_attribute_is_comparable.js.map +0 -1
  558. package/dist/migrations/20260505T060113_catalog_attribute_options_and_flags.d.ts.map +0 -1
  559. package/dist/migrations/20260505T060113_catalog_attribute_options_and_flags.js.map +0 -1
  560. package/dist/migrations/20260515T082629_catalog_attribute_mass_editable.d.ts.map +0 -1
  561. package/dist/migrations/20260515T082629_catalog_attribute_mass_editable.js.map +0 -1
  562. package/dist/migrations/20260526T124736_catalog_product_status_inactive.d.ts.map +0 -1
  563. package/dist/migrations/20260526T124736_catalog_product_status_inactive.js.map +0 -1
  564. package/dist/migrations/20260611T140346_catalog_product_value_overrides_init.d.ts.map +0 -1
  565. package/dist/migrations/20260611T140346_catalog_product_value_overrides_init.js.map +0 -1
  566. package/dist/migrations/20260611T140400_catalog_attribute_quick_searchable.d.ts.map +0 -1
  567. package/dist/migrations/20260611T140400_catalog_attribute_quick_searchable.js.map +0 -1
  568. package/dist/migrations/20260611T140407_catalog_bulk_operations.d.ts.map +0 -1
  569. package/dist/migrations/20260611T140407_catalog_bulk_operations.js.map +0 -1
  570. package/dist/migrations/20260611T140408_catalog_bulk_operation_logs.d.ts.map +0 -1
  571. package/dist/migrations/20260611T140408_catalog_bulk_operation_logs.js.map +0 -1
  572. package/dist/migrations/20260611T140412_catalog_product_packaging_units.d.ts.map +0 -1
  573. package/dist/migrations/20260611T140412_catalog_product_packaging_units.js.map +0 -1
  574. package/dist/migrations/20260718T060659_catalog_bulk_operation_revert_state.d.ts.map +0 -1
  575. package/dist/migrations/20260718T060659_catalog_bulk_operation_revert_state.js.map +0 -1
  576. package/dist/migrations/20260718T200343_catalog_category_custom_field_values.d.ts.map +0 -1
  577. package/dist/migrations/20260718T200343_catalog_category_custom_field_values.js.map +0 -1
  578. package/dist/migrations/20260723T230401_catalog_attributes_on_custom_fields.d.ts.map +0 -1
  579. package/dist/migrations/20260723T230401_catalog_attributes_on_custom_fields.js.map +0 -1
  580. package/dist/migrations/20260804T152604_catalog_widen_product_sku.d.ts.map +0 -1
  581. package/dist/migrations/20260804T152604_catalog_widen_product_sku.js.map +0 -1
  582. package/dist/migrations/20260804T160244_catalog_category_activation.d.ts.map +0 -1
  583. package/dist/migrations/20260804T160244_catalog_category_activation.js.map +0 -1
  584. package/dist/migrations/20260912T094557_catalog_sales_channel_products.d.ts.map +0 -1
  585. package/dist/migrations/20260912T094557_catalog_sales_channel_products.js.map +0 -1
  586. package/dist/migrations/20260912T094623_catalog_sales_channel_categories.d.ts.map +0 -1
  587. package/dist/migrations/20260912T094623_catalog_sales_channel_categories.js.map +0 -1
  588. package/dist/migrations/20260925T125527_catalog_inventory_columns.d.ts.map +0 -1
  589. package/dist/migrations/20260925T125527_catalog_inventory_columns.js.map +0 -1
  590. package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.d.ts.map +0 -1
  591. package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.js.map +0 -1
  592. package/dist/migrations/20261008T092714_catalog_category_content.d.ts.map +0 -1
  593. package/dist/migrations/20261008T092714_catalog_category_content.js.map +0 -1
  594. package/dist/migrations/20261014T170531_catalog_product_list_saved_views.d.ts.map +0 -1
  595. package/dist/migrations/20261014T170531_catalog_product_list_saved_views.js.map +0 -1
  596. package/dist/migrations/20261016T082008_catalog_order_rules.d.ts.map +0 -1
  597. package/dist/migrations/20261016T082008_catalog_order_rules.js.map +0 -1
  598. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +0 -1
  599. package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +0 -1
  600. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +0 -1
  601. package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +0 -1
  602. package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts.map +0 -1
  603. package/dist/migrations/20261022T111811_catalog_price_fields_removed.js.map +0 -1
  604. package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts.map +0 -1
  605. package/dist/migrations/20261022T182523_catalog_admin_name_keys.js.map +0 -1
  606. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +0 -1
  607. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +0 -1
  608. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +0 -1
  609. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +0 -1
  610. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +0 -1
  611. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +0 -1
  612. package/dist/migrations/index.d.ts.map +0 -1
  613. package/dist/migrations/index.js.map +0 -1
  614. package/dist/ports/index.d.ts.map +0 -1
  615. package/dist/ports/index.js.map +0 -1
@@ -0,0 +1,151 @@
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. The **Save** button sits
27
+ in the scope bar, next to the scope it saves, and shows how many changes are waiting ("Save 2 changes"). On a wide
28
+ screen the scope bar stays at the top of the window while you scroll, so Save is always in reach; on a narrow screen
29
+ Save is in the bar fixed to the bottom of the screen.
30
+
31
+ ## What Save covers
32
+
33
+ Save writes everything you have staged on the product, wherever on the page you staged it:
34
+
35
+ - the product's fields on every tab, at the current scope, the SEO fields included;
36
+ - the product's stock settings on the **Inventory** tab — stock management, backorders, the low-stock threshold and
37
+ its mode, and the fulfilment strategy with its warehouse order. They exist only at Global. The tab has no Save of
38
+ its own, and changing the threshold mode no longer saves by itself; setting a value back to the saved one removes
39
+ it from the count;
40
+ - the **Base prices** on the **Pricing** tab, while the Price lists module is on. There is no *Save prices* button.
41
+
42
+ The count on Save adds them all up ("Save 3 changes"). Changes on a tab you have left stay staged and counted, and
43
+ switching tabs asks nothing. Save is offered to anyone who may change the product or any of these parts, and it
44
+ writes only what they may change.
45
+
46
+ **First, everything is checked.** The product's fields are checked as before, and the base prices are checked by
47
+ the server without being written. If anything is refused, nothing is written and every change stays. A refused
48
+ product field shows its reason on the field, as before. When the base prices have problems, a summary under the
49
+ scope bar lists each part with its problems ("Base prices — 1 problem"); **Show** opens that part's tab and moves to
50
+ the first field with an error.
51
+
52
+ **Then the parts are written, one after another**: the product's fields first, then the base prices. Each part is
53
+ recorded in the audit log as its own module records it — the product's save as one entry, the base prices as
54
+ another.
55
+
56
+ - If the product's fields are refused — someone else saved the product meanwhile, the completeness check refuses a
57
+ status change, a URL key is taken, a value is invalid — the base prices are not written either. The editor says
58
+ why, as before.
59
+ - If the product's fields are saved and the base prices are not, the summary says both ("Saved: Product fields.
60
+ Not saved: Base prices — *reason*"). The product's fields are no longer staged; the base prices still are, Save
61
+ counts only them, and pressing it again writes only the base prices.
62
+ - If the Price lists module is switched off while base prices are staged, those changes are discarded and the editor
63
+ says so. A save the server refuses because the module was switched off is reported as that part not saved.
64
+
65
+ ## What applies immediately
66
+
67
+ Some actions on the product are not staged. They are written the moment you use them, each recorded on its own,
68
+ and they neither add to the staged changes nor clear them. Each section holding such an action carries an
69
+ **Applies immediately** badge on its heading, shown only where you may use the action:
70
+
71
+ - adding, removing, reordering or replacing variants, bundle slots, grouped items, links, images, attachments and
72
+ packaging units;
73
+ - deleting a URL redirect;
74
+ - the product's sales channels on the **Channels** tab;
75
+ - **Stock by warehouse** on the **Inventory** tab — each warehouse's stock level and low-stock threshold.
76
+
77
+ The prices in other price books are edited in the book's price grid, not here. The **Pricing** tab carries no badge:
78
+ its base prices save with Save.
79
+
80
+ ## Switching with unsaved changes
81
+
82
+ Changes are saved one scope at a time, so switching scope (or leaving the product, or using the browser's Back
83
+ button) with unsaved changes — base prices included — opens a dialog with three choices:
84
+
85
+ - **Save and continue** — save the changes at the scope you are leaving, then switch; if any part is not saved, you
86
+ stay;
87
+ - **Discard changes** — drop every unsaved change on the page and switch;
88
+ - **Stay here** — close the dialog and keep editing.
89
+
90
+ If the save is refused, you stay where you are and the refusal is shown on the field. If someone else saved the
91
+ product in the meantime, the editor reports a version conflict; **Reload** discards your staged changes and reads the
92
+ product again, and the button says so.
93
+
94
+ There is one such question for the whole page: no tab or panel asks one of its own. Closing or reloading the
95
+ browser tab with unsaved changes makes the browser ask before it leaves.
96
+
97
+ ## Inherit, or set a value here
98
+
99
+ At Channel and Channel × language, every field that can be set at that scope shows where its value comes from:
100
+
101
+ - **Inherited** — the field is ticked "Use value from *parent scope*" and shows the parent's value, with its source,
102
+ read-only. A text field at Channel × language reads "Not translated"; "No value" appears when nothing in the
103
+ chain has one;
104
+ - **Overridden** — the field holds its own value at this scope;
105
+ - **Empty here** — the field holds a deliberately empty value, which stops the chain: the parent's value is not used.
106
+
107
+ To set a value at this scope, untick "Use value from *parent scope*" and type it. To go back to the parent's value,
108
+ tick it again; the own value is removed when you save. A required field (the name, a required attribute) cannot be
109
+ left empty at a scope: enter a value or tick "Use value from *scope*".
110
+
111
+ The same action is available on the Scope map as **Use value from *scope***, after a confirmation.
112
+
113
+ ## What is missing at this scope
114
+
115
+ Under the scope switcher the editor lists the required values that would block publishing at the scope you are
116
+ editing: "Missing here" and, at a channel, "Missing in this channel" with the languages concerned. A value counts as
117
+ present when it exists at the scope, at the channel, or at Global, in that order. At Global the list becomes
118
+ "*N* incomplete scopes" with a link to the Scope map. The list reflects **saved** values; the check made when you
119
+ save counts saved and staged values together.
120
+
121
+ ## The Scope map tab
122
+
123
+ The **Scope map** tab is the overview of every scope of the product: one cell per sales channel in one language, a
124
+ "Whole channel" column for values set for the channel itself, the status in each cell (set here, from the channel or
125
+ from Global, and whether the product is live there now), and what is missing. **Edit at *scope*** opens the editor at
126
+ that scope, and a field's link focuses that field. Values kept for a channel or language the product has left are
127
+ listed under "No longer applies" and can be deleted there.
128
+
129
+ ## Read-only mode
130
+
131
+ Without the `catalog:write` permission the editor is read-only: "Read-only — you can view values at every scope".
132
+ You can switch scope and read the values, their sources and the Scope map, but no field can be changed.
133
+
134
+ ## Fields that exist only at Global, or only at Channel
135
+
136
+ - **Global only** — SKU, type, attribute set, categories, stock settings, the download file, the gallery image set,
137
+ attachment files and order, packaging units and quantities, and every attribute that is not marked scopable. At
138
+ another scope these tabs show the value read-only with "This is the same in every scope" and an **Edit at Global**
139
+ link.
140
+ - **Global and Channel, not Channel × language** — publication window, audience, minimum order quantity, returnable,
141
+ and scopable attributes that are not text (numbers, selects, booleans). At Channel × language these fields are not
142
+ offered.
143
+
144
+ ## Required attributes and Global saves
145
+
146
+ The completeness check looks at each channel and language separately, so a required attribute may be absent at
147
+ Global. There is one exception, kept on purpose: **a Global save that carries an attribute cell or an attribute-set
148
+ change is refused (`required_empty`) for every empty required attribute, whether or not you changed it.** Fill the
149
+ attributes it names, or save without touching the attributes section. A Global save with no attribute cell, and
150
+ saves at Channel or Channel × language, are not refused for this. The name and the URL key can never be cleared at
151
+ 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,69 +24,69 @@ 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), alt text per language, channels the item is hidden in |
28
- | `GET /api/v1/admin/catalog/products/:id/gallery/channel-roles` | admin | Each sales channel's own role holders |
29
- | `PUT /api/v1/admin/catalog/products/:id/gallery/channel-roles` | admin | Set or clear a sales channel's own role holders |
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) |
30
29
  | `DELETE /api/v1/admin/catalog/products/:id/gallery/:itemId` | admin | Remove from gallery (Asset row survives) |
31
30
  | `PUT /api/v1/admin/catalog/products/:id/gallery/order` | admin | Reorder by id list |
32
31
 
33
32
  ## Atomic label swap
34
33
 
35
34
  Without the `?replace=true` query, assigning a label that already exists
36
- 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
37
36
  service drops the conflicting assignments first then inserts the new
38
37
  one — all in a single transaction, so concurrent admins never see a
39
38
  half-applied state.
40
39
 
41
- ## Per sales channel and per language
40
+ ## Per scope: Global, Channel, Channel × language
42
41
 
43
42
  The set of images is the same in every sales channel: a channel cannot add an image
44
- of its own or reorder the gallery. What a channel can change is which image holds
45
- each role and which images it shows. The alt text can be set per language.
46
-
47
- - **Role per channel.** `PUT …/gallery/channel-roles` with
48
- `{ "channelId": "…", "roles": { "baseImage": "<itemId>", "smallImage": null } }`
49
- gives the channel its own holder of a role. `null` returns the role to the global
50
- holder; a role left out is unchanged. The keys are `baseImage`, `smallImage` and
51
- `thumbnail`. Each role has at most one holder per channel. `GET` lists the
52
- channels that have an override of their own.
53
- - **Hidden per channel.** `PATCH …/gallery/:itemId` with
54
- `{ "hiddenInChannels": ["…"] }` replaces the set of channels the image is hidden
55
- in. A hidden image is not served in that channel: not in the product page's
56
- gallery, not as the listing card's image, not as the Open Graph image, not in a
57
- product feed of that channel and not in a comparison seen in it. A role whose
58
- holder is hidden in a channel has no holder there, so the listing card moves on to
59
- the next image in its chain.
60
- - **Alt text per language.** `PATCH …/gallery/:itemId` with
61
- `{ "altText": { "pl-PL": "…", "de-DE": "" } }` sets the product's own alt text of
62
- the image in each named language. An empty string removes that language, and a
63
- language left out is unchanged. The product page serves the text in the request's
64
- language, else the asset's own alt text.
65
-
66
- You can hide an image or give it a role only in a channel the product is in;
67
- otherwise the request answers `422 SCOPE_INVALID`. Removing an override is always
68
- allowed, even after the product has left the channel.
69
-
70
- Hiding is presentation, not access control. A hidden image is not shown in the
71
- channel, but its file keeps its stable URL, and anyone who has that URL can still
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
72
81
  fetch it. Do not rely on hiding to keep an image confidential: a file that must
73
82
  not be public must not be in the product's gallery.
74
83
 
75
- Each of these writes is recorded once in the audit log as
76
- `product.media.update`, with the item's (or the channel's roles') state before and
77
- after. Sending the recorded before-state back through the same route restores it.
78
- The write announces `product.updated.v1` with `changedFields: ["media"]`. A request
79
- that changes nothing writes nothing and announces nothing.
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.
80
88
 
81
- The same holds for an item's labels and for the gallery's order. A `PATCH` that
82
- changes labels records them (`labels`) in the item's state; the labels are
83
- replaced in the same transaction as the rest of the item, so a refused label leaves
84
- the item untouched. With `?replace=true` the entry restores this item only: a label
85
- taken from another item is not handed back by re-sending it. `PUT …/gallery/order`
86
- records `orderedGalleryItemIds` before and after, and runs in one transaction.
87
- Deleting an item is recorded once, as `gallery_item.delete`.
88
-
89
- With no override, every channel shows the global gallery, as before.
89
+ With no override, every channel and language shows the Global gallery.
90
90
 
91
91
  ## Errors
92
92
 
@@ -95,15 +95,15 @@ With no override, every channel shows the global gallery, as before.
95
95
  | `GALLERY_LABEL_ALREADY_TAKEN` | 409 | Label conflict without `?replace=true` |
96
96
  | `GALLERY_LABEL_LIMIT_EXCEEDED` | 400 | More than 3 labels on a single item |
97
97
  | `ASSET_KIND_NOT_SUPPORTED` | 400 | Asset kind ∉ `{image, video}` |
98
- | `GALLERY_ITEM_NOT_FOUND` | 404 | `:itemId` missing, or a channel role names an item of another product |
99
- | `SCOPE_INVALID` | 422 | Hiding an image or giving a role in a channel the product is not in |
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 |
100
100
  | `PRODUCT_NOT_FOUND` | 404 | `:id` missing |
101
101
 
102
102
  ## Storefront integration
103
103
 
104
104
  `productDetail.gallery[]` carries `{id, position, labels[], asset{id, kind, url}, altText}`,
105
- as the request's sales channel shows it: hidden items are left out, `labels` are the
106
- channel's roles, and `altText` is in the request's language.
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.
107
107
  The `<GallerySwitcher>` component renders the Base Image as the primary
108
108
  `<img>` (or the first item if no Base Image is set) and emits a thumbnail
109
109
  strip with the Small Image marked via `data-small-image="true"` for
@@ -122,11 +122,12 @@ over the listing thumbnail so social shares get the marketer's hero shot.
122
122
 
123
123
  ## Storage
124
124
 
125
- `gallery_items` (id, product_id FK CASCADE, asset_id FK RESTRICT,
126
- 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
127
127
  (gallery_item_id, label), `UNIQUE (product_id, label)`, CHECK label IN
128
- ('base_image', 'small_image', 'thumbnail')). `gallery_items.alt_text` holds the alt
129
- text per language. `gallery_item_channel_labels` holds a channel's own role holder
130
- (primary key (product_id, sales_channel_id, label)) and `gallery_item_channel_hidden`
131
- an item hidden in a channel (primary key (gallery_item_id, sales_channel_id)); both
132
- cascade on the product's, the item's and the channel's delete.
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,8 +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,
18
- optionally translated per language (see *Name per language* below),
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),
19
19
  - a **base quantity** (whole number ≥ 1) — how many base pieces the unit holds,
20
20
  - a **default** flag — the unit pre-selected on the storefront,
21
21
  - a **position** — the order units appear in,
@@ -48,38 +48,44 @@ match one of the product's units. Anything else is refused with
48
48
  product's unit all give the same reason.
49
49
 
50
50
  **For API clients:** a name sent without an id is matched against the unit's
51
- **global** name only, never against its translations (see *Name per language*).
52
- A line that sends the name a buyer saw in a translated storefront — `Pallet`
53
- where the global name is `Paleta` — is refused with
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
54
  `422 PACKAGING_UNIT_MISMATCH` (reason `name_unknown`). Send the
55
- `packagingUnitId`, or the global name.
55
+ `packagingUnitId`, or the Global name.
56
56
 
57
- ## Name per language
57
+ ## Name per scope
58
58
 
59
- A unit's name can be translated: `nameTranslations` maps a language to a name, e.g.
60
- `{ "en-GB": "Pallet", "de-DE": "" }`. A named language is set, an empty string
61
- removes it, and a language left out is unchanged; each name is at most 160
62
- characters. The unit's own `name` stays the global name: it is the one that must be
63
- unique within the product, the one a quote line sent without an id is matched
64
- against, and the one minimum refusals name.
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.
65
68
 
66
- Where a buyer sees the unit, its name is the translation in the request's language,
67
- else the global name:
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:
68
71
 
69
72
  - the product page's `packagingUnits[].name`;
70
- - the name a basket line snapshots — in the basket's language on its channel. When
73
+ - the name a basket line snapshots — at the basket's channel and language. When
71
74
  an administrator names the channel on a customer's behalf, the name is taken in
72
75
  that channel's default language, like the product name beside it;
73
- - the name a buyer's quote-request line snapshots — in the request's language on the
74
- channel it is raised on.
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.
75
81
 
76
82
  Creating or updating a unit is recorded once in the audit log, as
77
83
  `packaging_unit.create` or `packaging_unit.update`, with the unit's state before and
78
- after (its product, name, `nameTranslations`, base quantity, default flag and
79
- minimum). Sending the recorded before-state back through the same route (without
80
- `productId`) restores it. The write announces `product.updated.v1` with
81
- `changedFields: ["packagingUnits"]`. A request that changes nothing writes nothing
82
- and announces nothing.
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.
83
89
 
84
90
  ## For buyers
85
91
 
@@ -92,7 +98,7 @@ line of the same product stay separate.
92
98
  ## How the label travels
93
99
 
94
100
  The unit name and base quantity are **snapshotted** on the line when it is
95
- created — the name in the line's language, as above — 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
96
102
  change historical carts, orders, or quote requests.
97
103
 
98
104
  - **Cart** — `cart_items` snapshot the unit; the cart serializer composes a
@@ -115,15 +121,16 @@ count.
115
121
 
116
122
  - Admin CRUD: `GET/POST /api/v1/admin/catalog/products/:id/packaging-units`,
117
123
  `PATCH/DELETE …/:unitId`, `PATCH …/packaging-units/reorder`
118
- (gated by `catalog:read` / `catalog:write`). Create and update accept an
119
- optional `nameTranslations` and an optional `minOrderUnits` (`1…1000000`, or `null` to clear); the response
120
- 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
121
128
  connectors, accepts the same optional field and refuses an out-of-range
122
129
  value with `422 VALIDATION_FAILED`; a writer that never sends it keeps
123
130
  working.
124
131
  - Public: the product detail (`GET /api/v1/catalog/products/:idOrSlug`)
125
- includes an optional `packagingUnits` array; each unit carries its name in
126
- the request's language and `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).
127
134
  - Cart: `POST /api/v1/cart/items` accepts an optional `packagingUnitId`; the
128
135
  resulting line quantity is `baseQuantity × quantity`.
129
136
 
@@ -134,9 +141,11 @@ Table `product_packaging_units` (migration
134
141
  (FK → `products`, cascade delete), `name`, `base_quantity`
135
142
  (`CHECK >= 1`), `position`, `is_default`, timestamps; `UNIQUE (product_id,
136
143
  name)`. Migration `20261016T082008_catalog_order_rules.ts` adds
137
- `min_order_units` (nullable, `CHECK` 1–1 000 000), and
138
- `20261026T084533_catalog_attachment_packaging_translations.ts` adds
139
- `name_translations` (jsonb, `{}` by default). 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:
140
149
  `cart_items` (`20260611T140413_carts_cart_item_packaging.ts`), `order_items`
141
150
  (`20260611T140414_orders_order_item_packaging.ts`), `quote_request_items`
142
151
  (`20260611T140415_quote_requests_qr_item_packaging.ts`; its