@salesforce/retail-react-app 10.3.0-nightly-20261008080708 → 10.3.0-preview.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/retail-react-app",
-  "version": "10.3.0-nightly-20261008080708",
+  "version": "10.3.0-preview.1",
   "license": "See license in LICENSE",
   "author": "cc-pwa-kit@salesforce.com",
   "ccExtensibility": {
@@ -46,10 +46,10 @@
     "@loadable/component": "^5.15.3",
     "@peculiar/webcrypto": "^1.4.2",
     "@salesforce/cc-datacloud-typescript": "1.1.2",
-    "@salesforce/commerce-sdk-react": "5.5.0-nightly-20261008080708",
-    "@salesforce/pwa-kit-dev": "3.21.0-nightly-20261008080708",
-    "@salesforce/pwa-kit-react-sdk": "3.21.0-nightly-20261008080708",
-    "@salesforce/pwa-kit-runtime": "3.21.0-nightly-20261008080708",
+    "@salesforce/commerce-sdk-react": "5.5.0-preview.0",
+    "@salesforce/pwa-kit-dev": "3.21.0-preview.1",
+    "@salesforce/pwa-kit-react-sdk": "3.21.0-preview.1",
+    "@salesforce/pwa-kit-runtime": "3.21.0-preview.1",
     "@salesforce/storefront-next-runtime": "1.3.1",
     "@tanstack/react-query": "^4.28.0",
     "@tanstack/react-query-devtools": "^4.29.1",
@@ -108,12 +108,12 @@
   "bundlesize": [
     {
       "path": "build/main.js",
-      "maxSize": "110 kB"
+      "maxSize": "109 kB"
     },
     {
       "path": "build/vendor.js",
-      "maxSize": "412 kB"
+      "maxSize": "403 kB"
     }
   ],
-  "gitHead": "cc484a6a87a04e2936705ba2763dad2487c294fd"
+  "gitHead": "a860b13c16696b0e8253ee1016d8500a5ce8a2f0"
 }

package/app/page-designer/content/announcement-banner/index.jsx

