@arc-ui/community-components 3.7.1 → 3.8.1

package/lib/index.d.cts

@@ -1,5 +1,5 @@
 import React$1, { ReactNode, FC } from 'react';
-import { HeadingLevel } from '@arc-ui/components/Heading';
+import { HeadingLevel, HeadingProps } from '@arc-ui/components/Heading';
 import { ImageProps, ImageSourceProps } from '@arc-ui/components/Image';
 import { DisclosureProps } from '@arc-ui/components/Disclosure';
 import { MediaCardProps } from '@arc-ui/components/MediaCard';
@@ -15,6 +15,7 @@ import { TypographyCardProps } from '@arc-ui/components/TypographyCard';
 import { TemplateBannerProps } from '@arc-ui/components/TemplateBanner';
 import { TagProps } from '@arc-ui/components/Tag';
 import { ReactPlayerProps } from 'react-player/types';
+import { VerticalSpaceProps } from '@arc-ui/components/VerticalSpace';
 
 interface AccordionHeadingProps {
     /**
@@ -560,7 +561,7 @@ interface ProductNavigationProps extends Omit<SectionHeadingProps, "isPadded"> {
      */
     productList: ListProps[];
     /**
-     * Include "show more" or "show less" buttons.
+     * Hide "show more" or "show less" button controls.
      */
     hideButton?: boolean;
     /**
@@ -641,6 +642,8 @@ declare const InlineLinkGroup: React$1.FC<InlineLinkGroupProps>;
 interface InlineLinkGroupProps {
     /** Optional overline label displayed above the link group */
     label?: string;
+    /** Heading level for the label, defaults to "2" for proper heading hierarchy */
+    headingLevel?: "1" | "2" | "3" | "4" | "5" | "6";
     /** Array of link items to display */
     links: InlineLinkGroupItem[];
 }
@@ -794,5 +797,73 @@ interface BusinessSegmentSwitcherProps {
     }[];
 }
 
-export { Accordion, ActionTile, ArticleCarousel, ArticleSidebar, Author, BannerWithTabs, BusinessSegmentSwitcher, ContentInfoWidget, CopyLead, DownloadList, FAQs, FeaturePost, Highlights, InlineLinkGroup, LinkTile, ProductNavigation, PromoListing, PromoListingThumbnailSignpost, Quote, SectionHeading, Statistics, Summary, ThumbnailSignpost, VideoHeroCard, VideoPortraitCard };
-export type { AccordionProps, ActionTileProps, ArticleCarouselProps, ArticleSidebarProps, AuthorProps, BannerWithTabsProps, BentoGridContent, BentoInformationCard, BentoMediaCard, BusinessSegmentSwitcherProps, ContentInfoWidgetProps, CopyLeadProps, DownloadListProps, FAQsProps, FeaturePostProps, HighlightsProps, InlineLinkGroupItem, InlineLinkGroupProps, LinkTileProps, ListProps, ProductNavigationProps, PromoListingProps, PromoListingThumbnailSignpostProps, QuoteProps, SectionHeadingProps, StatisticsProps, SummaryProps, ThumbnailSignpostProps, VideoHeroCardProps, VideoPortraitCardProps };
+/**
+ * Logo image source and alt text for screen reader accessibility.
+ */
+interface LogoTileItem {
+    /** Image source URL for the logo (e.g. an SVG or PNG path). */
+    src: string;
+    /** Alt text label to announce the logo to screen reader users. */
+    alt: string;
+}
+/**
+ * Subgroup data passed via the parent `subgroups` array.
+ */
+interface PartnerLogosSubgroup {
+    /** Optional subheading displayed above the logo grid. Fixed Size S Heading. */
+    subheading?: string;
+    /**
+     * Semantic heading level for the subheading. If omitted, it is automatically
+     * derived as one level below the parent headingLevel.
+     */
+    subheadingLevel?: HeadingLevel;
+    /** Optional supporting description text. Size M, tone "supporting". */
+    text?: string;
+    /** Array of logo images to display in the grid. */
+    logos: LogoTileItem[];
+    /**
+     * Height of each logo tile in pixels.
+     * @default 72
+     */
+    tileHeight?: number;
+}
+
+declare const PartnerBrandLogos: React$1.FC<PartnerBrandLogosProps>;
+/**
+ * Props for the `PartnerBrandLogos` page section component. Renders a heading,
+ * optional content, a padded ruler, and a list of partner logo subgroups.
+ */
+interface PartnerBrandLogosProps {
+    /** Main section heading text. */
+    heading: string;
+    /**
+     * Additional Arc Heading properties (e.g. `size`, `fontStyle`, `color`,
+     * `isWordWrap`, `casing`, `isResponsive`). Defaults to size "l", responsive.
+     */
+    headingProps?: Omit<HeadingProps, "children" | "level">;
+    /**
+     * Semantic heading level for the main heading. Subgroup headings are
+     * automatically derived relative to this value.
+     * @default "2"
+     */
+    headingLevel?: HeadingLevel;
+    /** Supporting content text below the heading. Supports paragraph breaks via `\n`. */
+    content?: string;
+    /** HTML `id` attribute applied to the main heading element. */
+    id?: string;
+    /**
+     * Vertical padding above the ruler. Accepts all VerticalSpace props.
+     * @default { size: "32" }
+     */
+    rulerTopPadding?: VerticalSpaceProps;
+    /**
+     * Vertical padding below the ruler. Accepts all VerticalSpace props.
+     * @default { size: "32" }
+     */
+    rulerBottomPadding?: VerticalSpaceProps;
+    /** Array of partner logo subgroups. */
+    subgroups: PartnerLogosSubgroup[];
+}
+
+export { Accordion, ActionTile, ArticleCarousel, ArticleSidebar, Author, BannerWithTabs, BusinessSegmentSwitcher, ContentInfoWidget, CopyLead, DownloadList, FAQs, FeaturePost, Highlights, InlineLinkGroup, LinkTile, PartnerBrandLogos, ProductNavigation, PromoListing, PromoListingThumbnailSignpost, Quote, SectionHeading, Statistics, Summary, ThumbnailSignpost, VideoHeroCard, VideoPortraitCard };
+export type { AccordionProps, ActionTileProps, ArticleCarouselProps, ArticleSidebarProps, AuthorProps, BannerWithTabsProps, BentoGridContent, BentoInformationCard, BentoMediaCard, BusinessSegmentSwitcherProps, ContentInfoWidgetProps, CopyLeadProps, DownloadListProps, FAQsProps, FeaturePostProps, HighlightsProps, InlineLinkGroupItem, InlineLinkGroupProps, LinkTileProps, ListProps, LogoTileItem, PartnerBrandLogosProps, PartnerLogosSubgroup, ProductNavigationProps, PromoListingProps, PromoListingThumbnailSignpostProps, QuoteProps, SectionHeadingProps, StatisticsProps, SummaryProps, ThumbnailSignpostProps, VideoHeroCardProps, VideoPortraitCardProps };

