@open-mercato/core 0.5.1-develop.3036.f02c281f23 → 0.5.1-develop.3043.1a796c3920

package/src/modules/catalog/backend/catalog/products/page.tsx

@@ -1,13 +1,34 @@
 "use client"
 
+import * as React from 'react'
 import { Page, PageBody } from '@open-mercato/ui/backend/Page'
-import ProductsDataTable from '../../../components/products/ProductsDataTable'
+import ProductsDataTable, {
+  type ProductsDataTableSnapshot,
+} from '../../../components/products/ProductsDataTable'
 
+/**
+ * Step 5.15 — Phase 3 WS-D.
+ *
+ * The catalog merchandising AI trigger moved behind the widget-injection
+ * system and now mounts in `data-table:catalog.products:header`. The
+ * products list page no longer imports `MerchandisingAssistantSheet`,
+ * `hasAllFeatures`, or the `/api/auth/feature-check` polling helper —
+ * feature gating is handled by the injection widget's `features`
+ * metadata (`catalog.products.view` + `ai_assistant.view`). The snapshot
+ * subscription is kept so host-side observability hooks the DataTable's
+ * current filter/total count for future extensions.
+ */
 export default function CatalogProductsPage() {
+  const [, setSnapshot] = React.useState<ProductsDataTableSnapshot>({
+    search: '',
+    filterValues: {},
+    total: 0,
+  })
+
   return (
     <Page>
       <PageBody>
-        <ProductsDataTable />
+        <ProductsDataTable onSnapshotChange={setSnapshot} />
       </PageBody>
     </Page>
   )

package/src/modules/catalog/components/CatalogStatsCard.tsx

@@ -0,0 +1,118 @@
+"use client"
+
+/**
+ * Demo dynamic AI UI part.
+ *
+ * Registered as `catalog.stats-card`. Tools (`catalog.show_stats`) emit a
+ * `{ uiPart: { componentId: 'catalog.stats-card', payload: { ... } } }`
+ * envelope and the chat client renders this card inline. Serves as the
+ * canonical example for how third-party modules contribute custom AI UI
+ * parts: define a presentational React component, register it on the
+ * shared `defaultAiUiPartRegistry` once at module load, and the dispatcher
+ * needs zero special handling.
+ */
+
+import * as React from 'react'
+import { Boxes, FolderTree, PackageCheck, Tags } from 'lucide-react'
+import { useT } from '@open-mercato/shared/lib/i18n/context'
+import {
+  defaultAiUiPartRegistry,
+  type AiUiPartProps,
+} from '@open-mercato/ui/ai'
+
+export interface CatalogStatsCardPayload {
+  products?: number
+  activeProducts?: number
+  categories?: number
+  tags?: number
+  generatedAt?: string
+  note?: string
+}
+
+function formatCount(value: unknown): string {
+  if (typeof value === 'number' && Number.isFinite(value)) {
+    return value.toLocaleString()
+  }
+  return '—'
+}
+
+function StatTile({
+  icon,
+  label,
+  value,
+}: {
+  icon: React.ReactNode
+  label: string
+  value: string
+}) {
+  return (
+    <div className="flex flex-col gap-1 rounded-md border border-border bg-card p-3">
+      <div className="flex items-center gap-1.5 text-xs uppercase tracking-wide text-muted-foreground">
+        {icon}
+        <span>{label}</span>
+      </div>
+      <div className="text-2xl font-semibold leading-none">{value}</div>
+    </div>
+  )
+}
+
+export function CatalogStatsCard({ payload }: AiUiPartProps) {
+  const t = useT()
+  const data = (payload ?? {}) as CatalogStatsCardPayload
+  return (
+    <div
+      className="rounded-lg border border-border bg-muted/30 p-3"
+      data-ai-ui-part="catalog.stats-card"
+    >
+      <div className="mb-2 flex items-center gap-2 text-sm font-medium">
+        <Boxes className="size-4 text-primary" aria-hidden />
+        <span>{t('catalog.stats.title', 'Catalog overview')}</span>
+      </div>
+      <div className="grid grid-cols-2 gap-2 sm:grid-cols-4">
+        <StatTile
+          icon={<Boxes className="size-3" aria-hidden />}
+          label={t('catalog.stats.products', 'Products')}
+          value={formatCount(data.products)}
+        />
+        <StatTile
+          icon={<PackageCheck className="size-3" aria-hidden />}
+          label={t('catalog.stats.active', 'Active')}
+          value={formatCount(data.activeProducts)}
+        />
+        <StatTile
+          icon={<FolderTree className="size-3" aria-hidden />}
+          label={t('catalog.stats.categories', 'Categories')}
+          value={formatCount(data.categories)}
+        />
+        <StatTile
+          icon={<Tags className="size-3" aria-hidden />}
+          label={t('catalog.stats.tags', 'Tags')}
+          value={formatCount(data.tags)}
+        />
+      </div>
+      {data.note ? (
+        <p className="mt-2 text-xs text-muted-foreground">{data.note}</p>
+      ) : null}
+      {data.generatedAt ? (
+        <p className="mt-2 text-[10px] text-muted-foreground">
+          {t('catalog.stats.snapshotAt', 'Snapshot at {time}').replace('{time}', new Date(data.generatedAt).toLocaleString())}
+        </p>
+      ) : null}
+    </div>
+  )
+}
+
+let registered = false
+/**
+ * Idempotent self-registration on the module-global UI-part registry.
+ * Mirrors the pattern in `@open-mercato/ui/ai/records/registry` —
+ * importing this file from a client module is enough for the registry
+ * to know about `catalog.stats-card`.
+ */
+export function registerCatalogStatsCard(): void {
+  if (registered) return
+  registered = true
+  defaultAiUiPartRegistry.register('catalog.stats-card', CatalogStatsCard)
+}
+
+registerCatalogStatsCard()

package/src/modules/catalog/components/products/ProductsDataTable.tsx

@@ -17,6 +17,7 @@ import { BooleanIcon } from '@open-mercato/ui/backend/ValueIcons'
 import { useOrganizationScopeVersion } from '@open-mercato/shared/lib/frontend/useOrganizationScope'
 import { useT } from '@open-mercato/shared/lib/i18n/context'
 import { useConfirmDialog } from '@open-mercato/ui/backend/confirm-dialog'
+import { useAppEvent } from '@open-mercato/ui/backend/injection/useAppEvent'
 import { E } from '#generated/entities.ids.generated'
 import { ProductImageCell } from './ProductImageCell'
 
@@ -139,7 +140,31 @@ function renderPrice(pricing: PricingInfo | undefined, currency?: string | null,
   )
 }
 