@@ -1,148 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-import React from 'react'
-import PropTypes from 'prop-types'
-import {
-    Box,
-    Skeleton,
-    Text,
-    Link as ChakraLink
-} from '@salesforce/retail-react-app/app/components/shared/ui'
-import Link from '@salesforce/retail-react-app/app/components/link'
-import {isAbsoluteURL} from '@salesforce/retail-react-app/app/page-designer/utils'
-
-const HEIGHT_STYLE = {
-    sm: {py: 1.5, fontSize: 'xs'},
-    md: {py: 3, fontSize: 'sm'},
-    lg: {py: 5, fontSize: 'md'}
-}
-
-const ALIGNMENT_JUSTIFY = {
-    left: 'flex-start',
-    center: 'center',
-    right: 'flex-end'
-}
-
-const COLOR_SCHEME_STYLE = {
-    primary: {bg: 'blue.600', color: 'white'},
-    secondary: {bg: 'gray.100', color: 'gray.800'},
-    destructive: {bg: 'red.600', color: 'white'}
-}
-
-const normalize = (value, allowed, fallback) => (allowed.includes(value) ? value : fallback)
-
-/**
- * Announcement Banner component.
- *
- * A banner for announcements, promotions, and alerts. Rendered as an authorable
- * content block; typically placed in the embedded header's `announcement` region.
- *
- * @param {object} props
- * @param {string} props.message - The announcement text (required; renders nothing when empty).
- * @param {string} [props.linkUrl] - Optional link target. Rendered only with linkText.
- * @param {string} [props.linkText] - Optional link label. Rendered only with linkUrl.
- * @param {string} [props.colorScheme] - primary | secondary | destructive (default primary).
- * @param {string} [props.height] - sm | md | lg (default md).
- * @param {string} [props.alignment] - left | center | right (default center).
- * @returns {React.ReactElement|null} - AnnouncementBanner component.
- */
-export const AnnouncementBanner = ({
-    message,
-    linkUrl,
-    linkText,
-    colorScheme,
-    height,
-    alignment
-}) => {
-    if (!message) return null
-
-    const heightStyle = HEIGHT_STYLE[normalize(height, ['sm', 'md', 'lg'], 'md')]
-    const resolvedAlignment = normalize(alignment, ['left', 'center', 'right'], 'center')
-    const colorStyle =
-        COLOR_SCHEME_STYLE[
-            normalize(colorScheme, ['primary', 'secondary', 'destructive'], 'primary')
-        ]
-
-    const isAbsolute = isAbsoluteURL(linkUrl)
-    const LinkWrapper = isAbsolute ? ChakraLink : Link
-    const linkProps = isAbsolute ? {href: linkUrl} : {to: linkUrl}
-
-    return (
-        <Box
-            role="status"
-            className={'announcement-banner'}
-            data-testid={'announcement-banner'}
-            display="flex"
-            alignItems="center"
-            gap={2}
-            px={{base: 4, md: 10}}
-            letterSpacing="wide"
-            justifyContent={ALIGNMENT_JUSTIFY[resolvedAlignment]}
-            {...heightStyle}
-            {...colorStyle}
-        >
-            <Text textAlign={resolvedAlignment} margin={0}>
-                {message}
-                {linkUrl && linkText && (
-                    <>
-                        {' '}
-                        <LinkWrapper
-                            {...linkProps}
-                            textDecoration="underline"
-                            fontWeight="medium"
-                            whiteSpace="nowrap"
-                            color="inherit"
-                        >
-                            {linkText}
-                        </LinkWrapper>
-                    </>
-                )}
-            </Text>
-        </Box>
-    )
-}
-
-AnnouncementBanner.propTypes = {
-    message: PropTypes.string,
-    linkUrl: PropTypes.string,
-    linkText: PropTypes.string,
-    colorScheme: PropTypes.string,
-    height: PropTypes.string,
-    alignment: PropTypes.string
-}
-
-AnnouncementBanner.displayName = 'AnnouncementBanner'
-
-/**
- * Suspense fallback for the Announcement Banner. Mirrors the default md/center/primary
- * height so switching from fallback to real content does not shift layout.
- *
- * @returns {React.ReactElement} - Skeleton placeholder.
- */
-export function AnnouncementBannerFallback() {
-    return (
-        <Box
-            aria-hidden="true"
-            display="flex"
-            alignItems="center"
-            justifyContent="center"
-            px={{base: 4, md: 10}}
-            py={3}
-            bg="blue.600"
-        >
-            <Skeleton height="16px" width="192px" />
-        </Box>
-    )
-}
-
-AnnouncementBannerFallback.displayName = 'AnnouncementBannerFallback'
-
-export default AnnouncementBanner
-
-// The V2 registry reads a module's named `fallback` export to render during the
-// client Suspense boundary while the component chunk loads.
-export {AnnouncementBannerFallback as fallback}

package/app/page-designer/content/announcement-banner/index.test.js

