@nextworks/blocks-sections 0.1.0-alpha.8 → 0.2.0-alpha.2

package/dist-types/components/Features.d.ts

@@ -0,0 +1,113 @@
+import React from "react";
+import { motion } from "motion/react";
+/**
+ * Data used to render a FeatureCard within the Features grid.
+ * @public
+ */
+export interface FeatureCardData {
+    imageSrc: string;
+    imageAlt: string;
+    headingText: string;
+    subheadingText: string;
+}
+/**
+ * Props for the Features section component.
+ *
+ * @remarks
+ * - Styling: slot-style className overrides are merged after defaults via cn().
+ * - Motion: entrance animations respect enableMotion; prefers-reduced-motion
+ *   disables transforms and transitions where possible.
+ *
+ * @public
+ */
+type MotionTransition = React.ComponentProps<typeof motion.div>["transition"];
+export interface FeaturesProps {
+    /**
+     * Optional id to attach to the root section element.
+     * @defaultValue "features"
+     */
+    id?: string;
+    /** Main section heading text */
+    sectionHeading?: string;
+    /** Subheading text displayed below the main heading */
+    sectionSubheading?: string;
+    /** Array of feature card data objects */
+    featuresData?: FeatureCardData[];
+    /** Optional top-level class to override the section root */
+    className?: string;
+    /** Styling configuration objects (slots) */
+    section?: {
+        className?: string;
+    };
+    container?: {
+        className?: string;
+    };
+    header?: {
+        className?: string;
+    };
+    heading?: {
+        className?: string;
+    };
+    subheading?: {
+        className?: string;
+    };
+    grid?: {
+        className?: string;
+    };
+    /** Wrapper around each FeatureCard (the animated container) */
+    cardWrapper?: {
+        className?: string;
+    };
+    /** Styles passed down to FeatureCard slots */
+    card?: {
+        className?: string;
+    };
+    image?: {
+        className?: string;
+    };
+    cardHeading?: {
+        className?: string;
+    };
+    cardSubheading?: {
+        className?: string;
+    };
+    /** When false, disables entrance animations and hover transitions. */
+    enableMotion?: boolean;
+    /** Motion configuration for the feature items */
+    motionConfig?: {
+        initial?: {
+            opacity?: number;
+            y?: number;
+        };
+        whileInView?: {
+            opacity?: number;
+            y?: number;
+        };
+        viewport?: {
+            once?: boolean;
+            amount?: number;
+        };
+        transition?: MotionTransition;
+    };
+    /** ARIA label for the features section */
+    ariaLabel?: string;
+}
+/**
+ * Responsive Features section that renders a heading, optional subheading,
+ * and a grid of FeatureCard items with configurable entrance animations.
+ *
+ * @remarks
+ * - Styling: slot-style className overrides are merged after defaults via cn().
+ * - Motion: Controlled by enableMotion and motionConfig; animations are reduced
+ *   or disabled when users prefer reduced motion.
+ * - Accessibility: Uses a semantic <section> with an aria-label.
+ *
+ * @example
+ * <Features
+ *   sectionHeading="Key Features"
+ *   featuresData={[{ imageSrc: "/a.png", imageAlt: "", headingText: "Fast", subheadingText: "Blazing" }]}
+ * />
+ */
+export declare function Features({ id, sectionHeading, sectionSubheading, featuresData, className, section, container, header, heading, subheading, grid, cardWrapper, card, image, cardHeading, cardSubheading, enableMotion, motionConfig, ariaLabel, }: FeaturesProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=Features.d.ts.map

package/dist-types/components/Features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Features.d.ts","sourceRoot":"","sources":["../../src/components/Features.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAItC;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,KAAK,gBAAgB,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,yCAAyC;IACzC,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IAEjC,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,+DAA+D;IAC/D,WAAW,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,8CAA8C;IAC9C,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,WAAW,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,cAAc,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAExC,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,iDAAiD;IACjD,YAAY,CAAC,EAAE;QACb,OAAO,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3C,WAAW,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,QAAQ,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,UAAU,CAAC,EAAE,gBAAgB,CAAC;KAC/B,CAAC;IAEF,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,EACvB,EAAe,EACf,cAA+B,EAC/B,iBAA0E,EAC1E,YAAkC,EAElC,SAAS,EAET,OAAgE,EAChE,SAAmE,EACnE,MAAoD,EACpD,OAGC,EACD,UAGC,EACD,IAGC,EACD,WAEC,EACD,IAGC,EACD,KAGC,EACD,WAGC,EACD,cAEC,EAED,YAAmB,EACnB,YAWC,EACD,SAA8B,GAC/B,EAAE,aAAa,qBAwFf"}

package/dist-types/components/Footer.d.ts

@@ -0,0 +1,120 @@
+import React from "react";
+/**
+ * Navigation link item interface representing a single link in the footer.
+ */
+export interface NavLinkItem {
+    /** Display name of the link */
+    name: string;
+    /** URL or anchor for the navigation link */
+    href: string;
+    /** Whether the link should open in a new tab */
+    external?: boolean;
+}
+/**
+ * Grouping for navigation link items under a section heading.
+ */
+export interface NavLinkGroup {
+    /** Section heading/title */
+    heading: string;
+    /** Collection of links under this section */
+    links: NavLinkItem[];
+}
+/**
+ * Social media link interface for footer social icons.
+ * @public
+ */
+export interface SocialLink {
+    /** Name of the social media platform */
+    name: string;
+    /** SVG icon component (e.g., Lucide). Should respect currentColor. */
+    icon: React.ComponentType<React.SVGProps<SVGSVGElement>>;
+    /** URL to the social profile */
+    url: string;
+    /** Optional aria-label for accessibility */
+    label?: string;
+    /** Whether the link should open in a new tab */
+    external?: boolean;
+}
+/**
+ * Props for the Footer component.
+ *
+ * @remarks
+ * Exposes slot-style className overrides for layout and typography. External
+ * links automatically receive target and rel attributes for security.
+ *
+ * @public
+ */
+export interface FooterProps {
+    /** Optional id to attach to the root footer element */
+    id?: string;
+    /** Brand name or logo text displayed in the footer */
+    footerBrandName?: string;
+    /** Optional custom brand node (e.g., logo). Rendered left of brand text */
+    brandNode?: React.ReactNode;
+    /** Optional link for the brand (wraps brand text) */
+    brandHref?: string;
+    /** Navigation link groups shown in the footer */
+    footerNavLinks?: NavLinkGroup[];
+    /** Social media links and icons shown in the footer */
+    footerSocialLinks?: SocialLink[];
+    /** Optional top-level class to override the footer root */
+    className?: string;
+    /** Styling configuration objects (slot-based API) */
+    section?: {
+        className?: string;
+    };
+    container?: {
+        className?: string;
+    };
+    brand?: {
+        className?: string;
+    };
+    brandWrapper?: {
+        className?: string;
+    };
+    navSection?: {
+        className?: string;
+    };
+    navGroup?: {
+        className?: string;
+    };
+    navHeading?: {
+        className?: string;
+    };
+    navLink?: {
+        className?: string;
+    };
+    linksList?: {
+        className?: string;
+    };
+    socialSection?: {
+        className?: string;
+    };
+    socialLink?: {
+        className?: string;
+    };
+    socialIcon?: {
+        className?: string;
+    };
+    copyright?: {
+        className?: string;
+    };
+    /** Optional overrides for copyright */
+    copyrightYear?: number;
+    copyrightOverride?: React.ReactNode;
+    /** ARIA label for the footer section */
+    ariaLabel?: string;
+}
+/**
+ * Site footer with brand, grouped navigation links, social icons, and copyright.
+ *
+ * @remarks
+ * - Styling: slot-style className overrides are merged after defaults via cn().
+ * - Accessibility: renders a semantic <footer> with aria-label and clear link
+ *   names; external links open in a new tab with rel security attributes.
+ *
+ * @example
+ * <Footer footerBrandName="Acme" />
+ */
+export declare function Footer({ id, footerBrandName, brandNode, brandHref, footerNavLinks, footerSocialLinks, className, section, container, brand, brandWrapper, navSection, navGroup, navHeading, navLink, linksList, socialSection, socialLink, socialIcon, copyright, copyrightYear, copyrightOverride, ariaLabel, }: FooterProps): React.JSX.Element;
+//# sourceMappingURL=Footer.d.ts.map

package/dist-types/components/Footer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Footer.d.ts","sourceRoot":"","sources":["../../src/components/Footer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IAGzB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IACzD,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IAChC,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,UAAU,EAAE,CAAC;IAEjC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,aAAa,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAEnC,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEpC,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,EACrB,EAAE,EACF,eAA8B,EAC9B,SAAS,EACT,SAAS,EACT,cAAgC,EAChC,iBAAsC,EACtC,SAAS,EACT,OAGC,EACD,SAAmD,EACnD,KAAuE,EACvE,YAEC,EACD,UAGC,EACD,QAGC,EACD,UAGC,EACD,OAGC,EACD,SAAsC,EACtC,aAA4E,EAC5E,UAGC,EACD,UAAqC,EACrC,SAGC,EACD,aAAa,EACb,iBAAiB,EACjB,SAA4B,GAC7B,EAAE,WAAW,qBAgFb"}

package/dist-types/components/HeroMotion.d.ts

@@ -0,0 +1,109 @@
+import React from "react";
+import { motion } from "motion/react";
+/**
+ * Props for the HeroMotion component.
+ *
+ * @remarks
+ * - Styling: exposes slot-style className overrides merged via cn().
+ * - Motion: controlled by enableMotion and motionOptions; respects
+ *   prefers-reduced-motion by allowing disabling transforms.
+ * - Accessibility: rendered as a semantic <section> with aria-label.
+ * - CTA: primary/secondary CTA can be links (href provided) or buttons.
+ */
+type MotionTransition = React.ComponentProps<typeof motion.div>["transition"];
+export interface HeroMotionProps {
+    /** Optional id to attach to the section root */
+    id?: string;
+    /** ARIA label for the section. @defaultValue "Hero section" */
+    ariaLabel?: string;
+    /** Optional top-level class to override the root */
+    className?: string;
+    /** Primary heading text. Ignored when headingNode is provided. */
+    heading?: string;
+    /** Custom heading node; use for advanced layouts or styling. */
+    headingNode?: React.ReactNode;
+    /** Inline highlight node rendered next to heading text. */
+    highlight?: React.ReactNode;
+    /** Optional description paragraph/node */
+    description?: React.ReactNode;
+    /** Primary call to action config or null to hide */
+    primaryCta?: {
+        label: string;
+        href?: string;
+    } | null;
+    /** Secondary call to action config or null to hide */
+    secondaryCta?: {
+        label: string;
+        href?: string;
+    } | null;
+    /** Slot-style overrides */
+    section?: {
+        className?: string;
+    };
+    container?: {
+        className?: string;
+    };
+    content?: {
+        className?: string;
+    };
+    headingText?: {
+        className?: string;
+    };
+    highlightText?: {
+        className?: string;
+    };
+    descriptionText?: {
+        className?: string;
+    };
+    actions?: {
+        className?: string;
+    };
+    primaryButtonStyle?: {
+        unstyled?: boolean;
+        style?: React.CSSProperties;
+        variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+        size?: "default" | "sm" | "lg" | "icon";
+        className?: string;
+    };
+    secondaryButtonStyle?: {
+        unstyled?: boolean;
+        style?: React.CSSProperties;
+        variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+        size?: "default" | "sm" | "lg" | "icon";
+        className?: string;
+    };
+    /** Optional background node (e.g., SVGs, gradients, images) */
+    backgroundNode?: React.ReactNode;
+    /** When false, disables entrance animations */
+    enableMotion?: boolean;
+    /** Motion configuration for entrance sequences */
+    motionOptions?: {
+        viewport?: {
+            once?: boolean;
+            amount?: number;
+        };
+        headingDelay?: number;
+        descriptionDelay?: number;
+        actionsDelay?: number;
+        transition: MotionTransition;
+    };
+}
+/**
+ * Motion-first hero with heading/highlight, optional description and CTAs.
+ *
+ * @remarks
+ * - Styling: slot-style className overrides are merged after defaults via cn().
+ * - Motion: enableMotion toggles entrance transitions; motionOptions controls
+ *   delays and viewport.
+ * - Accessibility: semantic <section> with aria-label.
+ *
+ * @example
+ * <HeroMotion
+ *   heading="Supercharge growth with"
+ *   highlight="AI-powered insights"
+ *   primaryCta={{ label: 'Get Started', href: '#contact' }}
+ * />
+ */
+export declare function HeroMotion({ id, ariaLabel, className, heading, headingNode, highlight, description, primaryCta, secondaryCta, section, container, content, headingText, highlightText, descriptionText, actions, primaryButtonStyle, secondaryButtonStyle, enableMotion, motionOptions, backgroundNode, }: HeroMotionProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=HeroMotion.d.ts.map

package/dist-types/components/HeroMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeroMotion.d.ts","sourceRoot":"","sources":["../../src/components/HeroMotion.tsx"],"names":[],"mappings":"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"}

package/dist-types/components/HeroOverlay.d.ts

@@ -0,0 +1,116 @@
+import React from "react";
+/**
+ * Props for the HeroOverlay component.
+ *
+ * @remarks
+ * - Prefer the structured image prop (image) over deprecated flat props.
+ * - Slot-style className overrides are merged after defaults via cn().
+ * - Motion controls affect CTA hover transitions.
+ *
+ * @public
+ */
+export interface HeroOverlayProps {
+    id?: string;
+    className?: string;
+    image?: {
+        src?: string;
+        alt?: string;
+        className?: string;
+        objectFit?: React.CSSProperties["objectFit"];
+        objectPosition?: React.CSSProperties["objectPosition"];
+    };
+    /** @deprecated Use image.src instead */
+    imageSrc?: string;
+    /** @deprecated Use image.alt instead */
+    imageAlt?: string;
+    /** @deprecated Use image.objectFit instead */
+    imageObjectFit?: React.CSSProperties["objectFit"];
+    /** @deprecated Use image.objectPosition instead */
+    imageObjectPosition?: React.CSSProperties["objectPosition"];
+    heading?: string | {
+        text?: string;
+        className?: string;
+    };
+    subheading?: string | {
+        text?: string;
+        className?: string;
+    };
+    overlayRGBA?: string;
+    overlayDarkRGBA?: string;
+    section?: {
+        className?: string;
+    };
+    container?: {
+        className?: string;
+    };
+    imageContainer?: {
+        className?: string;
+    };
+    overlay?: {
+        className?: string;
+    };
+    content?: {
+        className?: string;
+    };
+    textContainer?: {
+        className?: string;
+    };
+    /** @deprecated Use heading.className */
+    headingStyle?: {
+        className?: string;
+    };
+    /** @deprecated Use subheading.className */
+    subheadingStyle?: {
+        className?: string;
+    };
+    ctaContainer?: {
+        className?: string;
+    };
+    cta1?: {
+        label?: string;
+        href?: string;
+        variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+        size?: "default" | "sm" | "lg" | "icon";
+        className?: string;
+        unstyled?: boolean;
+        style?: React.CSSProperties;
+    };
+    cta2?: {
+        label?: string;
+        href?: string;
+        variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+        size?: "default" | "sm" | "lg" | "icon";
+        className?: string;
+        unstyled?: boolean;
+        style?: React.CSSProperties;
+    };
+    /** @deprecated Use cta1.label instead */
+    ctaBtn1Label?: string;
+    /** @deprecated Use cta1.href instead */
+    ctaBtn1Href?: string;
+    /** @deprecated Use cta2.label instead */
+    ctaBtn2Label?: string;
+    /** @deprecated Use cta2.href instead */
+    ctaBtn2Href?: string;
+    ariaLabel?: string;
+    enableMotion?: boolean;
+}
+/**
+ * Full-bleed image hero with color overlay, heading/subheading, and up to two CTAs.
+ *
+ * @remarks
+ * - Styling: slot-style overrides for container, imageContainer, overlay, content, textContainer.
+ * - Motion: enableMotion applies hover-lift transitions to CTA buttons only.
+ * - Accessibility: uses semantic <section> with aria-label; background image is
+ *   decorative with overlay and text content provided separately.
+ *
+ * @example
+ * <HeroOverlay
+ *   image={{ src: "/hero.png", alt: "" }}
+ *   heading="Welcome"
+ *   subheading="Build faster with our blocks"
+ *   cta1={{ label: "Get Started", href: "#getstarted" }}
+ * />
+ */
+export declare function HeroOverlay({ id, className, imageSrc, imageAlt, imageObjectFit, imageObjectPosition, image, heading, subheading, overlayRGBA, overlayDarkRGBA, ctaBtn1Label, ctaBtn1Href, ctaBtn2Label, ctaBtn2Href, container, section, imageContainer, overlay, content, textContainer, headingStyle, subheadingStyle, ctaContainer, cta1, cta2, ariaLabel, enableMotion, }: HeroOverlayProps): React.JSX.Element;
+//# sourceMappingURL=HeroOverlay.d.ts.map

package/dist-types/components/HeroOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeroOverlay.d.ts","sourceRoot":"","sources":["../../src/components/HeroOverlay.tsx"],"names":[],"mappings":"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"}

package/dist-types/components/HeroSplit.d.ts

@@ -0,0 +1,98 @@
+import React from "react";
+/**
+ * Props for the HeroSplit component.
+ *
+ * @remarks
+ * - Layout: split hero with text and image. imageLayout controls whether the
+ *   image is full-bleed or padded.
+ * - Styling: slot-style className overrides are merged via cn(). Heading and
+ *   subheading accept either a string or a { text, className } object.
+ * - Motion: enableMotion toggles button hover lift transitions.
+ * - Accessibility: uses a semantic <section> with aria-label.
+ */
+interface HeroSplitProps {
+    /** Optional id to attach to the root section element */
+    id?: string;
+    /** Optional top-level class to override the root */
+    className?: string;
+    /** Section slot override */
+    section?: {
+        className?: string;
+    };
+    /** Heading string or object with text and className */
+    heading?: string | {
+        text?: string;
+        className?: string;
+    };
+    /** Subheading string or object with text and className */
+    subheading?: string | {
+        text?: string;
+        className?: string;
+    };
+    /** Primary CTA configuration */
+    cta1?: {
+        label?: string;
+        href?: string;
+        variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+        size?: "default" | "sm" | "lg" | "icon";
+        className?: string;
+        /** When true, renders the Button in unstyled mode to avoid token bleed from variants */
+        unstyled?: boolean;
+        /** Optional inline style forwarded to Button */
+        style?: React.CSSProperties;
+    };
+    /** Secondary CTA configuration */
+    cta2?: {
+        label?: string;
+        href?: string;
+        variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+        size?: "default" | "sm" | "lg" | "icon";
+        className?: string;
+        /** When true, renders the Button in unstyled mode to avoid token bleed from variants */
+        unstyled?: boolean;
+        /** Optional inline style forwarded to Button */
+        style?: React.CSSProperties;
+    };
+    /** Image configuration */
+    image?: {
+        src?: string;
+        alt?: string;
+        className?: string;
+    };
+    /** Image container slot */
+    imageContainer?: {
+        className?: string;
+    };
+    /** Text container slot */
+    textContainer?: {
+        className?: string;
+    };
+    /** Buttons container slot */
+    buttonsContainer?: {
+        className?: string;
+    };
+    /** Text alignment at large breakpoints. @defaultValue "center" */
+    textAlign?: "left" | "center" | "right";
+    /** Fallback node shown when no image.src is provided */
+    fallback?: React.ReactNode;
+    /** ARIA label for the section. @defaultValue "Hero section" */
+    ariaLabel?: string;
+    /** When false, removes button hover lifts, keeps layout static */
+    enableMotion?: boolean;
+    /** "padded" keeps default gutters. "full-bleed" allows the image to touch page edges. @defaultValue "full-bleed" */
+    imageLayout?: "padded" | "full-bleed";
+}
+/**
+ * Split hero with text on one side and an image on the other.
+ *
+ * @remarks
+ * - Text props accept string or object forms to easily override classes.
+ * - Full-bleed layout absolutely positions the image on larger screens.
+ * - Motion only affects the subtle hover lift on CTA buttons.
+ *
+ * @example
+ * <HeroSplit heading="Build faster" subheading="Launch confidently" />
+ */
+export declare function HeroSplit({ id, className, heading, subheading, section, cta1, cta2, image, imageContainer, textContainer, buttonsContainer, textAlign, fallback, ariaLabel, enableMotion, imageLayout, }: HeroSplitProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=HeroSplit.d.ts.map

package/dist-types/components/HeroSplit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeroSplit.d.ts","sourceRoot":"","sources":["../../src/components/HeroSplit.tsx"],"names":[],"mappings":"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"}