package/lib/index.d.mts

@@ -1,5 +1,5 @@
 import React$1, { ReactNode, FC } from 'react';
-import { HeadingLevel } from '@arc-ui/components/Heading';
+import { HeadingLevel, HeadingProps } from '@arc-ui/components/Heading';
 import { ImageProps, ImageSourceProps } from '@arc-ui/components/Image';
 import { DisclosureProps } from '@arc-ui/components/Disclosure';
 import { MediaCardProps } from '@arc-ui/components/MediaCard';
@@ -15,6 +15,7 @@ import { TypographyCardProps } from '@arc-ui/components/TypographyCard';
 import { TemplateBannerProps } from '@arc-ui/components/TemplateBanner';
 import { TagProps } from '@arc-ui/components/Tag';
 import { ReactPlayerProps } from 'react-player/types';
+import { VerticalSpaceProps } from '@arc-ui/components/VerticalSpace';
 
 interface AccordionHeadingProps {
     /**
@@ -560,7 +561,7 @@ interface ProductNavigationProps extends Omit<SectionHeadingProps, "isPadded"> {
      */
     productList: ListProps[];
     /**
-     * Include "show more" or "show less" buttons.
+     * Hide "show more" or "show less" button controls.
      */
     hideButton?: boolean;
     /**
@@ -641,6 +642,8 @@ declare const InlineLinkGroup: React$1.FC<InlineLinkGroupProps>;
 interface InlineLinkGroupProps {
     /** Optional overline label displayed above the link group */
     label?: string;
+    /** Heading level for the label, defaults to "2" for proper heading hierarchy */
+    headingLevel?: "1" | "2" | "3" | "4" | "5" | "6";
     /** Array of link items to display */
     links: InlineLinkGroupItem[];
 }
@@ -794,5 +797,73 @@ interface BusinessSegmentSwitcherProps {
     }[];
 }
 
