feat(vtex): real legacy productList loader + disambiguate picker labels

[guitavano]

Summary

The Products picker showed three identical "ProductList" options because legacy/productList.ts and ProductList.ts were both just re-exports of intelligentSearch/productList.ts. VTEX actually provides two product-list backends — Intelligent Search and the legacy Catalog Search — so this makes them two real, distinct options and drops the redundant third.

Changes

1. Real legacy loader — vtex/loaders/legacy/productList.ts
Was export { default } from "../intelligentSearch/productList". Now a real implementation against the legacy Catalog Search API (/api/catalog_system/pub/products/search), ported from deco-cx/apps:

• Selection by collection (productClusterIds), term (ft), fq, SKU ids, product ids; plus sort (legacy O) and count (_from/_to).
• Lean toProductShelf() payload — same shape as the IS shelf loader, so both are interchangeable in ProductShelf sections.
• Segment/regionalization handled by vtexCachedFetch.
• Wired through a dedicated cachedProductListLegacy in commerceLoaders.ts (was pointing at the IS cached fn).
• The deprecated, ctx-only similars enrichment from the deco-cx version is intentionally dropped (loaders here have no ctx; deco-cx already steers callers to product extensions).

2. Picker labels (@title)

• intelligentSearch/productList.ts → "Intelligent Search"
• legacy/productList.ts → "Legacy"

3. Hide redundant alias (@ignore)

• vtex/loaders/ProductList.ts (0 usages across casaevideo / bagaggio / lebiscuit) → hidden from the picker, kept resolvable so any pre-existing block still works.

Notes

• Picker labels + hiding require decocms/deco-start#312 (@title/@ignore support in the schema generator). The legacy loader implementation works at runtime independently — the JSDoc tags are harmless no-ops on the current generator.
• bunx tsc clean on all touched files (2 pre-existing unrelated recordCommerceMetric errors in instrumentedFetch.ts are on main already).
• After both packages publish, sites bump them and re-run generate:schema to pick up the labels.

🤖 Generated with Claude Code

---

Summary by cubic

Adds a real VTEX legacy productList loader using the Catalog Search API and updates picker labels to show “Intelligent Search” vs “Legacy,” removing the duplicate option.

• New Features

  • Implements vtex/loaders/legacy/productList.ts against /api/catalog_system/pub/products/search with collection/term/fq/SKU IDs/product IDs, plus sort (O) and count.
  • Returns the same lean shelf payload as the IS loader, so sections can swap either loader.
  • Adds cachedProductListLegacy in vtex/commerceLoaders.ts; routes legacy requests to this cache.
  • Sets @title on intelligentSearch/productList.ts (“Intelligent Search”) and legacy loader (“Legacy”).
  • Hides redundant alias vtex/loaders/ProductList.ts from the picker via @ignore while keeping it resolvable.

• Migration

  • Picker labels and hiding require a schema generator with @title/@ignore support (update decocms/deco-start as needed), then run generate:schema. Runtime behavior works without this.

^{Written for commit 761fc09. Summary will update on new commits.}