@opensite/ui 1.0.0 → 1.0.2

package/dist/social-link-icon.cjs

@@ -0,0 +1,606 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var clsx = require('clsx');
+var tailwindMerge = require('tailwind-merge');
+var classVarianceAuthority = require('class-variance-authority');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+function cn(...inputs) {
+  return tailwindMerge.twMerge(clsx.clsx(inputs));
+}
+function normalizePhoneNumber(input) {
+  const trimmed = input.trim();
+  if (trimmed.toLowerCase().startsWith("tel:")) {
+    return trimmed;
+  }
+  const match = trimmed.match(/^[\s\+\-\(\)]*(\d[\d\s\-\(\)\.]*\d)[\s\-]*(x|ext\.?|extension)?[\s\-]*(\d+)?$/i);
+  if (match) {
+    const mainNumber = match[1].replace(/[\s\-\(\)\.]/g, "");
+    const extension = match[3];
+    const normalized = mainNumber.length >= 10 && !trimmed.startsWith("+") ? `+${mainNumber}` : mainNumber;
+    const withExtension = extension ? `${normalized};ext=${extension}` : normalized;
+    return `tel:${withExtension}`;
+  }
+  const cleaned = trimmed.replace(/[\s\-\(\)\.]/g, "");
+  return `tel:${cleaned}`;
+}
+function normalizeEmail(input) {
+  const trimmed = input.trim();
+  if (trimmed.toLowerCase().startsWith("mailto:")) {
+    return trimmed;
+  }
+  return `mailto:${trimmed}`;
+}
+function isEmail(input) {
+  const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+  return emailRegex.test(input.trim());
+}
+function isPhoneNumber(input) {
+  const trimmed = input.trim();
+  if (trimmed.toLowerCase().startsWith("tel:")) {
+    return true;
+  }
+  const phoneRegex = /^[\s\+\-\(\)]*\d[\d\s\-\(\)\.]*\d[\s\-]*(x|ext\.?|extension)?[\s\-]*\d*$/i;
+  return phoneRegex.test(trimmed);
+}
+function isInternalUrl(href) {
+  if (typeof window === "undefined") {
+    return href.startsWith("/") && !href.startsWith("//");
+  }
+  const trimmed = href.trim();
+  if (trimmed.startsWith("/") && !trimmed.startsWith("//")) {
+    return true;
+  }
+  try {
+    const url = new URL(trimmed, window.location.href);
+    const currentOrigin = window.location.origin;
+    const normalizeOrigin = (origin) => origin.replace(/^(https?:\/\/)(www\.)?/, "$1");
+    return normalizeOrigin(url.origin) === normalizeOrigin(currentOrigin);
+  } catch {
+    return false;
+  }
+}
+function toRelativePath(href) {
+  if (typeof window === "undefined") {
+    return href;
+  }
+  const trimmed = href.trim();
+  if (trimmed.startsWith("/") && !trimmed.startsWith("//")) {
+    return trimmed;
+  }
+  try {
+    const url = new URL(trimmed, window.location.href);
+    const currentOrigin = window.location.origin;
+    const normalizeOrigin = (origin) => origin.replace(/^(https?:\/\/)(www\.)?/, "$1");
+    if (normalizeOrigin(url.origin) === normalizeOrigin(currentOrigin)) {
+      return url.pathname + url.search + url.hash;
+    }
+  } catch {
+  }
+  return trimmed;
+}
+function useNavigation({
+  href,
+  onClick
+} = {}) {
+  const linkType = React__namespace.useMemo(() => {
+    if (!href || href.trim() === "") {
+      return onClick ? "none" : "none";
+    }
+    const trimmed = href.trim();
+    if (trimmed.toLowerCase().startsWith("mailto:") || isEmail(trimmed)) {
+      return "mailto";
+    }
+    if (trimmed.toLowerCase().startsWith("tel:") || isPhoneNumber(trimmed)) {
+      return "tel";
+    }
+    if (isInternalUrl(trimmed)) {
+      return "internal";
+    }
+    try {
+      new URL(trimmed, typeof window !== "undefined" ? window.location.href : "http://localhost");
+      return "external";
+    } catch {
+      return "internal";
+    }
+  }, [href, onClick]);
+  const normalizedHref = React__namespace.useMemo(() => {
+    if (!href || href.trim() === "") {
+      return void 0;
+    }
+    const trimmed = href.trim();
+    switch (linkType) {
+      case "tel":
+        return normalizePhoneNumber(trimmed);
+      case "mailto":
+        return normalizeEmail(trimmed);
+      case "internal":
+        return toRelativePath(trimmed);
+      case "external":
+        return trimmed;
+      default:
+        return trimmed;
+    }
+  }, [href, linkType]);
+  const target = React__namespace.useMemo(() => {
+    switch (linkType) {
+      case "external":
+        return "_blank";
+      case "internal":
+        return "_self";
+      case "mailto":
+      case "tel":
+        return void 0;
+      default:
+        return void 0;
+    }
+  }, [linkType]);
+  const rel = React__namespace.useMemo(() => {
+    if (linkType === "external") {
+      return "noopener noreferrer";
+    }
+    return void 0;
+  }, [linkType]);
+  const isExternal = linkType === "external";
+  const isInternal = linkType === "internal";
+  const shouldUseRouter = isInternal && typeof normalizedHref === "string" && normalizedHref.startsWith("/");
+  const handleClick = React__namespace.useCallback(
+    (event) => {
+      if (onClick) {
+        try {
+          onClick(event);
+        } catch (error) {
+          console.error("Error in user onClick handler:", error);
+        }
+      }
+      if (event.defaultPrevented) {
+        return;
+      }
+      if (shouldUseRouter && normalizedHref && event.button === 0 && // left-click only
+      !event.metaKey && !event.altKey && !event.ctrlKey && !event.shiftKey) {
+        if (typeof window !== "undefined") {
+          const handler = window.__opensiteNavigationHandler;
+          if (typeof handler === "function") {
+            try {
+              const handled = handler(normalizedHref, event.nativeEvent || event);
+              if (handled !== false) {
+                event.preventDefault();
+              }
+            } catch (error) {
+              console.error("Error in navigation handler:", error);
+            }
+          }
+        }
+      }
+    },
+    [onClick, shouldUseRouter, normalizedHref]
+  );
+  return {
+    linkType,
+    normalizedHref,
+    target,
+    rel,
+    isExternal,
+    isInternal,
+    shouldUseRouter,
+    handleClick
+  };
+}
+var baseStyles = [
+  // Layout
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap shrink-0",
+  // Typography - using CSS variables with sensible defaults
+  "font-[var(--button-font-family,inherit)]",
+  "font-[var(--button-font-weight,500)]",
+  "tracking-[var(--button-letter-spacing,0)]",
+  "leading-[var(--button-line-height,1.25)]",
+  "[text-transform:var(--button-text-transform,none)]",
+  "text-sm",
+  // Border radius
+  "rounded-[var(--button-radius,var(--radius,0.375rem))]",
+  // Smooth transition - using [transition:...] to set full shorthand property (not just transition-property)
+  "[transition:var(--button-transition,all_250ms_cubic-bezier(0.4,0,0.2,1))]",
+  // Box shadow (master level) - using [box-shadow:...] for complex multi-value shadows
+  "[box-shadow:var(--button-shadow,none)]",
+  "hover:[box-shadow:var(--button-shadow-hover,var(--button-shadow,none))]",
+  // Disabled state
+  "disabled:pointer-events-none disabled:opacity-50",
+  // SVG handling
+  "[&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 [&_svg]:shrink-0",
+  // Focus styles
+  "outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]",
+  // Invalid state
+  "aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive"
+].join(" ");
+var buttonVariants = classVarianceAuthority.cva(baseStyles, {
+  variants: {
+    variant: {
+      // Default (Primary) variant - full customization
+      default: [
+        "bg-[var(--button-default-bg,hsl(var(--primary)))]",
+        "text-[var(--button-default-fg,hsl(var(--primary-foreground)))]",
+        "border-[length:var(--button-default-border-width,0px)]",
+        "border-[color:var(--button-default-border,transparent)]",
+        "[box-shadow:var(--button-default-shadow,var(--button-shadow,none))]",
+        "hover:bg-[var(--button-default-hover-bg,hsl(var(--primary)/0.9))]",
+        "hover:text-[var(--button-default-hover-fg,var(--button-default-fg,hsl(var(--primary-foreground))))]",
+        "hover:border-[color:var(--button-default-hover-border,var(--button-default-border,transparent))]",
+        "hover:[box-shadow:var(--button-default-shadow-hover,var(--button-shadow-hover,var(--button-default-shadow,var(--button-shadow,none))))]"
+      ].join(" "),
+      // Destructive variant - full customization
+      destructive: [
+        "bg-[var(--button-destructive-bg,hsl(var(--destructive)))]",
+        "text-[var(--button-destructive-fg,white)]",
+        "border-[length:var(--button-destructive-border-width,0px)]",
+        "border-[color:var(--button-destructive-border,transparent)]",
+        "[box-shadow:var(--button-destructive-shadow,var(--button-shadow,none))]",
+        "hover:bg-[var(--button-destructive-hover-bg,hsl(var(--destructive)/0.9))]",
+        "hover:text-[var(--button-destructive-hover-fg,var(--button-destructive-fg,white))]",
+        "hover:border-[color:var(--button-destructive-hover-border,var(--button-destructive-border,transparent))]",
+        "hover:[box-shadow:var(--button-destructive-shadow-hover,var(--button-shadow-hover,var(--button-destructive-shadow,var(--button-shadow,none))))]",
+        "focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40",
+        "dark:bg-destructive/60"
+      ].join(" "),
+      // Outline variant - full customization with proper border handling
+      outline: [
+        "bg-[var(--button-outline-bg,hsl(var(--background)))]",
+        "text-[var(--button-outline-fg,inherit)]",
+        "border-[length:var(--button-outline-border-width,1px)]",
+        "border-[color:var(--button-outline-border,hsl(var(--border)))]",
+        "[box-shadow:var(--button-outline-shadow,var(--button-shadow,0_1px_2px_0_rgb(0_0_0/0.05)))]",
+        "hover:bg-[var(--button-outline-hover-bg,hsl(var(--accent)))]",
+        "hover:text-[var(--button-outline-hover-fg,hsl(var(--accent-foreground)))]",
+        "hover:border-[color:var(--button-outline-hover-border,var(--button-outline-border,hsl(var(--border))))]",
+        "hover:[box-shadow:var(--button-outline-shadow-hover,var(--button-shadow-hover,var(--button-outline-shadow,var(--button-shadow,none))))]",
+        "dark:bg-input/30 dark:border-input dark:hover:bg-input/50"
+      ].join(" "),
+      // Secondary variant - full customization
+      secondary: [
+        "bg-[var(--button-secondary-bg,hsl(var(--secondary)))]",
+        "text-[var(--button-secondary-fg,hsl(var(--secondary-foreground)))]",
+        "border-[length:var(--button-secondary-border-width,0px)]",
+        "border-[color:var(--button-secondary-border,transparent)]",
+        "[box-shadow:var(--button-secondary-shadow,var(--button-shadow,none))]",
+        "hover:bg-[var(--button-secondary-hover-bg,hsl(var(--secondary)/0.8))]",
+        "hover:text-[var(--button-secondary-hover-fg,var(--button-secondary-fg,hsl(var(--secondary-foreground))))]",
+        "hover:border-[color:var(--button-secondary-hover-border,var(--button-secondary-border,transparent))]",
+        "hover:[box-shadow:var(--button-secondary-shadow-hover,var(--button-shadow-hover,var(--button-secondary-shadow,var(--button-shadow,none))))]"
+      ].join(" "),
+      // Ghost variant - full customization
+      ghost: [
+        "bg-[var(--button-ghost-bg,transparent)]",
+        "text-[var(--button-ghost-fg,inherit)]",
+        "border-[length:var(--button-ghost-border-width,0px)]",
+        "border-[color:var(--button-ghost-border,transparent)]",
+        "[box-shadow:var(--button-ghost-shadow,var(--button-shadow,none))]",
+        "hover:bg-[var(--button-ghost-hover-bg,hsl(var(--accent)))]",
+        "hover:text-[var(--button-ghost-hover-fg,hsl(var(--accent-foreground)))]",
+        "hover:border-[color:var(--button-ghost-hover-border,var(--button-ghost-border,transparent))]",
+        "hover:[box-shadow:var(--button-ghost-shadow-hover,var(--button-shadow-hover,var(--button-ghost-shadow,var(--button-shadow,none))))]",
+        "dark:hover:bg-accent/50"
+      ].join(" "),
+      // Link variant - full customization
+      link: [
+        "bg-[var(--button-link-bg,transparent)]",
+        "text-[var(--button-link-fg,hsl(var(--primary)))]",
+        "border-[length:var(--button-link-border-width,0px)]",
+        "border-[color:var(--button-link-border,transparent)]",
+        "[box-shadow:var(--button-link-shadow,none)]",
+        "hover:bg-[var(--button-link-hover-bg,transparent)]",
+        "hover:text-[var(--button-link-hover-fg,var(--button-link-fg,hsl(var(--primary))))]",
+        "hover:[box-shadow:var(--button-link-shadow-hover,none)]",
+        "underline-offset-4 hover:underline"
+      ].join(" ")
+    },
+    size: {
+      default: [
+        "h-[var(--button-height-md,2.25rem)]",
+        "px-[var(--button-padding-x-md,1rem)]",
+        "py-[var(--button-padding-y-md,0.5rem)]",
+        "has-[>svg]:px-[calc(var(--button-padding-x-md,1rem)*0.75)]"
+      ].join(" "),
+      sm: [
+        "h-[var(--button-height-sm,2rem)]",
+        "px-[var(--button-padding-x-sm,0.75rem)]",
+        "py-[var(--button-padding-y-sm,0.25rem)]",
+        "gap-1.5",
+        "has-[>svg]:px-[calc(var(--button-padding-x-sm,0.75rem)*0.83)]"
+      ].join(" "),
+      md: [
+        "h-[var(--button-height-md,2.25rem)]",
+        "px-[var(--button-padding-x-md,1rem)]",
+        "py-[var(--button-padding-y-md,0.5rem)]",
+        "has-[>svg]:px-[calc(var(--button-padding-x-md,1rem)*0.75)]"
+      ].join(" "),
+      lg: [
+        "h-[var(--button-height-lg,2.5rem)]",
+        "px-[var(--button-padding-x-lg,1.5rem)]",
+        "py-[var(--button-padding-y-lg,0.5rem)]",
+        "has-[>svg]:px-[calc(var(--button-padding-x-lg,1.5rem)*0.67)]"
+      ].join(" "),
+      icon: "size-[var(--button-height-md,2.25rem)]",
+      "icon-sm": "size-[var(--button-height-sm,2rem)]",
+      "icon-lg": "size-[var(--button-height-lg,2.5rem)]"
+    }
+  },
+  defaultVariants: {
+    variant: "default",
+    size: "default"
+  }
+});
+var Pressable = React__namespace.forwardRef(
+  ({
+    children,
+    className,
+    href,
+    onClick,
+    variant,
+    size,
+    asButton = false,
+    fallbackComponentType = "span",
+    componentType,
+    "aria-label": ariaLabel,
+    "aria-describedby": ariaDescribedby,
+    id,
+    ...props
+  }, ref) => {
+    const navigation = useNavigation({ href, onClick });
+    const {
+      normalizedHref,
+      target,
+      rel,
+      linkType,
+      isInternal,
+      handleClick
+    } = navigation;
+    const shouldRenderLink = normalizedHref && linkType !== "none";
+    const shouldRenderButton = !shouldRenderLink && onClick;
+    const effectiveComponentType = componentType || (shouldRenderLink ? "a" : shouldRenderButton ? "button" : fallbackComponentType);
+    const finalComponentType = isInternal && shouldRenderLink ? "a" : effectiveComponentType;
+    const shouldApplyButtonStyles = asButton || variant || size;
+    const combinedClassName = cn(
+      shouldApplyButtonStyles && buttonVariants({ variant, size }),
+      className
+    );
+    const dataProps = Object.fromEntries(
+      Object.entries(props).filter(([key]) => key.startsWith("data-"))
+    );
+    const buttonDataAttributes = shouldApplyButtonStyles ? {
+      "data-slot": "button",
+      "data-variant": variant ?? "default",
+      "data-size": size ?? "default"
+    } : {};
+    const commonProps = {
+      className: combinedClassName,
+      onClick: handleClick,
+      "aria-label": ariaLabel,
+      "aria-describedby": ariaDescribedby,
+      id,
+      ...dataProps,
+      ...buttonDataAttributes
+    };
+    if (finalComponentType === "a" && shouldRenderLink) {
+      return /* @__PURE__ */ jsxRuntime.jsx(
+        "a",
+        {
+          ref,
+          href: normalizedHref,
+          target,
+          rel,
+          ...commonProps,
+          ...props,
+          children
+        }
+      );
+    }
+    if (finalComponentType === "button") {
+      return /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          ref,
+          type: props.type || "button",
+          ...commonProps,
+          ...props,
+          children
+        }
+      );
+    }
+    if (finalComponentType === "div") {
+      return /* @__PURE__ */ jsxRuntime.jsx(
+        "div",
+        {
+          ref,
+          ...commonProps,
+          children
+        }
+      );
+    }
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "span",
+      {
+        ref,
+        ...commonProps,
+        children
+      }
+    );
+  }
+);
+Pressable.displayName = "Pressable";
+var svgCache = /* @__PURE__ */ new Map();
+function DynamicIcon({
+  name,
+  size = 28,
+  color,
+  className,
+  alt
+}) {
+  const [svgContent, setSvgContent] = React__namespace.useState(null);
+  const [isLoading, setIsLoading] = React__namespace.useState(true);
+  const [error, setError] = React__namespace.useState(null);
+  const { url, iconName } = React__namespace.useMemo(() => {
+    const separator = name.includes("/") ? "/" : ":";
+    const [prefix, iconName2] = name.split(separator);
+    const baseUrl = `https://icons.opensite.ai/api/icon/${prefix}/${iconName2}?format=svg&width=${size}&height=${size}`;
+    return {
+      url: baseUrl,
+      iconName: iconName2
+    };
+  }, [name, size]);
+  React__namespace.useEffect(() => {
+    let isMounted = true;
+    const fetchSvg = async () => {
+      const cached = svgCache.get(url);
+      if (cached) {
+        if (isMounted) {
+          setSvgContent(cached);
+          setIsLoading(false);
+        }
+        return;
+      }
+      try {
+        setIsLoading(true);
+        setError(null);
+        const response = await fetch(url);
+        if (!response.ok) {
+          throw new Error(`Failed to fetch icon: ${response.status}`);
+        }
+        let svg = await response.text();
+        svg = processSvgForCurrentColor(svg);
+        svgCache.set(url, svg);
+        if (isMounted) {
+          setSvgContent(svg);
+          setIsLoading(false);
+        }
+      } catch (err) {
+        if (isMounted) {
+          setError(err instanceof Error ? err.message : "Failed to load icon");
+          setIsLoading(false);
+        }
+      }
+    };
+    fetchSvg();
+    return () => {
+      isMounted = false;
+    };
+  }, [url]);
+  if (isLoading) {
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "span",
+      {
+        className: cn("inline-block", className),
+        style: { width: size, height: size },
+        "aria-hidden": "true"
+      }
+    );
+  }
+  if (error || !svgContent) {
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "span",
+      {
+        className: cn("inline-block", className),
+        style: { width: size, height: size },
+        role: "img",
+        "aria-label": alt || iconName
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "span",
+    {
+      className: cn("inline-flex items-center justify-center", className),
+      style: {
+        width: size,
+        height: size,
+        color: color || "inherit"
+      },
+      role: "img",
+      "aria-label": alt || iconName,
+      dangerouslySetInnerHTML: { __html: svgContent }
+    }
+  );
+}
+function processSvgForCurrentColor(svg) {
+  let processed = svg;
+  processed = processed.replace(
+    /stroke=["'](#000000|#000|black)["']/gi,
+    'stroke="currentColor"'
+  );
+  processed = processed.replace(
+    /fill=["'](#000000|#000|black)["']/gi,
+    'fill="currentColor"'
+  );
+  return processed;
+}
+var platformIconMap = {
+  instagram: "cib/instagram",
+  linkedin: "cib/linkedin",
+  google: "cib/google",
+  facebook: "cib/facebook",
+  tiktok: "cib/tiktok",
+  youtube: "cib/youtube",
+  yelp: "cib/yelp",
+  spotify: "cib/spotify",
+  apple: "cib/apple",
+  x: "line-md/twitter-x"
+};
+var SocialLinkIcon = React__namespace.forwardRef(
+  ({
+    platformName,
+    label,
+    iconSize = 20,
+    iconColor,
+    iconClassName,
+    className,
+    ...pressableProps
+  }, ref) => {
+    const iconName = platformIconMap[platformName];
+    const accessibleLabel = label || platformName;
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      Pressable,
+      {
+        ref,
+        "aria-label": accessibleLabel,
+        className: cn(
+          "inline-flex items-center justify-center transition-colors",
+          className
+        ),
+        ...pressableProps,
+        children: /* @__PURE__ */ jsxRuntime.jsx(
+          DynamicIcon,
+          {
+            name: iconName,
+            size: iconSize,
+            color: iconColor,
+            className: iconClassName,
+            alt: accessibleLabel
+          }
+        )
+      }
+    );
+  }
+);
+SocialLinkIcon.displayName = "SocialLinkIcon";
+
+exports.SocialLinkIcon = SocialLinkIcon;

package/dist/social-link-icon.d.cts

@@ -0,0 +1,74 @@
+import * as React from 'react';
+import { PressableProps } from './pressable.cjs';
+import 'class-variance-authority';
+import './button-variants-8mtEHxev.cjs';
+import 'class-variance-authority/types';
+
+/**
+ * Supported social platform names
+ */
+type SocialPlatformName = "instagram" | "linkedin" | "google" | "facebook" | "tiktok" | "youtube" | "yelp" | "spotify" | "apple" | "x";
+/**
+ * Props for DynamicIcon that can be passed through
+ */
+interface SocialLinkIconDynamicIconProps {
+    /**
+     * Icon size in pixels
+     * @default 20
+     */
+    iconSize?: number;
+    /**
+     * Icon color - accepts any valid CSS color
+     * Note: When not specified, the icon inherits color from parent via CSS currentColor
+     */
+    iconColor?: string;
+    /**
+     * Additional CSS classes for the icon
+     */
+    iconClassName?: string;
+}
+/**
+ * Props for the SocialLinkIcon component
+ */
+interface SocialLinkIconProps extends Omit<PressableProps, "children">, SocialLinkIconDynamicIconProps {
+    /**
+     * The social platform name - determines which icon to display
+     */
+    platformName: SocialPlatformName;
+    /**
+     * Optional label for accessibility (defaults to platform name)
+     */
+    label?: string;
+}
+/**
+ * SocialLinkIcon - A reusable social media link icon component.
+ *
+ * Combines Pressable navigation with DynamicIcon rendering for social media platforms.
+ * Supports all major social platforms with proper icon mapping.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <SocialLinkIcon platformName="instagram" href="https://instagram.com/company" />
+ *
+ * // With custom size and styling
+ * <SocialLinkIcon
+ *   platformName="x"
+ *   href="https://x.com/company"
+ *   iconSize={24}
+ *   className="hover:text-primary"
+ * />
+ *
+ * // As a button-styled link
+ * <SocialLinkIcon
+ *   platformName="linkedin"
+ *   href="https://linkedin.com/company/example"
+ *   asButton
+ *   variant="outline"
+ *   size="icon"
+ * />
+ * ```
+ */
+declare const SocialLinkIcon: React.ForwardRefExoticComponent<SocialLinkIconProps & React.RefAttributes<HTMLAnchorElement | HTMLButtonElement | HTMLSpanElement>>;
+
+export { SocialLinkIcon, type SocialLinkIconDynamicIconProps, type SocialLinkIconProps, type SocialPlatformName };