-export { Accordion, ActionTile, ArticleCarousel, ArticleSidebar, Author, BannerWithTabs, BusinessSegmentSwitcher, ContentInfoWidget, CopyLead, DownloadList, FAQs, FeaturePost, Highlights, InlineLinkGroup, LinkTile, ProductNavigation, PromoListing, PromoListingThumbnailSignpost, Quote, SectionHeading, Statistics, Summary, ThumbnailSignpost, VideoHeroCard, VideoPortraitCard };
-export type { AccordionProps, ActionTileProps, ArticleCarouselProps, ArticleSidebarProps, AuthorProps, BannerWithTabsProps, BentoGridContent, BentoInformationCard, BentoMediaCard, BusinessSegmentSwitcherProps, ContentInfoWidgetProps, CopyLeadProps, DownloadListProps, FAQsProps, FeaturePostProps, HighlightsProps, InlineLinkGroupItem, InlineLinkGroupProps, LinkTileProps, ListProps, ProductNavigationProps, PromoListingProps, PromoListingThumbnailSignpostProps, QuoteProps, SectionHeadingProps, StatisticsProps, SummaryProps, ThumbnailSignpostProps, VideoHeroCardProps, VideoPortraitCardProps };
+/**
+ * Logo image source and alt text for screen reader accessibility.
+ */
+interface LogoTileItem {
+    /** Image source URL for the logo (e.g. an SVG or PNG path). */
+    src: string;
+    /** Alt text label to announce the logo to screen reader users. */
+    alt: string;
+}
+/**
+ * Subgroup data passed via the parent `subgroups` array.
+ */
+interface PartnerLogosSubgroup {
+    /** Optional subheading displayed above the logo grid. Fixed Size S Heading. */
+    subheading?: string;
+    /**
+     * Semantic heading level for the subheading. If omitted, it is automatically
+     * derived as one level below the parent headingLevel.
+     */
+    subheadingLevel?: HeadingLevel;
+    /** Optional supporting description text. Size M, tone "supporting". */
+    text?: string;
+    /** Array of logo images to display in the grid. */
+    logos: LogoTileItem[];
+    /**
+     * Height of each logo tile in pixels.
+     * @default 72
+     */
+    tileHeight?: number;
+}
+
+declare const PartnerBrandLogos: React$1.FC<PartnerBrandLogosProps>;
+/**
+ * Props for the `PartnerBrandLogos` page section component. Renders a heading,
+ * optional content, a padded ruler, and a list of partner logo subgroups.
+ */
+interface PartnerBrandLogosProps {
+    /** Main section heading text. */
+    heading: string;
+    /**
+     * Additional Arc Heading properties (e.g. `size`, `fontStyle`, `color`,
+     * `isWordWrap`, `casing`, `isResponsive`). Defaults to size "l", responsive.
+     */
+    headingProps?: Omit<HeadingProps, "children" | "level">;
+    /**
+     * Semantic heading level for the main heading. Subgroup headings are
+     * automatically derived relative to this value.
+     * @default "2"
+     */
+    headingLevel?: HeadingLevel;
+    /** Supporting content text below the heading. Supports paragraph breaks via `\n`. */
+    content?: string;
+    /** HTML `id` attribute applied to the main heading element. */
+    id?: string;
+    /**
+     * Vertical padding above the ruler. Accepts all VerticalSpace props.
+     * @default { size: "32" }
+     */
+    rulerTopPadding?: VerticalSpaceProps;
+    /**
+     * Vertical padding below the ruler. Accepts all VerticalSpace props.
+     * @default { size: "32" }
+     */
+    rulerBottomPadding?: VerticalSpaceProps;
+    /** Array of partner logo subgroups. */
+    subgroups: PartnerLogosSubgroup[];
+}
+
+export { Accordion, ActionTile, ArticleCarousel, ArticleSidebar, Author, BannerWithTabs, BusinessSegmentSwitcher, ContentInfoWidget, CopyLead, DownloadList, FAQs, FeaturePost, Highlights, InlineLinkGroup, LinkTile, PartnerBrandLogos, ProductNavigation, PromoListing, PromoListingThumbnailSignpost, Quote, SectionHeading, Statistics, Summary, ThumbnailSignpost, VideoHeroCard, VideoPortraitCard };
+export type { AccordionProps, ActionTileProps, ArticleCarouselProps, ArticleSidebarProps, AuthorProps, BannerWithTabsProps, BentoGridContent, BentoInformationCard, BentoMediaCard, BusinessSegmentSwitcherProps, ContentInfoWidgetProps, CopyLeadProps, DownloadListProps, FAQsProps, FeaturePostProps, HighlightsProps, InlineLinkGroupItem, InlineLinkGroupProps, LinkTileProps, ListProps, LogoTileItem, PartnerBrandLogosProps, PartnerLogosSubgroup, ProductNavigationProps, PromoListingProps, PromoListingThumbnailSignpostProps, QuoteProps, SectionHeadingProps, StatisticsProps, SummaryProps, ThumbnailSignpostProps, VideoHeroCardProps, VideoPortraitCardProps };