@@ -1,57 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-import React from 'react'
-import {
-    AnnouncementBanner,
-    AnnouncementBannerFallback
-} from '@salesforce/retail-react-app/app/page-designer/content/announcement-banner/index'
-import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'
-
-test('renders the message', () => {
-    const {getByRole, getByText} = renderWithProviders(
-        <AnnouncementBanner message="Free shipping this weekend" />
-    )
-    expect(getByRole('status')).toBeInTheDocument()
-    expect(getByText('Free shipping this weekend')).toBeInTheDocument()
-})
-
-test('renders nothing when message is empty', () => {
-    const {queryByRole} = renderWithProviders(<AnnouncementBanner message="" />)
-    expect(queryByRole('status')).not.toBeInTheDocument()
-})
-
-test('renders a link only when both linkUrl and linkText are set', () => {
-    const {getByRole} = renderWithProviders(
-        <AnnouncementBanner message="Sale" linkUrl="/sale" linkText="Shop now" />
-    )
-    expect(getByRole('link', {name: 'Shop now'})).toBeInTheDocument()
-})
-
-test('does not render a link when only linkUrl is set', () => {
-    const {queryByRole} = renderWithProviders(<AnnouncementBanner message="Sale" linkUrl="/sale" />)
-    expect(queryByRole('link')).not.toBeInTheDocument()
-})
-
-test('applies destructive color scheme background', () => {
-    const {getByRole} = renderWithProviders(
-        <AnnouncementBanner message="Alert" colorScheme="destructive" />
-    )
-    // Chakra maps the `bg` prop to a background CSS declaration; assert the token resolved.
-    expect(getByRole('status')).toHaveStyle({background: 'var(--chakra-colors-red-600)'})
-})
-
-test('falls back to md/center defaults for invalid enum values', () => {
-    const {getByRole} = renderWithProviders(
-        <AnnouncementBanner message="Hi" height="bogus" alignment="bogus" colorScheme="bogus" />
-    )
-    expect(getByRole('status')).toHaveStyle({justifyContent: 'center'})
-})
-
-test('fallback renders an aria-hidden skeleton', () => {
-    const {container} = renderWithProviders(<AnnouncementBannerFallback />)
-    expect(container.querySelector('[aria-hidden="true"]')).toBeInTheDocument()
-})

package/app/page-designer/content/index.js

@@ -1,8 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-export * from './announcement-banner'

package/app/page-designer/layouts/header/index.jsx

@@ -1,33 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-import React from 'react'
-import PropTypes from 'prop-types'
-import {Region} from '@salesforce/commerce-sdk-react/page-designer'
-
-/**
- * Embedded Header component.
- *
- * A singleton Page Designer component (instance id `header`) whose sole purpose is to
- * expose an `announcement` region above the storefront header. It holds no chrome of its
- * own — the storefront's own `Header`/`AboveHeader` remain the visual header. Authors place
- * content blocks (e.g. Announcement Banner) into the `announcement` region.
- *
- * @param {object} props
- * @param {object} props.component - The Page Designer component data (injected by the V2 pipeline).
- * @returns {React.ReactElement|null} - The rendered announcement region, or null when absent.
- */
-export const Header = ({component}) => {
-    return <Region component={component} regionId="announcement" />
-}
-
-Header.propTypes = {
-    component: PropTypes.object.isRequired
-}
-
-Header.displayName = 'PageDesignerHeader'
-
-export default Header

package/app/page-designer/layouts/header/index.test.js

@@ -1,38 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-import React from 'react'
-import {render} from '@testing-library/react'
-import Header from '@salesforce/retail-react-app/app/page-designer/layouts/header/index'
-import {registry} from '@salesforce/commerce-sdk-react/page-designer'
-
-const makeComponent = (regions) => ({
-    id: 'header',
-    typeId: 'commerce_layouts.header',
-    regions
-})
-
-beforeAll(() => {
-    // The embedded region renders authored components through the V2 registry.
-    registry.registerComponent('test.banner', (props) => <div>{props.message}</div>)
-})
-
-test('renders the announcement region components', () => {
-    const component = makeComponent([
-        {
-            id: 'announcement',
-            components: [{id: 'b1', typeId: 'test.banner', data: {message: 'Hello from banner'}}]
-        }
-    ])
-    const {getByText} = render(<Header component={component} />)
-    expect(getByText('Hello from banner')).toBeInTheDocument()
-})
-
-test('renders nothing when there is no announcement region', () => {
-    const component = makeComponent([{id: 'other', components: []}])
-    const {container} = render(<Header component={component} />)
-    expect(container).toBeEmptyDOMElement()
-})

package/app/page-designer/preview-page.js