-export default function ProductsDataTable() {
+export type ProductsDataTableSnapshot = {
+  search: string
+  filterValues: FilterValues
+  total: number
+}
+
+export type ProductsDataTableProps = {
+  /**
+   * Extra actions rendered alongside the built-in Create button in the
+   * DataTable header. Used by the Step 4.9 AI merchandising sheet
+   * trigger without coupling DataTable to the AI module.
+   */
+  extraActions?: React.ReactNode
+  /**
+   * Optional callback invoked whenever the table's search / filter /
+   * total-matching snapshot changes. Used by the Step 4.9 AI merchandising
+   * sheet to form a selection-aware pageContext per spec §10.1.
+   */
+  onSnapshotChange?: (snapshot: ProductsDataTableSnapshot) => void
+}
+
+export default function ProductsDataTable({
+  extraActions,
+  onSnapshotChange,
+}: ProductsDataTableProps = {}) {
   const t = useT()
   const { confirm, ConfirmDialogElement } = useConfirmDialog()
   const scopeVersion = useOrganizationScopeVersion()
@@ -153,6 +178,15 @@ export default function ProductsDataTable() {
   const [filterValues, setFilterValues] = React.useState<FilterValues>({})
   const [isLoading, setIsLoading] = React.useState(false)
   const [reloadToken, setReloadToken] = React.useState(0)
+  // Step 5.18 (spec §10 line 836, D18 demo): refresh the list when a
+  // catalog.product.* event arrives via the DOM event bridge. Confirmed
+  // AI bulk mutations (one `ai.action.confirmed` + one
+  // `catalog.product.updated` per record) and direct API writes both
+  // surface here so the table reflects the new state without a manual
+  // reload.
+  useAppEvent('catalog.product.*', () => {
+    setReloadToken((token) => token + 1)
+  })
   const [customFieldsetFilter, setCustomFieldsetFilter] = React.useState<string | null>(null)
   const { data: customFieldDefs = [] } = useCustomFieldDefs(ENTITY_ID, {
     keyExtras: [scopeVersion, reloadToken],
@@ -599,6 +633,11 @@ export default function ProductsDataTable() {
     }
   }, [confirm, t])
 
+  React.useEffect(() => {
+    if (!onSnapshotChange) return
+    onSnapshotChange({ search, filterValues, total })
+  }, [onSnapshotChange, search, filterValues, total])
+
   const currentParams = React.useMemo(() => Object.fromEntries(new URLSearchParams(queryParams)), [queryParams])
 
   const exportConfig = React.useMemo(() => ({
@@ -624,11 +663,14 @@ export default function ProductsDataTable() {
           isRefreshing: isLoading,
         }}
         actions={(
-          <Button asChild>
-            <Link href="/backend/catalog/products/create">
-              {t('catalog.products.actions.create', 'Create')}
-            </Link>
-          </Button>
+          <div className="flex items-center gap-2">
+            {extraActions}
+            <Button asChild>
+              <Link href="/backend/catalog/products/create">
+                {t('catalog.products.actions.create', 'Create')}
+              </Link>
+            </Button>
+          </div>
         )}
         columns={columns}
         data={rows}
@@ -649,6 +691,12 @@ export default function ProductsDataTable() {
           page,
           sorting,
           scopeVersion,
+          // Step 5.15: surface `total` so the merchandising AI widget
+          // (rendered in `data-table:catalog.products:header`) can build
+          // a selection-aware pageContext per spec §10.1 without taking a
+          // dependency on the host page.
+          total,
+          totalMatching: total,
         }}
         pagination={{
           page,

package/src/modules/catalog/events.ts

@@ -6,10 +6,13 @@ import { createModuleEvents } from '@open-mercato/shared/modules/events'
  * Declares all events that can be emitted by the catalog module.
  */
 const events = [
-  // Products
-  { id: 'catalog.product.created', label: 'Product Created', entity: 'product', category: 'crud' },
-  { id: 'catalog.product.updated', label: 'Product Updated', entity: 'product', category: 'crud' },
-  { id: 'catalog.product.deleted', label: 'Product Deleted', entity: 'product', category: 'crud' },
+  // Products — Step 5.18 (spec §10 line 836, §9.8): catalog CRUD events
+  // bridge to the DataTable on /backend/catalog/catalog/products via the
+  // DOM event bridge so confirmed mutations (AI or otherwise) auto-refresh
+  // the list without a round-trip.
+  { id: 'catalog.product.created', label: 'Product Created', entity: 'product', category: 'crud', clientBroadcast: true },
+  { id: 'catalog.product.updated', label: 'Product Updated', entity: 'product', category: 'crud', clientBroadcast: true },
+  { id: 'catalog.product.deleted', label: 'Product Deleted', entity: 'product', category: 'crud', clientBroadcast: true },
   { id: 'catalog.product_unit_conversion.created', label: 'Product Unit Conversion Created', entity: 'product_unit_conversion', category: 'crud' },
   { id: 'catalog.product_unit_conversion.updated', label: 'Product Unit Conversion Updated', entity: 'product_unit_conversion', category: 'crud' },
   { id: 'catalog.product_unit_conversion.deleted', label: 'Product Unit Conversion Deleted', entity: 'product_unit_conversion', category: 'crud' },

package/src/modules/catalog/i18n/de.json

@@ -85,6 +85,17 @@
   "catalog.errors.id_required": "Datensatzkennung ist erforderlich.",
   "catalog.errors.organization_required": "Organisationskontext ist erforderlich.",
   "catalog.errors.tenant_required": "Mandantenkontext ist erforderlich.",
+  "catalog.merchandising_assistant.context.filteredByCategory": "Filtered by category",
+  "catalog.merchandising_assistant.context.tags": "{count} tags",
+  "catalog.merchandising_assistant.dock.subtitle": "Catalog",
+  "catalog.merchandising_assistant.popover.heading": "AI assistants",
+  "catalog.merchandising_assistant.sheet.composerPlaceholder": "Frage nach Beschreibungen, Attributen, Titeln oder Preisideen…",
+  "catalog.merchandising_assistant.sheet.description": "Nur-Lese-Demo. Schlägt Beschreibungen, Attribute, Titel und Preisanpassungen für die aktuelle Auswahl vor. In dieser Phase werden keine Änderungen angewendet.",
+  "catalog.merchandising_assistant.sheet.dock": "Dock to side",
+  "catalog.merchandising_assistant.sheet.selectionPill": "Bearbeitet {count} Produkte",
+  "catalog.merchandising_assistant.sheet.title": "Katalog-Merchandising-Assistent",
+  "catalog.merchandising_assistant.trigger.ariaLabel": "KI-Merchandising-Assistent öffnen",
+  "catalog.merchandising_assistant.trigger.label": "AI",
   "catalog.module.description": "Verwalte wiederverwendbare Produkte, Varianten und Preise für Vertriebsdokumente.",
   "catalog.module.title": "Produktkatalog",
   "catalog.nav.group": "Katalog",
@@ -540,6 +551,12 @@
   "catalog.search.priceKind.promotion": "Aktion",
   "catalog.search.status.inactive": "Inaktiv",
   "catalog.search.variant.default": "Standard",
+  "catalog.stats.active": "Aktiv",
+  "catalog.stats.categories": "Kategorien",
+  "catalog.stats.products": "Produkte",
+  "catalog.stats.snapshotAt": "Stand: {time}",
+  "catalog.stats.tags": "Tags",
+  "catalog.stats.title": "Katalogübersicht",
   "catalog.variants.errors.skuExists": "SKU wird bereits verwendet.",
   "catalog.variants.form.barcodeLabel": "Barcode",
   "catalog.variants.form.barcodePlaceholder": "EAN, UPC usw.",

package/src/modules/catalog/i18n/en.json

@@ -85,6 +85,17 @@
   "catalog.errors.id_required": "Record identifier is required.",
   "catalog.errors.organization_required": "Organization context is required.",
   "catalog.errors.tenant_required": "Tenant context is required.",
+  "catalog.merchandising_assistant.context.filteredByCategory": "Filtered by category",
+  "catalog.merchandising_assistant.context.tags": "{count} tags",
+  "catalog.merchandising_assistant.dock.subtitle": "Catalog",
+  "catalog.merchandising_assistant.popover.heading": "AI assistants",
+  "catalog.merchandising_assistant.sheet.composerPlaceholder": "Ask for descriptions, attributes, titles, or price ideas...",
+  "catalog.merchandising_assistant.sheet.description": "Read-only demo. Proposes descriptions, attributes, titles, and price adjustments for the current selection. No writes are applied in this phase.",
+  "catalog.merchandising_assistant.sheet.dock": "Dock to side",
+  "catalog.merchandising_assistant.sheet.selectionPill": "Acting on {count} products",
+  "catalog.merchandising_assistant.sheet.title": "Catalog merchandising assistant",
+  "catalog.merchandising_assistant.trigger.ariaLabel": "Open AI merchandising assistant",
+  "catalog.merchandising_assistant.trigger.label": "AI",
   "catalog.module.description": "Manage reusable products, variants, and pricing for sales documents.",
   "catalog.module.title": "Product Catalog",
   "catalog.nav.group": "Catalog",
@@ -540,6 +551,12 @@
   "catalog.search.priceKind.promotion": "Promotion",
   "catalog.search.status.inactive": "Inactive",
   "catalog.search.variant.default": "Default",
+  "catalog.stats.active": "Active",
+  "catalog.stats.categories": "Categories",
+  "catalog.stats.products": "Products",
+  "catalog.stats.snapshotAt": "Snapshot at {time}",
+  "catalog.stats.tags": "Tags",
+  "catalog.stats.title": "Catalog overview",
   "catalog.variants.errors.skuExists": "SKU already in use.",
   "catalog.variants.form.barcodeLabel": "Barcode",
   "catalog.variants.form.barcodePlaceholder": "EAN, UPC, etc.",

package/src/modules/catalog/i18n/es.json

@@ -85,6 +85,17 @@
   "catalog.errors.id_required": "Se requiere el identificador del registro.",
   "catalog.errors.organization_required": "Se requiere el contexto de la organización.",
   "catalog.errors.tenant_required": "Se requiere el contexto del inquilino.",
+  "catalog.merchandising_assistant.context.filteredByCategory": "Filtered by category",
+  "catalog.merchandising_assistant.context.tags": "{count} tags",
+  "catalog.merchandising_assistant.dock.subtitle": "Catalog",
+  "catalog.merchandising_assistant.popover.heading": "AI assistants",
+  "catalog.merchandising_assistant.sheet.composerPlaceholder": "Pide descripciones, atributos, títulos o ideas de precios…",
+  "catalog.merchandising_assistant.sheet.description": "Demo de solo lectura. Propone descripciones, atributos, títulos y ajustes de precios para la selección actual. En esta fase no se aplican cambios.",
+  "catalog.merchandising_assistant.sheet.dock": "Dock to side",
+  "catalog.merchandising_assistant.sheet.selectionPill": "Actuando sobre {count} productos",
+  "catalog.merchandising_assistant.sheet.title": "Asistente de merchandising del catálogo",
+  "catalog.merchandising_assistant.trigger.ariaLabel": "Abrir el asistente de merchandising IA",
+  "catalog.merchandising_assistant.trigger.label": "AI",
   "catalog.module.description": "Administra productos reutilizables, variantes y precios para los documentos de ventas.",
   "catalog.module.title": "Catálogo de productos",
   "catalog.nav.group": "Catálogo",
@@ -540,6 +551,12 @@
   "catalog.search.priceKind.promotion": "Promoción",
   "catalog.search.status.inactive": "Inactivo",
   "catalog.search.variant.default": "Predeterminado",
+  "catalog.stats.active": "Activos",
+  "catalog.stats.categories": "Categorías",
+  "catalog.stats.products": "Productos",
+  "catalog.stats.snapshotAt": "Captura en {time}",
+  "catalog.stats.tags": "Etiquetas",
+  "catalog.stats.title": "Resumen del catálogo",
   "catalog.variants.errors.skuExists": "El SKU ya está en uso.",
   "catalog.variants.form.barcodeLabel": "Código de barras",
   "catalog.variants.form.barcodePlaceholder": "EAN, UPC, etc.",

package/src/modules/catalog/i18n/pl.json

@@ -85,6 +85,17 @@
   "catalog.errors.id_required": "Wymagany jest identyfikator rekordu.",
   "catalog.errors.organization_required": "Wymagany jest kontekst organizacji.",
   "catalog.errors.tenant_required": "Wymagany jest kontekst dzierżawy.",
+  "catalog.merchandising_assistant.context.filteredByCategory": "Filtered by category",
+  "catalog.merchandising_assistant.context.tags": "{count} tags",
+  "catalog.merchandising_assistant.dock.subtitle": "Catalog",
+  "catalog.merchandising_assistant.popover.heading": "AI assistants",
+  "catalog.merchandising_assistant.sheet.composerPlaceholder": "Poproś o opisy, atrybuty, tytuły lub propozycje cen…",
+  "catalog.merchandising_assistant.sheet.description": "Demo tylko do odczytu. Proponuje opisy, atrybuty, tytuły i korekty cen dla bieżącego wyboru. Na tym etapie żadne zmiany nie są zapisywane.",
+  "catalog.merchandising_assistant.sheet.dock": "Dock to side",
+  "catalog.merchandising_assistant.sheet.selectionPill": "Działa na {count} produktach",
+  "catalog.merchandising_assistant.sheet.title": "Asystent merchandisingu katalogu",
+  "catalog.merchandising_assistant.trigger.ariaLabel": "Otwórz asystenta merchandisingu AI",
+  "catalog.merchandising_assistant.trigger.label": "AI",
   "catalog.module.description": "Zarządzaj produktami, wariantami i cennikami wykorzystywanymi w sprzedaży.",
   "catalog.module.title": "Katalog produktów",
   "catalog.nav.group": "Katalog",
@@ -540,6 +551,12 @@
   "catalog.search.priceKind.promotion": "Promocja",
   "catalog.search.status.inactive": "Nieaktywny",
   "catalog.search.variant.default": "Domyślny",
+  "catalog.stats.active": "Aktywne",
+  "catalog.stats.categories": "Kategorie",
+  "catalog.stats.products": "Produkty",
+  "catalog.stats.snapshotAt": "Migawka o {time}",
+  "catalog.stats.tags": "Tagi",
+  "catalog.stats.title": "Przegląd katalogu",
   "catalog.variants.errors.skuExists": "SKU jest już używany.",
   "catalog.variants.form.barcodeLabel": "Kod kreskowy",
   "catalog.variants.form.barcodePlaceholder": "EAN, UPC itp.",

package/src/modules/catalog/widgets/injection/merchandising-assistant-trigger/widget.client.tsx

@@ -0,0 +1,109 @@
+"use client"
+
+/**
+ * Step 5.15 — Catalog merchandising AiChat injection widget.
+ *
+ * Reuses the Step 4.9 `MerchandisingAssistantSheet` component but loads
+ * it through the widget-injection system instead of being imported
+ * directly from the products list page. `pageContext` follows spec §10.1
+ * exactly and is derived from the DataTable's injection context (filter
+ * snapshot + total-matching count). Selection data is not exposed by the
+ * shared DataTable today (Phase 2 contract); `selectedCount` ships as 0
+ * until the host lifts selection into injection context.
+ */
+
+import * as React from 'react'
+import MerchandisingAssistantSheet, {
+  type MerchandisingPageContext,
+  type MerchandisingPageContextFilter,
+} from '../../../backend/catalog/products/MerchandisingAssistantSheet'
+
+interface HostInjectionContext {
+  search?: string
+  filters?: {
+    categoryIds?: unknown
+    tagIds?: unknown
+    status?: unknown
+  }
+  customFieldset?: string | null
+  page?: number
+  sorting?: unknown
+  scopeVersion?: unknown
+  total?: number | string
+  totalMatching?: number | string
+  /** Selected row IDs from DataTable (auto-enriched when bulk actions are present). */
+  _selectedRowIds?: string[]
+  _selectedCount?: number
+}
+
+interface MerchandisingAssistantTriggerProps {
+  context?: HostInjectionContext
+}
+
+function readString(value: unknown): string | null {
+  return typeof value === 'string' && value.length > 0 ? value : null
+}
+
+function readNumber(value: unknown): number {
+  if (typeof value === 'number' && Number.isFinite(value)) return value
+  if (typeof value === 'string') {
+    const parsed = Number.parseInt(value, 10)
+    if (Number.isFinite(parsed)) return parsed
+  }
+  return 0
+}
+
+function normalizeFilters(context: HostInjectionContext | undefined): MerchandisingPageContextFilter {
+  const rawCategories = context?.filters?.categoryIds
+  const categoryIds = Array.isArray(rawCategories) ? rawCategories : []
+  const firstCategoryId = categoryIds
+    .map(readString)
+    .find((value): value is string => value !== null && value.length > 0) ?? null
+
+  const rawTags = context?.filters?.tagIds
+  const tags = Array.isArray(rawTags)
+    ? rawTags.map(readString).filter((value): value is string => value !== null)
+    : []
+
+  const status = readString(context?.filters?.status)
+
+  return {
+    categoryId: firstCategoryId,
+    priceRange: null,
+    tags,
+    status,
+  }
+}
+
+/**
+ * Exposed for unit tests so the page-context derivation is exercisable
+ * without mounting the widget.
+ */
+export function computeCatalogMerchandisingPageContext(
+  context: HostInjectionContext | undefined,
+): MerchandisingPageContext {
+  const totalMatching = readNumber(context?.totalMatching ?? context?.total)
+  const selectedRowIds = Array.isArray(context?._selectedRowIds) ? context._selectedRowIds : []
+  const selectedCount = selectedRowIds.length > 0 ? selectedRowIds.length : readNumber(context?._selectedCount)
+  return {
+    view: 'catalog.products.list',
+    entityType: 'catalog.products.list',
+    recordType: null,
+    recordId: selectedRowIds.join(','),
+    extra: {
+      filter: normalizeFilters(context),
+      totalMatching,
+      selectedCount,
+    },
+  }
+}
+
+export default function MerchandisingAssistantTriggerWidget({
+  context,
+}: MerchandisingAssistantTriggerProps) {
+  const pageContext = React.useMemo(
+    () => computeCatalogMerchandisingPageContext(context),
+    [context],
+  )
+  return <MerchandisingAssistantSheet pageContext={pageContext} />
+}

package/src/modules/catalog/widgets/injection/merchandising-assistant-trigger/widget.ts

@@ -0,0 +1,29 @@
+import type { InjectionWidgetModule } from '@open-mercato/shared/modules/widgets/injection'
+import MerchandisingAssistantTriggerWidget from './widget.client'
+
+/**
+ * Step 5.15 (Phase 3 WS-D) — Catalog merchandising AiChat injection.
+ *
+ * Moves the Step 4.9 demo embed behind the widget-injection system so the
+ * products-list page no longer hosts the trigger directly. The widget
+ * targets `data-table:catalog.products:header` (owned by the shared
+ * `DataTable` primitive). The existing `MerchandisingAssistantSheet`
+ * component is reused verbatim so the Phase 2 read-only contract is
+ * preserved.
+ *
+ * Feature-gated behind `catalog.products.view` + `ai_assistant.view`.
+ */
+const widget: InjectionWidgetModule<Record<string, unknown>, Record<string, unknown>> = {
+  metadata: {
+    id: 'catalog.injection.merchandising-assistant-trigger',
+    title: 'Catalog Merchandising Assistant Trigger',
+    description:
+      'Renders an "AI Merchandising" button in the products list header that opens a sheet embedding the catalog merchandising assistant.',
+    features: ['catalog.products.view', 'ai_assistant.view'],
+    priority: 100,
+    enabled: true,
+  },
+  Widget: MerchandisingAssistantTriggerWidget,
+}
+
+export default widget

package/src/modules/catalog/widgets/injection/product-seo/widget.client.tsx

@@ -79,7 +79,7 @@ export default function ProductSeoWidget({ data }: InjectionWidgetComponentProps
   }
 
   return (
-    <div className="space-y-3 rounded-lg border bg-card p-4 shadow-sm">
+    <div className="mt-4 w-full space-y-3 rounded-lg border bg-card p-4 shadow-sm">
       <div className="flex items-start justify-between gap-3">
         <div>
           <div className="text-sm font-semibold text-foreground">{t('catalog.products.create.seoWidget.title', 'SEO Optimization')}</div>

package/src/modules/catalog/widgets/injection-table.ts

@@ -26,6 +26,18 @@ export const injectionTable: ModuleInjectionTable = {
     widgetId: 'catalog.injection.product-bulk-delete',
     priority: 40,
   },
+  // Step 5.15 — Phase 3 WS-D.
+  // Merchandising assistant trigger moved behind the injection system so the
+  // products list page no longer imports `MerchandisingAssistantSheet`
+  // directly. The DataTable's `injectionSpotId="data-table:catalog.products"`
+  // exposes the `:search-trailing` variant that this widget targets — the
+  // round icon-only trigger lives next to the products list search input.
+  'data-table:catalog.products:search-trailing': [
+    {
+      widgetId: 'catalog.injection.merchandising-assistant-trigger',
+      priority: 100,
+    },
+  ],
 }
 
 export default injectionTable

package/src/modules/customer_accounts/i18n/de.json

@@ -202,6 +202,11 @@
   "customer_accounts.notifications.user.locked.title": "Customer account locked",
   "customer_accounts.notifications.user.signup.body": "A new customer account was created.",
   "customer_accounts.notifications.user.signup.title": "New customer signup",
+  "customer_accounts.portal_ai_assistant.sheet.composerPlaceholder": "Frage zu deinem Konto stellen...",
+  "customer_accounts.portal_ai_assistant.sheet.description": "Read-only-Assistent für Portalkunden. Fragen zu deinem Konto und zur aktuellen Aktivität.",
+  "customer_accounts.portal_ai_assistant.sheet.title": "Portal-AI-Assistent",
+  "customer_accounts.portal_ai_assistant.trigger.ariaLabel": "Portal-KI-Assistent öffnen",
+  "customer_accounts.portal_ai_assistant.trigger.label": "KI fragen",
   "customer_accounts.search.badge.customerRole": "Kundenrolle",
   "customer_accounts.search.badge.customerUser": "Kundenbenutzer",
   "customer_accounts.settings.back": "Kundenbenutzer",

package/src/modules/customer_accounts/i18n/en.json

@@ -202,6 +202,11 @@
   "customer_accounts.notifications.user.locked.title": "Customer account locked",
   "customer_accounts.notifications.user.signup.body": "A new customer account was created.",
   "customer_accounts.notifications.user.signup.title": "New customer signup",
+  "customer_accounts.portal_ai_assistant.sheet.composerPlaceholder": "Ask about your account...",
+  "customer_accounts.portal_ai_assistant.sheet.description": "Read-only assistant for portal customers. Ask about your account and recent activity.",
+  "customer_accounts.portal_ai_assistant.sheet.title": "Portal AI assistant",
+  "customer_accounts.portal_ai_assistant.trigger.ariaLabel": "Open portal AI assistant",
+  "customer_accounts.portal_ai_assistant.trigger.label": "Ask AI",
   "customer_accounts.search.badge.customerRole": "Customer role",
   "customer_accounts.search.badge.customerUser": "Customer user",
   "customer_accounts.settings.back": "Customer Users",

package/src/modules/customer_accounts/i18n/es.json

@@ -202,6 +202,11 @@
   "customer_accounts.notifications.user.locked.title": "Customer account locked",
   "customer_accounts.notifications.user.signup.body": "A new customer account was created.",
   "customer_accounts.notifications.user.signup.title": "New customer signup",
+  "customer_accounts.portal_ai_assistant.sheet.composerPlaceholder": "Pregunta sobre tu cuenta...",
+  "customer_accounts.portal_ai_assistant.sheet.description": "Asistente de solo lectura para clientes del portal. Pregunta sobre tu cuenta y actividad reciente.",
+  "customer_accounts.portal_ai_assistant.sheet.title": "Asistente AI del portal",
+  "customer_accounts.portal_ai_assistant.trigger.ariaLabel": "Abrir asistente AI del portal",
+  "customer_accounts.portal_ai_assistant.trigger.label": "Preguntar a la IA",
   "customer_accounts.search.badge.customerRole": "Rol de cliente",
   "customer_accounts.search.badge.customerUser": "Usuario de cliente",
   "customer_accounts.settings.back": "Usuarios de clientes",

package/src/modules/customer_accounts/i18n/pl.json

@@ -202,6 +202,11 @@
   "customer_accounts.notifications.user.locked.title": "Customer account locked",
   "customer_accounts.notifications.user.signup.body": "A new customer account was created.",
   "customer_accounts.notifications.user.signup.title": "New customer signup",
+  "customer_accounts.portal_ai_assistant.sheet.composerPlaceholder": "Zapytaj o swoje konto...",
+  "customer_accounts.portal_ai_assistant.sheet.description": "Asystent tylko do odczytu dla klientów portalu. Zapytaj o swoje konto i ostatnią aktywność.",
+  "customer_accounts.portal_ai_assistant.sheet.title": "Asystent AI portalu",
+  "customer_accounts.portal_ai_assistant.trigger.ariaLabel": "Otwórz asystenta AI portalu",
+  "customer_accounts.portal_ai_assistant.trigger.label": "Zapytaj AI",
   "customer_accounts.search.badge.customerRole": "Rola klienta",
   "customer_accounts.search.badge.customerUser": "Użytkownik klienta",
   "customer_accounts.settings.back": "Użytkownicy klientów",