Backend of the sub-market template (spec agreed section by section with

the customer workflow in mind: the customer fills one XLSX per sub-market,
an importer builds the page).

- Frontend layout 21 'Sub-Market Page' in the existing
  BackendLayoutDataProvider: six zones, one per Figma section, emitted as
  colPos110..colPos160 - the JSON groups plus appearance.layout are the
  front-end contract (spec clause 7.17). A first attempt via page-TSconfig
  BackendLayouts was the wrong mechanism next to the provider and was
  removed again
- New Content Blocks vitec_markethero, vitec_marketintro,
  vitec_marketinsights (field bags, serialized unprefixed under data);
  the workflow section reuses intro-paragraph + vitec_card flip cards
- Stories gained quote/quote_person/quote_role (Testimonial tab),
  maintained once per story, emitted on every story card; usecaselist
  gained the layout value 'testimonials'
- New plugin vitec_productfeature: one referenced product as a full
  product card, serialisation shared with the product list (cObj made
  protected for the subclass)
- vitec_productlist gained hand-picked product selection: exactly the
  chosen products in the editor's order, category filter ignored,
  visibility filters kept - closes the long-standing single-select gap
- New CLI vitec:generate-submarket-workbooks: one protected customer
  XLSX per sub-market (9 main markets, 25 sub-markets from the Market
  category tree) - dropdowns filled live from the database, named ranges
  as the importer contract, hidden Meta sheet pinning submarket/group/
  record uid, soft character-limit warnings, asset URL fields

Verified end to end on Broadcast & Media: layout-21 payload with colPos110
carrying the hero element and its subline. Spec raised to v1.20.

packages/vitec/Classes/UserFunc/ProductListJsonRenderer.php

@@ -31,7 +31,9 @@ use TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer;
  */
 class ProductListJsonRenderer
 {
-    private ?ContentObjectRenderer $cObj = null;
+    // protected (not private) since 2026-10-01: ProductFeatureJsonRenderer
+    // extends this class to reuse serializeProduct() and needs the cObj.
+    protected ?ContentObjectRenderer $cObj = null;
 
     /**
      * TYPO3 v14 hands the ContentObjectRenderer over through this setter only -
@@ -119,6 +121,14 @@ class ProductListJsonRenderer
             }
             $debugMode = (bool)($settings['debug'] ?? false);
             $allProducts = (bool)($settings['allproducts'] ?? false);
+            // Explicit picks (2026-10-01, built for the sub-market template's
+            // Products section): when set, EXACTLY these products in the
+            // editor's order - the category filter is ignored. The visibility
+            // filters below stay in force on purpose, so a hidden/legacy
+            // record never surfaces through a stale selection.
+            $selectedUids = array_filter(
+                array_map('intval', explode(',', (string)($settings['selectedproducts'] ?? '')))
+            );
 
             // Extbase repositories don't work in UserFunc context — direct query.
             $productQueryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
@@ -137,7 +147,11 @@ class ProductListJsonRenderer
                     $productQueryBuilder->expr()->eq('p.subproduct', 0)
                 );
 
-            if (!empty($categoryUids) && !$allProducts) {
+            if ($selectedUids !== [] && !$allProducts) {
+                $productQuery->andWhere(
+                    $productQueryBuilder->expr()->in('p.uid', $productQueryBuilder->createNamedParameter($selectedUids, Connection::PARAM_INT_ARRAY))
+                );
+            } elseif (!empty($categoryUids) && !$allProducts) {
                 $productQuery
                     ->join(
                         'p',
@@ -159,7 +173,12 @@ class ProductListJsonRenderer
             // sitemap. $categoryUids comes from expandWithDescendants in
             // depth-first tree order; within one category the uid order is
             // kept - the records were created in sitemap-V2 row order.
-            if (!empty($categoryUids) && !$allProducts && $products !== []) {
+            if ($selectedUids !== [] && !$allProducts && $products !== []) {
+                // Editor's order, not storage order.
+                $rankBySelection = array_flip($selectedUids);
+                usort($products, static fn(array $a, array $b): int =>
+                    ($rankBySelection[(int)$a['uid']] ?? PHP_INT_MAX) <=> ($rankBySelection[(int)$b['uid']] ?? PHP_INT_MAX));
+            } elseif (!empty($categoryUids) && !$allProducts && $products !== []) {
                 $rankByCategory = array_flip($categoryUids);
                 $mmQueryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
                     ->getQueryBuilderForTable('sys_category_record_mm');