@@ -1,28 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-/**
- * The id of the synthetic region that hosts the single previewed component.
- * Must stay stable; the mini-PD canvas targets this region.
- */
-export const PREVIEW_REGION_ID = 'preview'
-
-/** The id of the synthetic page wrapping the previewed component. */
-export const PREVIEW_PAGE_ID = '__pwakit_preview__'
-
-/**
- * Wrap a single fetched Page Designer component in a synthetic one-region page
- * so the existing page-mode <Page>/<Region> pipeline can render it standalone,
- * with no changes to the render pipeline.
- *
- * @param {object} component - A Shopper Experience Component (from useComponent).
- * @returns {object} A minimal Page-shaped object hosting the component.
- */
-export const injectIntoPreviewRegion = (component) => ({
-    id: PREVIEW_PAGE_ID,
-    regions: [{id: PREVIEW_REGION_ID, components: [component]}]
-})

package/app/page-designer/preview-page.test.js

@@ -1,26 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-import {
-    PREVIEW_REGION_ID,
-    PREVIEW_PAGE_ID,
-    injectIntoPreviewRegion
-} from '@salesforce/retail-react-app/app/page-designer/preview-page'
-
-describe('injectIntoPreviewRegion', () => {
-    test('wraps a component in a synthetic single-region page', () => {
-        const component = {id: 'comp1', typeId: 'commerce_assets.imageTile', data: {}}
-        const page = injectIntoPreviewRegion(component)
-        expect(page).toEqual({
-            id: PREVIEW_PAGE_ID,
-            regions: [{id: PREVIEW_REGION_ID, components: [component]}]
-        })
-    })
-
-    test('PREVIEW_REGION_ID is "preview"', () => {
-        expect(PREVIEW_REGION_ID).toBe('preview')
-    })
-})

package/app/pages/component-preview/index.jsx

@@ -1,73 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-import React from 'react'
-import {useLocation} from 'react-router-dom'
-import {useComponent} from '@salesforce/commerce-sdk-react'
-import {Page} from '@salesforce/commerce-sdk-react/page-designer'
-import {Box} from '@salesforce/retail-react-app/app/components/shared/ui'
-import Seo from '@salesforce/retail-react-app/app/components/seo'
-import {injectIntoPreviewRegion} from '@salesforce/retail-react-app/app/page-designer/preview-page'
-
-/**
- * Mini-PD component-preview route.
- *
- * Renders a single existing Page Designer component standalone (chrome-free) for
- * the mini-PD "Edit in focused visual canvas" iframe. It is an internal authoring
- * surface, not a public storefront page:
- *  - It renders only when the request is in Page Designer EDIT or PREVIEW mode
- *    (`?mode=EDIT|PREVIEW`); otherwise it renders nothing.
- *  - It emits `robots: noindex`.
- *
- * It fetches the component by `componentId` (from the URL), wraps it in a synthetic
- * single-region page, and renders it via the existing <Page> pipeline — no changes
- * to the render pipeline are required.
- */
-const ComponentPreview = () => {
-    const {search} = useLocation()
-    const searchParams = new URLSearchParams(search)
-    const componentId = searchParams.get('componentId')
-    // Read mode straight from the URL search — SSR-safe (no window dependency).
-    // The runtime's isDesignModeActive()/isPreviewModeActive() no-arg forms fall
-    // back to window.location and are unsafe during SSR, so we don't use them.
-    const mode = searchParams.get('mode')
-    const inDesignOrPreview = mode === 'EDIT' || mode === 'PREVIEW'
-
-    const {
-        data: component,
-        isLoading,
-        error
-    } = useComponent(
-        {parameters: {componentId}},
-        {enabled: Boolean(inDesignOrPreview && componentId)}
-    )
-
-    if (!inDesignOrPreview || !componentId) {
-        return null
-    }
-
-    return (
-        <Box data-testid="component-preview-page" layerStyle="page">
-            <Seo title="Component Preview" noIndex />
-            {isLoading && (
-                <Box textAlign="center" py={8}>
-                    Loading...
-                </Box>
-            )}
-            {error && (
-                <Box textAlign="center" py={8} color="red.500">
-                    Error loading component.
-                </Box>
-            )}
-            {component && !error && <Page page={injectIntoPreviewRegion(component)} />}
-        </Box>
-    )
-}
-
-ComponentPreview.getTemplateName = () => 'component-preview'
-
-export default ComponentPreview

