@pixelated-tech/components 3.11.9 → 3.13.0

package/dist/components/integrations/contentful.delivery.js

@@ -2,7 +2,13 @@ import PropTypes from "prop-types";
 const debug = false;
 const ctfQSParams = "?fm=webp&q=50";
 /* ========== CALL CONTENTFUL DELIVERY API ========== */
+/**
+ * callContentfulDeliveryAPI — Perform an HTTP GET against a fully-formed Contentful Delivery API URL and return parsed JSON.
+ *
+ * @param {string} [props.full_url] - Full request URL to the Contentful Delivery API (include access token / query params).
+ */
 callContentfulDeliveryAPI.propTypes = {
+    /** Full request URL to the Contentful Delivery API */
     full_url: PropTypes.string.isRequired,
 };
 export async function callContentfulDeliveryAPI(props) {
@@ -27,12 +33,28 @@ export async function callContentfulDeliveryAPI(props) {
     return null;
 }
 /* ========== GET CONTENTFUL CARDS ========== */
+/**
+ * getContentfulEntries — Fetch entries from Contentful using the supplied API configuration.
+ *
+ * @param {shape} [props.apiProps] - Contentful API configuration object.
+ * @param {string} [props.proxyURL] - Optional proxy base URL to route requests through.
+ * @param {string} [props.base_url] - Contentful CDN base URL (e.g., https://cdn.contentful.com).
+ * @param {string} [props.space_id] - Contentful space ID.
+ * @param {string} [props.environment] - Contentful environment name (e.g., 'master').
+ * @param {string} [props.delivery_access_token] - Delivery API access token for read requests.
+ */
 getContentfulEntries.propTypes = {
+    /** Contentful API configuration */
     apiProps: PropTypes.shape({
+        /** Optional proxy base URL */
         proxyURL: PropTypes.string,
+        /** Contentful CDN base URL */
         base_url: PropTypes.string.isRequired,
+        /** Contentful space ID */
         space_id: PropTypes.string.isRequired,
+        /** Contentful environment */
         environment: PropTypes.string.isRequired,
+        /** Delivery API access token */
         delivery_access_token: PropTypes.string.isRequired,
     }).isRequired,
 };
@@ -49,7 +71,14 @@ export async function getContentfulEntries(props) {
 https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/entries/entries-collection/get-all-entries-of-a-space/console/js-plain
 */
 /* ========== GET CONTENTFUL CARDS BY TYPE ========== */
+/**
+ * getContentfulEntriesByType — Filter entries by Contentful content type using provided API configuration.
+ *
+ * @param {shape} [props.apiProps] - Contentful API configuration object.
+ * @param {string} [props.contentType] - Target content type ID to filter entries by.
+ */
 getContentfulEntriesByType.propTypes = {
+    /** Contentful API configuration */
     apiProps: PropTypes.shape({
         proxyURL: PropTypes.string,
         base_url: PropTypes.string.isRequired,
@@ -57,6 +86,7 @@ getContentfulEntriesByType.propTypes = {
         environment: PropTypes.string.isRequired,
         delivery_access_token: PropTypes.string.isRequired,
     }).isRequired,
+    /** Content type ID to filter by */
     contentType: PropTypes.string.isRequired,
 };
 export async function getContentfulEntriesByType(props) {
@@ -74,7 +104,14 @@ export async function getContentfulEntriesByType(props) {
     return allEntries;
 }
 /* ========== GET CONTENTFUL CARDS BY TYPE ========== */
+/**
+ * getContentfulContentType — Retrieve metadata for a Contentful content type.
+ *
+ * @param {shape} [props.apiProps] - Contentful API configuration object.
+ * @param {string} [props.contentType] - Contentful content type ID to retrieve.
+ */
 getContentfulContentType.propTypes = {
+    /** Contentful API configuration */
     apiProps: PropTypes.shape({
         proxyURL: PropTypes.string,
         base_url: PropTypes.string.isRequired,
@@ -82,6 +119,7 @@ getContentfulContentType.propTypes = {
         environment: PropTypes.string.isRequired,
         access_token: PropTypes.string.isRequired,
     }).isRequired,
+    /** Content type ID to retrieve */
     contentType: PropTypes.string.isRequired,
 };
 export async function getContentfulContentType(props) {
@@ -94,7 +132,14 @@ export async function getContentfulContentType(props) {
     return await callContentfulDeliveryAPI({ full_url });
 }
 /* ========== GET CONTENTFUL ENTRY BY ENTRY ID ========== */
+/**
+ * getContentfulEntryByEntryID — Fetch a single Contentful entry by its entry ID.
+ *
+ * @param {shape} [props.apiProps] - Contentful API configuration object.
+ * @param {string} [props.entry_id] - Contentful entry ID to fetch.
+ */
 getContentfulEntryByEntryID.propTypes = {
+    /** Contentful API configuration */
     apiProps: PropTypes.shape({
         proxyURL: PropTypes.string,
         base_url: PropTypes.string.isRequired,
@@ -102,6 +147,7 @@ getContentfulEntryByEntryID.propTypes = {
         environment: PropTypes.string.isRequired,
         delivery_access_token: PropTypes.string.isRequired,
     }).isRequired,
+    /** Target entry ID */
     entry_id: PropTypes.string.isRequired,
 };
 export async function getContentfulEntryByEntryID(props) {
@@ -125,7 +171,15 @@ export async function getContentfulEntryByField(params) {
     return null;
 }
 /* ========== GET CONTENTFUL CARD TITLES ========== */
+/**
+ * getContentfulFieldValues — Return unique values for a field from entries of a given content type.
+ *
+ * @param {shape} [props.apiProps] - Contentful API configuration object.
+ * @param {string} [props.contentType] - Contentful content type ID to inspect.
+ * @param {string} [props.field] - Field name to extract values from.
+ */
 getContentfulFieldValues.propTypes = {
+    /** Contentful API configuration */
     apiProps: PropTypes.shape({
         proxyURL: PropTypes.string,
         base_url: PropTypes.string.isRequired,
@@ -133,7 +187,9 @@ getContentfulFieldValues.propTypes = {
         environment: PropTypes.string.isRequired,
         delivery_access_token: PropTypes.string.isRequired,
     }).isRequired,
+    /** Content type ID to query */
     contentType: PropTypes.string.isRequired,
+    /** Field name to extract values from */
     field: PropTypes.string.isRequired,
 };
 export async function getContentfulFieldValues(props) {
@@ -147,8 +203,16 @@ export async function getContentfulFieldValues(props) {
     return fieldVals;
 }
 /* ========== GET CONTENTFUL IMAGES FROM CARDS ========== */
+/**
+ * getContentfulImagesFromEntries — Resolve image asset URLs and alt text for entry image references.
+ *
+ * @param {any} [props.images] - Entry image references (items with sys.id that map to assets).
+ * @param {any} [props.assets] - Array of Contentful asset objects to resolve URLs from.
+ */
 getContentfulImagesFromEntries.propTypes = {
+    /** Entry image references to resolve */
     images: PropTypes.any.isRequired,
+    /** Contentful asset objects containing file URLs and descriptions */
     assets: PropTypes.any.isRequired,
 };
 export async function getContentfulImagesFromEntries(props) {
@@ -166,7 +230,13 @@ export async function getContentfulImagesFromEntries(props) {
     return imageURLs;
 }
 /* ========== GET CONTENTFUL ASSETS ========== */
+/**
+ * getContentfulAssets — Fetch asset records from Contentful for the configured space/environment.
+ *
+ * @param {shape} [props.apiProps] - Contentful API configuration object.
+ */
 getContentfulAssets.propTypes = {
+    /** Contentful API configuration */
     apiProps: PropTypes.shape({
         proxyURL: PropTypes.string,
         base_url: PropTypes.string.isRequired,
@@ -184,7 +254,13 @@ export async function getContentfulAssets(props) {
     return await callContentfulDeliveryAPI({ full_url });
 }
 /* ========== GET CONTENTFUL ASSET URLS ========== */
+/**
+ * getContentfulAssetURLs — Return resolved asset URLs and metadata using provided API configuration.
+ *
+ * @param {shape} [props.apiProps] - Contentful API configuration object.
+ */
 getContentfulAssetURLs.propTypes = {
+    /** Contentful API configuration */
     apiProps: PropTypes.shape({
         proxyURL: PropTypes.string,
         base_url: PropTypes.string.isRequired,
@@ -207,7 +283,14 @@ export async function getContentfulAssetURLs(props) {
     return assetURLs;
 }
 /* ========== GET CONTENTFUL DISCOUNT CODES ========== */
+/**
+ * getContentfulDiscountCodes — Retrieve discount code entries from Contentful using the supplied API configuration.
+ *
+ * @param {shape} [props.apiProps] - Contentful API configuration object (base_url, space_id, environment, access tokens).
+ * @param {string} [props.contentType] - Contentful content type ID for discount codes (default: 'discountCodes').
+ */
 getContentfulDiscountCodes.propTypes = {
+    /** Contentful API configuration */
     apiProps: PropTypes.shape({
         proxyURL: PropTypes.string,
         base_url: PropTypes.string.isRequired,
@@ -215,6 +298,7 @@ getContentfulDiscountCodes.propTypes = {
         environment: PropTypes.string.isRequired,
         delivery_access_token: PropTypes.string.isRequired,
     }).isRequired,
+    /** Contentful content type ID to fetch */
     contentType: PropTypes.string.isRequired,
 };
 export async function getContentfulDiscountCodes(props) {

package/dist/components/integrations/contentful.items.components.js

@@ -24,8 +24,16 @@ let ContentfulApiProps = {
 };
 const contentfulContentType = "item";
 /* ========== CONTENTFUL ITEMS PAGE ========== */
+/**
+ * ContentfulItems — Fetch and render a list of Contentful items (carousel or list) using provided API configuration.
+ *
+ * @param {object} [props.apiProps] - Contentful API configuration (base_url, space_id, delivery_access_token, etc.).
+ * @param {string} [props.cloudinaryProductEnv] - Optional Cloudinary cloud name used to build remote fetch URLs for images.
+ */
 ContentfulItems.propTypes = {
+    /** Contentful API configuration object */
     apiProps: PropTypes.object.isRequired,
+    /** Optional Cloudinary product environment (cloud name) for image transforms */
     cloudinaryProductEnv: PropTypes.string,
 };
 export function ContentfulItems(props) {
@@ -44,9 +52,19 @@ export function ContentfulItems(props) {
     const providerContentfulApiProps = usePixelatedConfig()?.contentful;
     const mergedApiProps = { ...ContentfulApiProps, ...providerContentfulApiProps, ...props.apiProps, };
     const [apiProps] = useState(mergedApiProps);
+    /**
+     * paintItems — Convert Contentful API items and assets into rendered list nodes.
+     *
+     * @param {array} [props.items] - Array of Contentful item entries.
+ * @param {array} [props.assets] - Array of Contentful asset objects used for resolving images.
+ * @param {string} [props.cloudinaryProductEnv] - Optional Cloudinary cloud name used to transform image URLs.
+     */
     paintItems.propTypes = {
+        /** Array of Contentful items */
         items: PropTypes.array.isRequired,
+        /** Array of Contentful assets */
         assets: PropTypes.array.isRequired,
+        /** Optional Cloudinary product environment */
         cloudinaryProductEnv: PropTypes.string,
     };
     function paintItems(props) {
@@ -107,8 +125,16 @@ export function ContentfulItems(props) {
     }
 }
 /* ========== CONTENTFUL LIST ITEM ========== */
+/**
+ * ContentfulListItem — Render a single Contentful item with image, title and add-to-cart actions.
+ *
+ * @param {any} [props.item] - Single Contentful item entry to render.
+ * @param {string} [props.cloudinaryProductEnv] - Optional Cloudinary cloud name used to build image URLs.
+ */
 ContentfulListItem.propTypes = {
+    /** Contentful item entry object */
     item: PropTypes.any.isRequired,
+    /** Optional Cloudinary product environment */
     cloudinaryProductEnv: PropTypes.string,
 };
 export function ContentfulListItem(props) {
@@ -137,9 +163,19 @@ export function ContentfulListItem(props) {
                             : "$" + thisItem.fields.price + " USD" }), _jsx("br", {}), _jsxs("div", { className: "contentful-item-addtocart", children: [_jsx(ViewItemDetails, { href: "/store", itemID: thisItem.sys.id }), _jsx(AddToCartButton, { handler: addToShoppingCart, item: shoppingCartItem, itemID: thisItem.sys.id })] })] })] }));
 }
 /* ========== CONTENTFUL ITEM HEADER ========== */
+/**
+ * ContentfulItemHeader — Render a title for a Contentful item and optionally wrap it in a link.
+ *
+ * @param {string} [props.title] - Item title text.
+ * @param {string} [props.url] - Optional URL to link the title to.
+ * @param {string} [props.target] - Optional link target attribute (e.g., '_blank').
+ */
 ContentfulItemHeader.propTypes = {
+    /** Item title text */
     title: PropTypes.string.isRequired,
+    /** Optional link URL for the title */
     url: PropTypes.string,
+    /** Link target attribute (e.g., '_blank') */
     target: PropTypes.string,
 };
 export function ContentfulItemHeader(props) {
@@ -148,9 +184,19 @@ export function ContentfulItemHeader(props) {
             : _jsx("h2", { className: "", children: props.title }) }));
 }
 /* ========== CONTENTFUL ITEM DETAIL PAGE ========== */
+/**
+ * ContentfulItemDetail — Fetch and render a single Contentful item by entry ID.
+ *
+ * @param {object} [props.apiProps] - Contentful API configuration (base_url, space_id, delivery_access_token, etc.).
+ * @param {string} [props.entry_id] - Entry ID of the specific Contentful item to fetch.
+ * @param {string} [props.cloudinaryProductEnv] - Optional Cloudinary cloud name used to build image URLs.
+ */
 ContentfulItemDetail.propTypes = {
+    /** Contentful API configuration object */
     apiProps: PropTypes.object.isRequired,
+    /** Entry ID of the item to fetch */
     entry_id: PropTypes.string.isRequired,
+    /** Optional Cloudinary product env (cloud name) for image transforms */
     cloudinaryProductEnv: PropTypes.string,
 };
 export function ContentfulItemDetail(props) {

package/dist/components/integrations/contentful.management.js

@@ -7,11 +7,11 @@
  * List all entries of a specific content type
  */
 export async function listEntries(contentType, config) {
-    const { spaceId, accessToken, environment = 'master' } = config;
+    const { space_id, delivery_access_token, environment = 'master' } = config;
     try {
-        const response = await fetch(`https://api.contentful.com/spaces/${spaceId}/environments/${environment}/entries?content_type=${contentType}`, {
+        const response = await fetch(`https://api.contentful.com/spaces/${space_id}/environments/${environment}/entries?content_type=${contentType}`, {
             headers: {
-                'Authorization': `Bearer ${accessToken}`,
+                'Authorization': `Bearer ${delivery_access_token}`,
                 'Content-Type': 'application/json',
             },
         });
@@ -37,11 +37,11 @@ export async function listEntries(contentType, config) {
  * Get a single entry by ID
  */
 export async function getEntryById(entryId, config) {
-    const { spaceId, accessToken, environment = 'master' } = config;
+    const { space_id, delivery_access_token, environment = 'master' } = config;
     try {
-        const response = await fetch(`https://api.contentful.com/spaces/${spaceId}/environments/${environment}/entries/${entryId}`, {
+        const response = await fetch(`https://api.contentful.com/spaces/${space_id}/environments/${environment}/entries/${entryId}`, {
             headers: {
-                'Authorization': `Bearer ${accessToken}`,
+                'Authorization': `Bearer ${delivery_access_token}`,
                 'Content-Type': 'application/json',
             },
         });
@@ -71,11 +71,11 @@ export async function getEntryById(entryId, config) {
  * Search for entries by field value
  */
 export async function searchEntriesByField(contentType, fieldName, fieldValue, config) {
-    const { spaceId, accessToken, environment = 'master' } = config;
+    const { space_id, delivery_access_token, environment = 'master' } = config;
     try {
-        const response = await fetch(`https://api.contentful.com/spaces/${spaceId}/environments/${environment}/entries?content_type=${contentType}&fields.${fieldName}=${encodeURIComponent(fieldValue)}`, {
+        const response = await fetch(`https://api.contentful.com/spaces/${space_id}/environments/${environment}/entries?content_type=${contentType}&fields.${fieldName}=${encodeURIComponent(fieldValue)}`, {
             headers: {
-                'Authorization': `Bearer ${accessToken}`,
+                'Authorization': `Bearer ${delivery_access_token}`,
                 'Content-Type': 'application/json',
             },
         });
@@ -101,17 +101,17 @@ export async function searchEntriesByField(contentType, fieldName, fieldValue, c
  * Create a new entry
  */
 export async function createEntry(contentType, fields, config, autoPublish = true) {
-    const { spaceId, accessToken, environment = 'master' } = config;
+    const { space_id, delivery_access_token, environment = 'master' } = config;
     try {
         // Convert fields to Contentful format (with 'en-US' locale)
         const contentfulFields = {};
         for (const [key, value] of Object.entries(fields)) {
             contentfulFields[key] = { 'en-US': value };
         }
-        const createResponse = await fetch(`https://api.contentful.com/spaces/${spaceId}/environments/${environment}/entries`, {
+        const createResponse = await fetch(`https://api.contentful.com/spaces/${space_id}/environments/${environment}/entries`, {
             method: 'POST',
             headers: {
-                'Authorization': `Bearer ${accessToken}`,
+                'Authorization': `Bearer ${delivery_access_token}`,
                 'Content-Type': 'application/vnd.contentful.management.v1+json',
                 'X-Contentful-Content-Type': contentType,
             },
@@ -126,10 +126,10 @@ export async function createEntry(contentType, fields, config, autoPublish = tru
         const newEntry = await createResponse.json();
         // Publish if requested
         if (autoPublish) {
-            await fetch(`https://api.contentful.com/spaces/${spaceId}/environments/${environment}/entries/${newEntry.sys.id}/published`, {
+            await fetch(`https://api.contentful.com/spaces/${space_id}/environments/${environment}/entries/${newEntry.sys.id}/published`, {
                 method: 'PUT',
                 headers: {
-                    'Authorization': `Bearer ${accessToken}`,
+                    'Authorization': `Bearer ${delivery_access_token}`,
                     'X-Contentful-Version': newEntry.sys.version.toString(),
                 },
             });
@@ -151,7 +151,7 @@ export async function createEntry(contentType, fields, config, autoPublish = tru
  * Update an existing entry
  */
 export async function updateEntry(entryId, fields, config, autoPublish = true) {
-    const { spaceId, accessToken, environment = 'master' } = config;
+    const { space_id, delivery_access_token, environment = 'master' } = config;
     try {
         // Get current entry to get version
         const getResponse = await getEntryById(entryId, config);
@@ -167,10 +167,10 @@ export async function updateEntry(entryId, fields, config, autoPublish = true) {
         for (const [key, value] of Object.entries(fields)) {
             contentfulFields[key] = { 'en-US': value };
         }
-        const updateResponse = await fetch(`https://api.contentful.com/spaces/${spaceId}/environments/${environment}/entries/${entryId}`, {
+        const updateResponse = await fetch(`https://api.contentful.com/spaces/${space_id}/environments/${environment}/entries/${entryId}`, {
             method: 'PUT',
             headers: {
-                'Authorization': `Bearer ${accessToken}`,
+                'Authorization': `Bearer ${delivery_access_token}`,
                 'Content-Type': 'application/vnd.contentful.management.v1+json',
                 'X-Contentful-Version': currentEntry.sys.version.toString(),
             },
@@ -185,10 +185,10 @@ export async function updateEntry(entryId, fields, config, autoPublish = true) {
         const updatedEntry = await updateResponse.json();
         // Publish if requested
         if (autoPublish) {
-            await fetch(`https://api.contentful.com/spaces/${spaceId}/environments/${environment}/entries/${entryId}/published`, {
+            await fetch(`https://api.contentful.com/spaces/${space_id}/environments/${environment}/entries/${entryId}/published`, {
                 method: 'PUT',
                 headers: {
-                    'Authorization': `Bearer ${accessToken}`,
+                    'Authorization': `Bearer ${delivery_access_token}`,
                     'X-Contentful-Version': updatedEntry.sys.version.toString(),
                 },
             });
@@ -210,7 +210,7 @@ export async function updateEntry(entryId, fields, config, autoPublish = true) {
  * Delete an entry (unpublish first, then delete)
  */
 export async function deleteEntry(entryId, config) {
-    const { spaceId, accessToken, environment = 'master' } = config;
+    const { space_id, delivery_access_token, environment = 'master' } = config;
     try {
         // Get current entry to get version
         const getResponse = await getEntryById(entryId, config);
@@ -222,18 +222,18 @@ export async function deleteEntry(entryId, config) {
         }
         const entry = getResponse.entry;
         // Unpublish first
-        await fetch(`https://api.contentful.com/spaces/${spaceId}/environments/${environment}/entries/${entryId}/published`, {
-            method: 'DELETE',
+        await fetch(`https://api.contentful.com/spaces/${space_id}/environments/${environment}/entries/${entry.sys.id}/published`, {
+            method: 'PUT',
             headers: {
-                'Authorization': `Bearer ${accessToken}`,
+                'Authorization': `Bearer ${delivery_access_token}`,
                 'X-Contentful-Version': entry.sys.version.toString(),
             },
         });
         // Delete the entry
-        const deleteResponse = await fetch(`https://api.contentful.com/spaces/${spaceId}/environments/${environment}/entries/${entryId}`, {
+        const deleteResponse = await fetch(`https://api.contentful.com/spaces/${space_id}/environments/${environment}/entries/${entryId}`, {
             method: 'DELETE',
             headers: {
-                'Authorization': `Bearer ${accessToken}`,
+                'Authorization': `Bearer ${delivery_access_token}`,
                 'X-Contentful-Version': (entry.sys.version + 1).toString(),
             },
         });

package/dist/components/integrations/flickr.js

@@ -41,8 +41,16 @@ function getFlickrSize(size) {
         default: return '';
     }
 }
+/**
+ * GetFlickrData — Fetch image data from Flickr API using provided configuration.
+ *
+ * @param {object} [props.flickr] - Flickr-specific query overrides (method, tags, user_id, etc.).
+ * @param {object} [props.config] - Optional provider config to merge with defaults.
+ */
 GetFlickrData.propTypes = {
+    /** Flickr-specific query overrides */
     flickr: PropTypes.object,
+    /** Optional provider configuration for Flickr requests */
     config: PropTypes.object,
 };
 export function GetFlickrData(props) {
@@ -103,8 +111,16 @@ export function GetFlickrData(props) {
     };
     return fetchFlickrData();
 }
+/**
+ * GenerateFlickrCards — Convert raw Flickr image objects into card-friendly data structures.
+ *
+ * @param {array} [props.flickrImages] - Array of Flickr image objects returned by the API.
+ * @param {string} [props.photoSize] - Desired photo size label (e.g., 'Medium', 'Large').
+ */
 GenerateFlickrCards.propTypes = {
+    /** Flickr image array */
     flickrImages: PropTypes.array.isRequired,
+    /** Desired photo size label */
     photoSize: PropTypes.string.isRequired,
 };
 export function GenerateFlickrCards(props) {
@@ -121,13 +137,31 @@ export function GenerateFlickrCards(props) {
         return flickrCards;
     }
 }
+/**
+ * FlickrWrapper — Wrapper component that exposes Flickr query controls and renders fetched results.
+ *
+ * @param {string} [props.method] - Flickr API method to call (e.g., 'flickr.photos.search').
+ * @param {string} [props.api_key] - Flickr API key used for authentication.
+ * @param {string} [props.user_id] - Flickr user id to scope queries.
+ * @param {string} [props.tags] - Comma-separated tags to filter photos.
+ * @param {string} [props.photoset_id] - Photoset/album id to fetch specific album contents.
+ * @param {string} [props.photoSize] - Desired photo size label used by `getFlickrSize`.
+ * @param {function} [props.callback] - Optional callback function invoked after data fetch.
+ */
 FlickrWrapper.propTypes = {
+    /** Flickr API method */
     method: PropTypes.string,
+    /** Flickr API key */
     api_key: PropTypes.string.isRequired,
+    /** Flickr user id */
     user_id: PropTypes.string.isRequired,
+    /** Tag filter string */
     tags: PropTypes.string,
+    /** Photoset/album id */
     photoset_id: PropTypes.string,
+    /** Desired photo size label (e.g., 'Medium', 'Large') */
     photoSize: PropTypes.string,
+    /** Callback invoked with an array of Carousel cards after data is fetched */
     callback: PropTypes.func.isRequired,
     /* 	callback: (arg0: CarouselCardType[]) => void; */
 };

package/dist/components/integrations/google.reviews.components.js

@@ -6,11 +6,25 @@ import { SmartImage } from '../general/smartimage';
 import { getGoogleReviewsByPlaceId } from './google.reviews.functions';
 import { usePixelatedConfig } from '../config/config.client';
 import './google.reviews.css';
+/**
+ * GoogleReviewsCard — Fetch and display Google Place reviews for a specific Place ID.
+ *
+ * @param {string} [props.placeId] - Google Place ID to fetch reviews for (required).
+ * @param {string} [props.language] - Optional language code to localize review text.
+ * @param {number} [props.maxReviews] - Maximum number of reviews to display.
+ * @param {string} [props.proxyBase] - Optional proxy base URL to avoid CORS restrictions.
+ * @param {string} [props.apiKey] - Optional Google API key to use when fetching reviews.
+ */
 GoogleReviewsCard.propTypes = {
+    /** Google Place ID (required) */
     placeId: PropTypes.string.isRequired,
+    /** Language code for localization (optional) */
     language: PropTypes.string,
+    /** Max number of reviews to display */
     maxReviews: PropTypes.number,
+    /** Optional proxy base URL to avoid CORS issues */
     proxyBase: PropTypes.string,
+    /** Optional Google API key */
     apiKey: PropTypes.string,
 };
 export function GoogleReviewsCard(props) {

package/dist/components/integrations/googleanalytics.js

@@ -11,7 +11,13 @@ function isGA() {
     const hasGAInitScriptID = !!(document.querySelector('script#ga-init'));
     return (hasGtag || hasDataLayer || hasGAScript || hasGAScriptID || hasGAInitScriptID);
 }
+/**
+ * GoogleAnalytics — Inject Google Analytics gtag script and initialize with the given measurement id.
+ *
+ * @param {string} [props.id] - Google Analytics measurement ID (e.g., 'G-XXXX') or omitted to use provider config.
+ */
 GoogleAnalytics.propTypes = {
+    /** Google Analytics measurement ID */
     id: PropTypes.string,
 };
 export function GoogleAnalytics(props) {
@@ -55,8 +61,16 @@ ${adId ? `window.gtag('config', '${adId}');` : ''}
     // }, []); 
     return (_jsx("div", { className: "ga", suppressHydrationWarning: true }));
 }
+/**
+ * GoogleAnalyticsEvent — Trigger a one-off Google Analytics event using gtag.
+ *
+ * @param {string} [props.event_name] - Event name to send to GA (required).
+ * @param {object} [props.event_parameters] - Parameters associated with the event (required).
+ */
 GoogleAnalyticsEvent.propTypes = {
+    /** Event name for gtag */
     event_name: PropTypes.string.isRequired,
+    /** Event parameter object */
     event_parameters: PropTypes.object.isRequired,
 };
 export function GoogleAnalyticsEvent(props) {

package/dist/components/integrations/googlemap.js

@@ -2,14 +2,34 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import PropTypes from "prop-types";
 import { usePixelatedConfig } from "../config/config.client";
 // https://developers.google.com/maps/documentation/embed/embedding-map
+/**
+ * GoogleMaps — Embed a Google Maps iframe using the Maps Embed API.
+ *
+ * @param {string} [props.title] - Accessible iframe title.
+ * @param {string} [props.width] - Width of the iframe (e.g., '600' or '100%').
+ * @param {string} [props.height] - Height of the iframe (e.g., '400').
+ * @param {string} [props.frameBorder] - iframe frameBorder attribute.
+ * @param {object} [props.style] - Inline CSS styles applied to the iframe.
+ * @param {string} [props.map_mode] - Embed mode (e.g., 'place', 'search', 'directions').
+ * @param {string} [props.api_key] - Google Maps API key (falls back to config if omitted).
+ * @param {string} [props.parameters] - Additional query parameters for the embed URL (e.g., q=, center=, zoom=).
+ */
 GoogleMaps.propTypes = {
+    /** Accessible iframe title */
     title: PropTypes.string,
+    /** iframe width (pixels or %) */
     width: PropTypes.string,
+    /** iframe height (pixels) */
     height: PropTypes.string,
+    /** iframe frameBorder attribute */
     frameBorder: PropTypes.string,
+    /** Inline style object for the iframe */
     style: PropTypes.object,
+    /** Maps embed mode (required) */
     map_mode: PropTypes.string.isRequired,
+    /** Google Maps API key */
     api_key: PropTypes.string,
+    /** Additional query parameters for the embed URL */
     parameters: PropTypes.string,
 };
 export function GoogleMaps(props) {

package/dist/components/integrations/googlesearch.js

@@ -18,7 +18,13 @@ https://stackoverflow.com/questions/15779036/auto-adding-gsc-tab-0-after-the-url
 https://www.reddit.com/r/nextjs/comments/1gabiqn/hydration_error_when_installing_nextjs_15/?rdt=34262
 https://nextjs.org/docs/messages/react-hydration-error
 */
+/**
+ * GoogleSearch — Embed a Google Programmable Search Engine (CSE) widget by id.
+ *
+ * @param {string} [props.id] - The CSE 'cx' id to initialize the Programmable Search Engine (required).
+ */
 GoogleSearch.propTypes = {
+    /** CSE 'cx' id for the Google Programmable Search Engine */
     id: PropTypes.string.isRequired,
 };
 export function GoogleSearch(props) {