Missing js doc comment descriptions for Hydrogen 2025-10 gen docs v1

packages/hydrogen-react/src/CartProvider.tsx

@@ -35,6 +35,10 @@ import {useShop} from './ShopifyProvider.js';
 
 export const CartContext = createContext<CartWithActions | null>(null);
 
+/**
+ * `useCart` hook must be a descendent of a `CartProvider` component.
+ * @publicDocs
+ */
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 type UseCartDocs = () => CartWithActionsDocs;
 

packages/hydrogen-react/src/ExternalVideo.tsx

@@ -3,7 +3,7 @@ import type {Entries, PartialDeep} from 'type-fest';
 import {forwardRef, IframeHTMLAttributes} from 'react';
 
 /**
- * The `ExternalVideo` component renders an embedded video for the Storefront API's [ExternalVideo object](https://shopify.dev/api/storefront/reference/products/externalvideo).
+ * Takes in the same props as a native `<iframe>` element, except for `src`.
  * @publicDocs
  */
 export interface ExternalVideoBaseProps {

packages/hydrogen-react/src/ShopifyProvider.tsx

@@ -153,6 +153,7 @@ export interface ShopifyProviderBase {
 
 /**
  * Shopify-specific values that are used in various Hydrogen React components and hooks.
+ * @publicDocs
  */
 export interface ShopifyProviderProps extends ShopifyProviderBase {
   /** React children to render. */

packages/hydrogen-react/src/analytics-constants.ts

@@ -1,3 +1,7 @@
+/**
+ * Analytics event names accepted by Shopify analytics.
+ * @publicDocs
+ */
 export const AnalyticsEventName = {
   PAGE_VIEW: 'PAGE_VIEW',
   ADD_TO_CART: 'ADD_TO_CART',
@@ -7,6 +11,10 @@ export const AnalyticsEventName = {
   SEARCH_VIEW: 'SEARCH_VIEW',
 } as const;
 
+/**
+ * Analytics page type values accepted by Shopify analytics.
+ * @publicDocs
+ */
 export const AnalyticsPageType: AnalyticsPageType = {
   article: 'article',
   blog: 'blog',
@@ -32,6 +40,10 @@ export const AnalyticsPageType: AnalyticsPageType = {
   search: 'search',
 } as const;
 
+/**
+ * Analytics sales channel values accepted by Shopify analytics.
+ * @publicDocs
+ */
 export const ShopifySalesChannel: ShopifySalesChannel = {
   hydrogen: 'hydrogen',
   headless: 'headless',

packages/hydrogen-react/src/analytics-types.ts

@@ -224,7 +224,7 @@ export type ShopifyAnalyticsPayloadWithPrivacyFields =
 export type ShopifyAnalytics = ShopifyPageView | ShopifyAddToCart;
 
 /**
- * The Shopify analytics cookie values containing the unique user token and session token.
+ * Shopify cookies names
  * @publicDocs
  */
 export type ShopifyCookies = {

packages/hydrogen-react/src/analytics.ts

@@ -137,7 +137,7 @@ function sendToShopify(
 }
 
 /**
- * Gathers client browser values commonly used for analytics.
+ * If executed on server, this method will return empty string for each field.
  * @publicDocs
  */
 export function getClientBrowserParameters(): ClientBrowserParameters {