package/app/pages/component-preview/index.test.js

@@ -1,117 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-import React from 'react'
-import {screen, waitFor} from '@testing-library/react'
-import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'
-import ComponentPreview from '@salesforce/retail-react-app/app/pages/component-preview/index'
-import {useComponent} from '@salesforce/commerce-sdk-react'
-import {Page, registry} from '@salesforce/commerce-sdk-react/page-designer'
-import {PREVIEW_PAGE_ID} from '@salesforce/retail-react-app/app/page-designer/preview-page'
-import {initializeRegistry} from '@salesforce/retail-react-app/app/page-designer/registry'
-
-jest.mock('@salesforce/commerce-sdk-react', () => ({
-    ...jest.requireActual('@salesforce/commerce-sdk-react'),
-    useComponent: jest.fn()
-}))
-
-// Spy the real registry-backed Page so we can assert it is called without a
-// `components` map, while still rendering through the V2 Page/Region pipeline.
-jest.mock('@salesforce/commerce-sdk-react/page-designer', () => {
-    const actual = jest.requireActual('@salesforce/commerce-sdk-react/page-designer')
-    return {
-        ...actual,
-        // eslint-disable-next-line react/prop-types
-        Page: jest.fn((props) => actual.Page(props))
-    }
-})
-
-// Mode + componentId are derived directly from the URL search (via useLocation().search
-// and URLSearchParams), NOT the no-arg window fallback. The test harness uses
-// BrowserRouter, which reads window.location — so set the jsdom URL per test with
-// history.pushState (initialEntries does NOT apply to BrowserRouter).
-const setUrl = (path) => window.history.pushState({}, '', path)
-
-const PREVIEW_TYPE_ID = 'commerce_assets.imageTile'
-
-const restoreProductionRegistry = () => {
-    registry.clear()
-    initializeRegistry()
-}
-
-describe('ComponentPreview route', () => {
-    beforeEach(() => {
-        jest.clearAllMocks()
-        useComponent.mockReturnValue({data: undefined, isLoading: false, error: null})
-        restoreProductionRegistry()
-    })
-    afterEach(() => {
-        setUrl('/')
-        restoreProductionRegistry()
-    })
-
-    test('renders nothing when not in EDIT/PREVIEW mode', () => {
-        setUrl('/preview/component?componentId=comp1')
-        renderWithProviders(<ComponentPreview />)
-        expect(screen.queryByTestId('component-preview-page')).not.toBeInTheDocument()
-        expect(Page).not.toHaveBeenCalled()
-    })
-
-    test('renders nothing in EDIT mode when componentId is missing', () => {
-        setUrl('/preview/component?mode=EDIT')
-        renderWithProviders(<ComponentPreview />)
-        expect(screen.queryByTestId('component-preview-page')).not.toBeInTheDocument()
-        expect(Page).not.toHaveBeenCalled()
-    })
-
-    test('renders the component through registry-backed <Page> without a components map', async () => {
-        setUrl('/preview/component?mode=EDIT&componentId=comp1')
-        useComponent.mockReturnValue({
-            data: {
-                id: 'comp1',
-                typeId: PREVIEW_TYPE_ID,
-                data: {
-                    image: {
-                        url: 'https://example.com/tile.png',
-                        alt: 'Preview tile'
-                    }
-                }
-            },
-            isLoading: false,
-            error: null
-        })
-        renderWithProviders(<ComponentPreview />)
-
-        // Production `initializeRegistry()` registers a lazy importer, so Region/Component
-        // suspends until imageTile resolves. Await the eventual tile, not an eager mock.
-        await waitFor(() => {
-            expect(screen.getByTestId('image-tile-image')).toBeInTheDocument()
-        })
-        expect(screen.getByTestId('image-tile-image')).toHaveAttribute(
-            'src',
-            'https://example.com/tile.png'
-        )
-        expect(Page).toHaveBeenCalled()
-        const pageProps = Page.mock.calls[0][0]
-        expect(pageProps.page).toEqual(
-            expect.objectContaining({
-                id: PREVIEW_PAGE_ID,
-                regions: [
-                    expect.objectContaining({
-                        components: [
-                            expect.objectContaining({id: 'comp1', typeId: PREVIEW_TYPE_ID})
-                        ]
-                    })
-                ]
-            })
-        )
-        expect(pageProps.components).toBeUndefined()
-    })
-
-    test('exposes getTemplateName', () => {
-        expect(ComponentPreview.getTemplateName()).toBe('component-preview')
-    })
-})

