@pixelated-tech/components 3.11.8 → 3.12.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/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) {

package/dist/components/integrations/gravatar.components.js

@@ -32,32 +32,80 @@ import './gravatar.css';
     avatarSize?: number; // in pixels
     compact?: boolean; // compact variant
 }; */
+/**
+ * GravatarCard — Render a profile card using Gravatar profile data, with optional prop overrides.
+ *
+ * @param {shape} [props.profile] - Gravatar profile object (fetched server-side) including profile fields and accounts.
+ * @param {string} [props.hash] - Gravatar hash for the avatar.
+ * @param {string} [props.requestHash] - Optional request hash used when fetching the profile.
+ * @param {string} [props.profileUrl] - Direct URL to the Gravatar profile.
+ * @param {string} [props.preferredUsername] - Preferred username from the profile.
+ * @param {string} [props.thumbnailUrl] - Avatar image URL.
+ * @param {string} [props.displayName] - Display name to show on the card.
+ * @param {string} [props.pronouns] - Display pronouns (if available).
+ * @param {string} [props.aboutMe] - Short bio or about text.
+ * @param {string} [props.currentLocation] - Location string for the profile.
+ * @param {string} [props.job_title] - Job title from the profile.
+ * @param {string} [props.company] - Company name from the profile.
+ * @param {arrayOf} [props.accounts] - Array of social account objects (domain, url, username, etc.).
+ * @param {arrayOf} [props.emails] - Email objects associated with the profile.
+ * @param {string} [props.customRole] - Optional custom role to use instead of job_title.
+ * @param {shape} [props.socialLinks] - Override object for social links (github, linkedin, twitter, instagram, website).
+ * @param {oneOf} [props.layout] - Layout style: 'horizontal' or 'vertical'.
+ * @param {oneOf} [props.direction] - Photo position for horizontal layout: 'left' or 'right'.
+ * @param {number} [props.avatarSize] - Avatar size in pixels.
+ * @param {boolean} [props.compact] - Render a compact variant of the card.
+ */
 GravatarCard.propTypes = {
     // Gravatar profile data (fetched server-side)
+    /** Gravatar profile object with common fields */
     profile: PropTypes.shape({
+        /** Gravatar hash used to construct avatar URLs */
         hash: PropTypes.string,
+        /** Optional request identifier used when fetching the profile */
         requestHash: PropTypes.string,
+        /** Direct URL to the Gravatar profile */
         profileUrl: PropTypes.string,
+        /** Preferred username from the Gravatar profile */
         preferredUsername: PropTypes.string,
+        /** Avatar thumbnail URL from the profile */
         thumbnailUrl: PropTypes.string,
+        /** Display name from profile */
         displayName: PropTypes.string,
+        /** Pronouns string */
         pronouns: PropTypes.string,
+        /** Short bio / about text */
         aboutMe: PropTypes.string,
+        /** Current location string */
         currentLocation: PropTypes.string,
+        /** Job title from profile */
         job_title: PropTypes.string,
+        /** Company name from profile */
         company: PropTypes.string,
+        /** Social accounts array */
         accounts: PropTypes.arrayOf(PropTypes.shape({
+            /** Account domain (e.g., 'github.com') */
             domain: PropTypes.string,
+            /** Display label for the account */
             display: PropTypes.string,
+            /** URL for the account */
             url: PropTypes.string,
+            /** Icon URL for the account */
             iconUrl: PropTypes.string,
+            /** Account username */
             username: PropTypes.string,
+            /** Whether the account is verified */
             verified: PropTypes.bool,
+            /** Full name associated with the account */
             name: PropTypes.string,
+            /** Shortname used to identify the service (e.g., 'github') */
             shortname: PropTypes.string,
         })),
+        /** Email addresses associated with the profile */
         emails: PropTypes.arrayOf(PropTypes.shape({
+            /** Email primary flag (if applicable) */
             primary: PropTypes.string,
+            /** Email address value */
             value: PropTypes.string,
         })),
     }),
@@ -71,18 +119,29 @@ GravatarCard.propTypes = {
     pronouns: PropTypes.string,
     profileUrl: PropTypes.string,
     // Additional custom fields not in Gravatar
+    /** Optional custom role to display instead of job_title */
     customRole: PropTypes.string, // Alternative to job_title
+    /** Overrides for social links (preferred over profile accounts) */
     socialLinks: PropTypes.shape({
+        /** GitHub profile URL */
         github: PropTypes.string,
+        /** LinkedIn profile URL */
         linkedin: PropTypes.string,
+        /** Twitter profile URL */
         twitter: PropTypes.string,
+        /** Instagram profile URL */
         instagram: PropTypes.string,
+        /** Personal website URL */
         website: PropTypes.string,
     }),
     // Layout options
+    /** Layout style: 'horizontal' or 'vertical' */
     layout: PropTypes.oneOf(['horizontal', 'vertical']),
+    /** Photo position when horizontal: 'left' or 'right' */
     direction: PropTypes.oneOf(['left', 'right']), // photo position (for horizontal layout)
+    /** Avatar size in pixels */
     avatarSize: PropTypes.number, // in pixels
+    /** Compact card variant */
     compact: PropTypes.bool, // compact variant
 };
 export function GravatarCard(props) {

package/dist/components/integrations/hubspot.components.js

@@ -16,11 +16,25 @@ export function initializeHubSpotScript(region, portalId) {
     script.defer = true;
     document.head.appendChild(script);
 }
+/**
+ * HubSpotForm — Embed a HubSpot form by injecting the HubSpot script and creating a form instance.
+ *
+ * @param {string} [props.region] - HubSpot region code (e.g., 'na1').
+ * @param {string} [props.portalId] - HubSpot portal ID (account identifier).
+ * @param {string} [props.formId] - HubSpot form GUID to render.
+ * @param {string} [props.target] - CSS selector target for where the form will be injected (overrides containerId).
+ * @param {string} [props.containerId] - ID of the container element to mount the form into (default: 'hubspot-form-container').
+ */
 HubSpotForm.propTypes = {
+    /** HubSpot region code */
     region: PropTypes.string,
+    /** HubSpot portal/account ID */
     portalId: PropTypes.string,
+    /** HubSpot form GUID */
     formId: PropTypes.string,
+    /** CSS selector or target element for the form */
     target: PropTypes.string,
+    /** DOM ID of the container element for the form */
     containerId: PropTypes.string,
 };
 export function HubSpotForm({ region, portalId, formId, target, containerId = 'hubspot-form-container' }) {
@@ -48,15 +62,31 @@ export function HubSpotForm({ region, portalId, formId, target, containerId = 'h
     }, [finalRegion, finalPortalId, finalFormId, formTarget]);
     return _jsx("div", { className: "hs-form-frame", "data-region": finalRegion, "data-form-id": finalFormId, "data-portal-id": finalPortalId });
 }
+/**
+ * HubspotTrackingCode — Inject the HubSpot tracking script for the given portal ID.
+ *
+ * @param {string} [props.hubID] - HubSpot portal ID used to load the tracking script.
+ */
 HubspotTrackingCode.propTypes = {
+    /** HubSpot portal ID for tracking script injection */
     hubID: PropTypes.string.isRequired,
 };
 export function HubspotTrackingCode(props) {
     return (_jsx(_Fragment, { children: _jsx("script", { type: "text/javascript", id: "hs-script-loader", async: true, defer: true, src: `//js-na2.hs-scripts.com/${props.hubID}.js` }) }));
 }
+/**
+ * getHubspotFormSubmissions — Retrieve submissions for a HubSpot form via the HubSpot Forms API (proxied).
+ *
+ * @param {string} [props.proxyURL] - Proxy base URL used to avoid CORS (must include trailing slash if required by proxy).
+ * @param {string} [props.formGUID] - HubSpot form GUID to fetch submissions for.
+ * @param {string} [props.apiToken] - HubSpot API token used for authorization.
+ */
 getHubspotFormSubmissions.propTypes = {
+    /** Proxy base URL to route the request through */
     proxyURL: PropTypes.string.isRequired,
+    /** HubSpot form GUID */
     formGUID: PropTypes.string.isRequired,
+    /** Bearer API token for HubSpot requests */
     apiToken: PropTypes.string.isRequired,
 };
 export async function getHubspotFormSubmissions(props) {

package/dist/components/integrations/instagram.components.js

@@ -5,13 +5,31 @@ import PropTypes from 'prop-types';
 import { getInstagramTiles } from './instagram.functions';
 import { usePixelatedConfig } from "../config/config.client";
 import { Tiles } from '../general/tiles';
+/**
+ * InstagramTiles — Fetch Instagram media and render as tiles.
+ *
+ * @param {string} [props.accessToken] - Instagram user access token with required permissions.
+ * @param {string} [props.userId] - Instagram user ID to fetch media from.
+ * @param {number} [props.limit] - Maximum number of media items to fetch (default: 12).
+ * @param {number} [props.rowCount] - Number of columns/rows to use in the tiles layout.
+ * @param {boolean} [props.useThumbnails] - Whether to prefer thumbnail images over full-size media.
+ * @param {boolean} [props.includeVideos] - Include video posts in results when true.
+ * @param {boolean} [props.includeCaptions] - Include captions in the returned tile metadata.
+ */
 InstagramTiles.propTypes = {
+    /** Instagram access token */
     accessToken: PropTypes.string,
+    /** Instagram user ID */
     userId: PropTypes.string,
+    /** Max number of media items to fetch */
     limit: PropTypes.number,
+    /** Number of columns/rows used by Tiles layout */
     rowCount: PropTypes.number,
+    /** Prefer thumbnails when available */
     useThumbnails: PropTypes.bool,
+    /** Include video posts */
     includeVideos: PropTypes.bool,
+    /** Include captions in tile metadata */
     includeCaptions: PropTypes.bool,
 };
 export function InstagramTiles(props) {