package/app/utils/inline-agent-widget-utils.js

@@ -1,74 +0,0 @@
-/*
- * Copyright (c) 2024, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-// Kept in one place so the PDP and the widget agree. Matches
-// MAX_PDP_QUESTIONS in the widget (src/provider/pdp-questions.ts).
-export const MAX_PDP_QUESTIONS = 5
-
-/**
- * Parse the SCAPI `c_pdpQuestions` custom attribute into a sanitized list of
- * opener questions. The SCAPI response ships the value as a JSON-encoded
- * string (an array of strings), so we must JSON.parse it and defend against
- * malformed / non-array / non-string content — a bad publish upstream must
- * never break the PDP.
- *
- * Expected input (what the backend should publish into `pdpQuestions` /
- * SCAPI `c_pdpQuestions`): a JSON-encoded string array, e.g.
- *
- *     '["What does SmartTrack do?","Does it track sleep automatically?"]'
- *
- * Where the questions come from: Commerce Content Studio (an operator-run
- * tool outside the storefront) generates PDP FAQ questions per product with
- * an LLM, keeps them behind a human review gate, and publishes approved
- * content back to Business Manager via OCAPI's `sfcc-site-archive-import`
- * job in MERGE mode. The import writes the JSON string array into the
- * `pdpQuestions` product custom attribute, which SCAPI exposes as
- * `c_pdpQuestions` on the Shopper Products response. See the Commerce
- * Content Studio User Guide (step 7 — Write-back) for the publishing side.
- *
- * Returns [] for any unusable input. Trims, drops empties, dedupes, and caps
- * at MAX_PDP_QUESTIONS to keep the UI from getting overwhelmed. SSR-safe.
- *
- * Malformed input is logged via `console.warn` so a merchandiser who
- * published a bad value can see what tripped the parser in the browser
- * console; the PDP still renders without a pill shelf.
- */
-export const parsePdpQuestions = (raw, maxCount = MAX_PDP_QUESTIONS) => {
-    if (!raw || typeof raw !== 'string') return []
-    let parsed
-    try {
-        parsed = JSON.parse(raw)
-    } catch (err) {
-        console.warn(
-            '[inline-agent-widget] Ignoring malformed c_pdpQuestions: not valid JSON. ' +
-                'Expected a JSON-encoded string array, e.g. \'["Q1?","Q2?"]\'. Got:',
-            raw,
-            err
-        )
-        return []
-    }
-    if (!Array.isArray(parsed)) {
-        console.warn(
-            '[inline-agent-widget] Ignoring malformed c_pdpQuestions: parsed value is not an array. ' +
-                'Expected a JSON-encoded string array, e.g. \'["Q1?","Q2?"]\'. Got:',
-            parsed
-        )
-        return []
-    }
-
-    const seen = new Set()
-    const out = []
-    for (const q of parsed) {
-        if (typeof q !== 'string') continue
-        const trimmed = q.trim()
-        if (!trimmed || seen.has(trimmed)) continue
-        seen.add(trimmed)
-        out.push(trimmed)
-        if (out.length >= maxCount) break
-    }
-    return out
-}